原创 付费 娱乐 欢乐斗地主（支持folia） 5.2.0

[MD] # 【插件】[娱乐] 欢乐斗地主 （可选craftengine支持） v5.2.2 —— 真实牌桌 · TextDisplay 立体界面 · 多桌同开 --- ## 基本信息 | 项目 | 内容 | |------|------| | 插件名称 | Doudizhu（欢乐斗地主） | | 当前版本 | 5.2.2 | | 作者 | fentai | | 适用核心 | Paper / Purpur / Folia 等（api-version 1.19） | | 测试版本 | 1.19.4 → 1.21.x | | JDK | 17+ | | 硬依赖 | **无** | | 软依赖 | CMI（可选，楼梯坐下动画） | | 语言 | 简体中文 | --- ## 插件wiki [/MD]
[MD] ## 简介 把经典 **三人斗地主** 搬进 Minecraft：在方块搭的牌桌上，用 **TextDisplay** 画出立体手牌、出牌区、中心全息与按钮，点选出牌、叫/抢地主，支持 **多牌桌同时开打**，支持语音包，支持天地癞子玩法。 支持分桌vault赌注玩法，允许你自制牌皮用于服务器增值玩法。 支持语音包，包售后包更新。 不依赖 NoteBlockAPI、DecentHolograms 等第三方 UI/音乐插件；NBS 背景音乐与展示逻辑均内置，丢进 `plugins` 即可用。 适合生存服、小游戏厅、活动区——摆一张桌，就能开一局。 --- ## 主要特色 ### 游戏体验 - **标准三人斗地主**：叫/抢地主、出牌/不出、提示、超时托管 - **完整牌型**：单/对/三带、顺子、连对、飞机、四带二、炸弹、王炸 - **春天 / 反春天** 判定与中心飘字特效 - **催促**：点对手区「催促」或 `/ddz urge`，随机口语文案 - **倒计时**：叫地主 / 出牌独立超时，可配置警告音效 ### 画面与交互 - **按座位朝向** 的独立 UI（自己手牌仅本人可见，防透视） - 出牌区、剩余牌数、地主明牌、中心信息 - **手牌点选上浮**（插值动画，减少闪烁） - 加入 / 退出 / 叫地主 / 出牌 / 不出 / 提示 / 催促 均可点击 - 炸弹等特效：**粒子烟花**（不生成可炸人的烟花实体） - 可配置 **旁观者是否可见牌局**（手牌始终仅本人） ### 牌桌与多桌 - 首先你准备一个这样的桌子 [/MD]

