核心玩法 ①:CS 箱子(开箱抽奖)
把 CS:GO 那种「开箱 — 揭晓 — 稀有度」的体验原样搬到 Minecraft:
- 用
/give @p csgobox:csgo_box领一个箱子,配上对应等级的钥匙; - 手持箱子右键,看预览、把钥匙塞进卡槽;
- 点「开启」,一段滚动揭晓动画后,结果停在属于你的战利品上。
- 5 档稀有度:consumer / industrial / mil_spec / restricted / classified,越稀有越难抽,每档独立权重;
- 4 档钥匙:铁、金、钻石、下界合金,最高档只能靠锻造台升级获得;
- 自定义箱子:改
config/csbox/*.json就能加新箱子、调权重,不用重新编译; - 批量开箱:Shift + 右键进入总览屏,一次开一整组,流水揭晓;
- 成就 & 命令:首次开箱成就、累计开 200 箱的隐藏挑战,以及
/csbox查看 / 重载配置。
核心玩法 ②:终端机(谈判式购买)
终端机是一条独立的「谈判式抽卡」线:用武库点数向军火商买开箱产物,5 轮报价逐轮讨价还价。
- 五轮谈判:每轮长按「接受」成交,或长按「拒绝」等下一轮,最多 5 轮;
- 随机磨损:有耐久的物品按磨损扣耐久;没耐久的物品磨损折算成加价(每 5% 磨损 +1 武库点数,最多 +20);
- 服务端权威会话:中途关闭再打开,对话、报价和轮次跟上次完全一致;转手给别人的终端机对方无法交易,只会收到「去问问 xx 吧」;
- 3 小时倒计时:按世界运行时间计,暂停游戏和关服不计时,重启后续算;
- 一台一次:成交、5 轮全拒、超时三种结局都会销毁终端机,用完再弄一台;
- 批量购买 & 3D 检视:支持一次批量买(上限可选 30 / 64 / 200 / 400 / 800 / 无上限),报价物品可拖拽 3D 检视。
经济闭环:开箱 → 点数 → 再买
- 军火商职业村民可以用绿宝石 / 铁锭 / 金锭 / 钻石换武库点数,也卖箱子、钥匙和终端机;
- 用 武库拆解台 把开箱得到的战利品拆解成武库点数(熔炉式加工,带稀有度分级的物品才能拆);
- 点数再去军火商那里买箱子 / 钥匙 / 终端机,形成「开箱 → 拆解 → 再买」的循环。
支持平台
2.0.0-beta 起六个平台同步正式发布:
| 加载器 | 支持版本 |
|---|---|
| NeoForge | MC 1.21.1 / 26.1.2 / 26.2 |
| Forge | MC 1.20.1 / 26.1.2 / 26.2 |
选对应加载器和 MC 版本的 jar 放进 mods/ 即可。
关于项目
本项目是原版 CsgoBox(作者 Reclizer)的重制维护版,当前由 ChloePrime 维护。相比原版:重做了界面、修掉一个已知安全问题、把物品序列化改成不依赖 CraftTweaker,并改成多加载器结构。采用 MIT 许可,可自由分支再分发,注明原作者并附上仓库链接即可。
说明: 部分代码、贴图和文案由 AI 生成,发布前已人工核对。玩起来没问题,只是坦诚说明一下。
下载与反馈
- 仓库与安装:https://github.com/wikkd/CS2-Box(把 jar 放进
mods/)。 - 遇到问题 / 想提建议:GitHub Issues。
- 完整的配置参考:docs/CONFIGURATION.md。
How to Install CS2box (Mod)
CS2box by wikkd is verified for Forge, Neoforge across Minecraft versions 1.20.1, 1.21, 1.21.1, 26.1.2, 26.2 (latest release: 2.0.3, file size: 744 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20.1, 1.21, 1.21.1, 26.1.2, 26.2) and platform (Forge, Neoforge).
- Make sure you have the compatible loader or environment installed for Forge, Neoforge.
- Move the downloaded CS2box file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 |
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
- 装了 Cloth Config 后专用服务器无法启动**(NeoForge 三平台):Cloth 配置屏的注册代码里有个 lambda,虽然包在「仅客户端」守卫里,但会被连同签名一起编进模组主类;主类随后被事件总线反射扫描,专用服务器一解析到客户端界面类就崩溃。现在注册整体挪进一个只在「装了 Cloth 的客户端」才加载的持有类——守卫防得住执行防不住签名扫描,隔离类才是正解。Forge 三平台的同款潜伏隐患亦一并隔离,六平台模式统一。
- 没装 Create 时,1.21.1 / 1.20.1 服务器启动崩溃**:Create 机械手开箱联动的监听器此前在无 Create 环境直接把模组加载搞挂。现在只有检测到 Create 已安装才加载相应代码,无 Create 环境不再触发。
- 大批量开箱不再丢结果(1.21.1 / Forge 1.20.1)**:批量开箱结果分片的客户端待处理队列上限在这两个平台漏同步为旧值 64——开 6400 箱这种大批量时最旧约 4 千多份结果会被静默裁掉,合并弹窗缺数据。现在六平台统一为 256。
- Forge 三平台批量单包护栏收紧对齐**:单包物品数上限从 1024 收紧为与 NeoForge 一致的 32(服务端对异常批量包的拒绝口径六平台一致)。
- 网页端
#pack=导入不再越刷越多**:同一条/csbox editor链接此前每刷新一次网页,都会把config/csbox再导入一批新草稿(2→3→4→…),停留越久越卡。现在按文件名+内容指纹防重,刷新/重开同一链接不再重复导入。 /csbox editor链接现在会自动带上你本地的箱子配置**:命令输出的链接内嵌config/csbox/*.json与_prices.json(损坏的 JSON 原文也能带上,在导入框里就地修正后保存),同时把物品/生物注册表 id 同步进浏览器用于输入补全——在浏览器编辑箱子时无需再在游戏里逐个抄 id。配置只在你的游戏与浏览器之间流转,不会发往任何服务器;超长配置自动精简或回退纯链接。
终端机
2.0.0 的新玩法:用武库点数向军火商谈判购买开箱物品。
右键终端机开始谈判,最多 5 轮报价。每轮可以长按「接受」成交,或长按「拒绝」等下一轮;
报价带随机磨损值:有耐久的物品按磨损扣耐久;没有耐久的物品,磨损折算成加价(每 5% 磨损加 1 武库点数,最多 +20);
打开终端后开始 3 小时倒计时。按世界运行时间计,暂停游戏和关服不计时,重启后续算;
成交、5 轮全拒、超时,三种结局都会销毁终端机物品。一台一次性,用完要再弄一台;
中途关闭再打开,对话、报价和轮次与上次离开时一致;
正在谈判的终端机转给别人,对方无法交易,只会收到「去问问 xx 吧」;
支持批量购买(上限可选 30 / 64 / 200 / 400 / 800 / 无上限)和 3D 拖拽检视报价物品;
不需要钥匙。
武库商小屋与村庄生成
野外新增武库商小屋结构,屋内有军火商、武库拆解台和一个商店宝箱(武库点数、基础箱、铁钥匙、绿宝石、铁锭);
平原、沙漠、热带草原、雪地、针叶林五种村庄会沿街道自然生成武库商小屋;
军火商村民做了防解雇、防消失加固。
TACZ 枪械第一人称检视(1.21.1 / 1.20.1 版)
安装《永恒枪械工坊:零》后,抽中的 TACZ 枪械可进入独立的第一人称检视屏,播放检视动画。未安装 TACZ 时无影响。
变化
批量开箱
批量开箱:Shift + 右键箱子进入批量总览屏,点「开启」直接开箱(扣减与库存复核仍由服务端权威执行),结果以流水屏展示。单次上限由服务端配置 控制(0 为无上限)。bulkOpenCount
本版对批量开箱界面做了一轮客户端打磨(六平台同步):
终端机配置
首启不生成默认的 。创造栏拿到的终端机默认是空的,需要自建 (声明 )才能配置谈判奖池;terminal.jsonterminal.json"type": "terminal"
手写的终端配置如果缺 字段,会拒绝加载并在游戏内报错。type
其他
教程文档随版本更新为 ,首次启动自动下载新版、清理旧版;_tutorial_v2.0.0-beta*.md
jar 文件名改为 (Forge 为 )。csgobox-<MC版本>-2.0.0-beta.jarcsgobox-forge-<MC版本>-2.0.0-beta.jar
说明
本版本为测试版,遇到问题欢迎反馈;
6 个平台(NeoForge 3 + Forge 3)同步正式发布,功能线一致;
终端机
2.0.0 的新玩法:用武库点数向军火商谈判购买开箱物品。
右键终端机开始谈判,最多 5 轮报价。每轮可以长按「接受」成交,或长按「拒绝」等下一轮;
报价带随机磨损值:有耐久的物品按磨损扣耐久;没有耐久的物品,磨损折算成加价(每 5% 磨损加 1 武库点数,最多 +20);
打开终端后开始 3 小时倒计时。按世界运行时间计,暂停游戏和关服不计时,重启后续算;
成交、5 轮全拒、超时,三种结局都会销毁终端机物品。一台一次性,用完要再弄一台;
中途关闭再打开,对话、报价和轮次与上次离开时一致;
正在谈判的终端机转给别人,对方无法交易,只会收到「去问问 xx 吧」;
支持批量购买(上限可选 30 / 64 / 200 / 400 / 800 / 无上限)和 3D 拖拽检视报价物品;
不需要钥匙。
武库商小屋与村庄生成
野外新增武库商小屋结构,屋内有军火商、武库拆解台和一个商店宝箱(武库点数、基础箱、铁钥匙、绿宝石、铁锭);
平原、沙漠、热带草原、雪地、针叶林五种村庄会沿街道自然生成武库商小屋;
军火商村民做了防解雇、防消失加固。
TACZ 枪械第一人称检视(1.21.1 / 1.20.1 版)
安装《永恒枪械工坊:零》后,抽中的 TACZ 枪械可进入独立的第一人称检视屏,播放检视动画。未安装 TACZ 时无影响。
变化
批量开箱
批量开箱:Shift + 右键箱子进入批量总览屏,点「开启」直接开箱(扣减与库存复核仍由服务端权威执行),结果以流水屏展示。单次上限由服务端配置 控制(0 为无上限)。bulkOpenCount
本版对批量开箱界面做了一轮客户端打磨(六平台同步):
终端机配置
首启不生成默认的 。创造栏拿到的终端机默认是空的,需要自建 (声明 )才能配置谈判奖池;terminal.jsonterminal.json"type": "terminal"
手写的终端配置如果缺 字段,会拒绝加载并在游戏内报错。type
其他
教程文档随版本更新为 ,首次启动自动下载新版、清理旧版;_tutorial_v2.0.0-beta*.md
jar 文件名改为 (Forge 为 )。csgobox-<MC版本>-2.0.0-beta.jarcsgobox-forge-<MC版本>-2.0.0-beta.jar
说明
本版本为测试版,遇到问题欢迎反馈;
6 个平台(NeoForge 3 + Forge 3)同步正式发布,功能线一致;