插件介绍

这不是一个工具,这是一个工具车队

MythicTools 不是“单个自动机”,而是一整套可放置、可升级、可持久化的自动化功能方块体系。

MythicTools 是一款面向 Paper 1.20.1 服务器的模块化神话道具插件。玩家通过放置不同的头颅道具,在地图中部署自动化工具;工具使用各自的燃料体系运作,产出统一进入玩家的全局仓库,后续的熔炼、合成和仓库终端也围绕这套仓库继续工作。

从源码来看,插件当前实际注册的是 12 种 工具类型,而不是传统“单插件单功能”的设计。除了常见的挖掘、收割、钓鱼、熔炼、合成外,还带共享仓库、批量补能、仓库清理、管理员发放 GUI、自动合成禁用配方管理等配套能力。

说人话:给玩家几个工具头,摆下去,喂燃料,产出自动进同一个仓库;仓库里的材料又能被熔炼核心和自动合成台继续消耗,最后用终端统一提货。

核心架构

全局仓库串联生产线

产出型工具把物品直接打进同一个玩家仓库,熔炼核心和自动合成台再从仓库里吃材料,终端负责统一查看、提取和整理。

道具绑定 + 能量燃料

工具以玩家头颅形式发放,可预绑定或首次放置自动绑定;大部分工具都有独立燃料表、最大能量和分级参数。

MySQL 持久化 + 子服隔离

工具实例、玩家统计、全局仓库统一落库;已放置工具通过 server-id 区分所在子服,适合 Velocity 多服环境。

GUI + 全息 + 安全回收

右键打开控制界面查看进度、仓库和燃料;可接入 DecentHolograms 显示状态;被水冲、活塞推、爆炸或回收时会尽量返还给主人。

当前源码的实际功能口径

官网文档建议以源码为准:当前注册了 sharedstorage 共享仓库机,仓库 GUI 也带批量补能和原版装备清理能力,这些都属于插件真实可见功能。

工具列表

工具类型 ID功能说明关键细节
空置域挖掘机excavator自动向上或向下挖掘支持圆形 / 正方形切换,向上挖掘额外耗能,跳过容器和头颅
万象收割机harvester自动收割成熟作物并补种范围、单次收割数、能量消耗均按等级配置
虚空磁石voidmagnet吸附附近掉落物和经验球经验会累计并按 7 点转换为经验瓶存入仓库
深渊熔炼核心smeltcore自动熔炼全局仓库中的可烧炼物品从仓库取料,熔炼后产物重新回仓
自动合成台autocrafter按已选配方自动合成从仓库取材料,支持配方选择、按产物禁用、按命名空间过滤
灵魂牧笼soulcage捕获附近生物并转为刷怪蛋有捕获半径、工作间隔、单次捕获量和最大存储上限
神话林场treefarm自动种树、催熟、砍伐树木支持树苗类型配置和阶段状态显示
深海渔场fisher自动在水域钓鱼可产出鱼、宝藏和垃圾,宝藏概率按等级配置
怪物研磨器mobgrinder持续攻击范围内怪物按等级配置伤害和半径,适合刷怪塔清怪
远程收集器remotecollect抽取附近容器中的物品按工作次数整批搬运容器内容到全局仓库
仓库终端storageterminal直接打开自己的全局仓库无需能量,适合作为提货点和仓库入口
仓库共享机sharedstorage授权其他玩家访问你的仓库主人可在 GUI 中添加 / 移除共享成员,被授权玩家可直接开仓