[MD] - `/ddz create <牌桌名>` 对准方块一键建桌，支持 **命名多桌** - 桌面结构参数可配（木板、楼梯、尺寸、是否可破坏） - 可选 **CMI 坐楼梯**，更有「围桌打牌」感 - 开服延迟加载 + 强制加载区块，减少重启后全息丢失 ### 音效与音乐 - 出牌 / 炸弹 / 胜利 / 倒计时 / 催促 音效可配 - **内置 NBS 解析与播放**，附带两首默认曲，无需 NoteBlockAPI ### 可调参 - `first / second / third-left / third-right / hologram / table / config` 分区 YAML - `/ddz preview` 静态预览，方便对齐布局 --- ## 演示视频 [/MD]
[MD] --- ## 安装 1. 使用 **Paper 1.19.4+**（或兼容分支），**Java 17+** 2. 将 `doudizhu-5.2.0.jar` 放入 `plugins/` 3. （可选）安装 **CMI** 并保证玩家有坐下相关权限，体验更好 4. 启动 / 重载后，OP 对准桌面中心方块： ``` /ddz create 一号桌 ``` 5. 玩家走到桌边，点中心绿色 **「加入斗地主」**，或： ``` /ddz join ``` 三人坐满自动开局。 --- ## 命令 主命令：`/doudizhu`，别名：`/ddz` ### 玩家（默认权限 `doudizhu.play`） | 命令 | 说明 | |------|------| | `/ddz join` | 加入附近牌桌 | | `/ddz leave` | 离开牌桌 | | `/ddz urge` | 催促当前应出牌玩家 | 也可在全息/按钮上直接点击完成加入、出牌、催促等。 ### 管理（`doudizhu.admin`，默认 OP） | 命令 | 说明 | |------|------| | `/ddz create <名字>` | 对准方块创建牌桌 | | `/ddz remove [名字]` | 移除牌桌（可省略为最近） | | `/ddz list` | 列出全部牌桌 | | `/ddz reload` | 重载配置并刷新渲染 | | `/ddz preview <on\|off>` | 静态调参预览 | --- ## 权限 | 权限 | 默认 | 说明 | |------|------|------| | `doudizhu.play` | true | 加入 / 退出 / 催促 | | `doudizhu.admin` | op | 建桌 / 删桌 / 重载 / 预览 | | `doudizhu.*` | op | 全部 | --- ## 配置速览 数据目录：`plugins/Doudizhu/` | 文件 | 作用 | |------|------| | `config.yml` | 流程、音效、座位角、消息、催促文案、旁观可见等 | | `table.yml` | 三座位整体偏移与朝向 | | `first.yml` | 自己的手牌区 | | `second.yml` | 操作按钮 / 自己出的牌 | | `third-left.yml` / `third-right.yml` | 左右对手区、剩余牌、催促 | | `hologram.yml` | 中心全息（加入、地主、底牌、结果） | | `tables.yml` | 已创建牌桌坐标（自动生成） | | `song/*.nbs` | 背景音乐（已打进 jar，也可放数据目录） | ### 常用项（`config.yml`） ```yaml table: allow-break: false # 是否允许破坏牌桌核心方块 seats: angles: [0.0, 135.0, 225.0] # 三座位朝向，需与 table.yml 一致 cmi-sit: true # CMI 坐楼梯 game: bid-timeout: 15 play-timeout: 30 urge-cooldown: 10 spectator-visible: true # 旁观者是否看得见牌局（手牌仍仅本人） music-gap-seconds: 5 ``` 改完执行 `/ddz reload`。 --- ## 游玩流程（给玩家看） 1. 走到牌桌，点 **加入斗地主**（或 `/ddz join`） 2. 三人到齐 → 发牌 → **叫/抢地主** 3. 地主亮三张底牌，轮流 **点选手牌 → 出牌 / 不出** 4. 可用 **提示**；等不及可点对面 **催促** 5. 有人出完 → 地主胜 / 农民胜；春天有特殊提示与烟花粒子 6. 不想打了：等待阶段点红色 **退出**，或 `/ddz leave` --- ## 常见问题 **Q：重启后全息没了？** A：插件会延迟加载并强制加载区块。若仍异常，执行一次 `/ddz reload`，并确认世界/区块正常。 **Q：坐不下去 / 站着打牌？** A：检查是否装了 CMI、`seats.cmi-sit` 是否为 true，以及 CMI 坐下权限；关掉 CMI 时仍可传送到座位位置。 **Q：旁观者能看见我的手牌吗？** A：**不能。** 手牌仅本人可见。`spectator-visible` 只控制出牌区、剩余张数、中心信息等公开内容。 **Q：和某某全息/音乐插件冲突吗？** A：展示与 NBS 均为自研实现，**不依赖** NoteBlockAPI / DH 等；一般不抢同一套 API。 **Q：可以同时开很多桌吗？** A：可以，每桌独立状态与渲染，用不同名字 `create` 即可。 **Q：会炸伤玩家吗？** A：胜利/炸弹用的是 **粒子模拟烟花**，不生成伤害性烟花实体。 --- ## 注意事项 1. 需要支持 **Display 实体** 的版本（1.19.4+ 推荐） 2. 牌桌区域建议限制建筑权限，或保持 `allow-break: false` 3. 首次调参建议用 `/ddz preview on`，对齐后再正式开桌 4. `table.yml` 座位角与 `config.yml` 的 `seats.angles` 请保持一致，避免「人坐这边、UI 朝那边」 --- ## 更新日志（摘要） ### v5.2.2 新增按桌开关欢乐豆与独立倍率。 修复余额不足仍可入桌，只有赢家受伤。 新增胜场排行榜及 PlaceholderAPI 变量。 新增手动托管、三秒决策及取消托管。 取消超时自动进入托管。 修复玩家可同时加入多桌。 全员不抢地主时自动洗牌重发。 新增发牌动画及不出牌回弹动画。 新增锁座、免伤和离桌托管保护。 修复删除牌桌后残留悬浮文字。 优化牌型三秒全息特效及地主胜利重复文字。 加入可配置邀请广播、旁观完整手牌和精简消息模式。 新增 CraftEngine 斗地主语音包及音效播放范围。 新增可售卖自定义牌皮系统与玩家切换指令。 默认大小王图片字符仅在安装 CraftEngine 时启用。 --- ## 反馈 使用问题、建议、BUG 欢迎跟帖，或联系作者。 请尽量附上：**核心版本、插件版本、相关配置、报错日志**。 --- ## 声明 - 插件名：Doudizhu - 作者：fentai - 仅供学习与服务器娱乐，请勿用于任何违法用途 - 转载请注明作者与来源 --- **对准方块 → `/ddz create` → 三人入座 → 开始斗地主。** 祝各位天天地主，把把春天。 [/MD]