MythicShiPing 使用文档 - MMOItems 饰品强化系统

插件介绍

它不是“多几个饰品栏”这么简单

MythicShiPing 的核心不是展示栏位，而是一整套 MMOItems 饰品养成链路：装备、属性生效、强化、重铸、卷轴、幸运石、熔炼回收、套装联动，全部打通。

MythicShiPing 是一个面向 Paper 1.20.1 服务器的 MMOItems 饰品系统插件。玩家可以把指定的 MMOItems 饰品装备到独立饰品槽位中，插件会把这些饰品的数值属性和被动技能实时应用到玩家身上，并把强化、重铸和套装效果一起纳入计算。

从源码实现看，这个插件已经不是“半成品概念页”那种程度，而是完整可落地的养成模块：有 GUI 主界面、MySQL 持久化、进服自动加载、退服同步保存、世界禁用机制、PAPI 扩展、经济与点数消耗、材料校验以及后台管理命令。

说人话：玩家输入 /sp 打开饰品面板，装备饰品，消耗材料或点数去强化/重铸，不要的饰品还能熔掉返还点数，练满之后再吃套装和卷轴收益。

功能分析

1. 饰品装备层

独立槽位，不占原版护甲栏

插件内置 9 个饰品槽位，通过 GUI 字符位映射到界面。
每个槽位可以限制允许的 MMOItems 类型和具体物品 ID。
装备后会读取饰品上的数值属性和被动技能，直接注册到 MythicLib/MMOItems 的玩家属性系统。

2. 属性控制层

装备生效，但可以按世界失效

支持白名单、黑名单和完全关闭三种物品过滤模式。
支持 Soulbound 检测，绑定给别人的物品不能乱用。
可以设置禁用世界，玩家进入这些世界时饰品属性会被移除，离开后重新生效。

3. 养成层

强化、重铸、卷轴、幸运石、熔炼全部联动

强化支持成功率、分段金币消耗、材料或强化点消耗、失败降级/不变/销毁。
重铸支持按属性条目随机重洗数值，并记录重铸次数。
卷轴可以直接设定等级或追加等级。
幸运石是永久成功率加成，直接存数据库，不怕重登丢失。
熔炼会销毁饰品，但返还强化点和重铸点。

4. 运营层

不是单机插件，考虑了长期服运营

玩家数据和槽位数据都保存到 MySQL，支持多服共库。
提供管理员命令给玩家发点数、重置槽位、查询佩戴情况。
自带 PlaceholderAPI 扩展，可以拿去做计分板、菜单和个人面板。

主要功能

9 个独立饰品槽位，可分别限制物品类型与指定 ID。
属性与被动技能实时生效，直接对接 MythicLib / MMOItems 数值体系。
强化系统，支持 1~100 级、永久成功率加成、分段金币消耗和失败惩罚。
重铸系统，可对指定属性随机洗数值，并保留重铸记录。
物品兑换点数，支持把 MMOItems 材料兑换成强化点或重铸点。
熔炼回收，销毁饰品返还养成资源，避免废品完全报废。
套装效果，按佩戴件数和最低强化等级触发额外属性。
卷轴系统，可以直接升到指定等级或追加若干级。
幸运石系统，右键直接使用，永久提高强化成功率。
世界禁用机制，大厅和 PVP 世界可以关闭饰品属性效果。
MySQL 持久化，玩家上线异步加载，下线同步保存。
PlaceholderAPI 扩展，可读取点数、强化统计、槽位等级、套装状态等信息。

命令列表

主命令：/shiping，别名：/sp

命令	说明	权限
`/sp`	打开饰品主面板	`mythicshiping.use`
`/sp exchange`	打开物品兑换点数界面	`mythicshiping.use`
`/sp salvage`	打开饰品熔炼界面	`mythicshiping.use`
`/sp help`	显示帮助信息	`mythicshiping.use`
`/sp reload`	重载配置文件	`mythicshiping.admin`
`/sp give <玩家> <enhancepoint\|reforgepoint> <数量>`	给玩家发强化点或重铸点	`mythicshiping.admin`
`/sp reset <玩家> [槽位]`	重置玩家全部饰品数据或单个槽位	`mythicshiping.admin`
`/sp info <玩家>`	查看玩家当前装备和点数信息	`mythicshiping.admin`

