SLB 用户说明

SLB — 一个装了就能用的拔刀剑附属模组，带了一组写好的 SE（特殊效果）。你也可以自己加新刀。

---

安装

环境要求

依赖	版本
Minecraft	1.21.1
NeoForge	21.x
SlashBlade Resharped	≥ 2.0.3

步骤

1. 安装 NeoForge 1.21.1
2. 安装 SlashBlade Resharped 2.0.3+
3. 把 SLB.jar 丢进 .minecraft/mods/
4. 启动游戏

---

快速上手：三步加一把刀

不需要编程工具，只要一个能打开 zip 的软件（WinRAR / 7-Zip / Bandizip）。

用压缩软件打开 SLB.jar（不要解压，直接在里面操作）。

第 1 步：放模型

把模型文件拖进 assets/slb/model/ 目录，一个刀一个文件夹：

SLB.jar/assets/slb/model/
└── 你的刀名/           ← 新建文件夹
    ├── model.obj       ← 3D 模型文件
    └── texture.png     ← 贴图文件

模型去哪找？很多刀模型可以从模组交流群、MCBBS、Patreon 等渠道获取。格式要求是 Wavefront OBJ + PNG 贴图。

第 2 步：写 JSON 定义

在 data/slb/slashblade/named_blades/ 里新建一个 JSON 文件，命名随意，比如 my_sword.json：

{
  "name": "slb:my_sword",
  "properties": {
    "attack_base": 12.0,
    "max_damage": 200,
    "slash_art": "slashblade:judgement_cut",
    "sword_type": ["bewitched"],
    "special_effects": ["slb:swift_edge", "slb:blood_edge"]
  },
  "render": {
    "model": "slb:model/my_sword/model.obj",
    "texture": "slb:model/my_sword/texture.png",
    "carry_type": "katana"
  },
  "enchantments": [
    { "id": "minecraft:sharpness", "lvl": 5 },
    { "id": "minecraft:unbreaking", "lvl": 3 }
  ]
}

name 里的 slb: 前缀不要改，冒号后面的名字跟你文件夹名字保持一致就行。

第 3 步：加中文名

打开 assets/slb/lang/zh_cn.json，加一行：

{
  "item.slb.my_sword": "我的刀",
  "item.slb.my_sword.desc": "§b这是一把很厉害的刀"
}

英文同理，打开 en_us.json。

保存文件，压缩软件会问"是否更新到压缩包？"选是。搞定，进游戏就有了。

---

JSON 字段参考

properties（属性）

字段	类型	说明	示例
attack_base	float	基础攻击力（一般 8~20）	12.0
max_damage	int	锻造耐久上限	150
slash_art	string	右键释放的必杀技	"slashblade:sakura_end"
sword_type	string[]	剑类型	["bewitched"]
special_effects	string[]	挂载的特殊效果	["slb:swift_edge"]

sword_type 可选值

值	效果
"bewitched"	妖刀（可成长）
"enchanted"	附魔光泽
"sealed"	封印刀（需解封）

常用 slash_art

值	效果
slashblade:drive_vertical	纵斩
slashblade:drive_horizontal	横斩
slashblade:wave_edge	剑气波
slashblade:circle_slash	回旋斩
slashblade:sakura_end	樱之终焉
slashblade:judgement_cut	审判切割

render（渲染）

字段	类型	说明	示例
model	string	OBJ 模型路径	"slb:model/xxx/model.obj"
texture	string	PNG 贴图路径	"slb:model/xxx/texture.png"
carry_type	string	携带方式	"katana"
summon_sword_color	hex	刀光颜色（16 进制）	0xFFFF69B4

常用 carry_type

值	效果
"katana"	别在腰间（默认）
"ninja"	背在背后
"pso2"	悬浮在身旁

enchantments（附魔）

[
  { "id": "minecraft:sharpness", "lvl": 5 },
  { "id": "minecraft:unbreaking", "lvl": 3 }
]

语言文件

{
  "item.slb.<刀名>": "刀的名称",
  "item.slb.<刀名>.desc": "§b描述文字"
}

---

配置文件

首次运行后生成 config/slb.json5，可用记事本修改：

{
  "damage": {
    "globalDamageMultiplier": 1.0   // 全局伤害倍率，0.1~10.0
  },
  "sword_type": {
    "enableBewitchedByDefault": true  // 默认是否妖刀
  },
  "debug": {
    "logDiscoveredBlades": true       // 是否在日志列出所有刀
  }
}

改完重启游戏生效。

---

特殊效果（SE）系统

SLB 为你的刀增加了特殊效果系统——每把刀可以挂载被动特效，比如吸血、点燃敌人、加移动速度等。

