📖 插件简介

PaiLotteryCrates 是一款功能强大的抽奖箱插件，支持多种开启条件、保底机制、概率系统等高级功能。 插件提供了丰富的动画效果，包括经典的 CSGO 跑马灯、老虎机轮盘、雷电审判、魔法召唤等多达 15+ 种动画预设， 让玩家享受极致的开箱体验，极大提升服务器趣味性和玩家留存率。

✨ 核心特色

• 🎨 15+ 种动画预设 - CSGO跑马灯、老虎机、雷电审判、魔法召唤、宝藏挖掘等震撼视觉效果
• 🎯 完善的GUI编辑系统 - 无需手动编辑YAML，全程可视化配置抽奖箱
• 🔐 多种开启条件 - 支持钥匙物品、金钱（Vault）、点券（PlayerPoints）、权限、PAPI变量、抽奖次数
• 🎲 智能保底机制 - 支持单个玩家累计或全服共享保底，防止玩家无法抽到大奖
• 📊 精确概率系统 - 基于百分比的概率计算，支持普通/大奖品级，公平公正
• 💾 双存储支持 - YAML文件存储 / MySQL数据库存储，灵活选择
• 🌐 多语言支持 - 中文（zh_CN）/ 英文（en_US）可切换
• 🔌 PlaceholderAPI集成 - 完整的PAPI变量支持，可用于其他插件
• ⚡ 跨版本支持 - 使用PaiDaXingPlugins支持 Minecraft 1.12.x - 1.21.x
• 📢 全服广播 - 大奖抽中时可全服广播，营造氛围
• 📈 统计系统 - 支持今日/本周/历史抽奖次数统计
• 🎯 方块绑定 - 支持将抽奖箱绑定到方块上，右键打开

🎮 功能详解

1. 🎨 丰富的动画系统

经典GUI动画（9种）

• CSGO跑马灯 - 类似CS:GO开箱的横向滚动动画，平滑滚动，逐渐减速
• QUAD_CRATE平台 - 四方平台展示动画，九宫格布局，旋转展示
• QUICK_CRATE快速箱子 - 快速开箱动画，适合快速抽奖
• ROULETTE轮盘 - 轮盘旋转动画，圆形轮盘，旋转选择
• CRATE_ON_THE_GO - 移动式开箱动画，动态移动效果
• FIRE_CRACKER鞭炮 - 鞭炮爆炸效果动画，多次爆炸，烟花效果
• WONDER混元归一 - 混元归一特效动画，神秘魔法效果
• WHEEL老虎机 - 老虎机滚动动画，经典老虎机效果
• WAR九选一 - 九宫格选择动画，九宫格高亮选择

高级世界动画（5种）⭐

• ⚡ 雷电审判 - 天空降下多道雷电，最终金色闪电击中中奖物品
• 🎆 烟花发射 - 发射多枚彩色烟花，盔甲架旋转展示中奖物品，螺旋粒子效果
• ⛲ 物品喷泉 - 物品从地面喷涌而出，在空中漂浮，最终一个物品落下成为中奖物品
• ✨ 魔法召唤 - 生成紫色魔法阵，召唤6个盔甲架展示物品，逐个淘汰，最终只留下中奖物品
• ⛏ 宝藏挖掘 - 在地面标记5个挖掘点，盔甲架持铁锹挖掘，挖出假宝藏和真宝藏

CloudPick客户端动画

• CSGO_CLOUDPICK - 集成CloudPick插件，支持客户端请求-响应模式的CSGO开箱动画
• 支持自定义UI界面，流畅的客户端渲染

2. 🎯 完善的GUI编辑系统

• 可视化编辑 - 无需手动编辑YAML配置文件
• 物品管理 - 直接在GUI中添加、删除、修改抽奖物品
• 概率设置 - 右键物品即可设置概率（如: 5表示5%概率）
• 条件配置 - 点击按钮即可配置各种开启条件
• 动画预设选择 - 在GUI中直接选择和预览动画效果
• 实时保存 - 所有修改实时保存，无需重启服务器

3. 🔐 多种开启条件

• 钥匙物品 - 需要特定物品才能开启（支持NBT检测）
• 金钱条件 - 需要消耗金钱（Vault）
• 点券条件 - 需要消耗点券（PlayerPoints）
• 权限条件 - 需要特定权限
• PAPI变量条件 - 支持PlaceholderAPI变量判断
• 抽奖次数 - 限制每日/每周抽奖次数
• 组合条件 - 支持多个条件同时生效

4. 🎲 智能保底机制

• 个人保底 - 每个玩家独立计算保底次数
• 全服保底 - 全服共享保底计数，增加互动性
• 自定义保底次数 - 可配置保底触发次数
• 保底重置 - 管理员可手动重置玩家保底计数
• 保底提示 - 玩家可查询当前保底进度

5. 📊 统计系统

• 今日统计 - 记录今日抽奖次数
• 本周统计 - 记录本周抽奖次数
• 历史统计 - 记录历史总抽奖次数
• 分类统计 - 支持按抽奖箱分类统计
• PAPI变量 - 所有统计数据都可通过PAPI变量获取

6. 🎯 方块绑定系统

• 将抽奖箱绑定到任意方块
• 玩家右键方块即可打开抽奖
• 支持多个方块绑定同一个抽奖箱
• 支持解绑和重新绑定

⌨️ 指令系统

玩家命令

/plc 或 /pailotterycrates

玩家指令列表

管理员命令

/plcadmin

管理员指令列表

权限节点

📊 PlaceholderAPI 变量

钥匙相关

%pailottery_haskey_<抽奖箱名>% - 是否拥有钥匙（true/false）

条件检查

%pailottery_canopen_<抽奖箱名>% - 是否可打开（true/false）

次数相关

