原创 开源 娱乐 DummyPool——台球插件 | 5种球台支持 | 真实物理引擎 | AI对战系统 [1.21.11-26.X] v1.0.4

Vault 经济与球台收费​

• 接入 VaultAPI，plugin.yml 增加 softdepend: [Vault]；未安装 Vault 时收费功能不可用，原有免费玩法不受影响。
• 球台管理菜单新增“球台收费”按钮，可分别设置 自由模式/小时 与 对战模式/场，0 表示免费；费率持久化到 tables/*.yml。
• 自由模式收费后，非创建者在感应区副手持球杆蹲下会打开计费 Dialog 而非球库：显示费率、开始计费、结束计费、当前开台者、已开台时间、申请加入。
• 开台计费按分钟向上取整（至少 1 分钟），关闭时扣费；每分钟检查余额，不足自动结束；每 30 分钟提醒仍在计费。
• 开台期间仅开台者和已加入玩家可摆球、开球库、取放球、击球；未开台时非创建者不可操作；免费台页面提供一键摆球/球库/收球入库，计费台额外提供结束计费。
• 对战模式开始按钮在费率非 0 时显示 $金额，点击开始的人扣费；余额不足无法开始；AI 对局不收取对战费用。

碰撞音效​

• 新增 sound.collision 配置节：球-球碰撞按实际材质播放 hit 音效，高速碰撞（默认 ≥ 5.0 格/秒）播放对应材质 break 音效；两种不同材质的球高速碰撞时随机播放其中一种；球-库碰撞使用木板 hit/break 音效。高速阈值与所有音效 ID 均可持久化配置。

球自动归位​

• 新增 config.yml 一级项 ball_auto_return_distance：玩家背包中带归属标签的球距球台中心超过该距离自动放回球库，设为 0 关闭该功能。

修复​

• 修复对战犯规拿到自由球后 Q 键放台成功时，物品仍回到背包的问题：放球成功后下一 tick 统一消费残留自由球，避免手上残留与复制。