主要功能

  • 12 种可放置工具 —— 不是单机玩法,而是一整套围绕仓库系统运转的自动化模块
  • 全局仓库联动 —— 挖掘、收割、磁吸、钓鱼、抓怪、收集器产出统一入仓,熔炼和合成继续从仓库吃料
  • 玩家头颅道具 —— 工具以头颅物品发放,支持绑定玩家、记录等级、能量和额外数据
  • GUI 管理界面 —— 右键工具即可查看工作进度、能量、仓库信息、启停状态和可用燃料
  • 按工具分文件配置 —— 每个工具都有独立 tools/*.yml,可单独调半径、工作频率、燃料和等级参数
  • 自动合成配方管理 —— 管理员可在 GUI 中禁用某类合成产物,也能按命名空间控制可见配方
  • 共享仓库权限模型 —— 默认仅主人和管理员可管理,sharedstorage 可以对指定成员开放访问
  • 多服持久化 —— 工具实例、玩家统计和仓库数据落 MySQL,已放置工具按 server-id 绑定子服
  • 全息状态显示 —— 装了 DecentHolograms 后可在机器上方显示能量、产量、范围和状态信息
  • 领地保护接入 —— 检测到 Residence 时,会按工具工作半径阻止跨他人领地放置
  • 安全回收机制 —— 水流、活塞、爆炸等情况会尽量把工具返还给主人,而不是白白蒸发
  • 仓库运维功能 —— 支持翻页、整页清空、从仓库批量给全部机器补能,以及清理原版普通剑和原版盔甲

命令列表

主命令:/mt(别名:/mythictools/mtools

命令说明权限
/mt give <玩家> <类型> <等级> [数量]给予指定玩家 MythicTools 道具mythictools.admin
/mt reload重载主配置、消息、工具配置与配方缓存mythictools.admin
/mt list [玩家]查看所有已放置工具,或查看某个玩家的工具mythictools.admin
/mt remove <玩家|all>移除指定玩家的工具,或清空全服已放置工具mythictools.admin
/mt energy <玩家> <数量>直接设置某玩家所有已放置工具的能量mythictools.admin
/mt tools打开管理员工具发放 GUImythictools.admin
/mt autocrafter disable打开自动合成可禁用配方列表mythictools.admin
/mt autocrafter enable查看并恢复已禁用的自动合成产物mythictools.admin
/mt purgestorage swords清理所有玩家全局仓库中的原版普通剑mythictools.admin

输入 /mt 不带参数时会显示帮助。管理员常用流程一般是 givetoolsreload 这三类。

权限与访问

权限 / 机制说明默认
mythictools.admin管理命令、越权查看 / 回收 / 访问他人工具与仓库OP
mythictools.use插件基础使用节点,已在 plugin.yml 中声明所有人
mythictools.use.<tool>按工具细分的使用节点,适合配合权限插件做玩家分层所有人
所有者绑定工具可预绑定玩家;未绑定工具首次放置后会自动绑定当前玩家强制生效
共享仓库名单sharedstorage 的主人可授权在线玩家访问自己的仓库主人可管理

从当前源码来看,最明确生效的访问控制是 mythictools.admin、所有者绑定和共享仓库白名单。实际服内分权时,建议再配合 LuckPerms 等权限插件发放对应节点。

使用教程

安装插件并首次启动

MythicTools.jar 放进 plugins 文件夹。首次启动后会生成 config.ymltools/*.yml

配置 MySQL 与子服标识

编辑 config.ymldatabaseserver-id。数据库需要提前建库,表由插件自动创建。

调整每种工具参数

plugins/MythicTools/tools/ 修改对应 yml,决定每台工具的最大放置数、燃料、半径、间隔和等级强度。

重载配置

/mt reload —— 修改完配置后重载,自动合成的配方缓存也会一起刷新。

给玩家发工具

/mt give 玩家名 excavator 1,或者直接用 /mt tools 打开发放 GUI。

玩家摆机器、喂燃料、开仓库

玩家放置后右键管理机器。生产型工具会往全局仓库送货,仓库终端和共享仓库机负责提货与访问分发。

最常见的一条流水线

资源获取端

harvestertreefarmfishervoidmagnetremotecollect 负责收货,把东西全塞进同一个全局仓库。

加工与取货端

smeltcoreautocrafter 从仓库继续加工;storageterminalsharedstorage 负责打开、管理和分发访问权。

主配置

主配置文件位于 plugins/MythicTools/config.yml,负责数据库、消息文本、GUI 文案、自动合成过滤规则等公共行为。

数据库与子服设置

YAMLconfig.yml
server-id: 'survival'

database:
  host: 127.0.0.1
  port: 3306
  database: mythictools
  username: mythictools
  password: 'your-password'
  pool:
    maximum-pool-size: 10
    minimum-idle: 2
    max-lifetime: 1800000
    connection-timeout: 5000
    idle-timeout: 600000
  auto-save-interval: 30

自动合成配方来源过滤

YAMLconfig.yml
autocrafter:
  show-external-recipes: false
  allowed-namespaces:
    - minecraft
  blocked-namespaces: []

server-id 首次启动可自动生成;多服部署时建议手动改成易识别名字,例如 survivalresourcefarm

工具配置

每种工具都有单独的配置文件,统一放在 plugins/MythicTools/tools/。结构大体类似:最大放置数、头颅贴图、燃料表、分级参数。

典型工具配置示例

YAMLtools/excavator.yml
max-per-player: 5

fuels:
  DIAMOND: 100
  DIAMOND_BLOCK: 900
  EMERALD_BLOCK: 500

up-energy-multiplier: 2.0

tiers:
  1:
    radius: 30
    max-energy: 5000
    energy-per-work: 10
  2:
    radius: 50
    max-energy: 10000
    energy-per-work: 15

自动合成禁用列表

YAMLtools/autocrafter.yml
disabled-results:
  - TNT
  - HOPPER

disabled-recipe-keys:
  - minecraft:tnt
  - minecraft:hopper

无需燃料的终端类工具

YAMLtools/sharedstorage.yml
max-per-player: 5
skull-texture: 'base64...'
fuels: {}

storageterminalsharedstorage 这种终端类工具,不参与生产流程,所以不需要能量和燃料配置。

仓库系统

这是整个插件的中枢

如果把 MythicTools 看成工厂,那全局仓库就是传送带、原料堆、成品仓和操作台的结合体。大部分功能最终都在围着它转。

  • 玩家级共享仓库 —— 同一名玩家放的所有工具共用同一个仓库,不是一机一箱子
  • 多页浏览与整仓提取 —— 仓库 GUI 支持分页、整页查看、一键全部取出
  • 整页清理 —— 管理者可以清空当前页显示的物品,仓库会自动重新整理排序
  • 批量补能 —— 从仓库里扣燃料,给当前玩家所有已放置、可补能的机器统一补电
  • 原版装备清理 —— 可以移除仓库中的原版剑和原版盔甲,避免垃圾装备把仓库塞满
  • 共享访问 —— 通过 sharedstorage 把仓库读权限授权给其他在线玩家

典型仓库流转

产出型工具

挖掘机、收割机、磁石、林场、渔场、牧笼、收集器负责把资源直接打入仓库,省掉箱子和漏斗链。

消费型工具

熔炼核心和自动合成台从仓库取原料继续加工,仓库终端和共享仓库机则负责打开、管理和分发访问权。

依赖插件与版本

项目是否必须说明
Paper 1.20.1必须插件基于 Paper API 开发
Java 17+必须Maven 构建与运行环境均基于 Java 17
MySQL 5.7+必须工具实例、玩家仓库、统计信息全部依赖 MySQL 持久化
DecentHolograms可选提供机器上方的全息显示,不装也能运行
Residence可选启用后会在放置时检查工作范围是否侵入他人领地

技术信息

项目信息
插件名称MythicTools
版本1.0
服务端Paper 1.20.1
Java 版本17+
API 版本1.20
数据库MySQL 5.7+(HikariCP 5.1.0 连接池)
MySQL 驱动mysql-connector-j 8.0.33
已注册工具类型12 种:含 storageterminalsharedstorage
数据库表mt_toolsmt_player_statsmt_player_storage
持久化内容工具实例、主人信息、坐标、能量、额外数据、玩家仓库、玩家统计

常见问题

因为当前源码实际注册了 sharedstorage 这个共享仓库机,所以按代码口径是 12 种。官网文档建议按源码算,不按旧版 README 算。
不能。工具如果已经绑定到某个玩家,只允许绑定者自己放置;未绑定的工具会在首次放置时自动绑定当前玩家。
插件会优先把工具返还给主人背包;背包满了就掉在地上。总之不是那种“啪一下没了你自己想办法”的实现。
先检查 config.yml 里的命名空间过滤,再检查 tools/autocrafter.ymldisabled-resultsdisabled-recipe-keys。管理员也可能在游戏内把某类产物禁用了。
主人右键 sharedstorage 后会进入管理 GUI,可以添加或移除在线玩家。被授权的玩家再次右键该机器,就能打开主人的全局仓库。
能。没有 DecentHolograms 只是没有全息;没有 Residence 只是不会做领地范围校验,插件核心功能照常运行。

如果你看到这里,说明你不是在找一个“单机自动钓鱼器”,而是在找一套能串联经济、仓库和自动化生产线的系统。那 MythicTools 确实更对味。