Skip to content

Commit

Permalink
Issue #7 Add README (#9)
Browse files Browse the repository at this point in the history
* Issue #7 Add README

* added exec bit

* Updated readme for Gradle and Fabric

* updated readme according to Fabric install

* adjust source build jar path

* updated for Minecraft Forge

* tweaked Fabric API dependency comment

* link to issues section
  • Loading branch information
ajmas authored Sep 8, 2023
1 parent d846a3b commit 8abe2f9
Show file tree
Hide file tree
Showing 2 changed files with 74 additions and 0 deletions.
74 changes: 74 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# Screencopy

This is a client-side mod that lets you copy screenshots to your clipboard, you just need to press F2 like you usually do in Minecraft. It works in macOS, Linux and Windows that use x64 or arm64. Also there is a config file for not saving the file to the screenshots folder if that's your preference!

This mod shouldn't be incompatible with any mod (including optifine) but do report it in the [issues section](https://github.com/ImUrX/screencopy/issues) ;)

[Discord Server](https://discord.gg/7EnaAuaAwF)

Tested as working with Minecraft 1.19.1, 1.20.1.

## Dependencies


- [Cloth Config API](https://www.curseforge.com/minecraft/mc-mods/cloth-config)
- [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api) (if using Fabric)

Note: when downloading, be sure to pay attention to the target Minecraft
release and mod platform (Fabric/Forge) where applicable.

## Building

First make sure to have the latest Java SDK installed for your system:

- [Oracle Java](https://www.oracle.com/ca-en/java/technologies/downloads/)
- [OpenJDK](https://openjdk.org/)

Once you have the build environment setup, all you need to is
run the appropriate script, according to your platform, to get
the build running (current build uses Gradle 7). See the sub-sections,
for the most common platforms.

Note, generated assets will be in `fabric/build/libs` and
`forge/build/libs`, for Fabric and Forge, respectively.

### Linux & macOS

```sh
chmod +x ./gradlew
./gradlew build
```

### Windows

```sh
gradlew.bat build
```

## Installation

If you are looking to install an already built release, then visit
the project on [Curseforge](https://www.curseforge.com/minecraft/mc-mods/screencopy),
otherwise if you are building from source, follow the steps below.

### Forge

This assumes you have [Minecraft Forge](https://files.minecraftforge.net/net/minecraftforge/forge/) installed.

- Locate the `mods` folder for your Forge installation.
- Copy the file from `forge/build/libs/screenshotcopy-1.2.2-forge.jar` (adjust version number as appropriate) to the `mods` folder of your Forge installation.
- Launch your Forge version of Minecraft

### Fabric

This assumes you have [Fabric](https://fabricmc.net/) installed.

- Locate the `mods` folder for your Fabric installation.
- Copy the file from `fabric/build/libs/screenshotcopy-1.2.2-fabric.jar` (adjust version number as appropriate) to the `mods` folder of your Fabric installation.
- Launch your Fabric version of Minecraft

For a video on installing Frabric, see https://www.youtube.com/watch?v=lP_Z0E6oGo8

## License

This project uses the [MIT license](./LICENSE-MIT).
Empty file modified gradlew
100644 → 100755
Empty file.

0 comments on commit 8abe2f9

Please sign in to comment.