配置说明
LyGalaxyForge 的配置文件位于插件数据目录中:
config.yml:主配置,负责数据库、分类菜单、货币显示、条件符号、权限加速、保存与检测间隔、GUI 默认项及异步锻造设置。forge/:锻造图纸目录,存放锻造图纸 YAML 文件。entry/:词条方法目录,存放词条方法和表达式预设 YAML 文件。gui/:界面配置目录,存放锻造界面布局 YAML 文件。
配置文件
| 文件或目录 | 用途 |
|---|---|
config.yml | 配置数据库、分类菜单、货币显示、条件符号、权限加速、保存间隔、图纸检测、GUI 默认项和异步锻造。 |
forge/*.yml | 锻造图纸。 |
entry/*.yml | 词条方法和表达式预设。 |
gui/*.yml | 锻造界面布局。 |
修改配置后,应根据修改内容重载插件或重启服务器。涉及数据库连接、数据结构或插件初始化的配置,建议直接重启服务器确认配置已生效。
数据库
MySQL 前置要求
只要启用 MySQL 存储,就必须安装 LyMySQLCore,并确认 LyMySQLCore 已成功连接数据库。插件未加载、数据库连接失败或连接未完成时,LyGalaxyForge 的 MySQL 数据读取、保存、同步及相关记录不会生效。
mysql.enable 控制是否启用 MySQL 存储。
| 配置项 | 说明 |
|---|---|
mysql.enable | 是否启用 MySQL 存储。 |
mysql.databasename | 数据库名称。 |
mysql.username | 数据库账号。 |
mysql.password | 数据库密码。 |
mysql.ip | 数据库地址。 |
mysql.port | 数据库端口。 |
启用或关闭 MySQL 存储后,建议重启服务器。启用 MySQL 后,必须同时检查 LyMySQLCore 的加载状态和数据库连接状态。
分类菜单
forge-menu 用于配置锻造分类菜单。每个分类对应一个分类 ID,列表中的值必须是已存在的图纸 ID。
yaml
forge-menu:
test:
- "测试图纸"上面的配置会将图纸 ID 测试图纸 放入分类 test。玩家可使用 /lgf menu test 打开该分类菜单。
| 配置项 | 说明 |
|---|---|
forge-menu | 分类菜单配置。 |
forge-menu.<分类ID> | 分类 ID,同时用于菜单命令参数。 |
forge-menu.<分类ID>[] | 该分类包含的图纸 ID 列表。 |
货币显示
currency 用于配置锻造按钮上显示的货币需求类型。
| 货币 ID 格式 | 说明 |
|---|---|
eco | Vault 金币。 |
point | PlayerPoints 点券。 |
lyshop@货币ID | LyShopReload 货币,货币ID 替换为对应货币 ID。 |
cx@变量ID | CX 变量货币,变量ID 替换为对应变量 ID。 |
货币显示文本支持以下占位符:
| 占位符 | 说明 |
|---|---|
{need_currency} | 所需货币数量。 |
{current_currency} | 玩家当前拥有的货币数量。 |
{status} | 当前货币条件状态。 |
条件符号
条件符号用于显示图纸条件、货币条件、材料条件等是否满足。
| 配置项 | 说明 |
|---|---|
condition-true-text | 条件满足时显示的文本或符号。 |
condition-false-text | 条件不满足时显示的文本或符号。 |
权限加速
permission-upspeed 用于根据玩家权限减少锻造制作时间。每个条目包含权限节点、时间公式和加速提示。
yaml
permission-upspeed:
- permission: "vip.1"
time-formula: "{time}*0.9"
forge-message: "&a制作时间减少10%"| 配置项 | 说明 |
|---|---|
permission-upspeed | 权限加速规则列表。 |
permission-upspeed[].permission | 玩家拥有该权限时应用当前规则。 |
permission-upspeed[].time-formula | 新制作时间公式。{time} 表示原始制作时间。 |
permission-upspeed[].forge-message | 应用加速时显示的提示文本。 |
forge-message 支持以下占位符:
| 占位符 | 说明 |
|---|---|
{old_time} | 应用加速前的制作时间。 |
{new_time} | 应用加速后的制作时间。 |
保存与检测间隔
| 配置项 | 说明 |
|---|---|
auto-save-interval | 自动保存间隔,单位为秒。 |
draw-unlock-check-interval-seconds | 图纸自动解锁条件检测间隔,单位为秒。 |
draw-unlock-interact-cooldown-ms | 图纸交互冷却时间,单位为毫秒,用于防止频繁点击。 |
GUI 设置
以下配置项用于设置分类菜单、制作队列和通用界面物品。
| 配置项 | 说明 |
|---|---|
gui.menu-title | 分类菜单标题。 |
gui.making-title | 制作队列标题。 |
gui.menu-use-first-success-item | 是否让分类菜单使用第一个成功产物作为菜单图标。 |
gui.show-lore-sort | 成功产物展示时使用的全局 Lore 排版设置。 |
gui.fill-item | GUI 空白位置使用的填充物品。 |
gui.last-item | 上一页按钮物品。 |
gui.next-item | 下一页按钮物品。 |
gui.making-item | 打开制作队列的按钮物品。 |
异步锻造
forge.async-try-forge-enable 控制 ForgeGui 按钮触发的 tryForge 是否异步执行。
| 配置项 | 说明 |
|---|---|
forge.async-try-forge-enable | 是否异步执行 ForgeGui 按钮触发的 tryForge。默认关闭。 |
普通服务器建议保持默认关闭状态。只有在确认材料、货币和物品库相关调用适合异步执行时,才建议开启此选项。