TurnBasedMinecraftMod/README.md

64 lines
2.9 KiB
Markdown
Raw Normal View History

2018-09-28 10:42:46 +00:00
# TurnBasedMinecraftMod
This mod puts turn-based-combat of RPGs into Minecraft!
# Downloads
Precompiled jars are available here:
2018-09-28 10:45:41 +00:00
https://seodisparate.com/static/tbm_releases/
2018-09-28 10:42:46 +00:00
2018-10-17 03:53:50 +00:00
# What changed in what version
See the [Changelog](https://github.com/Stephen-Seo/TurnBasedMinecraftMod/blob/master/Changelog.md)
2018-09-28 10:56:18 +00:00
# Things you may need to know about this mod
On first run, this mod will create a config file and some directories in your
Minecraft directory. They will typically be located at
2018-09-28 10:57:49 +00:00
`.minecraft/config/TurnBasedMinecraft`. (for the server they will be in the
`config` directory in the server directory.)
2018-09-28 10:56:18 +00:00
2018-10-25 08:53:46 +00:00
The config file `.minecraft/config/TurnBasedMinecraft/TBM_Config.toml` is commented
with info on what each option does. ~~It will also be moved if a newer version
2018-09-28 10:56:18 +00:00
of this mod has a newer version of the config file (usually renamed with a
2018-10-25 08:53:46 +00:00
timestamp).~~ I will try my best to not move the previous version config, but rather
edit the previous version config to have new options.
2018-09-28 10:56:18 +00:00
Some options in the config file only affect the Server, and some only affect the Client.
When playing multiplayer, some configuration of the config on the server may be needed.
# Features
- Combat between players and mobs or other players will invoke a turn based battle
between them
- Supports use of the vanilla Minecraft bow and arrows (have bow selected when
in battle)
- Supports custom battle music to be played when fighting enemies. (They must be
placed in `.minecraft/config/TurnBasedMinecraft/Music/battle` or
`.minecraft/config/TurnBasedMinecraft/Music/silly`. Client-side config determines
2018-09-28 10:57:49 +00:00
which song plays in battle for the client. only `.wav` and `.mid` files supported.
Only `.wav` files are affected by volume options (master and music sliders))
2018-09-28 10:56:18 +00:00
- Config allows limiting number of combatants in turn-based battle.
- Config can be modified (server-side) to add entries of mobs from other mods.
(by default an unknown mob cannot enter turn-based battle, so the config must be
configured for them.)
2018-10-25 07:21:39 +00:00
- [Alternatively, the command "/tbm-edit" can be used in-game to add/edit
entities for the mod.](https://www.youtube.com/watch?v=MK648OVHddE)
2018-10-26 11:59:06 +00:00
- [Also, one can make entries for specific custom names](https://youtu.be/9lBETQFMd3A)
2018-09-28 10:56:18 +00:00
2018-09-28 10:42:46 +00:00
# Building
Simply invoke `./gradlew build` in the mod directory and after some time the
finished jar will be placed in build/libs/
2018-10-25 05:56:36 +00:00
# Other notes
This mod uses [shadow](https://github.com/johnrengelman/shadow) which is
licenced under the [Apache License 2.0](https://github.com/johnrengelman/shadow/blob/master/LICENSE).
This mod also uses [Cava-Toml](https://github.com/ConsenSys/cava/tree/master/toml)
which is licenced under the [Apache License 2.0](https://github.com/ConsenSys/cava/blob/master/LICENSE).
2018-10-30 05:11:48 +00:00
This mod also uses [JavaMP3](https://github.com/kevinstadler/JavaMP3)
which is licensed under the [MIT License](https://github.com/kevinstadler/JavaMP3/blob/master/LICENSE).