原创 付费 骗子酒馆和掼蛋插件 v2.5.2 支持Folia 5.2.2

[MD] # Guandan｜在 Minecraft 里玩掼蛋与骗子酒馆｜Paper / Folia > 本文可直接作为 MineBBS 资源介绍使用。 > 推荐短简介：四人经典掼蛋与骗子酒馆二合一插件，支持实体牌桌、经济结算、排行榜、托管及 Paper/Folia。 --- ## 插件介绍 **Guandan** 是一款运行在 Minecraft Java 版服务器中的四人桌游插件。 玩家不需要打开网页，也不需要离开服务器。加入牌桌后，手牌、公共信息、倒计时和操作按钮都会直接显示在 Minecraft 游戏内。 插件内置两套玩法： - **经典掼蛋**：两副牌、四人组队、逢人配、炸弹与升级规则。 - **骗子酒馆**：暗牌叫牌、真假质疑、六发左轮淘汰。 骗子酒馆不是需要另行购买或安装的附属插件，创建牌桌时选择对应模式即可。 完整中文 Wiki：[https://fentaiiii.github.io/wiki/docs/guandan](https://fentaiiii.github.io/wiki/docs/guandan) --- ## 经典掼蛋 经典模式使用两副扑克牌，共 108 张，四名玩家每人 27 张。对家组成一队，目标是在队友配合下争取更高游次。 ### 已实现内容 - 四人两队，对家为队友； - 初始打 2，最高打 A； - 当前红桃级牌作为“逢人配”； - 支持单张、对子、三张、三带二、顺子、连对、飞机、钢板等常见牌型； - 支持普通炸弹、同花顺和四王炸； - 支持上游、二游、三游、末游结算； - 根据双下、单下等结果自动升级； - 队伍阵容改变后自动重置级数，避免继承其他玩家的进度。 详细规则：[经典掼蛋规则](https://fentaiiii.github.io/wiki/docs/guandan/Classic-Mode) --- ## 骗子酒馆 骗子酒馆是一套独立的四人淘汰玩法。 每轮会从 Q、K、A 中随机确定一种目标牌。玩家可以扣下 1～3 张牌，并声称这些牌都是本轮目标牌。下一名玩家可以继续出牌，也可以选择质疑上一家。 - 上一家说谎：上一家接受左轮判定； - 上一家没有说谎：质疑者接受左轮判定； - Joker 始终可以当作真实目标牌； - 只剩最后一名存活玩家时获胜。 每名玩家拥有独立的六发左轮弹仓。配置开启真实死亡后，命中实弹的玩家会在 Minecraft 中死亡并离开牌桌；关闭后只进行游戏内淘汰。 为避免泄露信息，其他玩家和旁观者无法查看尚未翻开的暗牌。骗子酒馆默认全程静音，不会误播放经典掼蛋语音。 详细规则：[骗子酒馆模式](https://fentaiiii.github.io/wiki/docs/guandan/Liars-Bar-Mode) --- ## 主要功能 - 游戏内实体牌桌，无需网页客户端； - 四人坐齐后自动开始； - 手牌仅本人可见，公开信息按规则显示； - 支持出牌倒计时、催促和自动托管； - 支持掉线托管，玩家回到桌边后可以重新接管； - 支持旁观及私牌保护； - 支持 Vault 或 PlayerPoints 经济结算； - 支持 PlaceholderAPI 个人数据和排行榜； - 支持 CraftEngine / ItemsAdder 资源牌面； - 支持 GSit / CMI 坐下效果； - 支持 Paper 与 Folia。 --- ## 经济与排行榜 服主可以保留普通休闲桌，也可以只给指定牌桌开启经济玩法。 ```text /gd economy 〈桌名〉 on [倍率] [vault|playerpoints] /gd economy 〈桌名〉 off ``` 经典掼蛋按获胜队伍结算，骗子酒馆由最后存活的玩家获得整桌奖池。插件会记录交易过程，降低玩家中途退出或余额变化造成的结算问题。 安装 PlaceholderAPI 后，可以显示总场次、胜场、负场、胜率、名次以及经典掼蛋和骗子酒馆的分模式排行。 详细说明： - [经济系统](https://fentaiiii.github.io/wiki/docs/guandan/Economy-and-Vault) - [Placeholder 与排行榜](https://fentaiiii.github.io/wiki/docs/guandan/Placeholders-and-Leaderboards) --- ## 兼容与依赖 | 项目 | 说明 | | --- | --- | | 服务端 | Paper / Folia | | Bukkit API | 1.19 | | Java | 插件编译目标为 Java 17；实际版本还需满足服务端核心要求 | | 必装依赖 | 无 | | 可选依赖 | GSit、CMI、Vault、PlayerPoints、PlaceholderAPI、CraftEngine、ItemsAdder | 没有安装可选依赖时，核心玩法仍可运行；对应的坐下、经济、排行榜或资源牌面功能会自动停用或回退。 Vault 本身不是经济插件。使用 Vault 结算时，服务器还需要安装一个兼容 Vault Economy 的经济插件。 --- ## 安装方法 1. 停止服务器。 2. 将 Guandan 插件 JAR 放入服务器的 `plugins/` 目录。 3. 启动服务器，等待插件生成默认配置。 4. 按需要安装经济、坐下、排行榜或资源包插件。 5. 搭建牌桌后，由管理员对准中心方块创建牌桌。 创建经典掼蛋牌桌： ```text /gd create classic 〈桌名〉 ``` 创建骗子酒馆牌桌： ```text /gd create liarsbar 〈桌名〉 ``` 四名玩家加入： ```text /gd join 〈桌名〉 ``` 不填写桌名时，插件会尝试加入附近的牌桌。 第一次安装建议直接按照 Wiki 操作：[安装与依赖](https://fentaiiii.github.io/wiki/docs/guandan/Installation) --- ## 常用指令 ### 玩家指令 | 指令 | 用途 | | --- | --- | | `/gd join [桌名]` | 加入指定或附近牌桌 | | `/gd leave` | 离开牌桌；局内按配置转为托管 | | `/gd trustee` | 主动托管 | | `/gd return` | 回到桌边后取消托管 | | `/gd urge` | 催促当前行动玩家 | | `/gd skin [牌皮ID|reset]` | 查看、切换或重置牌面 | ### 管理员指令 | 指令 | 用途 | | --- | --- | | `/gd create classic 〈桌名〉` | 创建经典掼蛋牌桌 | | `/gd create liarsbar 〈桌名〉` | 创建骗子酒馆牌桌 | | `/gd economy 〈桌名〉 〈on|off〉 [倍率] [vault|playerpoints]` | 设置单桌经济模式 | | `/gd stop 〈桌名〉` | 强制结束当前牌局 | | `/gd remove 〈桌名〉` | 删除牌桌 | | `/gd list` | 查看牌桌和状态 | | `/gd reload` | 重载配置 | `/guandan` 与 `/gd` 完全等价。 完整列表：[命令与权限](https://fentaiiii.github.io/wiki/docs/guandan/Commands-and-Permissions) --- ## 权限 | 权限 | 默认 | 说明 | | --- | --- | --- | | `guandan.play` | 所有玩家 | 加入、退出、托管、回归和催促 | | `guandan.admin` | OP | 创建、删除、强停、重载和布局调试 | | `guandan.skin.anthropic` | 无 | 使用 Anthropic 配色牌面 | | `guandan.*` | OP | Guandan 全部权限 | --- ## 适合哪些服务器 - 希望增加长期四人桌游玩法的生存服或综合服； - 希望举办掼蛋活动、联赛或排行榜活动的服务器； - 想在同一张牌桌上提供经典竞技与轻量心理博弈玩法的服务器； - 需要经济入场、奖池结算或玩家长期统计的运营服； - 使用 Folia，同时希望桌游插件原生兼容区域线程的服务器。 --- ## 反馈问题前请准备 为了更快定位问题，请同时提供： 1. Minecraft 版本及 Paper/Folia 完整版本号； 2. Guandan 插件版本； 3. 使用的是经典掼蛋还是骗子酒馆； 4. 完整控制台报错，而不是只截最后一行； 5. 牌桌名称、参与人数和问题发生前的操作顺序； 6. 是否安装 Vault、PlayerPoints、PlaceholderAPI 或资源包插件。 请勿公开发送服务器密码、授权信息、玩家隐私数据或付费文件。 排障文档：[https://fentaiiii.github.io/wiki/docs/guandan/Troubleshooting](https://fentaiiii.github.io/wiki/docs/guandan/Troubleshooting) --- ## 相关链接 - [Guandan 完整 Wiki](https://fentaiiii.github.io/wiki/docs/guandan) - [快速开始](https://fentaiiii.github.io/wiki/docs/guandan/Quick-Start) - [玩家游玩指南](https://fentaiiii.github.io/wiki/docs/guandan/Player-Guide) - [配置总览](https://fentaiiii.github.io/wiki/docs/guandan/Configuration) - [FAQ](https://fentaiiii.github.io/wiki/docs/guandan/FAQ) 安装、指令、配置和玩法说明均以 Wiki 最新内容为准。 [/MD]