MorayLottery Plugin

# MorayLottery 抽奖插件 / Lottery Plugin ## 简介 / Introduction MorayLottery 是一个功能丰富的 Minecraft 抽奖插件，支持多种动画效果、经济系统整合和保底机制。 MorayLottery is a feature-rich Minecraft lottery plugin with multiple animation effects, economy system integration, and guarantee mechanism. ## 功能特性 / Features - **18种动画效果 / 18 Animation Effects** - 老虎机(Slot Machine)、轮盘(Roulette)、翻牌(Card Flip)、宝箱(Chest Open)、魔法阵(Magic Circle)、烟花(Firework)、黑洞(Black Hole)、彩虹流(Rainbow Stream)、水晶碎裂(Crystal Shatter)、龙息(Dragon Breath)、末影传送(Ender Teleport)、熔岩爆发(Lava Burst)、冰雪风暴(Ice Storm)、雷霆打击(Thunder Strike)、维度裂隙(Dimension Rift)、时空扭曲(Time Warp)、3D悬浮(Floating 3D)、随机混合(Random Mix) - **多经济支持 / Multi-Economy Support** - 支持 Vault 金币(Gold) 和 PlayerPoints 点券(Points) - **保底系统 / Guarantee System** - 可配置的保底机制，确保玩家获得超级大奖 / Configurable guarantee mechanism to ensure players get super prizes - **统计系统 / Statistics System** - 记录玩家抽奖次数、消耗和获奖情况 / Track player draw count, spending, and winnings - **排行榜 / Leaderboard** - 展示抽奖排行榜 / Display lottery leaderboard - **全息图支持 / Hologram Support** - 支持 HolographicDisplays 显示奖池信息 / Support HolographicDisplays for pool info - **多语言 / Multi-Language** - 支持简体中文(zh_CN)和英文(en_US) / Support Simplified Chinese and English - **数据库支持 / Database Support** - SQLite 和 MySQL 支持 / SQLite and MySQL support ## 指令 / Commands | 指令 / Command | 描述 / Description | 权限 / Permission | |------|------|------| | `/moraylottery` 或 /or `/mlottery` | 打开抽奖主菜单 / Open main menu | moraylottery.use | | `/moraylottery draw ` | 进行抽奖 / Draw lottery | moraylottery.use | | `/moraylottery gui` | 打开GUI菜单 / Open GUI menu | moraylottery.use | | `/moraylottery stats` | 查看个人统计 / View statistics | moraylottery.use | | `/moraylottery pool <奖池/pool>` | 选择奖池 / Select pool | moraylottery.use | | `/moraylottery list` | 列出所有奖池 / List all pools | moraylottery.use | | `/moraylottery claim` | 领取待领取物品 / Claim pending items | moraylottery.use | | `/moraylottery help` | 显示帮助信息 / Show help | moraylottery.use | | `/moraylottery reload` | 重载配置 / Reload config | moraylottery.admin | ## 权限 / Permissions - `moraylottery.use` - 允许使用抽奖功能 / Allow using lottery (默认: true) - `moraylottery.admin` - 允许使用管理员命令 / Allow admin commands (默认: op) ## 软依赖 / Soft Dependencies - **Vault** - 经济系统支持 / Economy system support - **PlayerPoints** - 点券系统支持 / Points system support - **PlaceholderAPI** - 变量支持 / Placeholder support - **HolographicDisplays** - 全息图支持 / Hologram support ## 安装 / Installation 1. 下载插件并放入服务器的 `plugins` 文件夹 / Download and put in `plugins` folder 2. 安装所需的软依赖（如需要）/ Install required soft dependencies 3. 启动服务器，插件会自动生成配置文件 / Start server, plugin will generate config files 4. 根据需要修改 `config.yml` 和语言文件 / Modify `config.yml` and language files as needed 5. 配置奖池文件（位于 `plugins/MorayLottery/pools/` 目录）/ Configure pool files in `plugins/MorayLottery/pools/` ## 配置文件 / Configuration Files ### config.yml ```yaml settings: language: "zh_CN" # 语言 / Language: zh_CN, en_US default-pool: "default" # 默认奖池 / Default pool database: type: "sqlite" # 数据库类型 / Database type: sqlite, mysql host: "localhost" port: 3306 database: "moraylottery" username: "root" password: "" cooldown: enabled: true time: 3 # 冷却时间（秒）/ Cooldown time (seconds) hologram: enabled: true height: 2.5 broadcast: enabled: true ``` ### 奖池配置示例 / Pool Configuration Example (pools/default.yml) ```yaml name: "默认奖池 / Default Pool" display-item: "DIAMOND" animation: "slot_machine" particle: "vortex" cost: type: "vault" # 经济类型 / Economy type: vault, playerpoints amount: 100 # 消耗金额 / Cost amount guarantee: enabled: true # 是否启用保底 / Enable guarantee threshold: 90 # 保底阈值 / Guarantee threshold super-prizes: # 超级大奖列表 / Super prize list - "legendary_sword" prizes: common_coin: name: "&e少量金币 / Small Coins" type: "MONEY" amount: 50 weight: 30 broadcast: false legendary_sword: name: "&6&l传说之剑 / Legendary Sword" type: "ITEM" material: "DIAMOND_SWORD" amount: 1 weight: 5 is-super: true # 是否为超级大奖 / Is super prize broadcast: true # 是否广播 / Broadcast enchantments: # 附魔 / Enchantments DAMAGE_ALL: 5 # 锋利 V / Sharpness V FIRE_ASPECT: 2 # 火焰附加 II / Fire Aspect II ``` ## 奖品类型 / Prize Types - **ITEM** - 物品奖品 / Item prize - **MONEY** - 金币（Vault）/ Gold (Vault) - **POINTS** - 点券（PlayerPoints）/ Points (PlayerPoints) - **COMMAND** - 执行命令 / Execute command ## 可用动画 / Available Animations - `slot_machine` - 老虎机 / Slot Machine - `roulette` - 轮盘 / Roulette - `card_flip` - 翻牌 / Card Flip - `chest_open` - 宝箱 / Chest Open - `magic_circle` - 魔法阵 / Magic Circle - `firework` - 烟花 / Firework - `black_hole` - 黑洞 / Black Hole - `rainbow_stream` - 彩虹流 / Rainbow Stream - `crystal_shatter` - 水晶碎裂 / Crystal Shatter - `dragon_breath` - 龙息 / Dragon Breath - `ender_teleport` - 末影传送 / Ender Teleport - `lava_burst` - 熔岩爆发 / Lava Burst - `ice_storm` - 冰雪风暴 / Ice Storm - `thunder_strike` - 雷霆打击 / Thunder Strike - `dimension_rift` - 维度裂