%pailottery_remaining_<抽奖箱名>% - 剩余抽奖次数
%pailottery_guarantee_<抽奖箱名>% - 保底计数

今日统计

%pailottery_today_<抽奖箱名>% - 今日指定抽奖箱抽奖次数
%pailottery_today_total% - 今日所有抽奖箱总抽奖次数

本周统计

%pailottery_week_<抽奖箱名>% - 本周指定抽奖箱抽奖次数
%pailottery_week_total% - 本周所有抽奖箱总抽奖次数

历史统计

%pailottery_total_<抽奖箱名>% - 历史指定抽奖箱抽奖次数
%pailottery_total_all% - 历史所有抽奖箱总抽奖次数

⚙️ 配置说明

基础配置（config.yml）

# 存储配置
storage:
  type: YAML  # 存储类型: YAML 或 MYSQL
  mysql:      # MySQL配置（当type为MYSQL时生效）
    host: localhost
    port: 3306
    database: pailottery
    username: root
    password: ''

# 语言设置
language: zh_CN  # 可选: zh_CN (中文) 或 en_US (英文)

# 抽奖次数重置配置
lottery-limit-reset:
  mode: DAILY  # 重置模式: DAILY (每天0点重置)

# 查看GUI配置
view-gui:
  show-probability: true  # 是否在查看界面显示概率

动画预设配置示例

# CSGO跑马灯动画配置示例
name: CSGO
type: CSGO
display-name: "§6§lCSGO跑马灯"
description: "经典的CSGO开箱动画"
icon-material: CHEST

animation:
  duration: 100        # 动画持续时间（tick，20tick=1秒）
  speed: 1            # 动画速度倍率
  enable-particles: true
  enable-sounds: true

particles:
  - type: FLAME
    count: 5
    offset-x: 0.5
    offset-y: 0.5
    offset-z: 0.5
    speed: 0.1

sounds:
  - type: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 1.0
    delay: 0

📥 安装方法

1. 下载插件
   • 在PaiDaXingPlugins授权器中输入插件授权码
2. 安装依赖插件（可选）
   • PaiDaXingPlugins - 提供跨版本支持和粒子效果（强烈推荐）
   • Vault - 支持金钱条件
   • PlayerPoints - 支持点券条件
   • PlaceholderAPI - 支持变量功能
   • CloudPick - 支持客户端动画（可选）
3. 启动服务器
   
   • 插件会自动生成配置文件和示例抽奖箱
4. 配置插件
   • 编辑 plugins/PaiLotteryCrates/config.yml 配置基础设置
   • 使用 /plcadmin edit 示例抽奖箱 查看示例配置
   • 创建自己的抽奖箱
5. 开始使用
   • 使用 /plcadmin create 我的抽奖箱 创建抽奖箱
   • 使用 /plcadmin edit 我的抽奖箱 编辑抽奖箱
   • 使用 /plcadmin bind 我的抽奖箱 绑定方块
   • 玩家右键方块即可抽奖！

🚀 快速开始教程

创建你的第一个抽奖箱（全GUI操作）

1. 创建抽奖箱

   /plcadmin create 新手宝箱

2. 打开GUI编辑器

   /plcadmin edit 新手宝箱

3. 在GUI中添加物品
   • 点击空槽位放入抽奖物品
   • 右键物品设置概率（如: 在聊天栏输入 5 表示5%概率）
   • 左键物品设置为大奖（大奖会触发全服广播）
4. 配置开启条件
   • 点击"抽奖箱设置"按钮
   • 点击"钥匙设置"按钮，放入钥匙物品
   • 或点击"金钱设置"按钮，在聊天栏输入金额
5. 选择动画效果
   • 点击"抽奖动画预设"按钮
   • 选择你喜欢的动画（推荐: CSGO跑马灯、雷电审判、魔法召唤）
6. 绑定方块

   /plcadmin bind 新手宝箱

   • 在10秒内右键点击要绑定的方块
7. 完成！
   • 玩家现在可以右键方块进行抽奖了！

🎬 动画效果展示

经典GUI动画

CSGO跑马灯 - 最受欢迎的开箱动画

老虎机轮盘 - 经典的老虎机效果

高级世界动画

✨ 魔法召唤 - 神秘的魔法阵召唤

⛏ 宝藏挖掘 - 趣味的挖宝动画

📷 插件截图展示

🔧 技术特性

性能优化

• ✅ 异步数据库操作，不阻塞主线程
• ✅ 智能缓存机制，减少文件读写
• ✅ 优化的粒子生成算法，降低性能消耗
• ✅ 自动清理过期数据，保持数据库整洁

兼容性

• ✅ 支持 Minecraft 1.12.x - 1.21.x 全版本
• ✅ 兼容 Spigot、Paper、Bukkit Catserver Mo F 等服务端
• ✅ 与主流插件完美兼容（Vault、PlaceholderAPI、PlayerPoints等）
• ✅ 支持自定义物品（NBT、Lore、附魔等）

💰 购买信息

• 💬 购买联系方式
• QQ：2776901795
• 定价：98 元
• 包含内容：
  • ✅ 插件本体（支持1.12.x - 1.21.x全版本）
  • ✅ 15+ 种动画预设
  • ✅ 完整的GUI编辑系统
  • ✅ 终身免费更新
  • ✅ 技术支持
  • ✅ 配置协助
  • ✅ 示例配置文件
• 可选服务：
  • 🎨 自定义动画开发：+50元/个
  • 🎯 定制功能开发：价格面议
  • 📦 整合包配置：+30元
  • 🚡CSGO动画云拾UI配置： +50元

售后服务

• ✅ 免费安装指导
• ✅ 免费配置协助
• ✅ 免费BUG修复
• ✅ 免费功能更新
• ✅ 优先功能建议采纳