为刀添加 SE

在刀 JSON 的 properties 里加上 special_effects 数组：

"properties": {
  "attack_base": 12.0,
  "special_effects": ["slb:swift_edge", "slb:blood_edge"]
}

一把刀可以同时挂载多个 SE，效果叠加。如果玩家等级没达到 SE 的等级要求，该 SE 不生效。

内置 SE 列表

SE ID	中文名	等级要求	效果
slb:glow_edge	辉光性	1	手持发光，SA闪光弹
slb:echo_edge	回声性	3	击杀声呐探测
slb:swift_edge	疾风性	8	加速+概率二连击
slb:hunter_edge	狩猎性	10	满血目标首刀增伤+击杀计数加速
slb:shield_edge	盾守性	12	手持伤害吸收
slb:blood_edge	血刃性	15	攻击吸血+击杀回复
slb:thunder_edge	雷霆性	20	概率召唤闪电
slb:storm_edge	风暴性	20	攻击产生范围AOE
slb:soul_edge	魂刃性	20	荣耀之魂获取+50%
slb:flame_edge	烈焰性	25	点燃目标+燃烧增伤
slb:frost_edge	冰霜性	25	减速+冰冻增伤
slb:void_edge	虚空性	35	真实伤害+虚空爆炸

自定义自己的 SE

打开 SLB.jar，编辑 slb_ses.json，在 ses 对象里加一段：

"我的绿光闪闪": {
  "requestLevel": 5,
  "isCopiable": true,
  "isRemovable": true,
  "effects": [
    { "type": "potion", "id": "minecraft:regeneration", "amplifier": 1, "trigger": "held" },
    { "type": "potion", "id": "minecraft:resistance", "amplifier": 0, "trigger": "held" }
  ]
}

保存后，在刀 JSON 里写 "special_effects": ["slb:我的绿光闪闪"] 即可。

原子效果类型参考

每个效果的 JSON 参数说明如下。加粗 = 必填，其余可选（不填则用默认值）。

type	效果	参数详解
potion	给自己加状态	id = 状态ID（如 minecraft:speed） amplifier = 等级，默认 0 duration = 持续刻数（20刻=1秒），默认 100
potion_target	给敌人加状态	id = 状态ID amplifier = 等级，默认 0 duration = 持续刻数，默认 100 chance = 触发概率 0~1，默认 1.0
fire_target	点燃敌人	seconds = 燃烧秒数，默认 5 chance = 触发概率 0~1，默认 1.0
damage	额外伤害	ratio = 伤害比例（0.3=基础伤害的30%），默认 0 condition = 触发条件（仅限 damage 类型使用，可选值见下表），默认 always chance = 触发概率 0~1，默认 1.0
lightning	召唤闪电	chance = 触发概率 0~1，默认 1.0 double_in_rain = 雨天概率翻倍，默认 false
life_steal	吸血	ratio = 吸血比例（0.03=造成伤害的3%），默认 0.03
heal_on_kill	击杀回血	amount = 回复血量，默认 2.0
double_strike	概率二连击	chance = 触发概率 0~1，默认 1.0 ratio = 二连击伤害比例（0.6=基础伤害的60%），默认 0.6
aoe_potion	范围状态	id = 状态ID amplifier = 等级，默认 0 duration = 持续刻数，默认 60 radius = 范围半径，默认 5.0
void_tear	虚空撕裂（真实伤害）	chance = 触发概率 0~1，默认 1.0 damage_ratio = 真实伤害倍率（2.0=基础伤害×2），默认 2.0
void_explosion	虚空爆炸（范围真实伤害）	chance = 触发概率 0~1，默认 1.0 damage_ratio = 伤害倍率，默认 0.8 radius = 爆炸半径，默认 3.0
sonar_pulse	声呐脉冲（透视发光）	range = 探测范围，默认 15.0 duration = 发光持续刻数，默认 100
proud_soul_mult	荣耀之魂获取倍率	multiplier = 倍率（1.5=获取量×1.5），默认 1.5
kill_count_mult	击杀计数获取倍率	multiplier = 倍率，默认 1.5

提示：状态ID（id）可参考 Minecraft 状态效果列表，如 minecraft:speed（速度）、minecraft:strength（力量）、minecraft:regeneration（再生）、minecraft:resistance（抗性）、minecraft:absorption（伤害吸收）等。

触发时机（trigger）

值	说明
held	手持刀时每 tick
hit	击中目标时（默认）
slashart	发动 SA 时
kill	击杀时
ps	获得荣耀之魂时

条件判断（condition，仅 damage 类型可用）

只在 type: "damage" 中有效，其他效果类型不支持此参数。

