(AI辅助)ArcartXAutoReload—— ArcartX 配置自动重载

免费 (AI辅助)ArcartXAutoReload—— ArcartX 配置自动重载 1.0.0

没有购买权限 (100.00 金锭)
支持核心
Spigot / Paper 及其分支
原创/转载
原创插件
作者
Alignment
前置
ArcartX
支持版本
1.18.1 ~ 26.1.2
ArcartXAutoReload
改了 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 效果不同)
  • 忘了通知客户端,以为配置没生效

把「监听 → 防抖 → 重载」全自动化,保存文件就等于执行了一次标准重载。



功能特性

  1. 递归监听:WatchService 事件驱动监听整个 plugins/ArcartX 目录树,后建的子目录自动纳入
  2. 智能防抖(默认 2 秒):编辑器保存、FTP 同步、批量替换产生的连续写入合并成一次重载
  3. 冷却防循环(默认 5 秒):防止「重载 → 写回配置 → 再重载」死循环,且不丢改动
  4. 精确过滤:只认 yml / yaml / json / toml,database.db 等运行时文件永不触发;支持 ignore-paths 通配符
  5. 主线程执行:监听线程只做纯文件系统工作,命令回主线程执行,与手敲完全一致
  6. 管理命令:/axr status | toggle | reload | now(权限 axr.admin)
  7. 零配置开箱即用:默认监听 plugins/ArcartX、默认执行 arcartx reload true



安装

  1. 把 jar 放进服务端 plugins/
  2. 启动服务器(已开服可用 /reload confirm 热加载)
  3. 完成,首次启动生成 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+

26.2 官方标注「即将支持」:本插件技术层面已可加载(实测通过),但 ArcartX 自身尚未支持,暂无实际效果。

实测:Spigot 1.18.2 ✅ Paper 1.18.2(388)✅ Purpur 1.18.2(1632)✅ Paper 1.21.1 ✅ Paper 26.2(135)✅



常见问题

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 输出、相关日志片段。
  • 5c5219b6-35d4-4026-8b90-b37e425e8634.webp
    5c5219b6-35d4-4026-8b90-b37e425e8634.webp
    59 KB · 查看: 5
  • 02-console-autoreload.webp
    02-console-autoreload.webp
    153.3 KB · 查看: 6
作者
Alignment
价格
100.00 金锭
下载
1
查看
21
首次发布
最后更新

评分

0.00 星 0 星

来自 Alignment 的更多资源

分享此资源

后退
顶部