MineCubes 🧊
MineCubes 是一款现代化的、高性能的 Minecraft 3D 方块生成器插件,专为 Minecraft 1.17 至 1.21.x 以及现代服务器引擎如 Paper, DivineMC, Leaf 和 Folia 26.2 设计。
它允许服务器管理员和玩家创建、自定义、放置和自动化带有加权掉落概率的 3D 方块生成器,并支持虚拟双箱存储、AutoMine 自动化以及集成的自动熔炼功能。
✨ 特性
- 🎲 可自定义模板: 在
cubegens.yml 中或通过游戏内命令定义自定义方块生成器模板,支持自定义尺寸($3 \times 3$,$5 \times 5$,$7 \times 7$)、再生间隔和类型(带基岩边框的 protect 模式或 normal 模式)。
- 🖥️ 交互式 GUI 方块编辑器 (
/mc template edit <name>):
- 直观的 54 格物品栏编辑器。
- 拖放任何你想要生成的方块(完全支持所有方块,包括现代 1.21 版本的凝灰岩和铜变体)。
- 在任意方块上按住 Shift + 左键点击,通过聊天设置其生成概率。
- 实时显示总百分比并进行验证(如果总和超过 $100%$,则阻止保存)。
- 一键 自动平衡 按钮,按比例缩放概率使其精确等于 $100%$。
- 🔗 自定义物品链接:
- 手持任何自定义物品(具有自定义模型、描述文本、发光效果或 NBT 标签),运行
/mc template linkitem <name>。
- 使用
/mc give <player> <template> [amount] 将生成器交付给玩家。
- 在世界中放置该物品会创建生成器;拾取它会返还完全相同的链接物品。
- 🌱 智能放置与地形保护:
- 自动检测草、高花、蕨类植物或雪层下方的坚实地面。
- 放置时清除植被,使生成器直接放置在坚实地面上,避免悬空。
- 放置后将玩家安全传送至结构外部,防止被困。
- 严格位于地面以上(
clickedSurface + 1);拾取时会保留下方地形完整,不会留下坑洞。
- 🧗 可攀爬的角落梯子:
- 内置梯子附着在距离玩家最近的基岩角柱的外侧面上。
- 从地面一直延伸到基岩框架顶部,方便攀爬。
- 当生成器被拾取时,梯子会自动清理,不产生物理掉落物。
- 📦 虚拟双箱存储(54 格):
- 内置通过管理菜单访问的实时同步虚拟存储空间。
- 自动将 AutoMine 和手动挖掘的掉落物存入 Storage Mode(存储模式)。
- 如果生成器被拾取,会将所有存储的物品安全地掉落在所有者脚下。
- 🤖 AutoMine 自动化:
- 以逼真的方块破碎粒子和声音逐个自动挖掘内部方块。
- 直接将掉落物存入生成器的 54 格虚拟物品栏中。
- 🔥 自动熔炼:
- 在将掉落物存入存储之前,直接熔炼挖掘出的原矿(粗铁、粗铜、粗金、远古残骸、圆石、沙子、木材制成木炭等)为精炼锭和物品。
- 需要启用 AutoMine 并拥有权限
minecubes.autosmelt。
- 🧲 存储模式(手动挖掘重定向):
- 启用后,在方块内部进行手动挖掘时,掉落物将直接存入生成器的存储中,而不是玩家背包。
- 🛑 全自动存储保护:
- 当存储空间达到 100% 满时,自动禁用 AutoMine 和存储模式,以防止战利品丢失。
- 向所有者发送清晰的通知和声音警告。
- 🔒 严格的归属权保护:
- 只有放置方块的玩家(或拥有
minecubes.admin 权限的服务器管理员)可以打开设置 GUI、切换 AutoMine/存储模式/自动熔炼、打开存储或拾取它。
- 非所有者将被锁定,并伴有视觉/音频反馈。
🕹️ 命令
| 命令 |
权限 |
描述 |
/mc 或 /minecube |
minecubes.use |
显示帮助菜单。 |
/mc list |
minecubes.use |
列出你放置的所有 MineCube 及其坐标。 |
/mc unplace [template/id] |
minecubes.unplace |
收回你的 MineCube 并返还物品。 |
/mc give <player> <template> [amount] |
minecubes.give |
向玩家发放一个关联的 MineCube 物品。 |
/mc template list |
minecubes.admin |
列出所有已创建的模板。 |
/mc template create <name> [size] [type] [regen] |
minecubes.admin |
创建新模板。 |
/mc template edit <name> |
minecubes.admin |
打开 GUI 方块和百分比编辑器。 |
/mc template linkitem <name> |
minecubes.admin |
将你手持的物品与模板关联。 |
/mc template setsize <name> <size> |
minecubes.admin |
设置模板尺寸(奇数且 $\ge 3$)。 |
/mc template setregen <name> <seconds> |
minecubes.admin |
设置再生间隔(秒)。 |
/mc template settype <name> <normal|protect> |
minecubes.admin |
设置生成器框架类型。 |
/mc template remove <name> |
minecubes.admin |
移除现有模板。 |
/mc reload |
minecubes.admin |
重新加载配置和模板。 |
别名: /mc, /minecubes, /minecube, /cg, /cubegen
🔐 权限
| 权限 |
默认值 |
描述 |
minecubes.* |
op |
授予对 MineCubes 所有功能的访问权限。 |
minecubes.use |
true |
允许使用基本命令(/mc, /mc list)。 |
minecubes.place |
true |
允许在世界中放置 MineCube 物品。 |
minecubes.unplace |
true |
允许收回你放置的 MineCube。 |
minecubes.storage |
op |
允许打开虚拟存储库并切换存储模式。 |
minecubes.automine |
op |
允许启用 AutoMine 自动化功能。 |
minecubes.autosmelt |
op |
允许在 AutoMine 期间启用自动熔炼。 |
minecubes.give |
op |
允许向玩家发放 MineCube 物品。 |
minecubes.admin |
op |
用于模板和管理的管理员权限。 |
(Legacy cubegen.* 权限节点也完全支持,以向后兼容)。
⚙️ 配置示例 (cubegens.yml)
templates:
default:
name: "Default MineCube"
size: 5
type: "protect"
regen: 10
blocks:
STONE: 70.0
COBBLESTONE: 20.0
COAL_ORE: 7.0
IRON_ORE: 3.0
diamond:
name: "Diamond MineCube"
size: 5
type: "protect"
regen: 8
blocks:
STONE: 50.0
DEEPSLATE: 30.0
DIAMOND_ORE: 15.0
DEEPSLATE_DIAMOND_ORE: 5.0
💬 社区与支持
加入我们的官方 Discord 社区以获取支持、更新和功能请求:
💡 起源与致谢
本插件的原始概念源自 m0hammad6335/CubeGen。它已被完全重构,为现代 Minecraft 和 Folia 引擎进行了现代化改造,并由 mmk1386 扩展了交互式 GUI 工具、AutoMine、自动熔炼、虚拟 54 格存储、智能放置机制以及攀爬梯子等功能。
☕ 支持与捐赠
如果你欣赏 MineCubes 并希望支持开发:
- NOWPayments (加密货币):
- Donofa (IR):
📄 许可证
本项目遵循 MIT License 许可。
MineCubes 🧊
MineCubes is a modern, high-performance Minecraft 3D cube generator plugin designed for Minecraft 1.17 through 1.21.x and modern server engines like Paper, DivineMC, Leaf, and Folia 26.2.
It allows server administrators and players to create, customize, place, and automate 3D cube generators with weighted block drop chances, virtual Double Chest storage, AutoMine automation, and integrated Auto Smelt.
✨ Features
- 🎲 Customizable Templates: Define custom cube generator templates in
cubegens.yml or via in-game commands with custom sizes ($3 \times 3$, $5 \times 5$, $7 \times 7$), regeneration intervals, and types (protect with a bedrock wireframe or normal).
- 🖥️ Interactive GUI Block Editor (
/mc template edit <name>):
- Intuitive 54-slot inventory editor.
- Drag and drop any blocks you want to generate (fully supports all blocks including modern 1.21 Tuff & Copper variants).
- Shift + Left Click on any block to set its spawn chance via chat.
- Live total percentage display with real-time validation (prevents saving if sum exceeds $100%$).
- One-click Auto-Balance button that mathematically scales chances to equal exactly $100%$.
- 🔗 Custom Item Linking:
- Hold any custom item (with custom models, lore, glowing effects, or NBT tags) and run
/mc template linkitem <name>.
- Deliver generators to players with
/mc give <player> <template> [amount].
- Placing the item in the world creates the generator; picking it up returns the exact linked item.
- 🌱 Smart Placement & Terrain Protection:
- Automatically detects solid ground beneath grass, tall flowers, ferns, or snow layers.
- Clears foliage upon placement so the generator rests directly on solid ground without hovering.
- Safely teleports the player outside the structure upon placement to prevent getting trapped.
- Sits strictly above ground level (
clickedSurface + 1); picking it up leaves the underlying terrain completely intact without creating trenches.
- 🧗 Climbable Corner Ladder:
- A built-in ladder attaches to the outer face of the bedrock corner pillar closest to the player.
- Runs from ground level all the way to the top of the bedrock frame, allowing easy climbing.
- Cleans up without physics drops when the generator is picked up.
- 📦 Virtual Double Chest Storage (54 Slots):
- Built-in live-synced virtual storage accessible via the management menu.
- Automatically deposits drops from AutoMine and manual mining in Storage Mode.
- Safely drops all stored items at the owner's feet if the generator is picked up.
- 🤖 AutoMine Automation:
- Automatically mines inner blocks one-by-one with realistic block break particles and sounds.
- Directly stores drops into the generator's 54-slot virtual inventory.
- 🔥 Auto Smelt:
- Directly smelts mined raw ores (Raw Iron, Raw Copper, Raw Gold, Ancient Debris, Cobblestone, Sand, Wood into Charcoal, etc.) into refined ingots and items before placing them into storage.
- Requires active AutoMine and permission
minecubes.autosmelt.
- 🧲 Storage Mode (Manual Mining Redirection):
- When enabled, manual mining inside the cube redirects drops directly into the generator's storage instead of player inventory.
- 🛑 Automatic Full Storage Protection:
- Automatically disables AutoMine and Storage Mode when the storage is 100% full to prevent loot loss.
- Sends a clear notification and sound warning to the owner.
- 🔒 Strict Owner Protection:
- Only the player who placed the cube (or server administrators with
minecubes.admin) can open the settings GUI, toggle AutoMine/Storage Mode/Auto Smelt, open the storage, or pick it up.
- Non-owners are locked out with visual/audio feedback.
🕹️ Commands
| Command |
Permission |
Description |
/mc or /minecube |
minecubes.use |
Displays the help menu. |
/mc list |
minecubes.use |
Lists all your placed MineCubes and their coordinates. |
/mc unplace [template/id] |
minecubes.unplace |
Picks up your MineCube and returns the item. |
/mc give <player> <template> [amount] |
minecubes.give |
Gives a linked MineCube item to a player. |
/mc template list |
minecubes.admin |
Lists all created templates. |
/mc template create <name> [size] [type] [regen] |
minecubes.admin |
Creates a new template. |
/mc template edit <name> |
minecubes.admin |
Opens the GUI block and percentage editor. |
/mc template linkitem <name> |
minecubes.admin |
Links your held item to the template. |
/mc template setsize <name> <size> |
minecubes.admin |
Sets the template size (odd number $\ge 3$). |
/mc template setregen <name> <seconds> |
minecubes.admin |
Sets the regeneration interval in seconds. |
/mc template settype <name> <normal|protect> |
minecubes.admin |
Sets the generator frame type. |
/mc template remove <name> |
minecubes.admin |
Removes an existing template. |
/mc reload |
minecubes.admin |
Reloads configurations and templates. |
Aliases: /mc, /minecubes, /minecube, /cg, /cubegen
🔐 Permissions
| Permission |
Default |
Description |
minecubes.* |
op |
Grants access to all MineCubes features. |
minecubes.use |
true |
Allows using basic commands (/mc, /mc list). |
minecubes.place |
true |
Allows placing a MineCube item in the world. |
minecubes.unplace |
true |
Allows picking up your placed MineCube. |
minecubes.storage |
op |
Allows opening the virtual Storage and toggling Storage Mode. |
minecubes.automine |
op |
Allows enabling AutoMine automation. |
minecubes.autosmelt |
op |
Allows enabling Auto Smelt during AutoMine. |
minecubes.give |
op |
Allows giving MineCube items to players. |
minecubes.admin |
op |
Administrative permission for templates and management. |
(Legacy cubegen.* permission nodes are also fully supported for backwards compatibility).
⚙️ Configuration Example (cubegens.yml)
templates:
default:
name: "Default MineCube"
size: 5
type: "protect"
regen: 10
blocks:
STONE: 70.0
COBBLESTONE: 20.0
COAL_ORE: 7.0
IRON_ORE: 3.0
diamond:
name: "Diamond MineCube"
size: 5
type: "protect"
regen: 8
blocks:
STONE: 50.0
DEEPSLATE: 30.0
DIAMOND_ORE: 15.0
DEEPSLATE_DIAMOND_ORE: 5.0
💬 Community & Support
Join our official Discord community for support, updates, and feature requests:
💡 Origin & Credits
The original concept of this plugin originated from m0hammad6335/CubeGen. It has been completely rebuilt, modernized for modern Minecraft and Folia engines, and expanded by mmk1386 with interactive GUI tools, AutoMine, Auto Smelt, virtual 54-slot storage, smart placement mechanics, and ladder climbing.
☕ Support & Donations
If you appreciate MineCubes and would like to support development:
- NOWPayments (Crypto):
- Donofa (IR):
📄 License
This project is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