MINECRAFTBIBLE
Loading...
Provides commands to manage trainers and start battles that can act as an interface for other mods (e.g. Easy NPC).
Provides commands to manage trainers and start battles that can act as interface for other mods (e.g. Easy NPC).
This mod is mostly intended for map makers and modpack developers.
tbcsattach <trainerId> <entity>: Attaches the given trainer to the specified entity (a trainer will only ever be attached to one entity).battle <battleFormat> <participants1>... vs <participants2>... [rules <battleRules>] [onwin <winCommands>]: Starts a battle between the given participants with the specified battle format, rules and win commands (the latter two are optional).All commands require a permission level of
2.
Battle rules are described by a json object with following properties:
maxItemUses: Specifies how many items each participant may use in a battle.Yes, it is currently only this one property.
Win commands are also described by a json object but with a little bit more dynamic structure. A win command object may define a property for each battle side (i.e. 1 or 2), containing an array of commands to execute if the respective side wins (see examples below).
In addition any win command has access to special selectors (similar to @s or @e) that allow to select any battle participant within the command. These selectors are structured as follows: @<n> with <n> specifying a position of the battle participants, relative to the side the win command is executed for.
When talking about commands some important questions to ask are: Who is executing the command? And where is it executed?
Win commands are usually executed by the server in the center of all participants from a battle. Although it is possible to have any participant of a battle become the executor of a command, in which case that command is also executed at the position of that participant.
Now, with the formal description out of the way lets get to...
Important: The trainers used in the following commands (e.g. tbcs:mytrainer1) are just an example. You have to provide your own trainers or install another mod that provides any (see Trainers section below).
tbcs attach tbcs:mytrainer1 @e[type=minecraft:villager,limit=1,sort=nearest]
Attaches tbcs:mytrainer1 to the closest villager.
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1
Starts a battle between the player executing the command and tbcs:mytrainer1 (must be attached to an entity).
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1 rules {maxItemUses: 1}
Like above but limits the item usage of each side to 1.
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1 rules {maxItemUses: 1} onwin {1: ['give @1 minecraft:diamond']}
Another one of these but this time the player is granted a diamond on win (first participant of the first side).
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1 onwin {1: ['loot spawn ~ ~ ~ loot minecraft:chests/simple_dungeon']}
An alternative to using give (often with quite a few more rewards but it depends on the loot table). The win command will be executed by the server in the center of all battle participants. To execute the command as the player (i.e. to spawn the loot directly on top of them) one could precede the loot command with @1 (see also example below).
tbcs battle GEN_9_MULTI @s tbcs:mytrainer1 vs tbcs:mytrainer2 tbcs:mytrainer3 onwin {1: ['give @1 minecraft:diamond', '@2 say We got them!']}
An example for positional selectors. The player will receive a diamond and tbcs:mytrainer1 will say "We got them!" when the first side wins (i.e. player side). This also shows how a command can be executed from a different source other than the server (the second command will be executed by the entity that tbcs:mytrainer1 is attached to).
tbcs battle GEN_9_MULTI @s tbcs:mytrainer1 vs tbcs:mytrainer2 tbcs:mytrainer3 onwin {1: ['give @1 minecraft:diamond', '@2 say We got them!'], 2: ['@3 tp ~ ~10 ~']}
We can extend the previous example by adding win commands for the other side, i.e. these are executed if the player side loses. As a reminder, the positional arguments are relative to the side of the win command and go from left to right. So for commands executed from the second side the selectors are mapped as the following:
@1 -> tbcs:mytrainer2@2 -> tbcs:mytrainer3@3 -> @s@4 -> tbcs:mytrainer1For reference commands executed from the first side will map the selectors like this:
@1 -> @s@2 -> tbcs:mytrainer1@3 -> tbcs:mytrainer2@4 -> tbcs:mytrainer3So the win command of the second side will punish the player when their side loses (i.e. the second side wins) by teleporting the player 10 blocks up relative from their position (the command is executed by the player).
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1 onwin {1: ['@2 say Not bad, but are you ready for this?!', 'tbcs attach tbcs:mytrainer2 @2', 'tbcs battle GEN_9_SINGLES @1 vs tbcs:mytrainer2 onwin {1: [\'give @1 minecraft:diamond\']}']}
This one chains one battle after another. Lets break it down (all of these are executed when the player wins):
tbcs::mytrainer1 to say "Not bad, but are you ready for this?!"tbcs:mytrainer2, to the same entity that tbcs:mytrainer1 is attached totbcs:mytrainer2 immediately afterwards. This battle also comes with its own definition for win commands rewarding the player with a diamond on win.See the command in action:
This could be repeated indefinetely. Note that the further nested a win command is the more backslashes (
\) are required to escape the apostrophes (') surrounding the command.
tbcs battle GEN_9_SINGLES @s vs tbcs:mytrainer1 onwin {2: ['@1 say You need to practice more @2!'], 1: ['@2 say You got me. Take this @1', 'loot spawn ~ ~ ~ loot minecraft:chests/end_city_treasure']}
There is nothing new here. It's a command from one of my tests.
Note: The video is from an older version, trainer ids are now structured a little bit different (see suggestions of the commands ingame) but the functionality is the same. You can find the full video on the repository.
Trainers can be defined using json, the trainer schema is provided by RCTApi hence the structure is mostly the same as from my other mod Radical Cobblemon Trainers (the only exceptions are identity, which does not exist in this mod as well as battleFormat and battleRules, which are both command arguments). You can find more information and an example in the corresponding documentation.
Whenever a world is loaded trainer files will be searched in all trainerPaths, a list of paths relative to the world directory. All trainers will be registered with an id that will be derived from their file name. For example, lets assmume we have a minecraft installation like this (shortened):
mods
config
trainers
bug_catcher.json
saves
My Cool World
Strong Trainers
Ash Ketchum.json
Boring World
...
With trainerPaths being defined as: ["Strong Trainers", "../../trainers"].
My Cool World: This will register the trainers tbcs:bug_catcher and tbcs:ash_ketchum.Boring World: This will only register the trainer tbcs:bug_catcher.If a trainer with the same id (i.e. different folders but same file name) will be registered multiple times any subsequent trainers will have a counter (
_n) appended to their id.
The mod is compatible with other mods that also rely on RCTApi. Copies of trainers from these mods may automatically be registered to tbcs when these mods are also installed (see config).
The config file is located at config/tbcs-server.toml:
[Trainers]
#━━━━━━━━━━
#List of paths, relative to the world directory, to search for trainer
#json files when (re)loading a world.
#
#Default: ["trainers", "../trainers", "../../trainers"]
trainerPaths = ["trainers", "../trainers", "../../trainers"]
#━━━━━━━━━━
#List of mod ids from mods that also rely on RCTApi to define trainers.
#Copies of trainers from the listed mods will also be registered to TBCS.
#
#Default: ["rctmod"]
trainerMods = ["rctmod"]
[Commands]
#━━━━━━━━━━
#Permission level of win commands.
#
#Default: 2
#Range: 1 ~ 4
winCommandsPermission = 2
The source code of this project is licensed under GNU-LGPL.