- 版权类型
- 原创
- 插件中文名称
- 牢李抽签
- 插件英文名称
- LichQian
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- XConomy https://www.spigotmc.org/resources/xconomy.75669/
PlaceholderAPI https://www.spigotmc.org/resources/placeholderapi.6245/
- 适配版本（Java）
- 1.21
- 1.20
简介
牢李抽签 旨在通过简单直观的 GUI 交互，模拟传统抽签求运的过程。玩家消耗金币进行摇签，根据运势获得不同等级的签文（上上签、上签、中签、下签等），并触发相应的奖励（金币、物品、药水效果）或惩罚。核心特性
● 国风沉浸：精心设计的 GUI 界面与签文解读，营造浓厚的国风氛围。● 等级系统：支持自定义签文等级（上上签、下下签等）与权重。
● 多样奖励：
经济奖励：直接发放 XConomy 金币。○
物品奖励：自定义物品类型与数量（支持汉化显示）。○
药水效果：赋予玩家 Buff 或 Debuff（如速度、失明）。○
指令执行：以控制台身份执行自定义指令。● 高度配置：所有签文、奖励、提示消息均可配置。
● PAPI 支持：提供丰富的变量接口，方便在记分板或菜单中展示。
安装与依赖
前置插件
本插件依赖以下插件才能正常运行：1. XConomy - 经济系统支持（必须）。
2. PlaceholderAPI - 变量支持（推荐，非必须）。
安装步骤
1. 确保服务器版本为 Minecraft 1.20+ (Paper)。2. 下载 LichQian-x.x.x.jar 并放入 plugins/ 目录。
3. 确保已安装 XConomy 插件。
4. 重启服务器或加载插件。
5. 配置文件将生成在 plugins/LichQian/config.yml。
命令与权限
命令与权限玩家命令
| 命令 | 别名 | 描述 | 权限 |
/lottery | /llcq | 打开抽签 GUI 界面 | lichqian.use (默认拥有) |
管理员命令
| 命令 | 描述 | 权限 |
/lichqian reload | 重载配置文件 | lichqian.admin (默认 OP 拥有) |
配置文件详解
配置文件位于 plugins/LichQian/config.yml。基础设置
| settings: cost: 100 # 每次抽签消耗的金币 gui_title: "&e&l求签阁" # GUI 界面标题 daily_limit: 0 # 每日抽签次数限制 (0 为无限制) |
签文池配置 (sign_pool)
您可以添加任意数量的签文。系统将根据 weight (权重) 计算抽取概率。| sign_pool: - level: "&d&l上上签" # 签文等级显示 name: "鸿运当头" # 签文名称 reward: 3000 # 金币奖励 (0 为无) desc: "鸿运相随，所求多得" # 签文解读 weight: 2 # 权重 (概率 = 该签权重 / 总权重) # [可选] 给予物品 # 格式: 物品ID:数量 # 支持自动汉化显示 (需客户端支持) items: - "GOLDEN_APPLE:2" - "DIAMOND:1" # [可选] 给予药水效果 # 格式: 效果名:持续秒数:等级(0开始) effects: - "SPEED:600:1" # 速度 II, 600秒 # [可选] 执行指令 # {player} 会被替换为玩家名 # 支持任何控制台可执行的指令 commands: # 示例1：发送全服公告 - "say 恭喜 {player} 抽中大奖！" # 示例2：给予经验 - "xp give {player} 500 points" # 示例3：发送 Title 标题 - "title {player} title {\"text\":\"欧皇附体\",\"color\":\"gold\"}" # 示例4：召唤烟花 (需原版指令) - "execute at {player} run summon firework_rocket ~ ~ ~ {LifeTime:20,FireworksItem:{id:firework_rocket,Count:1,tag:{Fireworks:{Flight:1,Explosions:[{Type:4,Flicker:1,Trail:1,Colors:[I;16766720,16711680],FadeColors:[I;16776960]}]}}}}" # 示例5：给予惩罚 (召唤闪电) - "execute at {player} run summon lightning_bolt ~ ~ ~" |
物品与效果格式说明
● 物品名：请使用标准 Bukkit Material 名称（如 APPLE, DIAMOND_SWORD）。
● 药水效果：支持标准效果名（如 SPEED, REGENERATION, WEAKNESS）。
● 药水效果：支持标准效果名（如 SPEED, REGENERATION, WEAKNESS）。
变量接口 (PlaceholderAPI)
变量接口 (PlaceholderAPI)| 变量 | 描述 | 示例返回值 |
%laolilottery_last_sign% | 玩家上一次抽到的签文等级 | 上上签 / 暂无 |
%laolilottery_sign_cost% | 当前抽签费用 | 100.0 |
%laolilottery_can_sign% | 玩家今日是否还能抽签 | true / false |
常见问题 (FAQ)
Q: 为什么输入 /lottery 没反应？A: 请检查后台是否有报错，并确认是否安装了 XConomy 经济插件。Q: 如何修改抽签概率？
A: 通过调整 config.yml 中每个签文的 weight (权重) 值。权重越高，被抽中的概率越大。
Q: 物品名称显示为英文怎么办？
A: 插件已内置客户端语言适配功能。只要玩家的 Minecraft 客户端语言设置为中文，聊天栏中的物品名称（如 BREAD）就会自动显示为 面包。
Q: 支持自定义模型材质吗？
A: 目前仅支持原版材质。如果需要自定义模型数据 (CustomModelData)，暂不支持直接配置，建议通过 commands 执行给予物品的指令来实现。
反馈可以进群哦！https://qm.qq.com/q/mtZx8QEnIW 作者QQ ：2562661003
