? PaletteCraft — 完整文档
PaletteCraft 是一款高级、轻量的 Minecraft 服务器实用插件,旨在优化并革新创造模式下的建造体验。它解决了建造者们面临的最繁琐的问题:在无尽的创造模式物品栏菜单中花费数小时滚动查找已经使用过的方块。
无需反复搜索材料,PaletteCraft 允许建造者将快捷栏(底部 9 个物品栏槽位)当作艺术家的调色板来使用。他们可以排列快捷栏,以自定义名称保存快捷栏布局,并通过一条命令随时瞬间重新装备这些特定的方块。
? 主要功能
完整的调色板生命周期管理(CRUD):一个动态系统,允许玩家在游戏中原生地创建、读取、更新和删除材料调色板,而无需重载服务器。
智能快捷栏填充:当装备调色板时,插件会智能扫描布局。已保存的方块作为完整堆叠(64 个单位)提供,而在保存时空缺(AIR)的槽位会自动清空玩家快捷栏中的对应位置。
无缝的用户体验(Tab 补全):插件与数据存储实时通信。输入 /mbuild give、/mbuild edit 或 /mbuild delete 时,随着你的输入,插件会自动建议你现有的调色板名称。
无卡顿优化:采用干净、性能优先的 Java 实践构建。配置更新无缝写入,以最小化主线程开销,确保即使在大规模建造期间,也对服务器的 TPS 零影响。
现代版本支持:完全兼容现代 Minecraft 版本(1.21+),并针对 Paper/Spigot 服务器环境进行了定制。
?️ 命令与用法
该插件的主命令是 /mbuild。以下是子命令的操作方式:
- 创建新调色板
命令:/mbuild create <palette_name>
工作原理:用最多 9 个特定项目所需的方块排列快捷栏(例如石材渐变、木材变体或装饰方块)。运行命令后,你的布局将被立即保存。
- 装备现有调色板
命令:/mbuild give <palette_name>
工作原理:是否清空了物品栏或切换到了建造的不同部分?运行此命令,当前快捷栏将立即被保存的布局替换,并提供每个物品的完整堆叠。
- 编辑已保存的调色板
命令:/mbuild edit <palette_name>
工作原理:需要更换现有调色板中的单个方块吗?将快捷栏重新排列为新的所需布局,然后运行编辑命令以覆盖旧版本。
- 删除调色板
命令:/mbuild delete <palette_name>
工作原理:项目完成,想要清理工作区?这将彻底从配置文件中清除调色板,并从 Tab 补全建议中移除它。
? 权限
为了确保在公共服务器上的安全部署,PaletteCraft 具备一个简单的权限节点(完全兼容 LuckPerms):
mbuild.use — 基础权限节点。没有此权限,玩家无法执行任何子命令,并将收到未经授权访问的消息。
不对可能发生的任何故障负责。
? 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:
- 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.
- 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.
- 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.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