
CSCases
Minecraft 的 CS:GO 风格开箱。分级加权战利品抽取、动画展示,以及通过数据包完全自定义的箱子。
CS Cases
一个 Minecraft 的 CS:GO 风格开箱模组。放置箱子、使用对应的钥匙、观看卷轴转动,然后领取你的战利品。
特性
- 原汁原味的开箱流程 —— 在确认前预览箱子内容,观看卷轴式揭示动画并伴随经典的开箱音效,然后明确点击 Claim(领取) 获得奖励,或按 ESC 将其丢到地上。
- 五级稀有度抽取,带权重概率和熟悉的 CS 配色:军规级蓝 → 受限级紫 → 保密级粉 → 隐秘级红 → 罕见特殊级金。
- 完全数据驱动 —— 每个箱子都是数据包中的一个 JSON 文件。可以在服务器或单个世界中添加、编辑或重新命名箱子,无需重新编译、重新打包,也无需发布客户端资源包。
- 以真实物品堆作为奖励 —— 一个奖励条目可以是任何
/give接受的内容。堆叠数量、附魔、自定义名称、描述文本、属性修饰符、染色的皮革、任何已注册的数据组件,全都支持。 - 错误钥匙保护 —— 钥匙通过数据组件绑定到特定箱子。对不匹配的箱子使用钥匙时,动作栏会显示 "This key does not fit this case.";钥匙不会被消耗。
- 支持多人游戏 —— 服务器在玩家加入时以及执行
/reload后,会将完整的箱子注册表推送给每个客户端,因此专用服务器玩家能看到服务器加载的内容,客户端无需任何设置。 - 热重载 ——
/reload会从磁盘重新解析每个箱子。有效的更改立即生效。格式错误的文件会被跳过,并在服务器日志中给出明确警告,而不是让世界崩溃。 - 游戏内配置界面,集成于 Mods 菜单。
工作原理
- 从创造模式标签页中拿取一个 Case(箱子) 和一个匹配的 Case Key(箱子钥匙) —— 该标签页会自动为每个已加载的箱子列出各一个。
- 放置箱子。用匹配的钥匙右键点击它,打开 预览界面,显示按等级分组的所有可能奖励。
- 点击 Open(开启) 消耗钥匙并开始揭示动画。在动画播放期间按 ESC 可直接跳到奖励界面。
- 在奖励界面上,点击 Claim(领取) 获取物品,或按 ESC 让它掉在你脚下。
添加你自己的箱子
将 JSON 文件放在:
<datapack-root>/data/<your-namespace>/cases/<case-id>.json
最小示例:
{
"display_name": "Weapon Case",
"tiers": [
{
"id": "mil_spec",
"weight": 79.92,
"color": "4b69ff",
"items": ["minecraft:wooden_sword", "minecraft:stone_sword"]
},
{
"id": "covert",
"weight": 0.64,
"color": "eb4b4b",
"items": [
{
"id": "minecraft:diamond_sword",
"components": {
"minecraft:enchantments": { "minecraft:sharpness": 5 },
"minecraft:custom_name": "{\"text\":\"Awakened Blade\",\"color\":\"gold\"}"
}
}
]
}
]
}
等级权重在抽取时会进行归一化,因此任何正数都可以 —— 1 和 99 等同于 1% / 99%。物品可以是裸 id(数量为 1,无组件),也可以是完整的 { "id": ..., "count": ..., "components": { ... } } 对象。
通过创造模式标签页或以下命令发放你的自定义箱子:
/give @s cs_cases:case_block[cs_cases:case_id="myserver:weapon_case"]
/give @s cs_cases:case_key[cs_cases:case_id="myserver:weapon_case"]
完整的数据包格式参考,包括所有支持的字段和校验规则,位于源代码仓库中的 docs/datapack-cases.md。
内置内容
该模组附带一个默认箱子 —— Starter Case(初始箱子) —— 使用与其他箱子相同的数据包机制构建,因此它的 JSON 本身就是一个可用的示例。
需求
- Minecraft 26.1.2
- NeoForge 26.1.2.30-beta 或更新版本
仅支持 NeoForge。不兼容 Forge 或 Fabric。
支持单人游戏和多人游戏(专用服务器)。自定义箱子以服务器为准 —— 在服务器和每个连接的客户端上安装该模组,并通过服务器上的数据包定义你的箱子。
许可证
All Rights Reserved.
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。