iPlugin | 主配置

主配置位于 plugins/Invero/config.yml，修改后完整重启服务端。菜单窗口与图标字段写在各自的菜单文件中，见配置字段索引。

常用设置

下表按插件生成的 config.yml 说明默认设置；已有配置保留自己的取值。数据库连接和导出服务参数分别见下文。

字段	类型	必填	默认行为	说明
`Kether.auto-placeholder-translate`	布尔值	否	`true`	启用文本处理与 Invero 消息扩展
`Workspaces.file-listener`	布尔值	否	`true`	保存菜单文件时自动重载
`Workspaces.paths`	文字列表	否	`plugins/Invero/workspace`	菜单目录，可填写多项
`Workspaces.filter`	文字	否	加载支持的配置扩展名，忽略以 `#` 或 `!` 开头的文件	文件名正则表达式，见下文
`GlobalNodes.enabled`	布尔值	否	`true`	启用全局节点
`GlobalNodes.paths`	文字列表	否	`plugins/Invero/global-nodes`	全局节点目录，可填写多项
`GlobalNodes.filter`	文字	否	使用随附的文件名筛选规则	全局节点文件名正则表达式，独立于菜单规则
`GlobalNodes.priority`	文字	否	`menu-first`	同名节点的查找顺序
`Menu.virtual-by-default`	布尔值	否	`false`	菜单未填写 `virtual` 时的窗口模式
`Menu.enable-raw-title-in-vanilla-inventory`	布尔值	否	`false`	普通窗口的原始标题处理开关
`Database.type`	文字	否	`SQLITE`	存储方式：`SQLITE` 或 `SQL`
`Paste.service-type`	文字	否	`lucko`	导出服务：`lucko`、`pastegg` 或 `pastebin`

工作空间与文件筛选

Workspaces:
  file-listener: true
  filter: '^(?![#!]).*\.(?i)(conf|hocon|yaml|yml|toml|json)$'
  paths:
    - 'plugins/Invero/workspace'

paths 中的路径相对服务端运行目录，菜单目录可以包含子目录。filter 是文件名正则表达式；默认加载上述扩展名，忽略以 # 或 ! 开头的文件。

只加载 YAML 菜单时可以改成：

Workspaces:
  filter: '^(?![#!]).*\.(?i)(yaml|yml)$'

修改筛选规则不会转换文件内容。文件名、菜单 ID 与重载操作见文件目录。

全局节点

GlobalNodes:
  enabled: true
  paths:
    - 'plugins/Invero/global-nodes'
  filter: '^(?![#!]).*\.(?i)(conf|hocon|yaml|yml|toml|json)$'
  priority: menu-first

GlobalNodes.filter 只影响全局节点文件，与 Workspaces.filter 分开设置。全局节点文件放在 GlobalNodes.paths 指定的目录中。

`priority`	查找顺序
`menu-first`	先找当前菜单的节点，再找全局节点
`global-first`	先找全局节点，再找当前菜单的节点

节点的配置与调用见节点。保存节点文件后执行 /invero gnode reload；修改这些主配置项则重启服务端。

文本与窗口默认值

Kether:
  auto-placeholder-translate: true
Menu:
  virtual-by-default: false
  enable-raw-title-in-vanilla-inventory: false

fmsg、mmsg 等消息扩展使用 auto-placeholder-translate。单个菜单里的 virtual 优先于 virtual-by-default；实际物品存取使用普通窗口，见窗口设置。

Menu.default-name-color 与 Menu.default-lore-color 不生效；名称与 Lore 的颜色在显示文字里使用颜色代码。Patch.enable-raw-title-in-vanilla-inventory 是旧配置位置，不控制当前标题开关；使用 Menu.enable-raw-title-in-vanilla-inventory。

数据库

SQLite

Database:
  type: SQLITE

默认数据保存在 plugins/Invero/data/invero_data.db，不需要填写 sql 连接信息。保存与读取玩家设置见持久数据。

SQL

使用已有 MySQL 数据库与账户时，配置连接信息：

Database:
  type: SQL
  sql:
    host: '127.0.0.1'
    port: 3306
    user: 'invero_user'
    password: '替换为数据库密码'
    database: 'minecraft'
    table: 'invero_data'

以下字段写在 Database.sql 中。连接信息必须与实际数据库一致，默认示例值不代表已建立可用连接。

字段	类型	必填	默认行为	说明
`host`	文字	启用 `SQL` 时填写	`localhost`	数据库主机地址，不含 `jdbc:mysql://`
`port`	整数	否	`3306`	数据库端口
`user`	文字	启用 `SQL` 时填写	`root`	数据库账户名；字段名是 `user`
`password`	文字	启用 `SQL` 时填写	`root`	该账户的实际密码
`database`	文字	启用 `SQL` 时填写	`test`	已创建的数据库名
`table`	文字	启用 `SQL` 时填写	随附配置为 `invero_data`	Invero 保存数据的表名

Database.type 使用 SQLITE 或 SQL；不提供 MONGODB 的配置用法。更换存储类型、数据库或表名不会自动迁移原有数据。调整前保存原数据，完整重启后检查后台数据库连接结果。

内容导出服务

menu dump、item encode 会将导出内容上传到所选服务。

`service-type`	对应配置
`lucko`	`Paste.services.lucko.base-url`
`pastegg`	`Paste.services.pastegg.base-url`
`pastebin`	`Paste.services.pastebin.base-url` 与 `dev-key`

使用默认 lucko 服务：

Paste:
  service-type: lucko
  services:
    lucko:
      base-url: 'https://api.pastes.dev'

服务参数写在 Paste.services.<服务名> 中，只读取 service-type 选中的服务。下表列出默认 API 地址，不提供开发者密钥：

字段	类型	必填	默认行为	说明
`lucko.base-url`	文字	选择 `lucko` 时需要	`https://api.pastes.dev`	lucko API 地址
`pastegg.base-url`	文字	选择 `pastegg` 时需要	`https://api.paste.gg/v1`	pastegg API 地址
`pastebin.base-url`	文字	选择 `pastebin` 时需要	`https://pastebin.com/api/api_post.php`	Pastebin API 地址
`pastebin.dev-key`	文字	选择 `pastebin` 时填写	—	自己的 Pastebin 开发者密钥

另外两种配置：

Paste:
  service-type: pastegg
  services:
    pastegg:
      base-url: 'https://api.paste.gg/v1'

base-url 是服务的 API 地址，而不是浏览器里某一份粘贴内容的地址。修改所选服务时，填写相同服务名下的配置；其他服务的设置不会替它提供地址或密钥。导出前移除配置与物品内容中的密码、密钥和玩家私密数据。

主配置

常用设置复制章节链接

工作空间与文件筛选复制章节链接

全局节点复制章节链接

文本与窗口默认值复制章节链接

数据库复制章节链接

SQLite复制章节链接

SQL复制章节链接

内容导出服务复制章节链接

本页目录