[MD]
# EquipMod 装备改造插件 使用说明(v1.3.0)
武器装备改造系统的 Paper 1.21.1 插件。构建产物:`target/EquipMod-1.3.0.jar`。
## 玩法概览
```
放入装备 → 消耗 金币 + 固定材料 → 随机重铸词条(预览)→ 确认保留 / 放弃
↑ 可锁定部分词条(锁定越多消耗倍率越高)
↑ 开始改造即按概率随机升级一条词条,并有保底兜底
```
- 词条 = 装备上的附加属性(攻击力、生命、护甲、攻速、移速、亡灵/节肢/远程增伤、破甲、伤害减免等),**实际生效**
- 词条条数默认 4 条;重铸时**已锁定的词条类型/数值/等级保持不变**,未锁定的随机重生成
- **开始改造(扣费成功)即结算**:改造次数 +1、保底 +1、随机升级判定——**不管之后确认还是放弃都计数**
## 改造等级(1~10)
config 里 `level-mode` 切换两种模式:
### CATEGORY(默认)
- 按**武器/护甲**两大类,每名玩家**每类存 4 个槽位等级**(词条#1~#4),同类别物品共享
- 例:玩家武器等级为 `[7,7,8,8]`,改造**任何一把新武器**,4 个词条槽就按 `7,7,8,8` 生成
- 升级时推进**对应槽位**的等级,新物品继承;剑/镐/斧/三叉戟/锤/弓等之间互换进度不丢
- 等级存 `plugins/EquipMod/data.yml`
### ITEM
- 每件物品单独计算词条等级。升级只从**当前等级最低**的词条里随机选一条 +1(如 [4,5,4,4] 只升那 3 条 4 级的),已锁定的不参与升级
## 升级与保底
- **随机概率**(`levels.upgrade-chance`):每次开始改造时按概率随机升级一条词条,概率按当前等级递减(1级5% → 10级0.001%)
- **保底兜底**(`levels.pity`):概率没中则累计保底,达到保底次数**必定升级**。当前保底表:1级15 / 2级20 / 3级30 / 4级50 / 5级70 / 6~9级120 次
- GUI 改造按钮实时显示:`保底升级: X/120 (还差 N 次)`、`升级概率: 5%`、`改造次数`
- 每次扣费成功计数,放弃/关界面都算
## 消耗
```
金币 = (基础 money + 每级50 × 当前最高等级) × 锁定倍率
钻石 = material-amount × 锁定倍率 ← 不随等级变化
```
| 锁定词条 | 倍率 | 金币(基础500, Lv.1) | 钻石 |
|---|---|---|---|
| 0 | ×1 | 550 | 1 |
| 1 | ×2 | 1,100 | 2 |
| 2 | ×4 | 2,200 | 4 |
| 3 | ×16 | 8,800 | 16 |
- 每级额外金币 = `costs.per-level-money`(默认50)× 当前最高等级
- 材料为固定单一物品(`costs.material`,默认钻石),数量不随等级变化
## 词条与数值方案
### 数值类词条(攻击力/生命/护甲/护甲韧性/幸运/亡灵增伤/节肢增伤/远程增伤)
统一区间(直接加数值):
| 等级 | 范围 | 等级 | 范围 |
|---|---|---|---|
| 1 | 0.1 ~ 0.3 | 6 | 2.5 ~ 3.0 |
| 2 | 0.3 ~ 0.8 | 7 | 3.0 ~ 3.5 |
| 3 | 0.8 ~ 1.2 | 8 | 3.5 ~ 4.0 |
| 4 | 1.2 ~ 2.0 | 9 | 4.0 ~ 5.0 |
| 5 | 2.0 ~ 2.5 | 10 | 5.0 ~ 6.0 |
### 攻速(百分比,0.01 = 1%)
| 等级 | 范围 | 等级 | 范围 |
|---|---|---|---|
| 1 | 1% ~ 5% | 6 | 25% ~ 30% |
| 2 | 5% ~ 10% | 7 | 30% ~ 35% |
| 3 | 10% ~ 15% | 8 | 35% ~ 40% |
| 4 | 15% ~ 20% | 9 | 40% ~ 45% |
| 5 | 20% ~ 25% | 10 | 45% ~ 50% |
### 移速(百分比,0.01 = 1%)
| 等级 | 范围 | 等级 | 范围 |
|---|---|---|---|
| 1 | 0.1% ~ 1% | 6 | 5% ~ 6% |
| 2 | 1% ~ 2% | 7 | 6% ~ 7% |
| 3 | 2% ~ 3% | 8 | 7% ~ 8% |
| 4 | 3% ~ 4% | 9 | 8% ~ 9% |
| 5 | 4% ~ 5% | 10 | 9% ~ 10% |
### 破甲(百分比)
1级 0.1%~0.3% → 10级 8%~10%。**复刻原版「破甲(Breach)」附魔算法**:把目标护甲按破甲百分比降低后重算减伤;最终破甲 = 附魔破甲(每级15%)+ 改造破甲。**所有武器(剑/斧/重锤/三叉戟/弓/弩)都可刷出该词条,但只有手持重锤时生效**,其他武器上不生效。
### 战斗特效词条
| 词条 | 效果 |
|---|---|
| 亡灵增伤 | 命中亡灵(僵尸/骷髅/凋灵等)追加伤害 |
| 节肢增伤 | 命中节肢(蜘蛛/蠹虫等)追加伤害 |
| 远程增伤 | 用弓/弩/三叉戟远程命中追加伤害 |
| 破甲 | 全武器可刷出;手持重锤时按百分比破甲(与 Breach 附魔叠加),其他武器不生效 |
| 伤害减免 | 玩家受击时按穿戴护甲上的减伤词条降低所受伤害(百分比) |
### 伤害减免(百分比)
| 等级 | 减伤 | 等级 | 减伤 |
|---|---|---|---|
| 1 | 0.1%~0.5% | 6 | 2.1%~3.0% |
| 2 | 0.5%~1.0% | 7 | 2.5%~3.5% |
| 3 | 0.9%~1.5% | 8 | 2.9%~4.0% |
| 4 | 1.3%~2.0% | 9 | 3.3%~4.5% |
| 5 | 1.7%~2.5% | 10 | 3.7%~5.0% |
可多件护甲的减伤叠加,最高 100%。
## Lore 展示
- **物品原本的附魔、原 Lore 完全不动**,改造内容只追加在下方:
- 「词条」块:列出词条、等级(带配色:1-4蓝/5-6浅蓝/7-8紫/9-10金)、加成与**改造次数**
- 「装备时额外获得」块:列出所有词条加成(含战斗特效词条)
- 「当前总属性」块:显示**最终总属性**——只给物品**天然具有**的属性加基础默认值(头盔/护甲默认血量0、伤害0,绝不乱加);附魔伤害(锋利等)计入武器攻击伤害
```
(钻石剑 + 攻击力+1 词条后)
……
§8═══════ 词条 §8═══════
攻击力 [Lv.3] +1.20
改造次数: 5
§8══════════════════
§8═══════ 装备时额外获得 §8═══════
攻击伤害 +1.20
§8══════════════════
§8═══════ 当前总属性 §8═══════
8 攻击伤害 ← 基础7 + 改造1
1.6 攻击速度
§8══════════════════
```
## 关闭界面的处理
改造后没确认/没放弃直接关界面时(`gui.preview-on-close`):
- **ABANDON(默认)+ 二次确认**:第一次关闭提示并重开界面,再次关闭才真正放弃(防止误关白花材料);玩家可点右侧按钮决定
- **CONFIRM**:关闭时自动保留本次改造结果(材料不白花)
装备始终返还背包(满则掉落脚边),不会丢。
## 安装 / 构建
1. 把 `target/EquipMod-1.3.0.jar` 放进服务器 `plugins/`(先删掉旧版 EquipMod jar 防冲突)
2. 服务器需 **Paper 1.21.1**,且安装 Vault 兼容经济插件(如 EssentialsX / CMI)才能扣金币
3. 重启服务器(或 `/reload confirm`),看到 `装备改造 EquipMod 已启用` 即成功
4. 首次启动自动生成 `config.yml`、`lang/`、`data.yml`,可用 `/equipmod reload` 热重载
用 IDEA 重新构建:`Maven 面板 → clean → package`,产物在 `target/EquipMod-1.3.0.jar`。
## 命令 / 权限
| 命令 | 说明 | 权限 | 默认 |
|---|---|---|---|
| `/gaizao` | 打开装备改造界面 | `equipmod.use` | 所有玩家 |
| `/equipmod reload` | 重载配置 | `equipmod.admin` | OP |
## 界面说明
45 格箱子界面:
```
[改造] [装备] [预览] [确认] [放弃]
词条1 词条2 词条3 词条4 [词条图鉴]
```
- **装备槽**:左键放入要改造的装备;光标空再左键取回
- **改造**:消耗金币+材料,生成重铸结果到预览槽(预览底部有"不可拿走"提示)
- **确认保留**:把预览写回装备;**放弃**:丢弃结果保留原词条
- **词条槽**:点击锁定/解锁(最多 `max-locked-affixes` 条);未附加时 lore 显示该槽可刷出的词条
- **词条图鉴**(右侧书本):点击切换显示等级,按 **词条#1~#4 槽位**列出各槽可刷出的词条和 `[数值范围]`
- 改造按钮实时显示:金币(含每级加成明细)、材料、锁定倍率、改造次数、升级概率、保底进度
## 配置说明(config.yml)
```yaml
lang: "zh_cn" # 语言:zh_cn / en_us(消息文案在 lang/ 目录)
level-mode: CATEGORY # 改造等级:CATEGORY=按武器/护甲分类(玩家每类4槽位共享等级) / ITEM=每件物品单独算
gui:
title: "&8&l装备改造"
preview-on-close: ABANDON # 关界面=放弃(CONFIRM=自动保留)
close-confirm: true # 放弃前二次确认
costs:
money: 500 # 基础金币
per-level-money: 50 # 每级额外金币(按当前最高等级)
material: DIAMOND # 固定材料
material-amount: 1 # 基础材料数量(不随等级)
lock-multipliers: [1, 2, 4, 16] # 锁定 0/1/2/3+ 条时的消耗倍率
levels:
max: 10
start: 1
upgrade-chance: # 每次开始改造随机升级概率(按当前最高等级)
default: 0.01
"1": 0.05
...
"10": 0.00001
pity: # 保底:连续 N 次未升级则下次必定升级
default: 120
"1": 15
"2": 20
"3": 30
"4": 50
"5": 70
"6": 120
...
pity-count: 0 # 全局保底:累计 N 次必定升级(>0 优先于上面按等级表)
combat-groups: # 战斗特效目标分组
UNDEAD_DAMAGE: [ZOMBIE, SKELETON, ...]
ARTHROPOD_DAMAGE: [SPIDER, CAVE_SPIDER, ...]
affix-slots: 4 # 词条条数(1-4)
max-locked-affixes: 3 # 最多可锁定条数
allowed-item-types: [] # 可改造物品白名单;空或 [ANY] = 全部
slot-pools: # 词条槽专属词条库
"1": [attack-damage, undead-damage, arthropod-damage, ranged-damage] # 伤害·攻击
"2": [armor, armor-toughness, damage-reduction] # 防御
"3": [attack-speed, movement-speed] # 攻速·移速
"4": [max-health, luck, armor-pierce] # 生命·其他
# 填 affix-pool 里的词条 id;空 / ["ALL"] = 全部词条池
affix-pool: # 词条池(统一池,每条可配 targets 限定物品)
attack-damage: # 词条 id
name: "攻击力"
color: "&c"
weight: 10
attribute: ATTACK_DAMAGE # 1.21 vanilla 属性名(可带 GENERIC_ 前缀)
operation: ADD_NUMBER # ADD_NUMBER 加数值 / MULTIPLY_SCALAR_1 乘百分比
# 战斗特效词条用 effect 代替 attribute/operation,例:
# effect: RANGED_DAMAGE # 远程增伤
# effect: ARMOR_PIERCE # 破甲(配 operation: MULTIPLY_SCALAR_1 按百分比显示)
value-min: 0.1 # 兜底下限
value-max: 0.3 # 兜底上限
values: # 各等级数值范围(数值类统一 0.1~6.0;攻速按百分比 0.01~0.50;移速按百分比 0.001~0.10)
1: [0.1, 0.3]
2: [0.3, 0.8]
...
10: [5.0, 6.0]
targets: [] # 限定出现的物品类型(如破甲限武器类 [WOODEN_SWORD...MACE...]);空 = 任意
```
平衡要点:等级越高数值范围越高、升级概率越低、保底次数越多;四词条同等级不再额外加价(已由每级金币取代)。
## 常见问题
- **改了配置没生效?** 用 `/equipmod reload`;改词条池/数值后改造按钮实时更新。
- **金币扣不掉?** 确认装了 Vault 兼容经济插件;控制台会提示"未检测到 Vault 经济插件"。
- **改造次数/保底没加?** 确认用的是 1.3.0 新 jar 并重启;1.1.0 起扣费成功即计数(放弃也算)。
- **物品能改造但词条一直不出?** 词条池为空会用内置兜底池;检查 `affix-pool` 语法(控制台有告警)。
- **攻击速度异常变快/伤害变低?** 1.21 设置 AttributeModifiers 会替换默认属性,插件已自动补回基础属性;如仍异常请反馈。
[/MD]
