抽卡作品

GachaWorks

GachaWorks 是一个基于数据包的模组系统，用于在整合包和服务器中添加扭蛋机。

整合包作者可以创建自己的扭蛋机、设置价格、选择可用奖励并控制概率——无需编写单独的模组。机器可以使用来自 Minecraft 或其他已安装模组的物品，可用于商店、进度系统、物品消耗机制或服务器经济。

该模组还包含四台开箱即用的扭蛋机，供只想安装并游玩的玩家使用。

默认内容

默认情况下，GachaWorks 添加了四台以绿宝石为货币的机器：

机器	价格	奖励
村庄集市	1 绿宝石	基础补给品和旅行物品
贸易大厅	4 绿宝石	实用的村民交易商品
下界远征	10 绿宝石	下界材料及更稀有的发现
大图书馆	16 绿宝石	附魔书，包括宝藏附魔

在打开扭蛋之前，可以查看每种可能的奖励及其精确概率。没有隐藏概率或真实货币购买。

机器会随着使用而升级。更高等级会提高获得额外一次旋转的机会，但不会提高价格或暗中改变奖励概率。

功能特性

• 通过数据包自定义机器、扭蛋和奖励池
• 支持使用原版和模组物品作为支付货币或奖励
• 加权稀有度分级，游戏中显示精确概率
• 动画机器摇柄和扭蛋开启动画
• 一次开启一个或五个扭蛋
• 持久的机器等级和额外旋转奖励
• 新生成的村庄中会随机放置机器
• 探索宝箱中可找到损坏的 Gacha 底盘物品
• 可选 JEI 支持，用于查看配方、机器获取方式和扭蛋内容
• 服务端奖励处理，包括断开连接或重启后的恢复
• 服务端设置，可禁用默认内容和村庄放置

获取默认机器

新生成的村庄可能包含一台随机的已启用 GachaWorks 机器。

机器也可以通过 损坏的 Gacha 底盘 合成获得，该物品有较小概率出现在地牢、矿井、要塞、林地府邸和远古城市的宝箱中。

数据包

自定义内容分为三种定义类型：

text 机器 → 扭蛋 → 稀有度分级 → 奖励池

一个基础数据包的结构如下：

text pack.mcmeta data/ your\_namespace/ gachaworks/ machine/ starter.json capsule/ starter.json reward\_pool/ starter\_common.json starter\_rare.json recipe/ starter\_machine.json

机器定义 控制：

• 名称和外观
• 分发的扭蛋种类
• 支付所需的物品及数量
• 等级阈值和额外旋转概率

扭蛋定义 控制：

• 名称、颜色和动画
• 稀有度分级
• 每个分级分配的权重和奖励池

奖励池 包含当对应分级被抽中时可选的物品或其他奖励。池可以包含单个物品、捆绑包、效果、免费旋转、空结果或对其他池的引用。

命名空间和文件名共同构成定义 ID。例如：

text data/example/gachaworks/machine/starter.json

将创建机器定义：

text example:starter

内置的机器可以作为创建数据包时的实用示例。要完全替换它们，请在 serverconfig/gachaworks-server.toml 中设置：

toml enable\_default\_machines = false

机器、扭蛋和奖励池定义会在世界或专用服务器启动时加载。更改后，请完全重新打开世界或重启服务器；/reload 是不够的。