- 支持核心
- Spigot / Paper 及其分支
- 原创/转载
- 原创插件
- 作者
- Alignment
- 前置
- ArcartX
- 支持版本
- 1.18.1 ~ 26.1.2
ArcartXAutoReload
改了 ArcartX 配置?不用再手动敲命令 —— 保存即生效
改了 ArcartX 配置?不用再手动敲命令 —— 保存即生效
一句话介绍
极轻量的 Spigot / Paper 服务端插件:监听 ArcartX 配置目录,文件一保存就自动执行重载命令。体积 约 13 KB、无依赖,兼容范围与 ArcartX 服务端插件对齐(Spigot / Paper 及分支,MC 1.18.1~26.1.2)。
它解决什么问题
ArcartX 的配置散落在 plugins/ArcartX/ 下:setting.yml、ui/、item_effect/、player_host/、model_link/ …… 开发期每天改几十次:
- 每次改完都要切控制台敲一遍重载命令
- 多人协作时不知道谁改了、有没有生效
- 重载参数记混(arcartx reload 与 arcartx reload true 效果不同)
- 忘了通知客户端,以为配置没生效
把「监听 → 防抖 → 重载」全自动化,保存文件就等于执行了一次标准重载。
功能特性
- 递归监听:WatchService 事件驱动监听整个 plugins/ArcartX 目录树,后建的子目录自动纳入
- 智能防抖(默认 2 秒):编辑器保存、FTP 同步、批量替换产生的连续写入合并成一次重载
- 冷却防循环(默认 5 秒):防止「重载 → 写回配置 → 再重载」死循环,且不丢改动
- 精确过滤:只认 yml / yaml / json / toml,database.db 等运行时文件永不触发;支持 ignore-paths 通配符
- 主线程执行:监听线程只做纯文件系统工作,命令回主线程执行,与手敲完全一致
- 管理命令:/axr status | toggle | reload | now(权限 axr.admin)
- 零配置开箱即用:默认监听 plugins/ArcartX、默认执行 arcartx reload true
安装
- 把 jar 放进服务端 plugins/
- 启动服务器(已开服可用 /reload confirm 热加载)
- 完成,首次启动生成 plugins/ArcartXAutoReload/config.yml
前置要求:服务端已安装 ArcartX 插件。支持 Spigot / Paper 及其分支(与 ArcartX 一致);不支持 Folia、Sponge 与 1.13 以下的旧版 CraftBukkit。
配置
代码:
enabled: true # 总开关
watch-dir: "plugins/ArcartX" # 监听目录(相对服务端根目录 / 绝对路径)
reload-command: "arcartx reload true" # true = 同时通知客户端热重载资源
debounce-ms: 2000 # 防抖:最后一次变化后静默该时长才触发
cooldown-ms: 5000 # 冷却:重载后忽略该时长内的变化,防死循环
watch-extensions: [yml, yaml, json, toml]
ignore-paths: [] # glob 忽略,如 scripts/**
verbose-logging: true
常用调整
- 只重载服务端、不惊动客户端 → reload-command: "arcartx reload"
- 想立刻生效 → debounce-ms: 500
- 一次改一堆文件 → debounce-ms: 4000
- 临时停用 → /axr toggle
命令与权限
- /axr status — 查看状态、监听目录、最近触发文件
- /axr toggle — 暂停 / 恢复自动重载
- /axr reload — 重读本插件配置并重启监听
- /axr now — 立即执行一次重载命令
权限节点:axr.admin(默认仅 OP)
兼容性与实测
本插件与 ArcartX 使用同一兼容基线,实际可用范围 = ArcartX 服务端插件的支持范围。
- 服务端核心:Spigot / Paper 及其分支(Purpur 等)—— 与 ArcartX 官方口径一致
- 不支持:Folia(ArcartX 未声明 Folia 支持)、Sponge
- Minecraft 版本:跟随 ArcartX 清单 —— 1.18.1、1.18.2、1.19~1.19.4、1.20.1、1.20.2、1.20.4、1.21.1、1.21.3、1.21.4、1.21.11、26.1、26.1.2
- api-version:1.18(与 ArcartX 2.10.100 一致)
- 前置:ArcartX(softdepend 保证加载顺序)
- 字节码:Java 17(向上兼容更高 JVM);1.18~1.20 需 Java 17+,1.21 需 Java 21+,26.x 需 Java 25+
实测:Spigot 1.18.2
常见问题
Q:改了配置没触发?
检查:文件是否真保存(部分编辑器先写临时文件)、扩展名是否在白名单、是否被 ignore-paths 排除、是否处于冷却期、是否执行过 /axr toggle。用 /axr status 查看最近触发记录。
Q:为什么重载了两次?
防抖只合并「同一波写盘」。改完 A 文件隔几秒又改 B 文件属于两次独立修改,重载两次是正确行为。
Q:影响性能吗?
不会。WatchService 是操作系统文件事件通知,不轮询扫描;线程空闲时仅 250ms 阻塞等待,内存占用 < 1 MB。
Q:能监听其他插件吗?
可以,把 watch-dir 与 reload-command 改成对应插件的目录和命令即可(需自行确认该插件重载幂等)。
更新日志
v1.0.0 首个版本:递归监听、防抖、冷却、扩展名白名单、/axr 管理命令、可配置重载命令;兼容范围与 ArcartX 对齐(api-version 1.18、softdepend、Spigot/Paper 及分支、MC 1.18.1~26.1.2);编译基线 Paper-API 1.18.2 + Java 17 字节码;实测 Spigot 1.18.2 / Paper 1.18.2 / Purpur 1.18.2 / Paper 1.21.1 / Paper 26.2
许可
作者:Alignment
允许在整合包 / 服务器免费使用;允许转载,保留作者与原始链接;二次修改请注明来源;禁止盗卖或声称原创。
遇到问题请附:服务端版本、ArcartX 版本、config.yml 内容、/axr status 输出、相关日志片段。