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 [次数/times]	进行抽奖 / 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

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)

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 - 维度裂隙 / Dimension Rift
• time_warp - 时空扭曲 / Time Warp
• floating_3d - 3D悬浮 / Floating 3D
• random_mix - 随机混合 / Random Mix

作者信息 / Author Information

• 作者 / Author: Morpe14514
• 工作室官方QQ交流群 / Official QQ Group: 1085808257

许可证 / License

本插件仅供个人服务器使用，禁止用于商业用途。 This plugin is for personal server use only, commercial use is prohibited.