FTB Library Mod — Guide
Sidebar System
The Sidebar System is the most visible feature of FTB Library. It adds a dynamic array of buttons to the top-left corner of the player's inventory screen. These buttons provide quick access to mod features without requiring complex commands.
Key Functions
- Quick Access: Open GUIs for FTB Quests, FTB Chunks (Map), or FTB Teams.
- Utility Toggles: Quickly change the time of day, toggle rain, or switch gamemodes (requires OP permissions).
- Mod Settings: Access client-side configuration menus directly from the inventory.
Customization & Edit Mode
Players can fully customize their sidebar experience:
* Enter Edit Mode: Right-click any sidebar button to enter the customization GUI.
* Hide/Show Buttons: Toggle the visibility of specific buttons to declutter the UI.
* Reordering: Drag and drop buttons to change their sequence.
* Global Toggle: The entire sidebar can be disabled via the /ftblibrary clientconfig menu if a player prefers a vanilla inventory look.
NBT Editor
FTB Library includes a robust, user-friendly NBT (Named Binary Tag) Editor. This tool allows server administrators and modpack creators to view and modify the underlying data of any object in the game world without leaving the client.
| Target Type | Command Syntax | Description |
|---|---|---|
| Block | /ftblibrary nbtedit block <x> <y> <z> |
Edits the NBT data of a Tile Entity (e.g., Chest, Furnace). |
| Entity | /ftblibrary nbtedit entity <UUID> |
Edits the data of any living or non-living entity. |
| Item | /ftblibrary nbtedit item |
Edits the NBT of the item currently held in the main hand. |
| Player | /ftblibrary nbtedit player <name> |
Edits a specific player's data (e.g., health, inventory, stats). |
Editor Features
- Tree View: Navigate complex NBT structures using a collapsible folder-style interface.
- Type Safety: The editor prevents invalid data entry by enforcing tag types (Byte, Int, Long, String, etc.).
- Real-time Updates: Changes made in the GUI are applied instantly to the world upon saving.
Technical Details
For modpack creators and developers, FTB Library offers several extensible systems:
- Sidebar JSONs: New sidebar buttons can be added by placing JSON files in
assets/<modid>/sidebar_buttons/. This allows non-FTB mods to integrate with the sidebar system. - Icon Class: A reworked rendering system that handles textures, item icons, and even remote URLs for UI elements.
- Team Integration: While FTB Teams is a separate mod, FTB Library provides the underlying UI components for team management, color selection, and member lists.