原创 工具 娱乐 YiyunRedPacket | 支持群组的多功能红包插件 | 支持Folia | 1.21+ v1.0.0

[MD] # 🧧 逸云红包 · YiyunRedPacket > **把过年抢红包的那份热闹，搬进你的 Minecraft 服务器。** > > 金币红包、经验红包、物品礼包，单服即装即用，群组服跨服同抢。       --- ## ✦ 一眼看懂 | 🎁 四种玩法 | 🌐 跨服同抢 | 🖱️ 全图形界面 | | :-- | :-- | :-- | | 均分、拼手气、口令、物品红包，可以写祝福语、指定玩家领取 | A 服发出，B 服也能抢；不用装 Velocity 附属插件 | 发红包、抢红包、查记录、看排行，全在箱子菜单里点 | | **📣 聊天框大图公告** | **⏰ 定时红包与红包雨** | **🛡️ 账目安全** | | 聊天里弹出一个红包图案，点一下就能领 | 每天定点发福利，活动时一键下红包雨 | 重启不丢、过期自动退款、物品不会被复制 | --- ## 🧧 四种红包，各有各的玩法 | 类型 | 怎么玩 | 适合 | | :-- | :-- | :-- | | **普通红包** | 总额平均分成 N 份 | 发工资、发补贴 | | **拼手气红包** | 每份金额随机，结算时公布手气王 | 节日、活动，最热闹的玩法 | | **口令红包** | 领取的人要说对口令；可以公开口令、只给提示，或干脆不告诉别人 | 答题、暗号、整活 | | **物品红包** | 往格子里放物品，一格就是一份 | 开服礼包、抽奖、送装备 | 每个红包都可以加上： - ✉️ **祝福语**：领取时以屏幕大标题显示，详情页里就是红包封皮的标题 - 🎯 **专属对象**：只发给某位玩家，对方离线也会在上线后收到提醒 - ⏳ **有效期**：到期还没领完的部分自动退回发送者 - 💰 **两种货币**：可以用 Vault 经济（金币），也可以用原版经验 --- ## 🎁 物品红包：一格一份，自己装礼包 ``` 物品红包 · 一格一份 · 空手右键编辑 [木][钻][包][剑][ ][ ][ ][ ][ ] ← 每一格就是一份 [ ][ ][ ][ ][ ][ ][ ][ ][ ] ... [随][〓][－][拆][＋][〓][份][〓][〓] ← 发放方式 · 一键均分 · 份数 [返][祝][令][时][专][密][〓][发][？] ← 祝福 · 口令 · 有效期 · 专属 · 保密 · 发出 ``` - **放了几格就是几份**：拖进去或 Shift 点击就能放入，原版的拖动均分操作也能用 - **🎀 礼包**：空手右键某一格，可以在这一份里装进多种物品（最多 18 格），领到的人一次拿走整份 - **⚖️ 一键均分**：把一堆物品按种类平均分成 N 份；分不匀时会先告诉你哪几份缺什么，再点一次才执行 - **🎲 发放方式**：随机发（拼手气），或者按顺序发（第一个领的人拿第一格，可以用来放头奖） - **🙈 内容保密**：公告里只显示份数，领到了才知道是什么 - **🌐 跨服到账**：A 服发出的物品红包，B 服玩家照样能领，物品发到玩家当前所在的子服；玩家离线就等上线后补发，背包满了就掉在脚下 > 🔒 **防复制**：每一份给了谁，都在数据库的同一个事务里写定，多个子服同时抢也不会重复发放。万一服务器恰好在发放的那一瞬间宕机，插件会把这批物品标记为“待核对”交给管理员处理，**绝不自动重发**。 --- ## 📣 聊天框里的红包公告 - **🎨 按类型配色**：普通红包是红色，拼手气是金色，口令是紫色，物品是宝箱；图案可以换成你自己的 PNG - **🖱️ 点一下就能领**：整张图都能点，鼠标悬停显示金额和份数 - **🔔 提醒齐全**：提示音、物品栏上方提示、上线提醒、快过期提醒、手气王结算公告 - **🧩 样式可切换**：大图、多行文字卡片、单行三种样式；基岩版玩家（Floodgate）会自动收到文字卡片 - **🔇 玩家自己做主**：每位玩家可以分别开关聊天、声音、标题提示；短时间内的多条公告会合并成一条，不会刷屏 --- ## 🖱️ 全程箱子界面，不用记命令 输入 `/hb` 就能打开主界面，所有操作都可以用鼠标完成： ``` 主界面 发红包工作台 A#@@@@@@@ A 当前红包 #N#L#P#I# ① 选类型 S#@@@@@@@ S 我发出的 #[{(A)}]$ ② 调金额（两侧微调） H#@@@@@@@ H 领取记录 #123S456D ③ 份数与分配方式 T#@@@@@@@ T 排行榜 #E#G#W#K# ④ 有效期 祝福 专属 口令 N#@@@@@@@ N 通知 B#M#Y#T#? 上次设置 · 确认 · 模板 P#<F#C#K> P 我的 C 发红包 ``` - **左键领取、右键看详情**，领取结果直接显示在格子上 - **鼠标悬停在“确认发出”上就能预览**：实付多少、税多少、每份多少、付完还剩多少余额，参数不对会逐条写明原因 - **3 个常用模板，记住上次的设置**：草稿关服后也不会丢 - **口令红包体验**：领取时在聊天里输入口令，输错会提示还剩几次机会；抢到后，这句口令会以你的身份发到公屏，像真的喊出来一样 - **领取明细支持翻页和排序**，可以直接跳到“我的领取”那一条 - **金额榜、次数榜、个人统计**一应俱全 --- ## 🎨 界面布局，你说了算 每个界面都是一个 YAML 文件，**用字符画出布局，一个字符对应一格**： ```yaml title: "<dark_red>红包详情 <dark_gray>#{code}" shape: - "rrr#@@@@@" - "rYr#@@@@@" icons: "Y": function: action material: craftengine:yiyun:open_button # 支持 CraftEngine 自定义物品 material-fallback: GOLD_BLOCK states: claim: { name: "<gold><bold>開", lore: ["<green>点击领取"] } claimed: { material: LIME_DYE, name: "<green>你已领取 {amount}" } ``` - 支持 **MiniMessage** 和 `&a` 颜色码，支持 **PlaceholderAPI** 变量 - 支持 **CraftEngine** 物品、`item-model`、`custom-model-data`，标题可以换成整张贴图做背景 - 可以加 **自定义按钮**：执行命令、播放音效、打开其他界面、按权限隐藏 - 改完 `/hb reload` 立即生效；写错了控制台会指出具体哪一行，该界面暂时使用内置布局，不会让菜单打不开 - 聊天文案全部在 `messages.yml` 里，变量用 `{amount}`、`{sender}` 这样直接看得懂的写法 --- ## ⏰ 定时红包与红包雨 ```yaml scheduled_packets: enabled: true packets: noon: time: "12:00" # 每天中午 12 点 distribution: lucky # 拼手气 amount: 1000 count: 20 greeting: "午间福利" days: [SATURDAY, SUNDAY] # 只在周末发 ``` - 系统红包由服务器出钱，**不扣任何玩家的余额**，没领完的部分直接回收 - 管理员可以随时下一场红包雨：`/hb admin rain <总金额> <个数>`，按间隔连续发出拼手气红包 --- ## 🛡️ 防刷、防滥用、账目可靠 | 能力 | 说明 | | :-- | :-- | | 💸 **税率与限额** | 可以设置发红包税率、金额与份数上下限、发送冷却 | | 🔐 **口令防爆破** | 口令输错次数达到上限后，锁定一段时间 | | 🚫 **物品黑名单** | 按材质、名称、描述、CraftEngine 物品 ID 拦截，**潜影盒和收纳袋里面的东西也会检查** | | 🤐 **屏蔽词** | 祝福语、口令、提示都会过滤；会忽略空格和符号，“坏 词”“坏\*词”这种写法也绕不过去，还支持正则 | | 🎮 **游戏内管理** | `/hb admin blacklist` 拿着物品就能加进黑名单，修改立即生效 | | 💾 **重启不丢** | 红包和账本都存进数据库，重启后自动恢复；过期或撤销时退还剩余部分 | | 🧾 **不确定就不动** | 经济插件返回不确定的结果时，记为待核对，不会自动重复入账；管理员用一条命令就能复查 | | ⚡ **大服不卡** | 排行榜读汇总表；实测 40 万条领取记录时，查询也在毫秒级完成 | --- ## 🌐 单服与群组，一份插件两种用法 | | 🏠 单服模式 | 🌐 群组模式 | | :-- | :-- | :-- | | 配置 | `mode: standalone` | `mode: network` | | 存储 | SQLite，开箱即用 | 共享 MySQL / MariaDB + Redis | | 金币红包 | ✅ | ✅（需要各子服共用同一份余额，如 MySQL 版 XConomy、CMI） | | 物品红包 | ✅ | ✅ 任意子服发、任意子服领 | | 代理端插件 | 不需要 | **不需要**：各子服直接连 Redis，Velocity / BungeeCord 上什么都不用装 | > 💡 群组模式会自动比对各子服使用的经济插件和货币，配置不一致时，控制台和 `/hb status` 都会提醒。 --- ## 🚀 三步上手 **1. 准备环境** - Paper / Folia **1.21+**，Java **21** - 发金币红包需要 [Vault](https://www.spigotmc.org/resources/vault.34315/) 和一个经济插件；只发经验或物品红包则不需要 - 可选：PlaceholderAPI、CraftEngine **2. 安装** 把 `YiyunRedPacket-1.0.0.jar` 放进 `plugins/` 文件夹，然后启动服务器。数据库驱动等依赖会由服务端自动下载，首次启动需要能连上 Maven 仓库。 **3. 开抢** 进入游戏输入 `/hb`。单服默认配置就能直接用，想调整税率、冷却、公告样式就改 `plugins/YiyunRedPacket/config.yml`。 > 📖 群组服配置、界面自定义、黑名单写法等详细说明，请看 **[服主手册](https://github.com/Chun2919089965/YiyunRedPacket/blob/main/docs/GUIDE.md)**。 --- ## ⌨️ 常用命令 主命令 `/hongbao`，别名 `/hb`。 **玩家** | 命令 | 作用 | | :-- | :-- | | `/hb` | 打开红包主界面 | | `/hb compose [normal\|lucky\|password\|item]` | 打开发红包工作台 | | `/hb send <金额> <份数> [类型]` | 快速填好金额和份数，打开工作台确认 | | `/hb claim <编号>` | 领取红包，编号只输前几位也行，支持 Tab 补全 | | `/hb top [amount\|count]` | 查看排行榜 | | `/hb history` · `/hb sent` | 查看领取记录 · 我发出的红包 | | `/hb inbox` · `/hb alerts` | 查看通知 · 切换提醒方式 | | `/hb help` | 查看全部命令，点一下就能填进聊天框 | **管理员** | 命令 | 作用 | | :-- | :-- | | `/hb admin rain <总金额> <个数> [每个份数] [间隔秒]` | 发起红包雨 | | `/hb admin schedule fire <名称>` | 立即发一次定时红包 | | `/hb admin revoke <编号>` | 强制撤销红包，剩余部分退回发送者 | | `/hb admin blacklist ...` | 在游戏内增删黑名单与屏蔽词 | | `/hb admin pending` · `/hb admin items` | 处理待核对的经济操作和物品 | | `/hb status` · `/hb reload` | 查看运行状态 · 热重载配置 | 完整命令表见 [服主手册 · 常用命令](https://github.com/Chun2919089965/YiyunRedPacket/blob/main/docs/GUIDE.md#常用命令)。 --- ## 🔑 权限 | 权限 | 默认 | 作用 | | :-- | :-- | :-- | | `yiyunredpacket.use` | 所有人 | 查看与领取红包 | | `yiyunredpacket.create` | 所有人 | 发普通与拼手气红包 | | `yiyunredpacket.create.password` | 所有人 | 发口令红包 | | `yiyunredpacket.create.item` | 所有人 | 发物品红包 | | `yiyunredpacket.create.target` | 所有人 | 发专属红包 | | `yiyunredpacket.bypass.cooldown` | 无 | 不受发送冷却限制 | | `yiyunredpacket.bypass.tax` | 无 | 发红包免税 | | `yiyunredpacket.admin` | OP | 管理命令、核对与重载 | --- ## 🧩 PlaceholderAPI 变量 前缀为 `%yiyunredpacket_...%`： | 变量 | 内容 | | :-- | :-- | | `active_count` · `active_total` | 当前进行中的红包个数 · 剩余总额 | | `claim_count` · `claim_total` · `last_amount` | 我的领取次数 · 领取总额 · 最近一次领到的金额 | | `sent_count` · `sent_total` | 我发出的红包个数 · 总额 | | `rank_amount` · `rank_count` | 我在金额榜 · 次数榜上的名次 | | `top_amount_<1-10>` · `top_count_<1-10>` | 排行榜第 N 名 | | `mode` · `group` · `server_id` | 运行模式 · 群组名 · 子服 ID | [/MD]