原创 付费 鲸鱼拼团 1.0

[MD] # 🐋 鲸鱼拼团 JYGroupBuying —— 拼单 · 团购 · 玩家开店，一套搞定 > 一套完整的「拼单 + 团购 + 玩家开店」交易系统：金币 / 点券 / 物品三种方式自由支付，限时确认防误操作，超时自动退款，全版本通用（1.12.2 ~ 1.21.x）。 --- ## 插件简介 - **插件名称**：JYGroupBuying / 鲸鱼拼团 - **适用服务器**：生存服、RPG 服、小游戏服、公益服 - **核心玩法**： - **拼单拼团**——多人凑单低价成团，满员发货，超时全员退款 - **团购券**——买券得券码，核销领奖励，未用随时退 - **玩家开店**——玩家自己开店上架物品，平台抽成、店铺可升级 --- ## 插件特点 | 功能 | 说明 | | --- | --- | | 拼单式拼团 | 开团 → 邀请码 → 参团 → 满员成团发货；超时未成团自动全员退款 | | 团购券 | 12 位券码，自助或管理员核销，支持多套餐「m 选 n」组合 | | 玩家开店 | 开店、上架（团购/拼单两种形态）、核销收款，店铺等级与手续费减免 | | 三选一支付 | 金币 / 点券 / 物品 任选，每个商品可单独设置各币种价格 | | 动态确认界面 | 确认界面按支付方式自动出按钮，点哪个按哪个扣款 | | 限时二次确认 | 所有支付先弹确认（30 秒），超时自动作废，防止误操作 | | 免拼卡 / 广播卷 | 免拼卡立即成团；广播卷全服拉人 | | 待取箱 | 离线发货、物品支付收入自动入箱，一键领取 | | 自动退款 | 超时、失败、未核销的订单按原支付方式自动退回 | | 限购防超卖 | 每人限购 + 库存动态计算，不会超卖 | | 音效系统 | 14+ 场景音效，支持原版音效和龙核客户端 ogg | | 交易账单 | 全链路交易记录，按日保存、自动清理旧日志 | | 数据存储 | YAML / MySQL / SQLite 三选一，数据一致可互相迁移 | | 全版本兼容 | 材质、音效、附魔跨版本自动映射，旧配置不用改 | --- ## 前置依赖 | 插件 | 用途 | 是否必须 | | --- | --- | --- | | Vault | 金币支付 | 需要金币支付时 | | PlayerPoints | 点券支付 | 需要点券支付时 | | PlaceholderAPI | 变量（如拼单进度、券数） | 可选 | | MythicMobs | MM 物品 / 奖励 | 可选 | | DragonCore | 客户端 ogg 音效 | 可选 | 未安装的依赖自动降级：金币不可用、点券不可用、MM 物品退回原版材质、ogg 音效跳过，插件照常运行。 --- ## 常用指令 ### 玩家指令 | 指令 | 说明 | | --- | --- | | `/jygb open` | 打开功能主界面 | | `/jygb pindan` | 打开拼单商城 | | `/jygb pindan create <商品ID>` | 开团（可加 freecard 用免拼卡立即成团） | | `/jygb pindan join <邀请码>` | 参团 | | `/jygb pindan quit <邀请码>` | 退出拼单（原路退款） | | `/jygb tuangou` | 打开团购商城 | | `/jygb tuangou buy <团购ID>` | 购买团购券 | | `/jygb tuangou use <券码>` | 核销团购券 | | `/jygb tuangou refund <券码>` | 退券 | | `/jygb shop create <店名>` | 开设玩家店铺 | | `/jygb market` | 打开集市（浏览 / 搜索商品） | | `/jygb market buy <商品ID>` | 购买商品 | | `/jygb chest` | 打开待取箱 | | `/jygb confirm` | 确认当前待支付订单 | ### 管理指令（需管理员权限） | 指令 | 说明 | | --- | --- | | `/jygb reload` | 重载全部配置 | | `/jygb admin panel` | 打开管理面板 | | `/jygb admin pindan force <邀请码>` | 强制成团发货 | | `/jygb admin pindan refund <邀请码>` | 强制退款 | | `/jygb admin tuangou give <玩家> <团购ID>` | 发放团购券 | | `/jygb admin tuangou verify <玩家> <券码>` | 核销团购券 | | `/jygb admin tuangou refund <玩家> <券码>` | 退团购券 | | `/jygb admin shop close <店铺ID>` | 关闭店铺 | | `/jygb admin shop ledger <店铺ID>` | 查看店铺账单 | | `/jygb admin givefreecard <玩家> <数量>` | 发放免拼卡 | | `/jygb admin inspect <玩家>` | 查看玩家数据 / 待取箱 | | `/jygb admin migrate <yaml\|mysql\|sqlite>` | 数据存储迁移 | --- ## 权限节点 | 权限 | 说明 | 默认 | | --- | --- | --- | | `jygroupbuying.use` | 使用基本指令 | 玩家 | | `jygroupbuying.pindan.create` | 发起拼单 | 玩家 | | `jygroupbuying.tuangou.buy` | 购买团购券 | 玩家 | | `jygroupbuying.freecard.use` | 使用免拼卡 | 玩家 | | `jygroupbuying.shop.create` | 开店 | 玩家 | | `jygroupbuying.shop.use` | 店铺管理 | 玩家 | | `jygroupbuying.market.use` | 集市浏览 / 搜索 | 玩家 | | `jygroupbuying.market.buy` | 集市购买 / 参团 / 退券 | 玩家 | | `jygroupbuying.reload` | 重载配置 | 管理员 | | `jygroupbuying.inspect` | 查看他人数据 / 待取箱 | 管理员 | | `jygroupbuying.admin` | 管理权限（发券 / 核销 / 关店 / 账单） | 管理员 | | `jygroupbuying.admin.force` | 强制成团 / 核销 / 退款 | 管理员 | --- ## 配置文件 首次启动自动生成全部配置文件，修改后 `/jygb reload` 即可生效（无需重启）。 | 文件 | 作用 | | --- | --- | | `config.yml` | 主配置：存储、支付、物品支付、手续费、交互方式 | | `products-pindan.yml` | 拼单商品配置（商品名可写中文） | | `products-tuangou.yml` | 团购商品配置（含多套餐组合） | | `playershop.yml` | 玩家开店：成本、手续费、店铺等级 | | `freecard.yml` | 免拼卡 / 广播卷 | | `sound.yml` | 音效（开关 + 音量 + 各场景音效） | | `messages.yml` | 全部提示文案 | | `gui/` | 各界面布局（按钮位置随便挪，功能不变） | > 支付方式三选一：平台商品在 `products-*.yml` 中配置每种支付方式的价格，有几个就支持几种；物品支付接受哪些物品在 `config.yml` 中配置。 --- ## 数据存储 - **YAML**（默认）：一玩家一文件，无需数据库 - **MySQL**：自动建表、支持中文，内置连接池 - **SQLite**：单文件存储 三种存储数据格式一致，随时可用指令互相迁移，换存储不丢数据。 --- ## 常见问题 **Q：改了配置怎么生效？** A：执行 `/jygb reload`（需管理员权限），商品、文案、界面、音效全部热加载，不用重启服务器。 **Q：拼单超时了怎么办？** A：超时未成团的拼单会自动给所有参与者原路全额退款，不用担心钱货两空。 **Q：退款收手续费吗？** A：拼单超时失败全额退款不收手续费；玩家中途主动退出可按配置收取少量手续费（物品支付全额退）。 **Q：券码 / 邀请码是什么格式？** A：团购券码 12 位、拼单邀请码 6 位，均为大写字母和数字，全局唯一。 **Q：多个玩家同时支付会冲突吗？** A：不会。每个玩家的待确认交易相互独立，确认、取消、超时互不影响。 **Q：支持哪些版本的服务器？** A：1.12.2 到 1.21.x 全版本通用，一份文件通吃，旧配置无需修改。 [ATTACH]145164[/ATTACH][ATTACH]145165[/ATTACH][ATTACH]145166[/ATTACH][ATTACH]145167[/ATTACH][ATTACH]145168[/ATTACH][ATTACH]145169[/ATTACH][ATTACH]145170[/ATTACH][ATTACH]145171[/ATTACH][ATTACH]145172[/ATTACH][ATTACH]145173[/ATTACH][ATTACH]145174[/ATTACH] [/MD]