Skip to content

Configurations 20.1‐0.25‐v2 & Before

BeansGalaxy edited this page May 6, 2024 · 1 revision

Mod Loader Config

When using Fabric, Cloth Config & Mod Menu must be installed for config to be loaded.

Modify The Size of Backpacks

Forge
config/beansbackpacks-common.toml
Fabric
config/beansbackpacks.json5
Limits
Configure Backpack Sizes maximumStacks (name of the group)
Leather Backpack Maximum Stacks leather Range of 1 - 32
Ender Backpack Maximum Stacks ender Range of 1 - 8
Winged Backpack Maximum Stacks winged Range of 1 - 32
Iron & Undefined Metal Backpacks Maximum Stacks metal Range of 1 - 32
Equipped Decorated Pots Maximum Stacks pot Range of 1 - 128
Equipped Cauldrons Maximum Buckets cauldron Range of 1 - 128

For now Gold Backpacks inherit the size of Iron Backpacks and Netherite Backpacks are set at 11. This is due to the way their traits are loaded into the game.

Modify Client-Sided Features

Forge
config/beansbackpacks-client.toml
Fabric
config/beansbackpacks.json5
Description
Beans Backpacks Config clientConfig (name of the group)
Inventory Help Menu visibility menuVisibility DISABLE: always hides the menu.
HIDE_ABLE (default): Includes a button that will hide the menu until a new tab is discovered.
SHOWN: menu is always available in the inventory.
Hidden Menu Tabs hiddenHelpTabs For internal use. Lists the unlocked tabs the last time the player pressed the hide menu button.
Instantly place backpack on hotkey press instantPlace If true, an equipped backpack will be placed without a right click

Modify the Value Each Gamerule Defaults to

Forge
config/beansbackpacks-client.toml
Fabric
config/beansbackpacks.json5
Description
Configure Gamerule Defaults gamerules (name of the group)

Each setting is named according to their command's name in both configs. For a detailed list on each command and what they do checkout Commands#gamerule Be aware that changing these values in the config only sets their default when a world is created and each value may still be changed by the player running the /beansmod gamerule command on a per world basis.

Data Configurations

All of the mod's configuration is handled by vanilla data packs. You can start by using the Modify Data Template.zip. If you're curious about more on data packs, read through the minecraft wiki's Tutorials/Creating a data pack.

Item Lists

Once you have your data pack created, add the folders so the structure looks like this.

data
└── [folder named anything but 'beansbackpacks']
    └── modify
        ├── blacklist_items
        ├── disable_chestplate
        ├── disables_back_slot
        ├── elytra_items
        └── remove_backpack_keys

For an example, check data/beansbackpacks/modify. You'll find these four files,

disable_chestplate
Enables item to be worn in the Back Slot, and disables it from the Chestplate, However, items with any special attributes do not keep their functionality nor support their custom models.
disables_back_slot
If this item is worn in the Chestplate, it disables anything from being worn in the Back Slot. Good for mods that add larger custom armor models.
blacklist_items
Any items written into this file will no longer be able to be stored in any backpack inventory. This is useful to stop other mod's portable storage to be kept in backpack.
elytra_items
All items in this file will grant the player elytra flight and will be allowed to be worn in the backslot. Also while any of these items are equipped, it disables the backslot and backpacks cannot be worn with them.

Note if an Item is listed in both disable_chestplate and disables_back_slot, it will be removed from disable_chestplate.

These 3 text files are only a written list of items. Simply add any items, modded or vanilla, by their in-game item id. For example if I wanted Iron and Golden Chestplates to not be stored in the backpack I would write in blacklist_items

minecraft:iron_chestplate, minecraft:golden_chestplate

Using ! in front of an item, such as !minecraft:shulker_box, removes that item from the list and overrides all other modifications. If you would like to allow shulker boxes to be carried in backpacks, add each variant of the boxes to the blacklist_items list, or !minecraft:elytra to return the elytra back to it's vanilla functionality.

Additional Lists

remove_backpack_keys
This file works differently than all the other ones. Remove any backpacks by adding their `key` into this folder. This only removes their functionality and recipe, it will not remove any from your world. Here's an example of all the key's in the game now, it should be obvious which key relates to which backpack.
leather, gold, iron, netherite, winged, ender

Adding Modded Elytra (WIP)

Add the in-game item id to elytra_items to allow any item, modded or vanilla, to be equipped in the Back Slot and grant the player elytra flight.

Translations

This mod is fully translatable, but I only took 3 years of Spanish and failed one of those. If you wanted to help, leave a pull request (or just an issue if you are un-familiar with github) with your lang file and the language translated to and I will add your translations to the mod.

Here is the lang file for the English translation of the mod. Translations are added through resource packs, if you need any help creating one read Creating a Resource Pack on the minecraft wiki. If you're unsure what to name your lang file, use the in-game locale code according to this chart.

Looking through the lang file of my mod you might see symbols like §7 and %d. §7 is the color translation code used to turn the color of minecraft text a light gray. %d is a reference determined by the code, in this case it references the key binds for the Backpack Action hotkey and the Use key.