TurnBasedMinecraftMod/README.md

100 lines
4.5 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!
2023-12-28 03:23:00 +00:00
# Links/Downloads
2018-09-28 10:42:46 +00:00
2020-06-22 08:04:55 +00:00
Precompiled jars are available here:
2020-06-22 08:05:44 +00:00
https://seodisparate.com/static/tbm_releases/
https://burnedkirby.com/tbmm_downloads/
2024-01-01 03:37:45 +00:00
https://www.curseforge.com/minecraft/mc-mods/turnbasedminecraft/files
2024-01-17 04:38:39 +00:00
https://modrinth.com/mod/turnbasedmc
2024-01-17 04:35:09 +00:00
https://git.seodisparate.com/stephenseo/TurnBasedMinecraftMod/releases
2023-12-28 03:23:00 +00:00
2023-12-30 02:58:11 +00:00
# Forge or NeoForge
2024-01-30 02:13:39 +00:00
The `forge` branch tracks the version of the mod for Minecraft Forge.
2023-12-30 02:58:11 +00:00
The `neoforge` branch tracks the version of the mod for Minecraft NeoForge.
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
2020-11-18 11:19:44 +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.~~ When a new config version is made,
usually because a new entry has been added, the existing config is renamed to a file with
a timestamp in the filename of when it was replaced. One can set a config option in the
config to prevent it being overwritten if necessary.
2018-09-28 10:56:18 +00:00
2024-10-14 12:37:40 +00:00
Some options in the config file only affect the Server, and ~~some only affect the Client~~.
2024-10-15 06:49:05 +00:00
Client config has been moved to a
[separate system provided by NeoForge](https://github.com/Stephen-Seo/TurnBasedMinecraftMod/blob/neoforge/FAQ.md#how-do-i-configure-battle-music).
2018-09-28 10:56:18 +00:00
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)
2024-01-08 06:37:48 +00:00
- 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 which song plays in battle for the client. only `.wav`,
~~`.mid`~~, `.mp3`, and `.ogg` files supported. ~~Only `.mid` files are not
affected by volume options (master and music sliders))~~ Midi file playback
has been disabled for now due to lack of volume control issues. MP3 file
playback sometimes fails, but seems to work better when the file is as
2024-01-08 09:24:26 +00:00
"barebones" as possible (no album art metadata in the file).
- It is recommended to use `.ogg` files for music.
- Note that ogg Vorbis is supported, and NOT ogg Opus.
- One can convert to ogg Vorbis with ffmpeg like this: `ffmpeg -i
<my_music_file_to_convert> -map a:0 -c:a libvorbis output.ogg`.
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)
2022-06-10 04:39:09 +00:00
- [Server-side config can be edited in-game with the "/tbm-server-edit" command](https://youtu.be/9xkbHNWkcIY)
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
2024-01-08 06:37:48 +00:00
finished jar will be saved at
`build/libs/TurnBasedMinecraft-NeoForge-1.26.0-all.jar`
2018-10-25 05:56:36 +00:00
# Reproducibility
This mod should support reproducible builds. See `Reproducibility.md` to see
more details.
2018-10-25 05:56:36 +00:00
# Other notes
This mod uses [j-ogg-vorbis](https://github.com/stephengold/j-ogg-all)
available from [http://www.j-ogg.de](http://www.j-ogg.de) and copyrighted by
Tor-Einar Jarnbjo.
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).
2019-11-29 10:48:03 +00:00
2024-01-08 08:27:45 +00:00
# Frequently Asked Questions
[See the FAQ page.](https://github.com/Stephen-Seo/TurnBasedMinecraftMod/blob/master/FAQ.md)
2019-11-29 10:48:03 +00:00
# Related Videos
2021-05-24 04:17:19 +00:00
[See related videos here](https://burnedkirby.com/posts/tbmm/)