玩家在 GUI 里还能直接操作：左键空槽装备，右键已装备饰品卸下，Shift 点击背包饰品会自动寻找可用槽位。

权限节点

权限	说明	默认
`mythicshiping.use`	基础使用权限，允许打开和使用饰品系统	所有玩家
`mythicshiping.admin`	管理员权限，允许重载、发点数、查询和重置数据	OP
`mythicshiping.enhance.bypass`	强化时绕过材料、点数和金币消耗	手动授权
`mythicshiping.reforge.bypass`	重铸时绕过材料、点数和金币消耗	手动授权
`mythicshiping.salvage.bypass`	熔炼时绕过 Vault / PlayerPoints 消耗	手动授权

PlaceholderAPI 占位符

如果服务器安装了 PlaceholderAPI，插件会自动注册标识符 shiping。

占位符	说明
`%shiping_enhance_points%`	当前强化点
`%shiping_reforge_points%`	当前重铸点
`%shiping_enhance_total%`	强化总次数
`%shiping_enhance_success%`	强化成功次数
`%shiping_enhance_rate%`	强化成功率
`%shiping_reforge_total%`	重铸总次数
`%shiping_permanent_bonus%`	永久强化成功率加成
`%shiping_total_enhance_level%`	全身强化总等级
`%shiping_equipped_count%`	当前已装备饰品数量
`%shiping_slot_level_槽位ID%`	指定槽位强化等级
`%shiping_slot_reforge_槽位ID%`	指定槽位重铸次数
`%shiping_slot_item_槽位ID%`	指定槽位物品名称
`%shiping_set_active_套装Key%`	某个套装效果是否已激活

使用教程

安装依赖

先确保服务端安装 MythicLib 和 MMOItems。如果要启用经济、蓝宝石和占位符，再额外安装 Vault、PlayerPoints、PlaceholderAPI。

配置数据库

编辑 plugins/MythicShiPing/config.yml 中的 database 节点，填好 MySQL 信息。首次启动会自动建表。

定义饰品规则

在 accessory.slots 里配置每个槽位允许的 MMOItems 类型和 ID，同时设置禁用世界、物品过滤规则。

配置养成材料

把强化石、重铸石、卷轴、幸运石等 MMOItems 物品 ID 写进配置。兑换界面也依赖你在这里定义的物品。

进服测试

执行 /sp 打开主面板，给自己发点数，测试装备、强化、重铸和熔炼流程是否都符合你的服玩法。

配置结构

插件的核心配置文件位于 plugins/MythicShiPing/config.yml，同时还有 gui.yml 和 messages.yml 用于界面和提示文本。

数据库配置

YAMLconfig.yml

database:
  host: "localhost"
  port: 3306
  database: "mythicshiping"
  username: "root"
  password: "your_password"
  table-prefix: "mythicshiping_"
  pool-size: 15
  minimum-idle: 2
  connection-timeout: 5000

物品过滤与世界限制

YAMLconfig.yml

accessory:
  item-filter:
    mode: WHITELIST
    types:
      - ACCESSORY
    specific-items: []

  disabled-worlds:
    - "world_pvp"
    - "world_lobby"

配置里有真实数据库信息

当前插件目录里的示例配置已经写了数据库地址、用户名和密码。你上线正式环境前最好自行更换，别把测试密码当生产密码用。

饰品槽位

默认配置里定义了 9 个槽位，每个槽位都可以限制可放入的饰品 ID，并且在 GUI 中有独立图标和说明。

槽位 ID	定位	默认用途倾向
`core`	核心槽	攻击 / 技能 / 魔法伤害类
`cloak`	披风槽	PVE / 物理减伤类
`bracelet`	手镯槽	魔法 / 投射物减伤类
`gauntlet`	手套槽	火焰 / 摔落减伤类
`necklace`	项链槽	格挡强度 / 格挡几率类
`ring`	戒指槽	闪避几率 / 闪避冷却类
`badge`	徽章槽	招架几率 / 招架冷却类
`emblem`	纹章槽	生命上限 / PVP 减伤类
`war_ring`	战环槽	暴击 / 技能暴击类

