PaletteCraft

👑 PaletteCraft — Complete Documentation
PaletteCraft is a premium, lightweight utility plugin for Minecraft servers designed to optimize and revolutionize the building experience in Creative Mode. It solves the most tedious problem that builders face: wasting hours scrolling through endless creative inventory menus to find blocks they've already used.

Instead of searching for materials repeatedly, PaletteCraft allows builders to treat their hotbar (the 9 bottom inventory slots) like an artist's paint palette. They can arrange their hotbar, capture it under a custom name, and instantly re-equip those exact blocks anytime with a single command.

🚀 Key Features
Full Palette Lifecycle Management (CRUD): A dynamic system that lets players create, read, update, and delete material palettes natively in-game without requiring a server reload.

Smart Hotbar Filling: When a palette is equipped, the plugin intelligently scans the layout. True blocks are given as full stacks (64 units), while slots that were empty (AIR) when saved are automatically cleared in the player's hotbar.

Seamless User Experience (Tab Completion): The plugin communicates with its data storage in real-time. Typing /mbuild give, /mbuild edit, or /mbuild delete will automatically suggest your existing palette names as you type.

Lag-Free Optimization: Built with clean, performance-first Java practices. Configuration updates are written seamlessly to minimize main-thread overhead, ensuring zero impact on your server's TPS, even during massive build sessions.

Modern Version Support: Fully compatible with modern Minecraft versions (1.21+) and tailored for Paper/Spigot server environments.

🛠️ Commands & Usage
The main command for the plugin is /mbuild. Here is how the sub-commands operate:

1. Create a New Palette
   Command: /mbuild create

How it works: Arrange your hotbar with up to 9 blocks needed for a specific project (e.g., gradients of stone, wood variants, or detailing blocks). Run the command, and your layout is instantly saved.

1. Equip an Existing Palette
   Command: /mbuild give

How it works: Did you clear your inventory or switch to a different section of your build? Run this command, and your current hotbar will immediately be replaced by the saved layout, providing full stacks of each item.

1. Edit a Saved Palette
   Command: /mbuild edit

How it works: Need to swap out a single block in an existing palette? Rearrange your hotbar to the new desired layout and run the edit command to overwrite the old version.

1. Delete a Palette
   Command: /mbuild delete

How it works: Project finished and you want to clean up your workspace? This completely wipes the palette from the configuration file and removes it from tab completion suggestions.

🔐 Permissions
To ensure secure deployment on public servers, PaletteCraft features a straightforward permission node (fully compatible with LuckPerms):

mbuild.use — The baseline permission node. Without this, players cannot execute any sub-commands and will receive an unauthorized access message.

No responsibility is taken for any malfunction that may occur.