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 <palette_name>

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 <palette_name>

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 <palette_name>

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 <palette_name>

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.