LuckyEngine
LuckyEngine 是一款功能强大且完全可配置的 Lucky Block 插件,适用于 Paper 和 Spigot 1.21.x,旨在提供可定制的奖励、动态玩家运气值、高级游戏内编辑器、统计数据以及多语言支持。
该插件围绕原版 Minecraft 机制构建,在不依赖资源包的情况下重现经典的 Lucky Block 体验。每个 Lucky Block 都使用一个真实的可破坏方块结合视觉 Block Display 核心来实现,使系统保持轻量化的同时提供独特的视觉体验。
⚡ 推荐主机配置
⚙️ 依赖项
REQUIRED(必需)
Paper / Spigot 1.21.x
LuckyEngine 专为 Minecraft 1.21.x 服务器环境设计。
Java 21+
运行 LuckyEngine 所需的环境。
OPTIONAL(可选/软依赖)
PlaceholderAPI
提供针对运气、统计数据和奖励相关信息的扩展占位符支持。
✨ 功能特性
- 完全可配置的 Lucky Block 系统
- 无需资源包
- 基于原版的 Lucky Block 机制
- 视觉 Block Display 核心
- 动态的独立玩家运气系统
- 运气值范围从 -100 到 +100
- 自定义奖励层级和加权概率
- 多种奖励类型
- 高级游戏内 GUI 编辑器
- 奖励浏览器和管理工具
- 多语言支持
- 个人和全局统计数据
- PlaceholderAPI 集成
- 可配置的冷却时间和限制
- 自定义音效和粒子效果
- 可配置的 HUD 消息
- 广播系统
- 自定义合成配方
- 持久化 Lucky Block 存储
- 轻量级且优化的架构
? Lucky Block 系统
LuckyEngine 使用真实的 Minecraft 方块作为物理上的 Lucky Block,同时将已放置的 Lucky Block 与普通世界方块分开追踪。
系统包括:
- 真实的可破坏黄色染色玻璃方块
- 视觉海绵 BlockDisplay 核心
- 持久的 Lucky Block 追踪
- 与普通世界方块的独立存储
- 自动忽略自然生成的方块
- 使用
lucky_blocks.yml 进行持久化存储
无需资源包即可让 LuckyEngine 立即在标准 Minecraft 客户端上正常工作。
? 运气系统
每位玩家都有一个独立的运气值,范围在 -100 到 +100 之间。
运气值会动态影响获得不同奖励层级的概率。
| Luck |
Effect |
+100 |
GREAT 奖励变得非常常见,BAD 奖励变得极罕见 |
0 |
使用默认的奖励概率 |
-100 |
BAD 奖励变得更常见,GREAT 奖励几乎不可能出现 |
系统支持:
- 独立玩家的运气存储
- 可配置的最小和最大值
- 打破 Lucky Block 后的运气变化
- 死亡后可选的运气重置
- 聊天中显示的运气 HUD
- PlaceholderAPI 集成
这创建了一个动态奖励系统,玩家的运气可以改变未来 Lucky Block 的结果。
? 奖励系统
LuckyEngine 允许无限数量的自定义奖励,具备可配置的权重和奖励层级。
可用的层级包括:
支持的奖励类型包括:
| Type |
Description |
ITEM |
带有附魔、名称和描述的物品 |
MULTI_ITEM |
多个物品奖励 |
XP |
给予经验值或等级 |
COMMAND |
执行控制台命令 |
MOB_SPAWN |
生成自定义生物 |
EXPLOSION |
创建可配置的爆炸 |
POTION_EFFECT |
施加药水效果 |
LIGHTNING |
召唤闪电 |
MESSAGE |
发送私人玩家消息 |
STRUCTURE |
生成特殊结构和陷阱 |
CHEST_LOOT |
从原版战利品表中生成奖励 |
ENCHANT_HELD |
随机附魔玩家手持的物品 |
FIREWORKS |
创建随机烟花 |
TRAP |
施加负面效果,例如掉落快捷栏物品 |
奖励概率、层级和行为均可在不修改插件本身的情况下进行配置。
?️ 游戏内 GUI
LuckyEngine 提供了用于管理奖励和插件设置的游戏内工具。
打开主界面请使用:
/lb gui
主菜单
主菜单提供以下访问入口:
- 当前运气信息
- 奖励浏览器
- 奖励创建
- Lucky Block 管理
- 配置重载
奖励列表
奖励浏览器提供:
- 分页的奖励列表
- 左键点击编辑
- 右键点击删除
- 快速奖励管理
奖励编辑器
高级编辑器可用于:
- 奖励类型选择
- 附魔设置
- 生物配置
- 药水效果
- 命令设置
这使得服务器管理员可以直接在游戏内管理奖励,而无需手动编辑配置文件。
⚙️ 配置
LuckyEngine 为不同的服务器设置提供了广泛的配置选项。
可配置的系统包括:
- 奖励概率
- 运气行为
- 冷却时间
- 允许的维度/世界
- 所需工具
- 音效
- 粒子效果
- HUD 消息
- 广播设置
- 合成配方
- 语言文件
- Lucky Block 行为
配置更改可以使用以下命令应用:
/lb reload
对于可重载的配置更改,不需要重启整个服务器。
? 多语言支持
所有面向玩家的消息都可以通过语言文件进行自定义。
包含的语言:
en_US - English
pl_PL - Polish
可以通过复制现有的语言文件并翻译其中的消息来创建额外的翻译版本。
这使得 LuckyEngine 能够适应不同的服务器社区,而无需修改插件本身。
? 统计系统
LuckyEngine 会追踪单个玩家的活动以及服务器的全局活动。
个人统计
%luckyblock_breaks_total%
%luckyblock_breaks_hourly%
%luckyblock_breaks_daily%
%luckyblock_breaks_weekly%
%luckyblock_breaks_monthly%
全局统计
%luckyblock_breaks_global_total%
%luckyblock_breaks_global_hourly%
%luckyblock_breaks_global_daily%
%luckyblock_breaks_global_weekly%
%luckyblock_breaks_global_monthly%
统计数据以高效的方式存储,旧条目会自动移除,以防止不必要的数据增长。
? PlaceholderAPI
当安装了 PlaceholderAPI 时,LuckyEngine 支持其功能。
Luck 占位符
%luckyblock_luck%
%luckyblock_luck_formatted%
%luckyblock_luck_bar%
%luckyblock_luck_tier%
其他占位符
%luckyblock_total_rewards%
占位符可用于:
- 记分板 (Scoreboards)
- 全息图 (Holograms)
- 菜单 (Menus)
- 排行榜 (Leaderboards)
- 聊天格式化
- 其他兼容 PlaceholderAPI 的插件
? 游戏体验
LuckyEngine 围绕快速、不可预测且高度可重玩的游戏体验进行设计。
该系统专注于:
- 简单的幸运方块交互
- 动态奖励结果
- 玩家控制的运气进度
- 快速的 GUI 管理
- 视觉反馈
- 灵活的奖励自定义
随机奖励与动态运气的结合,允许服务器从简单的幸运方块事件,扩展到基于奖励的小游戏和进度系统。
?️ 命令
| 命令 |
描述 |
/lb gui |
打开主 GUI |
/lb give <player> [amount] |
给予幸运方块 |
/lb setluck <player> <value> |
设置玩家运气 |
/lb addluck <player> <value> |
增加或减少玩家运气 |
/lb getluck [player] |
检查玩家运气 |
/lb list |
列出已配置的奖励 |
/lb reload |
重载配置 |
别名
/luckyblock
/lucky
? 权限
| 权限 |
描述 |
luckyblock.use |
访问基本命令和 GUI 功能 |
luckyblock.admin |
访问管理功能 |
? 数据存储
LuckyEngine 使用以下路径存储持久化的幸运方块数据:
plugins/LuckyEngine/lucky_blocks.yml
玩家的运气和统计数据也会持久化存储,以便在服务器重启之间保留玩家的进度。
统计数据会自动移除过时的条目,以保持存储的高效性。
⚙️ 系统设计
LuckyEngine 结合了原版 Minecraft 方块、区块显示实体 (Block Display entities)、持久化存储和模块化奖励系统,构建了一个灵活的幸运方块框架。
核心设计目标包括:
- 轻量级的服务端运行
- 持久的玩家进度
- 高效的幸运方块追踪
- 模块化的奖励处理
- 灵活的配置
- 游戏内管理工具
- 易于与 PlaceholderAPI 集成
- 支持未来的奖励扩展
该系统旨在与现有的 Paper 和 Spigot 服务器生态系统自然配合,同时保持易于配置和管理。
? 安装
- 下载 LuckyEngine
- 将插件 JAR 文件放入以下目录:
plugins/
- 重启服务器
- 在以下位置配置插件:
plugins/LuckyEngine/config.yml
- 重载配置:
/lb reload
- 给自己一个幸运方块:
/lb give <player>
? 计划中的功能
LuckyEngine 正在积极维护中,并可通过添加额外的奖励和游戏系统进行扩展。
潜在的后续更新可能包括:
- 额外的奖励类型
- 扩展的 GUI 编辑器
- 更先进的运气机制
- 更多的统计数据
- 更多语言支持
- 扩展的 PlaceholderAPI 集成
- 额外的配置选项
- 性能和优化改进
- API 和开发者扩展支持
? 链接
官方网站:
文档: (修复中)
LuckyEngine
LuckyEngine is a powerful and fully configurable Lucky Block plugin for Paper and Spigot 1.21.x, designed to provide customizable rewards, dynamic player luck, advanced in-game editors, statistics, and multi-language support.
Built around vanilla Minecraft mechanics, LuckyEngine recreates the classic Lucky Block experience without requiring a resource pack. Each Lucky Block uses a real breakable block combined with a visual Block Display core, allowing the system to remain lightweight while providing a unique visual experience.
⚡ Recommended Hosting
⚙️ Dependencies
REQUIRED
Paper / Spigot 1.21.x
LuckyEngine is designed for Minecraft 1.21.x server environments.
Java 21+
Required to run LuckyEngine.
OPTIONAL (Soft Dependency)
PlaceholderAPI
Provides expanded placeholder support for luck, statistics, and reward-related information.
✨ Features
- Fully configurable Lucky Block system
- No resource pack required
- Vanilla-based Lucky Block mechanics
- Visual Block Display cores
- Dynamic per-player luck system
- Luck values from -100 to +100
- Custom reward tiers and weighted chances
- Multiple reward types
- Advanced in-game GUI editors
- Reward browser and management tools
- Multi-language support
- Personal and global statistics
- PlaceholderAPI integration
- Configurable cooldowns and restrictions
- Custom sounds and particles
- Configurable HUD messages
- Broadcast system
- Custom crafting recipe
- Persistent Lucky Block storage
- Lightweight and optimized architecture
? Lucky Block System
LuckyEngine uses real Minecraft blocks as the physical Lucky Block while keeping track of placed Lucky Blocks separately from normal world blocks.
The system includes:
- Real breakable Yellow Stained Glass blocks
- Visual Sponge BlockDisplay cores
- Persistent Lucky Block tracking
- Separate storage from normal world blocks
- Automatic ignoring of naturally generated blocks
- Persistent storage using
lucky_blocks.yml
No resource pack is required, allowing LuckyEngine to work immediately with standard Minecraft clients.
? Luck System
Every player has an individual luck value ranging from -100 to +100.
Luck dynamically affects the probability of receiving different reward tiers.
| Luck |
Effect |
+100 |
GREAT rewards become much more common and BAD rewards become extremely rare |
0 |
Uses the default reward chances |
-100 |
BAD rewards become more common and GREAT rewards become almost impossible |
The system supports:
- Per-player luck storage
- Configurable minimum and maximum values
- Luck changes after breaking Lucky Blocks
- Optional luck reset after death
- Luck HUD displayed in chat
- PlaceholderAPI integration
This creates a dynamic reward system where player luck can change the outcome of future Lucky Blocks.
? Reward System
LuckyEngine allows unlimited custom rewards with configurable weights and reward tiers.
Available tiers include:
Supported reward types include:
| Type |
Description |
ITEM |
Custom items with enchantments, names, and lore |
MULTI_ITEM |
Multiple item rewards |
XP |
Give experience points or levels |
COMMAND |
Execute console commands |
MOB_SPAWN |
Spawn customized mobs |
EXPLOSION |
Create configurable explosions |
POTION_EFFECT |
Apply potion effects |
LIGHTNING |
Create lightning strikes |
MESSAGE |
Send private player messages |
STRUCTURE |
Generate special structures and traps |
CHEST_LOOT |
Generate rewards from vanilla loot tables |
ENCHANT_HELD |
Randomly enchant the player's held item |
FIREWORKS |
Create random fireworks |
TRAP |
Apply negative effects such as dropping hotbar items |
Reward chances, tiers, and behaviour can be configured without modifying the plugin itself.
?️ In-Game GUI
LuckyEngine provides in-game tools for managing rewards and plugin settings.
Open the main interface with:
/lb gui
Main Menu
The main menu provides access to:
- Current luck information
- Reward browser
- Reward creation
- Lucky Block management
- Configuration reload
Reward List
The reward browser provides:
- Paginated reward lists
- Left-click editing
- Right-click deletion
- Quick reward management
Reward Editor
Advanced editors are available for:
- Reward type selection
- Enchantments
- Mob configuration
- Potion effects
- Commands
This allows server administrators to manage rewards directly in-game without manually editing configuration files.
⚙️ Configuration
LuckyEngine provides extensive configuration options for different server setups.
Configurable systems include:
- Reward chances
- Luck behaviour
- Cooldowns
- Allowed worlds
- Required tools
- Sounds
- Particles
- HUD messages
- Broadcast settings
- Crafting recipes
- Language files
- Lucky Block behaviour
Configuration changes can be applied using:
/lb reload
A full server restart is not required for reloadable configuration changes.
? Multi-Language Support
All player-facing messages can be customized through language files.
Included languages:
en_US - English
pl_PL - Polish
Additional translations can be created by copying an existing language file and translating its messages.
This allows LuckyEngine to be adapted to different server communities without modifying the plugin itself.
? Statistics System
LuckyEngine tracks both individual player activity and global server activity.
Personal Statistics
%luckyblock_breaks_total%
%luckyblock_breaks_hourly%
%luckyblock_breaks_daily%
%luckyblock_breaks_weekly%
%luckyblock_breaks_monthly%
Global Statistics
%luckyblock_breaks_global_total%
%luckyblock_breaks_global_hourly%
%luckyblock_breaks_global_daily%
%luckyblock_breaks_global_weekly%
%luckyblock_breaks_global_monthly%
Statistics are stored efficiently, with old entries automatically removed to prevent unnecessary data growth.
? PlaceholderAPI
LuckyEngine supports PlaceholderAPI when installed.
Luck Placeholders
%luckyblock_luck%
%luckyblock_luck_formatted%
%luckyblock_luck_bar%
%luckyblock_luck_tier%
Other Placeholders
%luckyblock_total_rewards%
Placeholders can be used with:
- Scoreboards
- Holograms
- Menus
- Leaderboards
- Chat formatting
- Other PlaceholderAPI-compatible plugins
? Gameplay Experience
LuckyEngine is designed around fast, unpredictable, and highly replayable gameplay.
The system focuses on:
- Simple Lucky Block interactions
- Dynamic reward outcomes
- Player-controlled luck progression
- Fast GUI management
- Visual feedback
- Flexible reward customization
The combination of random rewards and dynamic luck allows servers to create anything from simple Lucky Block events to larger reward-based minigames and progression systems.
?️ Commands
| Command |
Description |
/lb gui |
Open the main GUI |
/lb give <player> [amount] |
Give Lucky Blocks |
/lb setluck <player> <value> |
Set player luck |
/lb addluck <player> <value> |
Add or remove player luck |
/lb getluck [player] |
Check player luck |
/lb list |
List configured rewards |
/lb reload |
Reload configuration |
Aliases
/luckyblock
/lucky
? Permissions
| Permission |
Description |
luckyblock.use |
Access basic commands and GUI features |
luckyblock.admin |
Access administration features |
? Data Storage
LuckyEngine stores persistent Lucky Block data using:
plugins/LuckyEngine/lucky_blocks.yml
Player luck and statistics are also stored persistently so that player progression is preserved between server restarts.
Statistics automatically remove outdated entries to keep storage efficient.
⚙️ System Design
LuckyEngine combines vanilla Minecraft blocks, Block Display entities, persistent storage, and a modular reward system to create a flexible Lucky Block framework.
Core design goals include:
- Lightweight server-side operation
- Persistent player progression
- Efficient Lucky Block tracking
- Modular reward handling
- Flexible configuration
- In-game administration tools
- Easy integration with PlaceholderAPI
- Support for future reward expansion
The system is designed to work naturally with existing Paper and Spigot server ecosystems while remaining easy to configure and manage.
? Installation
- Download LuckyEngine
- Place the plugin JAR into:
plugins/
- Restart the server
- Configure the plugin in:
plugins/LuckyEngine/config.yml
- Reload the configuration:
/lb reload
- Give yourself a Lucky Block:
/lb give <player>
? Planned Features
LuckyEngine is actively maintained and can be expanded with additional reward and gameplay systems.
Potential future updates may include:
- Additional reward types
- Expanded GUI editors
- More advanced luck mechanics
- Additional statistics
- More language support
- Expanded PlaceholderAPI integration
- Additional configuration options
- Performance and optimization improvements
- API and developer expansion support
? Links
Official Website:
Documentation: (In Repair)
评论 0
登录后参与评分
还没有评论,来抢沙发吧