值	效果
always	总是触发（默认）
target_on_fire	目标燃烧时
target_frozen	目标冰冻时
full_health	目标满血时

组合示例

"吸血+燃烧+加速" SE：

"血火双刃": {
  "requestLevel": 20,
  "effects": [
    { "type": "life_steal", "ratio": 0.05, "trigger": "hit" },
    { "type": "fire_target", "seconds": 3, "chance": 0.5, "trigger": "hit" },
    { "type": "potion", "id": "minecraft:speed", "amplifier": 1, "trigger": "held" }
  ]
}

---

常见问题

游戏崩溃，提示 No key properties

原因： JSON 里 properties 拼写错误。检查是否写成了 proprties 或 propreties。

游戏里没有 SLB 的刀

• SLB.jar 里没有放刀的数据（空包就是这样）。按上面的步骤加一把进去。
• SlashBlade Resharped 版本低于 2.0.3，升级即可。

刀显示为紫黑方块

原因： 模型或贴图路径不对。检查 JSON 里的 model 和 texture 路径是否跟你放文件的位置一致。

所有刀伤害太低 / 太高

改 config/slb.json5 里的 globalDamageMultiplier，2.0=两倍，0.5=一半。

游戏崩溃，提示 Not a string: null

原因： JSON 里某个字段应该填字符串，但写成了 null 或漏掉了。最常见于 render 段的路径：

❌ 错误 — model 字段为空
"render": {
    "model": null,       // ← 应该写 "slb:model/xxx/model.obj"
    "texture": null      // ← 应该写 "slb:model/xxx/texture.png"
}

✅ 正确
"render": {
    "model": "slb:model/example_blank/model.obj",
    "texture": "slb:model/example_blank/texture.png"
}

刀名（name 字段）、技能名（slash_art）、SE ID 等也都是字符串，不能写 null 或漏掉。

---

JSON 格式检查清单

修改 JSON 文件后如果游戏崩溃，最可能的原因是格式写错了。JSON 对格式要求非常严格，差一个逗号都会崩。对照以下清单检查：

❌ 常见错误 & ✅ 正确写法

#	错误写法	问题	正确写法
1	"attack_base": 12.0, "max_damage": 200 ← 最后一个属性后面有逗号	尾随逗号（trailing comma）	"attack_base": 12.0, "max_damage": 200 ← 去掉末尾逗号
2	"attack_base": 12.0 "max_damage": 200 ← 两行之间没逗号	缺少逗号	"attack_base": 12.0, "max_damage": 200
3	'name': 'slb:my_sword'	用了单引号，JSON 必须双引号	"name": "slb:my_sword"
4	name: "slb:my_sword"	key 没加引号	"name": "slb:my_sword"
5	"max_damage": "200"	数字写了引号（成了字符串）	"max_damage": 200
6	"attack_base": 12,0	逗号当小数点（应该是点）	"attack_base": 12.0
7	"id": "minecraft:sharpness", "lvl": 5, ← 数组最后一项有逗号	数组尾随逗号	"id": "minecraft:sharpness", "lvl": 5 ← 去掉逗号
8	"sword_type": "bewitched"	本应是数组，写成字符串	"sword_type": ["bewitched"]
9	"model": "slb:model\my_sword\model.obj"	用了反斜杠 \，应该用 /	"model": "slb:model/my_sword/model.obj"
10	// 这是一把刀 写在 JSON 中间	JSON 标准不支持注释	删除注释（json5 支持但 blade JSON 不是 json5）
11	漏了 { 或 }，或多了 }	花括号不配对	数一下 { 和 } 数量是否相等
12	"slash_art": slashblade:drive_vertical	字符串没加引号	"slash_art": "slashblade:drive_vertical"

自检步骤

修改完 JSON 后，打开 JSONLint 之类的在线校验工具，把 JSON 贴进去检查：

1. ✅ 所有 key 和字符串值都用双引号
2. ✅ 每行属性末尾有逗号（最后一行不要逗号）
3. ✅ { 和 }、[ 和 ] 数量配对
4. ✅ 路径用正斜杠 /，不是反斜杠
5. ✅ 数字不加引号，字符串必须加引号

参考模板 _example_blank.json.example

SLB 自带一个 _example_blank.json.example 文件作为格式参考。后缀是 .json.example，不是 .json，所以 SlashBlade 不会加载它，也就不会因为缺少模型文件而崩溃。

想用这把刀时，把文件名改成 _example_blank.json，然后把 model.obj 和 texture.png 放到 assets/slb/model/example_blank/ 目录下即可。

---

许可

All Rights Reserved. 仅供学习交流使用。