SX-Item —— 稳定维护的老牌随机物品库 [1.8-26.2.x]

原创 开源 工具 SX-Item —— 稳定维护的老牌随机物品库 [1.8-26.2.x] 4.5.0

完成注册/登录后下载
版权类型
原创
插件中文名称
埃斯插艾特一爱慕
插件英文名称
SX-Item
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
  3. Folia
  4. Purpur
  5. PufferFish
  6. Leaves
语言支持
中文(简体)
适配版本(Java)
  1. 最新版本
  2. 26.x
  3. 1.21
  4. 1.20
  5. 1.19
  6. 1.18
  7. 1.17
  8. 1.16
  9. 1.15
  10. 1.14
  11. 1.13
  12. 1.12
  13. 1.11
  14. 1.10
  15. 1.9
  16. 1.8
SX-Item —— 全版本物品管理插件

一个物品,千变万化。从 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>
uUUID 随机<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 文件夹,还能把「品质表」「职业表」「附魔表」抽成全局变量,多个物品共享一套随机池。




🧊 现代组件支持(1.20.5+ / 1.21.1+)

直接用原版组件(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>
[td]给予玩家物品[/td]
[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+,脚本功能需自行安装引擎模块)




📥 下载与文档


一份配置,无限可能。快来创造属于你的物品吧!​
作者
枫溪
下载
1,046
查看
7,066
首次发布
最后更新

评分

5.00 星 3 次评分

枫溪 的其他资源

最新更新

  1. 4.5.0

    新增功能 表达式系统:新增 6 种控制流 / 比较语法 <if:条件?真值:假值> — 三元条件(真值集 true/1/yes/ok)...
  2. [4.2.2] 支持1.21.1

    4.2.2 兼容 paper 1.21 4.2.1 移除了脚本可能报错的不安全参数 `"--no-deprecation-warning"``...

最新评价

埃斯插艾特一爱慕好用爱用
感谢作者大大分享
插个眼,点个赞先
后退
顶部 底部