原创 付费 【1.12-26.X|Folia】WarZBustaMine｜紧张刺激的多货币爆点赌博小游戏|GUI|PAPI|观战 2.0.0

https://www.yuque.com/daqingtian-3ob8x/warz/gy8z7gg6wd2f9ngh?singleDoc# 《WarZBustaMine 玩家使用手册》

​

---

---

[MD] # WarZBustaMine 玩家使用手册（中文 Wiki） > 一份 jar，从 **1.12 一路支持到最新版（含 Folia）** 的多房间 Crash / 爆点小游戏。 > 爆点由业界通用的 **可验证公平算法** 生成，玩家随时能自己验算；带图形界面、自动下注脚本、观战、赛季排行、成就与 VIP 等级。 > > 作者：**Crazy_Jky** ｜ 主命令：`/wbm`（别名 `/warzbm`、`/bustamine`）｜ 版本：v2.0.0 --- ## 目录 1. [这是什么](#1-这是什么) 2. [特性一览](#2-特性一览) 3. [安装与依赖](#3-安装与依赖) 4. [快速开始](#4-快速开始) 5. [玩家命令大全](#5-玩家命令大全) 6. [玩法详解](#6-玩法详解) 7. [图形界面（GUI）说明](#7-图形界面gui说明) 8. [可验证公平](#8-可验证公平) 9. [自动下注脚本](#9-自动下注脚本) 10. [观战模式](#10-观战模式) 11. [赛季排行榜](#11-赛季排行榜) 12. [成就系统](#12-成就系统) 13. [VIP 等级](#13-vip-等级) 14. [多货币](#14-多货币) 15. [展示条（BossBar / ActionBar）](#15-展示条bossbar--actionbar) 16. [管理员命令](#16-管理员命令) 17. [权限节点](#17-权限节点) 18. [配置文件详解](#18-配置文件详解) 19. [数据存储与迁移](#19-数据存储与迁移) 20. [常见问题（FAQ）](#20-常见问题faq) 21. [更新与支持](#21-更新与支持) --- ## 1. 这是什么 WarZBustaMine 是一个 **Crash（爆点）类赌博小游戏**：每一局有一个倍率从 `×1.00` 开始往上爬，玩家在爆掉之前点「取现（Cash Out）」就能拿走**当前倍率 × 本金**的奖金；如果贪心多等一秒，倍率一旦封顶（BUST），所有还没结算的下注 **连本带利全没**。 它和市面上同类插件最大的区别： - **爆点可验证**：采用业界通用的 bustabit 公式（HMAC-SHA256），玩家用 `/wbm verify` 当场复算每一局的爆点，服主可随时轮换种子。 - **版本通吃**：一份 jar 通过反射适配层兼容 1.12 到最新版，且 **Folia 原生调度**（区域化多线程服务端不卡顿、不报错）。 - **多房间独立**：每个房间一套独立配置（倍率曲线、下注档位、货币、抽水、风控），开新区互不干扰。 --- ## 2. 特性一览 | 特性 | 说明 | |---|---| | 💥 多房间独立配置 | 每个房间独立倍率曲线、下注档位、货币、抽水、风控 | | 🔐 可验证公平 | 爆点由 HMAC-SHA256 推算，玩家可自验、服主可轮换种子 | | 🧵 Folia 原生支持 | 反射适配层在 Folia 实体线程安全调度 | | 🖥️ 图形界面下注 | 一键下注 / 取现 / 看胜率 / 看历史，不用背命令 | | 🤖 自动下注脚本 | 平注 / 马丁 / 反马丁 / 目标倍率四种策略 + 三层熔断 | | 👁️ 观战模式 | 旁观他人对局，下注槽锁定，只看不赌 | | 🏆 赛季排行榜 | 按赛季统计净盈利，跨重启持久化 | | 🎖️ 成就系统 | 场次 / 单笔 / 净盈利 / 结算倍率四类触发 | | 💎 多货币 | Vault / 经验 / PlayerPoints / TokenManager / CustomShop | | 🇨🇳 全中文 | 配置与提示全中文，MiniMessage 双语 | --- ## 3. 安装与依赖 ### 3.1 基础安装 1. 把 `WarZBustaMine-2.0.0.jar` 丢进服务端的 `plugins/` 文件夹。 2. 启动一次服务端，插件会自动生成 `plugins/WarZBustaMine/` 目录与 `default` 房间、SQLite 数据库。 3. 重启或 `/wbm reload` 即可生效。 > 单 jar 即开即用，**默认用 SQLite，无需任何前置插件**。 ### 3.2 可选依赖（按需安装） | 插件 | 作用 | 软依赖 | |---|---|---| | **Vault** | 提供金币货币（最常用） | softdepend | | **EssentialsX** | 作为 Vault 的经济后端（金币实际存这里） | 经 Vault | | **PlaceholderAPI** | 在外部版面显示房间倍率 / 状态 / 玩家盈亏 / 种子哈希 | softdepend | | **PlayerPoints** | 用「点券」作为货币 | softdepend | | **TokenManager** | 用 TokenManager 货币 | softdepend | | **CustomShop** | 用 WarZ 系列自定义货币（如 `kr`） | softdepend | > 装了哪个，对应货币才可用；没装就自动跳过，不会报错。 ### 3.3 Folia 服务端特别说明 - 插件已在 `plugin.yml` 声明 `folia-supported: true`，Folia 会正常加载。 - **Folia 兼容性坑**：部分旧版经济插件自身不兼容 Folia（例如 EssentialsX 2.21.0 的 `scheduleSyncDelayedTask` 在 Folia 上会抛错，导致 Vault 经济后端整体失效）。 - 表现：日志出现 `Vault economy not found: vault-currency rooms will reject bets`。 - 解决：改用 **PlayerPoints 货币**（装 PlayerPoints 即可正常下注），或等经济插件发布 Folia 兼容版。 --- ## 4. 快速开始 ### 4.1 服主三步开张 | 步骤 | 操作 | |---|---| | ① 丢进 plugins 重启 | 单 jar 放入 `plugins/` 重启，默认生成 `default` 房间 + SQLite | | ② 按需调房间 | 复制 `rooms/default.yml` 改名即开新房间；调倍率曲线、下注档位、抽水、风控、货币 | | ③ 开公平与展示 | `config.yml` 里 `fair.enabled` 保持 `true`；告诉玩家用 `/wbm verify` 自验、`/wbm display` 开展示条 | > 想接 MySQL：改 `storage.yml` 的 `type: mysql`。想从旧版 BustaMine 导入数据：运行 `/wbm migrate legacy`。 ### 4.2 玩家三步上手 1. 输入 `/wbm` 打开房间界面，先看胜率面板和倍率曲线心里有数。 2. 点下注按钮 或 `/wbm bet <房间> <金额>` 押上本金，倍率开始往上爬。 3. 在爆掉之前点 **Cash Out** 取现；贪心多等，可能血本无归。 - 想挂机？`/wbm autocashout 2.0` 设自动取现，或 `/wbm autobet` 开脚本策略。 --- ## 5. 玩家命令大全 > 所有命令主入口是 `/wbm`，也可用别名 `/warzbm` 或 `/bustamine`。 > 大多数玩家命令只能在游戏内（作为玩家）使用；带 🔧 的是管理员命令。 | 命令 | 说明 | 权限 | |---|---|---| | `/wbm` | 打开默认房间界面（多个房间时打开选房界面） | 玩家 | | `/wbm open <房间>` | 打开指定房间界面 | 玩家 | | `/wbm bet <房间> <金额>` | 下注指定金额 | 玩家 | | `/wbm cashout` | 一键取现（所有房间里你自己的下注） | 玩家 | | `/wbm autocashout <x\|off>` | 设定/关闭「到达 ×x 自动取现」 | 玩家 | | `/wbm autobet <房间> <策略> [参数]` | 启动自动下注脚本 | 玩家 | | `/wbm autobet stop` | 停止自动下注 | 玩家 | | `/wbm spectate <房间>` | 进入观战模式 | 玩家 | | `/wbm display <bossbar\|actionbar\|off>` | 切换屏幕顶部展示条 | 玩家 | | `/wbm stats [玩家]` | 查看自己或他人的战绩 | 玩家 | | `/wbm top [类型]` | 全服排行（`NetProfit` / `NetProfit_Exp` / `GamesPlayed`） | 玩家 | | `/wbm verify <局号> [房间]` | 验算某局爆点是否公平 | 玩家 | | `/wbm season top\|info` | 赛季榜单 / 当前赛季信息 | 玩家 | | 🔧 `/wbm go <房间>` | 启动某房间 | 管理员 | | 🔧 `/wbm stop <房间>` | 停止某房间 | 管理员 | | 🔧 `/wbm reload` | 重载配置与存储 | 管理员 | | 🔧 `/wbm seed rotate` | 轮换服务端种子（公布旧种子） | 管理员 | | 🔧 `/wbm bankroll <give\|take\|set> <货币> <金额>` | 调整资金池 | 管理员 | | 🔧 `/wbm migrate legacy` | 从旧版 BustaMine 导入数据 | 管理员 | | 🔧 `/wbm test [局数]` | 跑爆点分布自检（默认 10 万局） | 管理员 | | `/wbm help` | 查看命令帮助（按权限显示玩家/管理员两部分） | 全部 | ### 自动下注命令的写法 ```text /wbm autobet <房间> flat <本金> # 平注：每局固定本金 /wbm autobet <房间> target <本金> <取现倍率> # 目标倍率：达到 ×倍率才取现 /wbm autobet <房间> martingale <本金> <倍投系数> <取现倍率> # 马丁倍投 /wbm autobet <房间> anti <本金> <倍投系数> <取现倍率> # 反马丁 /wbm autobet <房间> preset <预设名> # 加载 scripts/ 下的预设 /wbm autobet stop # 停止 ``` 示例：用经典马丁预设开自动下注 ```text /wbm autobet default preset martingale ``` --- ## 6. 玩法详解 ### 6.1 一局怎么跑 1. **下注阶段**：倒计时 `round-interval-seconds`（默认 6 秒）内，玩家点下注按钮或 `/wbm bet` 押注。下注后头像出现在面板，附金额与实时倍率。 2. **爬升阶段**：倍率从 `×1.00` 起每 `curve.tick-interval` tick 增长一段（增长曲线见[房间配置](#182-房间配置-roomsdefaultyml)）。实时倍率每 4 tick 刷新一次。 3. **取现**：爬升途中随时点绿色按钮结算，按**当前倍率 × 本金**立刻到账。错过只能等爆。 4. **爆点（BUST）**：倍率到达本局爆点后状态切为 `BUST`，所有未结算下注归零，红屏 + 音效提醒。之后进入 `cooldown-seconds`（默认 3 秒）冷却，再开下一局。 ### 6.2 爆点是怎么来的 爆点 = 服务端种子 + 玩家种子 + 局号，经 HMAC-SHA256 推算出一个 1/100 倍率整数（如 `155` = `×1.55`），且**永不超过房间 `max-multiplier`**。 抽水（house-edge，默认 1%）决定了分布：理论上约 **1% 瞬间爆（×1.00）**、约 **49.5% 能到 ×2 以上**、约 **9.9% 能到 ×10 以上**（可用 `/wbm test` 自检验证）。 ### 6.3 胜率面板 & 历史记录 - **胜率面板**：显示 ×2 / ×3 / ×7 / ×12 等档位的实时爆率与当前最大倍率。 - **历史记录**：最近若干局爆点，红色=亏损、绿色=盈利，一眼看清走势。 ### 6.4 真·爆点长这样  > 倍率封顶切 `BUST`，未结算下注全归零（红屏 + 音效）。 --- ## 7. 图形界面（GUI）说明 打开 `/wbm` 后看到的主面板分为几块： | 区域 | 作用 | |---|---| | 下注头部 | 点下注档位或命令下注后，对应玩家头像出现，附金额与倍率；倍率每 4 tick 跳动 | | 立即结算 | 绿色按钮，倍率爬升时点击按当前倍率到账（如 ×1.39 锁盈） | | 爆炸状态 | 倍率封顶后切 BUST，红屏提示，未结算归零 | | 胜率面板 | ×2/×3/×7/×12 实时爆率 + 最大倍率 | | 历史记录 | 最近若干局爆点，红亏绿盈 | | 自动结算 | ± 按钮设定倍率，到点自动锁盈（配合自动下注脚本） |    --- ## 8. 可验证公平 这是本插件的核心卖点：**公平不是嘴上说，是能当众复现的。** ### 8.1 算法 采用业界通用的 **bustabit 公式（HMAC-SHA256）**： - 服务端持有一个 `serverSeed`（哈希对外公开，种子本身在轮换前保密）。 - 每局由 `serverSeed` + 玩家 `clientSeed` + 局号 `nonce` 经 HMAC-SHA256 推算出爆点。 - 抽水 `house-edge` 决定分布形态。 ### 8.2 玩家当场验算 对局结束后： ```text /wbm verify <局号> [房间] ``` 会显示：种子哈希、服务端种子（轮换后公开）、玩家种子、局号，以及**复算结果**。如果存档爆点与复算不一致，会直接标红 `MISMATCH`。 > 注意：使用 **YAML 存储**时 `/wbm verify` 不支持（会提示 `verify.not-supported-yaml`）；请用 SQLite 或 MySQL。 ### 8.3 服主轮换种子 ```text /wbm seed rotate ``` 公布旧种子、更换新种子，避免长期复用同一序列的疑虑。聊天会回显 `Revealed: <旧种子>` 与 `New hash: <新哈希>`。 ### 8.4 开关 `config.yml`： ```yaml fair: enabled: true # false 则回退到不可验证的旧分布（灵活兜底） ``` --- ## 9. 自动下注脚本 挂机也能按纪律玩，避免情绪上头。 ### 9.1 四种策略 | 策略 | 写法 | 含义 | |---|---|---| | `flat` 平注 | `flat <本金>` | 每局固定本金 | | `target` 目标倍率 | `target <本金> <取现x>` | 达到指定倍率才取现 | | `martingale` 马丁 | `martingale <本金> <系数> <取现x>` | 输了按系数倍投，赢回本 | | `anti` 反马丁 | `anti <本金> <系数> <取现x>` | 赢了才加注，输了减注 | ### 9.2 预设 `scripts/` 目录放好预设（如经典马丁 `martingale.yml`），一键加载： ```text /wbm autobet default preset martingale ``` 预设文件示例（`scripts/martingale.yml`）： ```yaml strategy: martingale base-bet: 10 factor: 2.0 auto-cashout: 2.0 # 固定自动取现倍率；0 = 用你的 /wbm autocashout 设定 stop-loss: 5000 # 亏损达到即停（0 = 关） take-profit: 0 # 盈利达到即停（0 = 关） max-rounds: 200 # 最多跑多少局（0 = 关） max-consec-loss: 8 # 连续亏损达到即停（0 = 关） ``` ### 9.3 三层熔断（保护资金） 1. **房间层**：房间 `max-bet` 封顶，单笔下注不超此值。 2. **个人层**：脚本的 `stop-loss`（止损）/ `max-consec-loss`（连亏上限）/ `take-profit`（止盈）触发即停。 3. **全局层**：`config.yml` 的 `autobet.max-bet-cap`（默认 100000）硬上限，任何自动下注都不超。 超限自动停，钱袋更安全。 --- ## 10. 观战模式 ```text /wbm spectate <房间> ``` 进入旁观：下注槽显示为**屏障图标**并拦截点击，界面正常展示倍率与结算，只看不赌。适合主播、管理巡场、或单纯想看别人心跳。  --- ## 11. 赛季排行榜 `seasons.yml` 开启赛季后，按**净盈利**持久化统计（跨重启不丢）： ```text /wbm season top # 看榜单（前 10） /wbm season info # 当前赛季信息 ``` 配置（`seasons.yml`）： ```yaml current: s1 # 留空则关闭赛季 seasons: s1: name: "Season 1" start: 0 # 纪元毫秒，仅展示用（不自动启停） end: 0 ``` --- ## 12. 成就系统 达成立即弹提示并播放升级音效。声明式配置在 `achievements.yml`，触发类型有四种： | 触发类型 | 含义 | 内置成就示例 | |---|---|---| | `GAMES` | 总场次达标 | 初出茅庐（1 局）、身经百战（500 局） | | `NET_PROFIT` | 累计净利润达标 | 盆满钵满（100000） | | `SINGLE_BET` | 单笔下注达标 | 一掷千金（10000） | | `CASHOUT_MULT` | 在某倍率及以上结算 | 直冲云霄（×50） | 成就配置示例： ```yaml achievements: moonshot: name: "<gold>直冲云霄" description: "<gray>在 x50 或更高倍率结算" trigger: CASHOUT_MULT goal: 50 ``` > 成就名/描述支持 `<gold>`、`<gray>` 等颜色代码。 --- ## 13. VIP 等级 `vip.yml` 配置权限组，在线即时生效： | 等级 | 权限节点 | 下注上限 | 结算加成 | |---|---|---|---| | VIP | `warzbustamine.vip.vip` | 房间 `max-bet` ×2 | +1% | | SVIP | `warzbustamine.vip.svip` | 房间 `max-bet` ×5 | +2% | 配置（`vip.yml`）： ```yaml tiers: vip: permission: warzbustamine.vip.vip max-bet-multiplier: 2.0 payout-bonus-percent: 1 svip: permission: warzbustamine.vip.svip max-bet-multiplier: 5.0 payout-bonus-percent: 2 ``` > 规则：玩家**持有的第一个匹配权限的层级**生效（先 vip 后 svip）。 --- ## 14. 多货币 房间 `currency` 字段决定本房间用哪种货币结算。默认示例用 `vault`（金币）或 `exp`（经验）： ```yaml currency: vault # vault | exp ``` 插件内置的货币提供方： | 货币 | 来源 | 启用条件 | |---|---|---| | `vault` | Vault + 经济后端（如 EssentialsX） | 装 Vault | | `exp` | 玩家经验值 | 内置 | | `playerpoints` | PlayerPoints 点券 | 装 PlayerPoints | | `tokenmanager` | TokenManager | 装 TokenManager | | `customshop:<id>` | CustomShop 自定义货币 | 装 CustomShop 并在 `config.yml` 登记 | `config.yml` 登记 CustomShop 货币： ```yaml economy: customshop: currencies: [] # 例如 ["kr"]，房间写作 currency: customshop:kr ``` 资金池风控：每个房间设 `risk.max-payout-per-round`（每局最高赔付）与 `risk.pause-threshold`（资金池低于此值自动暂停），赔付超限按比例缩放并广播，保护服主资金池。 --- ## 15. 展示条（BossBar / ActionBar） 对局信息常驻屏幕顶部： ```text /wbm display bossbar # 顶部 BossBar 进度条式展示 /wbm display actionbar # 屏幕下方 ActionBar 文本展示 /wbm display off # 关闭 ``` > 1.12 客户端也能正常显示 ActionBar（插件用兼容写法）。 --- ## 16. 管理员命令 > 均需 `warzbustamine.admin` 权限（默认 OP）。 | 命令 | 作用 | |---|---| | `/wbm go <房间>` | 启动某房间 | | `/wbm stop <房间>` | 停止某房间 | | `/wbm reload` | 重载配置与存储（改了 yml 后不用重启） | | `/wbm seed rotate` | 轮换服务端种子，公布旧种子 | | `/wbm bankroll <give\|take\|set> <货币> <金额>` | 调整资金池（货币：`vault`/`exp`/`playerpoints`/`tokenmanager`） | | `/wbm migrate legacy` | 从旧版 BustaMine 导入玩家数据 | | `/wbm test [局数]` | 跑爆点分布自检（默认 10 万局），验证抽水与概率 | 资金池查看示例： ```text /wbm bankroll set vault 1000000 # 把金币资金池设为 100 万 /wbm bankroll give exp 50000 # 经验资金池加 5 万 ``` --- ## 17. 权限节点 | 权限节点 | 默认 | 说明 | |---|---|---| | `warzbustamine.play` | 所有人 | 允许参与游戏 | | `warzbustamine.admin` | OP | 管理命令：go / stop / reload / seed / bankroll / migrate / test | | `warzbustamine.admin.alerts` | OP | 接收资金池 / 风控告警 | | `warzbustamine.vip.vip` | 否 | VIP：下注上限 ×2、结算 +1% | | `warzbustamine.vip.svip` | 否 | SVIP：下注上限 ×5、结算 +2% | > 房间还可单独设 `permission` 字段，限制只有特定权限的玩家能进该房间（留空 = 所有人可进）。 --- ## 18. 配置文件详解 插件数据在 `plugins/WarZBustaMine/` 下： ```text plugins/WarZBustaMine/ ├── config.yml # 全局配置 ├── storage.yml # 存储引擎 ├── vip.yml # VIP 等级 ├── seasons.yml # 赛季 ├── achievements.yml # 成就 ├── rooms/ │ └── default.yml # 房间配置（复制改名 = 新房间） ├── scripts/ │ └── martingale.yml # 自动下注预设 ├── lang/ │ ├── zh_CN.yml # 中文消息 │ └── en_US.yml # 英文消息 └── WarZBustaMine.db # SQLite 数据库（用 SQLite 时） ``` ### 18.1 全局配置（`config.yml`） ```yaml language: zh_CN # 默认语言文件（lang/ 下），优先用玩家客户端语言 default-room: default # /wbm 无参时打开的房间 fair: enabled: true # 可验证公平开关（false = 不可验证旧分布） bstats-id: 0 # bStats 统计 ID（0 = 关闭） currency-symbol: "$" # Vault 货币符号 economy: customshop: currencies: [] # CustomShop 货币 id 列表 update-check: enabled: false # 更新检查（Modrinth） modrinth-project-id: "" gameplay: one-room-per-player: true # 同一玩家同时只能在一个房间有活跃下注 autobet: max-bet-cap: 100000 # 自动下注全局硬上限（三层熔断第 3 层） render: multiplier-interval-ticks: 4 # 倍率帧刷新间隔 players-interval-ticks: 20 # 下注者头像列表刷新间隔 viewers-per-tick: 25 # 每 tick 最多渲染的观众数（分片） sounds: # 音效（XSound 风格名，空串 = 静音） bet: ENTITY_PAINTING_PLACE cashout: ENTITY_EXPERIENCE_ORB_PICKUP bust: ENTITY_PLAYER_HURT click: UI_BUTTON_CLICK ``` ### 18.2 房间配置（`rooms/default.yml`） 文件名即房间 ID。复制改名即开新房间。 ```yaml currency: vault # vault | exp（及其他已启用货币） round-interval-seconds: 6 # 每局下注倒计时（秒） cooldown-seconds: 3 # 爆点后到下一局开始的冷却（秒） max-multiplier: 100 # 倍率硬上限（爆点永不超过此值） house-edge: 0.01 # 抽水比例（0.01 = 1%），决定爆点分布 bet-tiers: [10, 100, 1000] # GUI 下注档位（3 档） max-bet: 5000 # 每局每玩家最大下注 min-bet: 1 # 最小下注 curve: # 倍率增长曲线（分段） tick-interval: 4 # 每隔多少 tick 增长一次 brackets: # 倍率低于 below 时，每次增长 step（单位 1/100 倍） - { below: 115, step: 1 } # < ×1.15：每次 +×0.01 - { below: 180, step: 2 } - { below: 360, step: 4 } - { below: 720, step: 8 } - { below: 1440, step: 16 } - { below: 999999999, step: 32 } permission: "" # 进入本房间所需权限（空 = 所有人） risk: max-payout-per-round: 1000000 # 每局最高赔付，超额缩放并广播 pause-threshold: 0 # 资金池低于此值自动暂停（0 = 不暂停） broadcast: jackpot-multiplier: 30 # 达到该倍率的爆点全服广播 instabust: true # 瞬间爆（×1.00）是否广播 ``` ### 18.3 其他配置文件 - **`vip.yml`**：见 [VIP 等级](#13-vip-等级)。 - **`achievements.yml`**：见 [成就系统](#12-成就系统)。 - **`seasons.yml`**：见 [赛季排行榜](#11-赛季排行榜)。 - **`scripts/*.yml`**：见 [自动下注脚本](#9-自动下注脚本)。 --- ## 19. 数据存储与迁移 ### 19.1 三种存储引擎（`storage.yml`） ```yaml type: sqlite # sqlite | mysql | yaml mysql: host: localhost port: 3306 database: warzbustamine user: root password: "" pool-size: 4 queue: flush-interval-ms: 2000 batch-size: 200 ``` | 引擎 | 适用 | 备注 | |---|---|---| | `sqlite` | 默认、小服 | 开箱即用，单文件 `WarZBustaMine.db` | | `mysql` | 大服 / 多服 | 带连接池，需填账号密码 | | `yaml` | 兼容 / 调试 | 注意：**YAML 下 `/wbm verify` 不可用** | ### 19.2 从旧版 BustaMine 迁移 老服换插件不丢档： ```text /wbm migrate legacy ``` 会异步导入旧版玩家数据，收尾提示 `Migrated N players.`。 --- ## 20. 常见问题（FAQ） **Q：提示 `Vault economy not found`，下注被拒？** A：Vault 经济后端没就绪。常见于 Folia + 不兼容的 EssentialsX。先装 PlayerPoints 用作货币，或换 Folia 兼容的经济插件。日志也会提示 `PlayerPoints currency hooked` 表示可用。 **Q：`/wbm verify` 说不支持？** A：你用的是 YAML 存储，YAML 不支持验算。改用 SQLite 或 MySQL（`storage.yml` 的 `type`）。 **Q：Folia 上插件加载失败 / 报不支持？** A：确认 `plugin.yml` 含 `folia-supported: true`（本插件已含）。若由前置于经济插件报错导致，见上一题。 **Q：自动下注没反应？** A：检查三层熔断——房间 `max-bet`、脚本的 `stop-loss`/`max-consec-loss`、全局 `autobet.max-bet-cap`。任一触发都会自动停。 **Q：怎么加新房间？** A：复制 `rooms/default.yml` 改名为 `rooms/xxx.yml`，重启或 `/wbm reload`。 **Q：消息想改成自己的风格？** A：直接改 `lang/zh_CN.yml`（或 `en_US.yml`），改完 `/wbm reload` 即可，无需重新编译。 **Q：1.12 客户端看不到表情/渐变？** A：本插件消息刻意只用 `§` 颜色码与基础符号（✔✘★），不用 emoji 和 MiniMessage 渐变，1.12 老客户端可正常显示。 --- ## 21. 更新与支持 - **作者**：Crazy_Jky - **版本**：v2.0.0 - **兼容**：Paper / Spigot / Folia，1.12 – 最新版 - **技术交流群**：QQ 群 `398893720` - **末日类服务器交流**：QQ 群 `1063544727` - **插件定制开发**：QQ `1285988665` - **支持作者**：爱发电 `https://afdian.com/a/sunjood` > 一份 jar 从 1.12 跑到 Folia，爆点能当众复算的 Crash 小游戏。配置、文案、货币都能按你的服调，有问题随时来聊。 --- *本文档基于 WarZBustaMine v2.0.0 源码与配置文件编写，命令、权限、配置项均与插件实际实现一致。* [/MD]