- 版权类型
- 原创
- 插件中文名称
- 埃斯插艾特一爱慕
- 插件英文名称
- SX-Item
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
SX-Item —— 全版本物品管理插件
一个物品,千变万化。从 1.8.8 到 26.2,一套配置通吃。
当前版本:v4.5.0 | 作者:Saukiya、Ray_Hughes、Lounode | 开源协议见仓库
一个物品,千变万化。从 1.8.8 到 26.2,一套配置通吃。
当前版本:v4.5.0 | 作者:Saukiya、Ray_Hughes、Lounode | 开源协议见仓库
SX-Item 是一款专注于物品创建、随机化与管理的 Spigot 插件。它把「写一个物品」这件事,从死板的固定配置,升级成了一套可随机、可计算、可脚本化、可自动更新的动态物品系统。
无论你是想做一把带随机品质、随机词条、随机属性的装备,还是要用原版组件定制一个能吃、能采石、能堆叠 99 个的钻石,SX-Item 都能用几行 YAML 搞定。
- 全版本支持 —— 通过独立 NMS 模块,原生兼容 1.8.8 ~ 1.21.10(含 26.1.x / 26.2.x 快照),要什么版本发 Issue 即可
- 多平台运行 —— Spigot / Paper / Folia 均可运行
- 多语言内置 —— 简体中文、English、Deutsch 三语本地化
- 随机字符串引擎 —— 17 种表达式,物品的每一行都能随机、能运算
- 物品自动更新 —— 改了配置,玩家背包里的旧物品自动同步新内容
- NBT & 组件双系统 —— 传统 NBT 与 1.20.5+ 原版组件(Components)全支持
- 数据保护机制 —— 自动更新时可保护指定 NBT / 原版组件不被覆盖
- 脚本引擎集成 —— 支持 JS(Nashorn)/ Python(PySpigot),物品逻辑随你写
- 软依赖联动 —— PlaceholderAPI 变量、MythicMobs 怪物掉落无缝对接
这是 SX-Item 最强的地方。物品名称、Lore、材质、属性……任何字符串位置都能嵌入表达式,格式为 <类型:参数>。
| 标记 | 类型 | 示例 |
| i / r | 整数随机 | <i:1_7> |
| d | 小数随机 | <d:2.3_6> |
| s | 正常随机 | <s:AAA:BBB:CCC> |
| l | 锁定随机(同物品内复用同一结果) | <l:品质> |
| c | 计算器(支持 int 取整) | <c:int ((2*3)+2)*1.4></font> |
| b | 整行条件判断 | <b:<l:品质>:史诗:优秀></font> |
| t | 时间格式 | <t:1Y1M1D1h1m1s></font> |
| u | UUID 随机 | <u:random> |
| j | 脚本处理 | <j:Default.itemScript#a,b></font> |
| if | 三元条件 | <if:<cmp:5 gt 3>?是:否></font> |
| when | 多分支选择 | <when:史诗$史诗:...|default:普通></font> |
| eq / like | 相等 / 模糊包含判断 | <like:钢铁长剑==长剑></font> |
| cmp | 数值比较 | <cmp:10 gt 9> |
| null | 空占位 | <null:忽略这段> |
表达式还能嵌套。举个真实例子 —— 一把品质、职业、属性全随机的武器:
代码:
Default-1:
Name: <l:DefaultPrefix>&c炎之洗礼 <l:<l:品质>Color><l:品质>
ID: <l:<l:职业>ID>
Lore:
- '&6品质等级: <l:<l:品质>Color><l:品质>'
- '&6限制等级: <c:int 10 * <s:<l:品质>基数>>级'
- '&c攻击力: +<l:攻击力>'
- '&7耐久度: <c:int <d:0.6_0.9> * <l:耐久度>>/<l:耐久度>'
- '&a到期时间: <t:10m>'
Random:
攻击力: <c:20 * <s:<l:品质>基数>>
耐久度: <c:int <r:350_400> * <s:<l:品质>基数>>
Update: true
配合独立的 RandomString 文件夹,还能把「品质表」「职业表」「附魔表」抽成全局变量,多个物品共享一套随机池。
直接用原版组件(Components)高度自定义物品,无需第三方:
代码:
Component-1:
ID: DIAMOND
Name: "组件教程"
Components:
minecraft:item_name: '默认名称(无法被铁砧修改)'
minecraft:rarity: 'epic'
minecraft:max_stack_size: 99 # 钻石堆叠 99 个
minecraft:food: # 让钻石能吃
nutrition: '[int]<i:1_5>'
saturation: '[float]<d:1_5>'
can_always_eat: true
minecraft:tool: # 让钻石能采石
rules:
- blocks: [ minecraft:stone ]
correct_for_drops: true
开启自动更新后,最怕玩家强化过的物品被「重置」。SX-Item 提供全局 + 单物品两级保护:
- 全局在 Config.yml 的 ProtectNBT 中声明受保护 NBT
- 单物品可用 ProtectNBT 追加保护,如保护附魔 Enchantments
- 支持保护原版顶级组件:components.minecraft:damage、components.minecraft:enchantments(需 1.20.5+)
- 支持用 !protect.data 单独解除某物品对全局保护的继承
主命令 /SxItem,别名 /sxi、/si。
| 命令 | 说明 |
| /si give [物品] <玩家> <数量> <key:value></font> |
[tr][td]/si save <编号> <类型></font>[/td][td]保存手中物品到配置文件[/td][/tr]
[tr][td]/si info[/td][td]查看物品信息[/td][/tr]
[tr][td]/si nbt[/td][td]查看 / 修改物品 NBT(支持点击复制)[/td][/tr]
[tr][td]/si component[/td][td]查看 / 修改物品组件数据[/td][/tr]
[tr][td]/si script[/td][td]调用脚本函数[/td][/tr]
[tr][td]/si reload[/td][td]重载插件配置[/td][/tr]
- SX-Attribute —— 官方属性扩展,物品可直接写入属性词条
- PlaceholderAPI —— Lore / 名称中直接使用 PAPI 变量
- MythicMobs —— 史诗怪物掉落 SX 物品可直接进入玩家背包
- 提供 Gradle / JitPack 依赖,开发者可二次开发
代码:
repositories { maven { url 'https://jitpack.io' } }
dependencies { compileOnly 'com.github.Saukiya:SX-Item:4.5.0' }
1.8.8 · 1.11.2 · 1.12.2 · 1.13.2 · 1.14.4 · 1.15.2 · 1.16.5
1.17.1 · 1.18.2 · 1.19.2/4 · 1.20.1~6 · 1.21.1~11
26.1 26.2
运行环境:Java 8+(组件功能需 1.21.1+,脚本功能需自行安装引擎模块)
一份配置,无限可能。快来创造属于你的物品吧!