安装与配置

运行环境

要求	最低版本
Java	8+
服务端	Bukkit / Spigot / Paper 1.12+
前置插件	TabooLib 6.3.0

安装步骤

1. 前往 GitHub Releases 下载最新版本的 jar 文件
2. 将 jar 文件放入服务器的 plugins/ 目录
3. 启动或重启服务器

首次启动后，插件会自动生成以下目录和文件：

plugins/Monoceros/
  config.yml          # 主配置文件
  lang/               # 语言文件
  dispatcher/         # 事件分发器定义
  schedule/           # 调度任务定义
  wireshark/          # 数据包规则定义
  workflow/action/    # 动作工作流定义
  command/            # 命令定义

主配置文件

config.yml 的默认内容如下：

resource-version: 1
debug: false
script:
  watcher-throttle-ms: 500
wireshark:
  allow-intercept: false
  allow-rewrite: false

配置项	类型	默认值	说明
resource-version	int	1	配置文件版本号，请勿手动修改
debug	boolean	false	是否开启调试模式
script.watcher-throttle-ms	int	500	文件监视器的节流间隔（毫秒）
wireshark.allow-intercept	boolean	false	是否允许拦截数据包
wireshark.allow-rewrite	boolean	false	是否允许改写数据包

热重载

你可以通过 /mono reload 命令热重载配置，无需重启服务器。

Monoceros 内置了文件监视器，使用 SHA-256 校验检测文件变更。当脚本文件发生修改时，插件会在节流间隔（默认 500ms）后自动重新加载。你可以通过 config.yml 中的 script.watcher-throttle-ms 调整这个间隔。