简介(短描述字段)
类 Skyblock 风格的自动矿工 —— 喂食它们,链接箱子,在商店中购买,并在游戏内完全创建全新的矿工类型。
描述(项目正文)
Minions
放置一个小工人,保持它的饱食度,让你致富。 Minions 是小型、无敌的盔甲架工人,它们会放置并挖掘自己的资源区域,将掉落物投入链接的箱子或它们的内部存储中。当你离开时,它们会继续工作——但它们需要 能量 驱动,所以必须有人(你,或者一个 Feeder 矿工)来给它们“喂食”。
功能
能量
每个矿工都有一个能量池,当能量耗尽时会停止工作。可以通过以下方式补充:
- 右键点击食物 —— 熟牛肉、苹果、面包(完全可配置,任何物品都可以作为食物)
- Feeder 矿工 —— 从其链接的箱子中为半径内的所有饥饿矿工喂食
- 金钱 —— 矿工菜单中的一个按钮可通过你的经济系统为其充电(默认按比例分配)
浮动名称标签显示颜色编码的闪电标志:? 高于一半,? 低于一半,? 空。仅在你实际看向矿工时才会显示名称标签(可切换)。
Feeder 矿工
一种支持型矿工,用于自动化喂食循环:将其链接到装满食物的箱子,它会让范围内所有矿工保持饱食状态,优先喂最饿的。你维护 Feeder 矿工,Feeder 矿工维护矿工们。
箱子链接
直接从矿工的菜单中将任何矿工链接到附近的箱子 —— 点击现有箱子 或直接放置一个。矿工将产出存入那里(内部存储作为后备);Feeder 矿工从中获取食物。从同一菜单取消链接并旋转矿工。
⬆ 等级
每种矿工有三个等级(可在配置中添加更多)。升级需要金钱,并提高能量容量、挖掘区域大小(3×3 → 5×5 → 7×7)、速度和存储容量。Feeder 矿工则扩大其喂食半径。
商店
/minion shop —— 一个 GUI,玩家可以用金钱购买矿工。每种类型有独立价格,可从游戏内编辑器实时编辑。
为 Skyblock 设计的限制
- 按玩家分类别限制(矿工 / Feeder),可通过权限覆盖每个等级的上限 (
minion.limit.miner.5, .unlimited)
- SuperiorSkyblock2 集成:每个岛屿的最大矿工数量
- 在非岛屿服务器上,基于半径的区域限制作为后备方案,加上每个区块的限制
在游戏内创建矿工类型
/minion admin → Minion Types 打开完整的类型构建器:选择头部(任何方块都可以 —— 或者使用玩家头颅以显示其皮肤)、输出物品、工作方块、工具、速度、数量、类别和商店价格。保存后即时生效 —— 无需重启,无需编辑配置文件。已放置的现有矿工会立即更换外观。
重新排列菜单本身
/minion admin → GUI Layouts 打开插件菜单的拖放布局编辑器:移动按钮,绘制灰色/黑色填充玻璃,添加/删除行,重命名标题。存储在 guis.yml 中。
模块
将 熔炉(自动烧炼)或 活塞(压缩器,9→1 个方块)放入矿工的模块槽位中。
⚙ 配置
一切皆可调。config.yml 分为九个文档化的部分(能量、食物、价格、等级、限制、音效、粒子效果、每种类型的覆盖设置如自定义能量成本和禁用标志)。messages.yml 将所有面向玩家的字符串外部化,支持 & 和十六进制颜色代码 —— 完全可翻译。常用设置也可在 /minion admin 中实时编辑。
命令
| 命令 |
描述 |
/minion give <player> <type> [level] |
给予可放置的矿工物品 (管理员) |
/minion list |
列出你放置的矿工及其能量状态 |
/minion info |
插件信息和你拥有的矿工数量 |
/minion shop |
用金钱购买矿工 |
/minion admin |
实时设置、类型构建器、商店价格、GUI 布局编辑器 (管理员) |
/minion reload |
重新加载所有配置文件 (管理员) |
权限
| 权限 |
默认值 |
授予 |
minion.use |
所有人 |
放置、打开、喂食、升级、拾取自己的矿工 |
minion.shop |
所有人 |
使用 /minion shop |
minion.admin |
op |
所有功能,包括任意矿工和所有编辑器 |
minion.limit.<miner|feeder>.<n> |
— |
提升某个等级的放置上限(最高者胜出;.unlimited 移除限制) |
需求与兼容性
- Paper 1.21+(基于 1.21.x API 构建,对 TPS 友好 —— 生产环境无方块更新,仅一个轻量级调度器任务)
- 可选: Vault + 任何经济系统(例如 EssentialsX)—— 启用商店、金钱充值和金钱升级。如果没有它,这些功能将优雅地禁用,其他一切正常工作。
- 可选: SuperiorSkyblock2 —— 启用按岛屿限制。如果没有它,将使用基于半径的限制。
将 jar 文件放入 plugins/,重启,完成 —— 所有配置文件自动生成。
Summary (short description field)
Skyblock-style minions that mine for you — feed them, chest-link them, buy them in a shop, and build brand-new minion types entirely in game.
Description (project body)
Minions
Place a little worker, keep it fed, get rich. Minions are small, invulnerable armor-stand workers that place and mine their own resource field, dropping everything into a linked chest or their internal storage. They keep working while you're away — but they run on energy, so somebody (you, or a Feeder minion) has to keep them fed.
Features
Energy
Every minion has an energy pool and stops working when it hits zero. Refill it by:
- Right-clicking with food — cooked beef, apples, bread (fully configurable, any item can be a food)
- A Feeder minion — feeds every hungry minion in its radius from its own linked chest
- Money — one button in the minion's menu recharges it via your economy (prorated by default)
The floating nametag shows a color-coded bolt: ? above half, ? below half, ? empty. Nametags only appear while you're actually looking at the minion (toggleable).
Feeder minions
A support minion that automates the feeding loop: link it to a chest full of food and it keeps every minion in range topped up, hungriest first. You maintain the feeders, the feeders maintain the miners.
Chest linking
Link any minion to a nearby chest straight from its menu — click an existing chest or just place one down. Miners deposit their output there (internal storage as fallback); feeders pull food from it. Unlink and rotate the minion from the same menu.
⬆ Levels
Three levels per minion (add more in config). Upgrades cost money and raise energy capacity, mining field size (3×3 → 5×5 → 7×7), speed, and storage. Feeders grow their feeding radius instead.
Shop
/minion shop — a GUI where players buy minions with money. Prices per type, editable live from an in-game editor.
Limits built for Skyblock
- Per-player caps per category (miners / feeders), overridable per rank via permissions (
minion.limit.miner.5, .unlimited)
- SuperiorSkyblock2 integration: max minions per island
- Radius-based area cap as fallback on non-island servers, plus a per-chunk cap
Create minion types in game
/minion admin → Minion Types opens a full type builder: pick the head (any block works — or a player head for its skin), the output item, work block, tool, speed, amount, category, and shop price. Save and it's live instantly — no restart, no config editing. Existing placed minions re-skin on the spot.
Rearrange the menus themselves
/minion admin → GUI Layouts opens a drag-and-drop layout editor for the plugin's menus: move buttons, paint gray/black filler glass, add/remove rows, rename titles. Stored in guis.yml.
Modules
Drop a Furnace (Auto-Smelt) or Piston (Compactor, 9→1 blocks) into a miner's module slots.
⚙ Configuration
Everything is a knob. config.yml is organized into nine documented sections (energy, foods, prices, levels, limits, sounds, particles, per-type overrides like custom energy costs and disable flags). messages.yml externalizes every player-facing string with & and hex color support — fully translatable. Common settings are also editable live in /minion admin.
Commands
| Command |
Description |
/minion give <player> <type> [level] |
Give a placeable minion item (admin) |
/minion list |
List your placed minions with energy state |
/minion info |
Plugin info and your minion counts |
/minion shop |
Buy minions with money |
/minion admin |
Live settings, type builder, shop prices, GUI layout editor (admin) |
/minion reload |
Reload all config files (admin) |
Permissions
| Permission |
Default |
Grants |
minion.use |
everyone |
Place, open, feed, upgrade, pick up your own minions |
minion.shop |
everyone |
Use /minion shop |
minion.admin |
op |
Everything, including any minion and all editors |
minion.limit.<miner|feeder>.<n> |
— |
Raise a rank's placement cap (highest wins; .unlimited removes it) |
Requirements & compatibility
- Paper 1.21+ (built against 1.21.x API, TPS-friendly — no block updates on production, one lightweight scheduler task)
- Optional: Vault + any economy (e.g. EssentialsX) — enables the shop, money refills, and money upgrades. Without it, those features disable gracefully and everything else works.
- Optional: SuperiorSkyblock2 — enables per-island limits. Without it, a radius-based cap takes over.
Drop the jar in plugins/, restart, done — all config files generate themselves.
评论 0
登录后参与评分
还没有评论,来抢沙发吧