LibX Mod — Configuration
Player Commands
LibX includes a set of administrative and diagnostic commands accessible via the /libx prefix. These are particularly useful for debugging item data, block states, and entity NBT without needing external editors.
| Command | Description |
|---|---|
/libx hand |
Displays the full NBT (Named Binary Tag) data of the item currently held in the player's main hand. |
/libx block |
Displays the block state properties and NBT data of the block the player is currently looking at. |
/libx entity |
Displays the NBT data of the entity (mob or player) the player is currently looking at. |
/libx reload |
Reloads all configuration files managed by the LibX framework, allowing for real-time changes without restarting the game. |
These commands output information directly to the chat, which can then be copied to the clipboard for use in modding or modpack configuration.
Configuration System
LibX features a custom, annotation-based configuration system that uses the JSON5 format. This allows for comments within configuration files, making them much easier for players and modpack authors to navigate and edit.
Config Types
- Common Configs: These are shared between the client and the server. When a player joins a server, the server's common config values are synced to the client to ensure gameplay consistency.
- Client Configs: These are local to the player's machine and handle visual or audio settings that do not affect server-side logic.
File Locations
Configuration files generated by LibX are typically found in the .minecraft/config/ directory. They follow a specific naming convention based on the mod ID:
* config/modid.json5 (Primary config)
* config/namespace/path.json5 (Sub-configs or categorized settings)
Features
- Automatic Syncing: Ensures that players cannot bypass server rules by changing local config files.
- Validation: Includes built-in validators like
@IntRangeto prevent invalid values (e.g., setting a spawn rate to a negative number) from crashing the game.