- 版权类型
- 原创
- 插件中文名称
- 魔符文系统
- 插件英文名称
- MoRuneSocketing
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 26.x
- 1.21
MoRuneSocketing
附魔符文 / Buff符文 / GUI镶嵌 / 拆卸返还 / 成功率系统
不只是给装备添加一条 Lore，而是一套可配置、可限制、可收费的装备成长系统。
适用于：生存服 / RPG服 / 副本服 / 养成服 / 综合服 / Folia服务器 / 多子服网络
附魔符文 / Buff符文 / GUI镶嵌 / 拆卸返还 / 成功率系统
不只是给装备添加一条 Lore，而是一套可配置、可限制、可收费的装备成长系统。
适用于：生存服 / RPG服 / 副本服 / 养成服 / 综合服 / Folia服务器 / 多子服网络
插件简介
MoRuneSocketing 是一款面向 Minecraft 1.21.1+ 服务端设计的符文镶嵌插件。玩家可以通过 GUI 将附魔符文或 Buff 符文镶嵌到武器、工具、防具等装备中，服主则可以控制符文外观、适用装备、成功率、经济费用、消耗规则、Buff 上限与拆卸返还概率。
插件内置 FoliaLib 调度适配，支持 Paper、Folia、Spigot、Purpur 及常见 Paper 分支。1.0.9 版本新增 Custom-Fishing 物品提供器兼容，可直接把任意符文和符文拆卸粉加入钓鱼战利品。
- 通过 GUI 完成装备与符文镶嵌，降低玩家学习成本
- 附魔符文可升级原版附魔，也支持命名空间格式的第三方附魔
- Buff 符文可在主手、副手和防具槽持续提供属性效果
- 支持固定成功率、随机成功率和定时刷新
- 支持 Vault、PlayerPoints、GemsEconomy、RedisEconomy、PEconomy
- 支持符文拆卸粉，可配置符文返还概率
- 支持全局装备限制与单个符文装备限制
- 支持 CustomModelData、菜单布局、语言和音效配置
- 支持 SQLite / MySQL，并提供多服数据同步相关能力
- 支持 Custom-Fishing 钓取符文与拆卸粉
核心亮点
| 模块 | 说明 | 适合场景 |
|---|---|---|
| GUI 镶嵌 | 玩家把装备和符文放入指定槽位，点击确认按钮完成操作 | 生存服、RPG服、装备养成 |
| 附魔符文 | 增加或升级装备附魔，可配置最高等级和适用装备 | 武器强化、工具成长、防具升级 |
| Buff 符文 | 装备后持续提供幸运、速度、力量、生命提升、恢复、抗火等效果 | 职业装备、套装养成、属性构筑 |
| 成功率系统 | 支持固定成功率、随机区间和定时刷新，可控制失败消耗 | 强化玩法、活动概率、经济回收 |
| 经济收费 | 镶嵌可收取金币或点券，并可选择只在成功后扣费 | 服务器经济消耗、强化手续费 |
| 拆卸系统 | 使用符文拆卸粉移除 Buff 符文，可配置返还概率 | 装备洗练、流派更换、材料回收 |
| 装备限制 | 全局 socketable-items 与符文 runes-items 双层控制 | 职业限制、武器专属符文、平衡控制 |
| Custom-Fishing | 把真实可用的符文和拆卸粉加入钓鱼战利品 | 钓鱼服、材料获取、活动奖励 |
| 多核心支持 | 内置 FoliaLib，自动适配不同服务端调度方式 | Paper、Folia、Purpur 等服务端 |
1.0.9 更新重点
- 新增 Custom-Fishing 官方 ItemProvider 扩展接口兼容
- 支持钓取 runes.yml 中任意符文
- 支持钓取符文拆卸粉
- 钓鱼物品保留名称、Lore、CustomModelData 和符文持久化数据
- 统一符文与拆卸粉物品创建逻辑，避免第三方生成物品失效
- 为拆卸粉增加持久化识别标记，提高兼容稳定性
- Custom-Fishing 为可选依赖，未安装时不影响插件启动
代码：
MoRuneSocketing:rune/<符文ID>
MoRuneSocketing:<符文ID>
MoRuneSocketing:remover玩家如何使用
镶嵌符文：
- 准备一件允许镶嵌的装备和对应符文
- 输入 /mrs menu 打开镶嵌菜单
- 将装备放入装备槽
- 将符文放入符文槽
- 点击确认按钮
- 插件按照成功率、费用和消耗规则处理镶嵌
- 输入 /mrs menu 打开菜单
- 将拥有 Buff 符文的装备放入装备槽
- 将符文拆卸粉放入符文槽
- 点击确认按钮
- 插件移除 Buff，并按照 return-chance 判断是否返还符文
- 装备是否符合 config.yml 中的 socketable-items
- 装备是否符合该符文的 runes-items
- require-enchantment-for-rune 是否要求装备已有对应附魔
- 附魔等级是否已经达到 max-level
- 第三方附魔是否正确注册到服务端
符文类型与配置
附魔符文示例：
代码：
sharpness:
name: "§6锋利符文"
material: "PAPER"
custom-model-data: 0
lore:
- "§7镶嵌效果: §f增加装备锋利等级"
- "§7最高等级: §f10级"
enchantment: "DAMAGE_ALL"
max-level: 10
runes-items:
- "*_SWORD"
- "*_AXE"
代码：
strength1:
name: "§c力量符文"
material: "PAPER"
custom-model-data: 0
lore:
- "§7镶嵌效果: §f给玩家添加力量BUFF"
- "§7BUFF等级: §f1级"
buff: "custom_strength"
buff-level: 1
runes-items:
- "*_SWORD"| 字段 | 说明 |
|---|---|
| 符文顶层节点 | 符文 ID，例如 sharpness、strength1 |
| name | 物品显示名称，支持颜色代码 |
| material | 符文基础材质 |
| custom-model-data | 资源包自定义模型数据，0 表示不设置 |
| lore | 符文说明文字 |
| enchantment | 附魔 ID，支持 命名空间:附魔ID |
| max-level | 附魔符文允许提升到的最高等级 |
| buff | Buff 类型标识 |
| buff-level | Buff 等级 |
| runes-items | 当前符文允许使用的装备列表，支持通配符 |
成功率与经济系统
固定与随机成功率：
代码：
features:
consume-rune: true
consume-rune-on-fail: true
success-rate: 100
random-success-rate:
enabled: false
min-rate: 50
max-rate: 100
refresh-interval: "1h"- 随机成功率关闭时使用 success-rate
- 随机成功率开启后，在 min-rate 与 max-rate 之间生成当前成功率
- 刷新间隔支持 s、m、h、d，最低 60 秒
- consume-rune 控制成功时是否消耗符文
- consume-rune-on-fail 控制失败时是否消耗符文
代码：
socketing:
cooldown: 0.5
economy:
enabled: false
cost: 1000
deduct-on-success-only: false
provider: ""
代码：
Vault → PlayerPoints → GemsEconomy → RedisEconomy → PEconomy符文拆卸粉
代码：
rune-remover:
item: "SUGAR"
name: "§b符文拆卸粉"
custom-model-data: 0
lore:
- "§7功能: §e拆卸已镶嵌BUFF符文的装备上的符文"
- "§7效果: §a将符文从装备上拆下，装备不损坏"
return-chance: 100- item：拆卸粉基础材质
- name：显示名称
- custom-model-data：资源包模型数据
- lore：物品介绍
- return-chance：拆卸后返还每个 Buff 符文的概率，建议设置为 0-100
Custom-Fishing 兼容教程
本兼容由 MoRuneSocketing 单边完成，不需要修改 Custom-Fishing 源码。
第一步：开启兼容
代码：
integrations:
custom-fishing:
enabled: true
代码：
CustomFishing integration enabled: MoRuneSocketing
代码：
sharpness_rune_reward:
material: MoRuneSocketing:rune/sharpness
show-in-fishfinder: false
disable-stat: true
disable-game: true
rune_remover_reward:
material: MoRuneSocketing:remover
show-in-fishfinder: false
disable-stat: true
disable-game: true按照 Custom-Fishing 原有配置方法，将 sharpness_rune_reward 或 rune_remover_reward 加入需要的钓鱼战利品组，并在 Custom-Fishing 中控制权重、概率、区域、群系和其他条件。
建议：不要在 Custom-Fishing 中覆盖奖励物品的名称、Lore 或模型数据，应让 MoRuneSocketing 根据当前符文配置生成完整物品。
菜单与 Buff 检查
menu-config.yml 可修改：
- 菜单标题、行数和布局字符
- 装备槽、符文槽、确认按钮、返回按钮和边框
- 按钮材质、名称、Lore 与 CustomModelData
- 打开菜单、镶嵌成功、镶嵌失败和返回音效
- 菜单提示消息
- %success_rate% 与 %refresh_time% 的显示格式
代码：
buff-check:
check-period-ticks: 100
check-main-hand: true
check-off-hand: true
check-helmet: true
check-chestplate: true
check-leggings: true
check-boots: true
renew-threshold-ticks: 200
nbt-cache-enabled: true
nbt-cache-size: 10000安装说明
| 项目 | 要求 |
|---|---|
| Minecraft | 1.21.1 或更高版本 |
| Java | Java 21 或更高版本 |
| Paper | 支持 |
| Folia | 支持 |
| Spigot | 支持 |
| Purpur / Paper 分支 | 支持 |
- 下载 MoRuneSocketing-1.0.9-Release.jar
- 将文件放入服务器 plugins 目录
- 确认服务器使用 Java 21+
- 启动服务器并等待配置自动生成
- 修改 config.yml、runes.yml、menu-config.yml 或语言文件
- 普通配置可执行 /mrs reload；安装、更新或修改兼容关系后建议完整重启
代码：
plugins/MoRuneSocketing/
├─ config.yml
├─ runes.yml
├─ menu-config.yml
└─ lang/
├─ zh_CN.yml
└─ en_US.yml依赖与兼容
| 插件 | 是否必需 | 用途 |
|---|---|---|
| Vault | 可选 | Vault 经济接口 |
| PlayerPoints | 可选 | 点券经济 |
| GemsEconomy | 可选 | 宝石经济 |
| RedisEconomy | 可选 | Redis 跨服经济 |
| PEconomy | 可选 | PEconomy 经济支持 |
| Custom-Fishing | 可选 | 钓取符文和拆卸粉 |
常用命令
| 命令 | 说明 | 权限 |
|---|---|---|
| /mrs | 显示帮助 | 无额外权限 |
| /mrs help | 显示帮助 | 无额外权限 |
| /mrs menu | 打开镶嵌菜单 | 当前命令处理器未强制检查权限 |
| /mrs analyze | 分析手中物品的附魔命名空间和 ID | 无额外权限 |
| /mrs give <玩家> <符文ID> [数量] | 给予符文 | morunesocketing.admin |
| /mrs giveremover <玩家> [数量] | 给予拆卸粉 | morunesocketing.admin |
| /mrs reload | 重载配置和相关系统 | morunesocketing.admin |
| /mrs setrate <成功率> | 设置当前随机成功率 | morunesocketing.admin |
| /mrs setinterval <时间> | 设置随机成功率刷新间隔 | morunesocketing.admin |
代码：
/mrs setinterval 60s
/mrs setinterval 30m
/mrs setinterval 2h
/mrs setinterval 1d常用权限
| 权限 | 默认值 | 说明 |
|---|---|---|
| morunesocketing.use | 所有玩家 | 基础使用权限节点 |
| morunesocketing.open | 所有玩家 | 菜单相关权限节点 |
| morunesocketing.admin | OP | 给予、重载、成功率管理等命令 |
数据库说明
默认关闭数据库，可选择 SQLite 或 MySQL：
代码：
database:
enabled: false
type: "sqlite"
代码：
database:
enabled: true
type: "mysql"
mysql:
host: "localhost"
port: 3306
database: "morunesocketing"
username: "root"
password: "password"
pool:
min-connections: 2
max-connections: 10
connection-timeout: 30000注意：当前默认配置的部分同步字段与代码读取键名存在差异。正式启用跨服同步前，请先在测试服验证，不建议未经测试直接用于生产环境。
适合使用的人群
- 你希望服务器拥有装备强化和材料消耗玩法
- 你需要附魔升级与 Buff 属性构筑
- 你希望不同符文只能用于指定武器或防具
- 你希望强化系统接入金币、点券或其他经济
- 你希望使用成功率、失败消耗和定时概率活动
- 你需要 Paper、Folia 或 Purpur 兼容
- 你希望通过钓鱼产出符文和拆卸材料
- 你愿意根据服务器玩法调整 yml 配置
- 你只需要用命令直接给装备添加附魔
- 你不需要 GUI、成功率、经济或装备限制
- 你不愿意维护符文和菜单配置文件
- 你的服务器仍运行 Minecraft 1.20.x 或 Java 17
更新注意事项
- 升级前建议备份 plugins/MoRuneSocketing 目录
- 1.0.9 新增 integrations.custom-fishing.enabled 配置
- Custom-Fishing 兼容需要完整重启，不建议使用 PlugMan 热插拔
- Custom-Fishing 中的符文 ID 必须与 runes.yml 顶层节点一致
- 不要在 Custom-Fishing 中覆盖符文名称、Lore 或模型数据
- 随机成功率管理命令需要先开启 random-success-rate.enabled
- 多子服使用 Buff 时，每个相关子服都需要安装本插件
- 数据库同步正式上线前请先在测试服验证
MoRuneSocketing
让符文成为装备成长、材料循环和服务器经济的一部分。
让符文成为装备成长、材料循环和服务器经济的一部分。