这部分设计说明了插件的目标用户基本是 RPG / 副本成长服，而不是纯生存服。因为默认槽位已经按战斗数值体系拆得很细。

养成系统

强化

强化支持最高 100 级，成功率按目标等级读取配置，可叠加玩家的永久幸运加成。每次强化还能按等级段扣除 Vault 金币，失败行为支持 NOTHING、DOWNGRADE、DESTROY 三种模式。

YAMLconfig.yml

accessory:
  enhance:
    max-level: 100
    fail-action: DOWNGRADE
    cost-points-per-level: 1
    cost-item:
      type: CONSUMABLE
      id: ENHANCE_STONE

重铸

重铸不是“随机整件重做”，而是从允许重铸的属性列表里选一个具体词条重洗。新数值按原值乘以随机倍率生成，默认范围是 0.5x 到 1.5x，所以很适合拿来做毕业追求。

兑换与熔炼

兑换系统可以把指定 MMOItems 材料换成强化点或重铸点。熔炼系统则会销毁饰品，并根据强化等级和重铸次数返还点数，同时额外消耗 Vault 和 PlayerPoints 资源。

卷轴与幸运石

卷轴是 GUI 内对已装备饰品使用的等级道具，支持直接设定等级或增加等级。幸运石则是右键直接消耗的永久型道具，会把强化成功率加成写入玩家数据里。

套装效果

套装判定按“满足条件的装备件数”计算，可以要求最少强化等级，也可以进一步限制指定 MMOItems 类型。只要条件达成，插件就会额外注册整套属性加成。

依赖插件与版本

组件	是否必须	说明
Paper 1.20.1	必须	开发目标服务端版本
Java 17+	必须	Maven 配置明确使用 Java 17
MythicLib	必须	属性与被动技能应用依赖
MMOItems	必须	饰品物品来源与数值读取依赖
MySQL 5.7+	必须	玩家与饰品数据持久化
PlaceholderAPI	可选	启用 `%shiping_...%` 占位符
Vault	可选	强化、重铸、熔炼中的金币消耗
PlayerPoints	可选	熔炼中的点券消耗
ItemsAdder	可选	GUI 标题贴图偏移效果

技术信息

项目	信息
插件名称	MythicShiPing
版本	1.0
服务端	Paper 1.20.1
Java 版本	17+
API 版本	1.20
数据库连接池	HikariCP 5.0.1
MythicLib	1.7.1-SNAPSHOT
MMOItems API	6.10.1-SNAPSHOT
PlaceholderAPI	2.11.6
VaultAPI	1.7
数据表	`accessories` + `player_data` 两张核心表

常见问题

最适合 RPG 养成服、PVE 副本服、装备成长服。纯净生存也能上，但会显得有点重。

能用一部分。插件把它们做成软依赖，但只要你的配置启用了对应消耗，没有装插件就会导致该功能不可用。

是永久加成，而且会保存到数据库。玩家下线、重连、换服后仍然保留。

大概率不是。源码里明确支持 disabled-worlds，进入禁用世界后会主动移除饰品属性，离开才恢复。

正常情况下不会。插件上线时异步加载，下线时同步保存，还会在服务器关闭时把在线玩家的数据补存一遍。

如果你想做 MMOItems 体系里的“饰品终局养成”，MythicShiPing 这套功能是够用的，重点已经不是有没有功能，而是你准备把数值膨胀到什么程度。

MythicShiPing ¥388

插件介绍

它不是“多几个饰品栏”这么简单

功能分析

1. 饰品装备层

独立槽位，不占原版护甲栏

2. 属性控制层

装备生效，但可以按世界失效

3. 养成层

强化、重铸、卷轴、幸运石、熔炼全部联动

4. 运营层

不是单机插件，考虑了长期服运营

主要功能

命令列表

权限节点

PlaceholderAPI 占位符

使用教程

安装依赖

配置数据库

定义饰品规则

配置养成材料

进服测试

推荐开服流程

PVE 成长服

副本材料循环

配置结构

数据库配置

物品过滤与世界限制

配置里有真实数据库信息

饰品槽位

养成系统

强化

重铸

兑换与熔炼

卷轴与幸运石

套装效果

依赖插件与版本

技术信息

常见问题