-
Notifications
You must be signed in to change notification settings - Fork 30
Editing Entities
The Book of Souls (BoS) is the main feature of the NBTEditor, it acts like a container that holds a custom entity and allow easy access and modification of any variables. No files are saved on the server, you can just keep the book on a chest for later use.
All operations are done using the /bookofsouls (/bos) command.
Books of Souls are created using the /bos get <entity> command, e.g. /bos get pig will create a Book of Souls for a Pig. To see all available entities just use /bos get.
Opening the book you will see all available variables for that entity.
To edit variables use the /bos var <variable> ... command. E.g. a Pig has the Saddle variable, this is a boolean variable (true/false) and controls the saddle on the Pig, using /bos var Saddle true will set it to true. Now the book represents a saddled Pig. Naming the Pig is easy too, just use /bos var Name Neo.
Entities also inherit variables from their parent type, e.g. a Pig (which is a sub-type of Mob) also has the Health variable, this variable is also present on all Mobs.
Variables have many types, a accept a wide range of data, use tab-completion to help build the commands. Some entities have special variables that open an inventory to improve customization, e.g. all mobs have a ArmorItems when running /bos var ArmorItems will open an inventory where you can set the Mob's armor.
Using /bos clearvar <variable> will reset a variable to its default value (unset the variable).
It's also possible to edit Mob attributes using the /bos attr command. Check the command list for all the commands and the Minecraft Wiki for more information on Attributes.
With empty BoSs it's possible to capture the information (soul) of entities. Run /bos getempty, this creates the empty BoS, then right-clicking an entity will capture all the information on a fresh BoS that can be edited further.
Spawning entities is as easy as left-clicking while holding a BoS. You can also convert any BoS to as vanilla /summon command by looking at a Command Block while holding the BoS and running /bos tocommand. And it's possible to convert some Mob BoSs to vanilla spawn eggs using the command /bos toegg.