kami-blue/README.md

242 lines
9.3 KiB
Markdown
Raw Normal View History

2020-01-26 04:31:12 +00:00
<img src="https://github.com/S-B99/kamiblue/blob/assets/assets/icons/kami.svg" align="left" width="120"/>
2019-10-24 23:31:36 +00:00
# KAMI Blue
2019-10-24 22:59:40 +00:00
2019-10-24 23:09:04 +00:00
### A minecraft utility mod for anarchy servers.
2019-10-24 16:56:30 +00:00
2020-01-26 05:27:07 +00:00
#
<a href="https://github.com/S-B99/kamiblue/releases/download/v1.1.2/KAMI-Blue-v1.1.2-release.jar">
<img src="https://github.com/S-B99/kamiblue/blob/assets/assets/icons/download.svg" width="200"/>
</a>
2020-01-13 15:05:35 +00:00
| | S-B99 (feature/master)| 086 (upstream) |
2019-10-28 00:19:48 +00:00
|:------------:|:-------------:|:--------------:|
2020-01-31 19:07:42 +00:00
| Build Status | [![Build Status features-master](https://img.shields.io/travis/com/S-B99/kamiblue/feature/master?logo=gradle&label=build)](https://travis-ci.com/S-B99/kamiblue/) | [![Build Status 086](https://img.shields.io/travis/com/zeroeightysix/KAMI/master?logo=gradle)](https://travis-ci.com/zeroeightysix/KAMI) |
| Media | [![Discord Mine](https://img.shields.io/discord/573954110454366214?label=chat&logo=discord&logoColor=white)](https://discord.gg/KfpqwZB) | [![Discord 086](https://img.shields.io/discord/496724196542513174?label=discord&logo=discord&logoColor=white)](http://discord.gg/9hvwgeg) |
| Downloads | [![Dl discord](https://img.shields.io/badge/discord-22k-brightgreen?logo=discord&logoColor=white)](https://discord.gg/KfpqwZB) [![Dl Github](https://img.shields.io/github/downloads/S-B99/kamiblue/total?label=github&logo=github)](https://github.com/S-B99/kamiblue/releases) | [![Dl github 086](https://img.shields.io/github/downloads/zeroeightysix/KAMI/total?label=github&logo=github)](https://github.com/zeroeightysix/KAMI/releases) |
2020-01-31 19:07:42 +00:00
| Version | [![Version master](https://img.shields.io/github/v/release/S-B99/kamiblue?color=dark-green&label=latest&logo=java)](https://github.com/S-B99/kamiblue/releases) | [![Version 086](https://img.shields.io/github/v/tag/zeroeightysix/kami?color=bright-green&label=latest%20%28pre%20v1.1.0%29&logo=java)](https://github.com/zeroeightysix/KAMI/releases) |
2019-12-17 02:19:19 +00:00
2019-10-31 21:00:11 +00:00
[![Paypal](https://img.shields.io/badge/paypal-donate-red?color=169bd7&logo=paypal)](https://paypal.me/bellawhotwo)
[![BTC](https://img.shields.io/badge/btc-clickme-red?color=f08b16&logo=bitcoin)](https://www.blockchain.com/btc/address/19pH4aNZZMPJkqQ2826BauRokyBs1NYon7)
[![BCH](https://img.shields.io/badge/bch-clickme-red?color=2db300&logo=cash-app)](https://www.blockchain.com/bch/address/19pH4aNZZMPJkqQ2826BauRokyBs1NYon7)
2019-10-31 13:23:21 +00:00
Please consider donating to help continue this project and get a unique cape in game.
2019-10-24 21:35:47 +00:00
Also note Baritone is no longer included. Download the standalone jar [from here](https://github.com/cabaletta/baritone/releases/tag/v1.2.10).
2019-10-24 16:56:30 +00:00
<details>
<summary>Click to view disclaimers</summary>
2019-10-24 16:56:30 +00:00
2019-10-24 23:59:08 +00:00
***
This is by no means a finished project, nor is it a "cheat" or "hack" for anything, it is a *utility* mod.
See [forgehax](https://github.com/fr1kin/forgehax) for an equivalent. Some features in KAMI may be based on those of forgehax, and KAMI / KAMI Blue have some features it doesn't. KAMI Blue won't be based off of other mods unless said otherwise.
2019-10-24 16:56:30 +00:00
2019-10-24 23:59:08 +00:00
***
2019-10-24 16:56:30 +00:00
</details>
2018-07-21 20:00:15 +00:00
## Installing
2019-11-04 23:22:33 +00:00
To install drag the `VERSION-release.jar` to your `mods/1.12.2` folder
2019-10-25 22:04:55 +00:00
<details>
<summary>Click to see more detailed installing instructions</summary>
KAMI Blue is a forge mod. Start by downloading the latest version of [1.12.2 forge](https://files.minecraftforge.net/maven/net/minecraftforge/forge/index_1.12.2.html).
1. Install forge
2019-10-24 16:56:30 +00:00
2. Go to your `.minecraft` directory.
* **Linux**: `~/.minecraft`
* **Windows**: `%appdata%/.minecraft`
2019-12-10 13:21:41 +00:00
* **OS X**: `~/Library/Application Support/minecraft`
3. Navigate to the `mods` directory. If it doesn't exist, create it.
4. Get the KAMI Blue `.jar` file.
2018-08-10 13:21:57 +00:00
* By **downloading** it: see [releases](../../releases)
2018-08-10 13:23:05 +00:00
* By **building** it: see [building](#building).
2019-10-24 16:56:30 +00:00
5. Drag the `-release.jar` file into your mods directory.
2019-10-25 22:04:55 +00:00
</details>
## FAQ
2018-08-12 18:52:03 +00:00
2019-10-24 16:56:30 +00:00
<details>
<summary>Click to see the frequently asked questions or basic stuff</summary>
2018-08-12 18:52:03 +00:00
2019-10-24 23:59:08 +00:00
***
##### Open the GUI
Press Y.
2018-08-12 18:52:03 +00:00
##### Use commands
The default prefix is `.`. Commands are used through chat, use `.commands` for a list of commands.
2018-08-12 18:52:03 +00:00
##### Bind modules
Run `.bind <module> <key>`.
You can also use `.bind modifiers on` to allow modules to be bound to keybinds with modifiers, e.g `ctrl + shift + w` or `ctrl + c`.
2018-08-12 18:52:03 +00:00
2020-01-27 15:23:29 +00:00
You can unbind modules with backspace in the GUI or by running `.bind <module> none`
##### Change command prefix
By using the command `prefix <prefix>` or after having ran KAMI Blue (make sure it's closed), editing your configuration file (find it using `config path` in-game) and changing the value of `commandPrefix` to change the prefix.
2018-08-10 13:07:49 +00:00
2019-10-24 23:59:08 +00:00
***
2019-10-24 16:56:30 +00:00
</details>
2018-10-03 06:41:36 +00:00
2020-01-19 01:29:01 +00:00
## Preview
***
### Click on images to expand
2020-01-19 01:29:01 +00:00
Capes in game
2020-01-26 04:31:12 +00:00
<img src="https://raw.githubusercontent.com/S-B99/kamiblue/assets/assets/readme/capes.png" width="500"/>
2020-01-19 01:29:01 +00:00
Rich presence on discord
2020-01-26 04:31:12 +00:00
<img src="https://raw.githubusercontent.com/S-B99/kamiblue/assets/assets/readme/rpc.png" width="500"/>
2020-01-19 01:29:01 +00:00
Shulker preview being used in chat
2020-01-26 04:31:12 +00:00
<img src="https://raw.githubusercontent.com/S-B99/kamiblue/assets/assets/readme/shulkerChat.png" width="500"/>
2020-01-19 01:29:01 +00:00
CrystalAura targeting
2020-01-26 04:31:12 +00:00
<img src="https://raw.githubusercontent.com/S-B99/kamiblue/assets/assets/readme/crystalAura.png" width="500"/>
2020-01-19 01:29:01 +00:00
***
## Status
<details>
<summary>Click to view current development status</summary>
***
2020-01-26 04:31:12 +00:00
Please see the [issues](https://github.com/S-B99/kamiblue/issues/) page for planned features and bugs to fix.
This is currently in active development. When issues are being closed is by milestone, and bugs are higher priority, though there aren't any that break anything completely.
***
</details>
2020-01-07 16:56:26 +00:00
## Building and Contributing
2019-12-15 05:28:38 +00:00
<details>
2020-01-07 19:34:27 +00:00
<summary>Click to see instructions</summary>
2019-12-15 05:28:38 +00:00
***
2020-01-07 16:56:26 +00:00
If you can't figure these instructions out, please see [this](https://youtu.be/PfmlNiHonV0) before asking for help.
2020-01-07 21:00:05 +00:00
Please make sure to restart your IDE in after running all setup commands
2020-01-07 16:56:26 +00:00
***
2020-01-07 23:10:59 +00:00
***
2020-01-09 15:51:24 +00:00
### Contributing
You are free to clone, modify KAMI and KAMI Blue and make pull requests as you wish. To set up your development environment, make use of the following commands:
On GNU/Linux, run `chmod +x gradlew` beforehand
On Windows, for the following commands use `./gradlew` instead of `gradlew.bat`
Of-course you can also use a Gradle installation if you for some reason want another version of gradle
```
2020-01-26 04:31:12 +00:00
git clone https://github.com/S-B99/kamiblue/
2020-01-09 15:51:24 +00:00
cd KAMI
```
Import KAMI Blue into your IDE of choice.
```
./gradlew setupDecompWorkspace
./gradlew genIntellijRuns #for intellij
./gradlew eclipse #for eclipse
```
If you use IntelliJ, import `build.gradle`
If you use Eclipse, import a new gradle project and select the KAMI folder.
If you have gradle related issues with either of these force your gradle version to `4.8.1`
If you do not wish to run from an IDE, use `./gradlew runClient` to run KAMI Blue.
Note: I don't recommend using runClient as sometimes it's wonky. If you have issues then do `./gradlew clean`
***
If you get build errors see this: [troubleshooting page](docs/TROUBLESHOOTING.md)
***
***
2020-01-07 16:57:06 +00:00
### Building
2020-01-07 23:10:59 +00:00
***
2019-12-15 05:28:38 +00:00
#### Linux
You can build by running these commands (without the <>) in a terminal.
```
2020-01-26 04:31:12 +00:00
git clone https://github.com/S-B99/kamiblue/
2019-12-15 05:28:38 +00:00
cd KAMI
chmod +x gradlew
./gradlew <args>
```
Possible arguments:
```
build
mkdir
rmOld
copy
```
If you use more than one then it must be in that order.
Build is required, `mkdir` makes the `mods/1.12.2` directory, `rmOld` removes old versions of KAMI and KAMI Blue\* in that directory, and `copy` copies the build release to the `mods/1.12.2` directory.
\*`rmOld` removes any jars ending in `-release.jar`, which is the format KAMI used and that KAMI Blue uses. If you use any other mod that uses that naming scheme please remove old versions manually.
If you prefer copying it manually, find a file in `build/libs` called `KAMI-<kamiVersion>-**release**.jar` which you can copy to the `mods/1.12.2` folder of a minecraft instance that has forge installed.
Note: This assumes your minecraft folder is in the default location under your home folder.
2020-01-26 04:31:12 +00:00
Note: Any argument other then `build` assumes you downloaded KAMI Blue to a nested folder inside your home folder. For example `~/Downloads/KAMI` or `~/Documents/KAMI`. This will be fixed as per [issue #15](https://github.com/S-B99/kamiblue/issues/15)
2019-12-15 05:28:38 +00:00
***
#### Windows
You can build by running these commands in a terminal with the current directory being KAMI. (EG. `cd C:\Users\Username\Downloads\KAMI`)
```
gradlew.bat build
```
2020-01-07 19:29:55 +00:00
To copy on windows find a file in `build/libs` called `KAMI-<kamiVersion>-**release**.jar` which you can copy to the `mods\1.12.2` folder of a minecraft instance that has forge installed.
2019-12-15 05:28:38 +00:00
Note: This assumes your minecraft folder is in the default location under your %appdata% folder.
***
If you get build errors see this: [troubleshooting page](docs/TROUBLESHOOTING.md)
***
</details>
2018-10-10 19:32:02 +00:00
## Thank you
2019-10-24 16:56:30 +00:00
[zeroeightysix](https://github.com/zeroeightysix) for the original [KAMI](https://github.com/zeroeightysix/KAMI)
2018-10-10 19:32:02 +00:00
[ZeroMemes](https://github.com/ZeroMemes) for [Alpine](https://github.com/ZeroMemes/Alpine)
[ronmamo](https://github.com/ronmamo/) for [Reflections](https://github.com/ronmamo/reflections)
2019-10-24 16:56:30 +00:00
The [Minecraft Forge team](https://github.com/MinecraftForge) for [forge](https://files.minecraftforge.net/)
2019-12-22 16:00:51 +00:00
2020-01-26 04:31:12 +00:00
All the [contributors](https://github.com/S-B99/kamiblue/graphs/contributors), including the ones who will be remembered in comments and in our hearts. This has been a huge community effort and I couldn't have done it without them.