? LuckBlocksPlus - 高级幸运方块插件
专为运行 Paper 1.21+ 的 Minecraft 服务器打造的轻量级、性能优化的 Lucky Block 插件
✨ 主要特性
? 核心系统
- 加权奖励池 - 完全可配置的加权随机奖励,每次打破幸运方块时触发
- 14 种动作类型 - 单个奖励可链式执行多个动作,按顺序依次执行
- 安全方块检测 - 使用 PersistentDataContainer 标记的方块;普通方块绝不会触发
- 持久化追踪 - 幸运方块的位置在重启后依然保留,支持 O(1) 查找
- 挖矿生成 - 幸运方块可以自然地出现在玩家于指定世界中挖掘时
- 全息显示 - 浮动文本向所有人展示玩家刚刚获得的奖励
? 管理工具
- 游戏内 GUI 编辑器 - 无需触碰配置文件即可创建、编辑和删除奖励
- 动作编辑器 - 为每个奖励添加、编辑、重新排序和移除动作
- 从光标设置预览 - 手持物品点击即可设置奖励的预览图标
- 挖矿生成 GUI - 完全在游戏内切换和调整自然生成设置
- 热重载 (Live Reload) - 更新配置无需重启服务器
⚡ 性能优化
- 异步保存系统 - 非阻塞式保存防止 TPS 下降
- O(1) HashSet 查找 - 即时验证幸运方块位置
- 零世界扫描 - 位置已缓存,从不进行扫描
- 缓存设置 - 关键路径直接从内存读取,而非磁盘
- 优雅关闭 - 同步最终保存确保数据不丢失
? 灵活奖励
- 多种奖励类型:物品、控制台/玩家命令、金钱(兼容 Vault)
- 单奖励控制:权重、权限、冷却时间、启用状态、预览物品
- 特效与奇观:标题、音效、烟花、爆炸、生物生成、药水效果、传送
- 自定义钩子:触发
CUSTOM_EVENT 供其他插件监听
? 动作多样性
✓ 给予物品 ✓ 控制台命令 ✓ 玩家命令
✓ 发送消息 ✓ 标题 ✓ 音效
✓ 爆炸 ✓ 生成生物 ✓ 药水效果
✓ 烟花 ✓ 随机传送 ✓ 给予金钱
✓ 自定义事件 ✓ 全息显示
? 安装
- 下载最新的
.jar 文件
- 放入服务器的
plugins 文件夹
- 重启服务器
- 配置
config.yml、rewards.yml 和 lang/*.yml
- 使用
/lb reload 重载配置
? 命令
玩家命令
/lb 或 /luckyblocks - 显示插件帮助
- 打破幸运方块以抽取奖励
管理员命令
/lb give <player> [amount] - 给予幸运方块物品
/lb editor - 打开 GUI 编辑器
/lb list - 列出所有奖励
/lb reload - 重载所有配置
/lb debug - 切换调试模式 + 显示追踪的方块数量
? 权限
luckyblocks.use - 打破幸运方块获取奖励(默认:true)
luckyblocks.admin - 所有管理功能(默认:op)
luckyblocks.give - 给予幸运方块物品(默认:op)
luckyblocks.editor - 打开 GUI 编辑器(默认:op)
luckyblocks.reload - 重载配置(默认:op)
luckyblocks.debug - 调试命令(默认:op)
⚙️ 配置
简洁且文档完善的配置文件:
config.yml - 方块材质、全息显示、挖矿生成、经济系统、语言
rewards.yml - 奖励定义、权重和动作列表
lang/en_US.yml, lang/id_ID.yml - 完整本地化文本(MiniMessage)
挖矿生成示例配置:
mining-spawn:
enabled: true
worlds: [world]
chance: 0.01
trigger-blocks: [STONE, DEEPSLATE]
min-y: -64
max-y: 320
? 兼容性
- Minecraft 版本:1.21+ (Paper)
- Java 版本:21+
- 可选依赖项:
? 性能统计
- ✅ 支持扩展到数千个幸运方块,采用 O(1) 查找
- ✅ 异步、非阻塞保存 — 零 TPS 影响
- ✅ 全程无世界扫描
- ✅ 非持久化全息显示 — 重启后无幽灵实体
- ✅ 缓存设置使打破方块的关键路径保持轻量
? 支持与反馈
发现 Bug 或有建议?请通过以下方式提交问题报告:
- 服务器版本(例如 Paper 1.21)
- 插件版本
- 复现步骤
- 控制台错误信息(如有)
由 ResistanceCore 用心制作 ❤️
如果您喜欢这个插件,请留下 ❤️ 爱心并分享给其他服务器管理员!
? LuckBlocksPlus - Advanced Lucky Block Plugin
A lightweight, performance-optimized Lucky Block plugin for Minecraft servers running Paper 1.21+
✨ Key Features
? Core Systems
- Weighted Reward Pool - Fully configurable, weighted-random rewards per Lucky Block break
- 14 Action Types - Chain multiple actions per reward, executed in order
- Safe Block Detection - PersistentDataContainer-tagged blocks; ordinary blocks never trigger
- Persistent Tracking - Lucky Block locations survive restarts with O(1) lookups
- Mining Spawn - Lucky Blocks can appear naturally as players mine in selected worlds
- Holograms - Floating text shows everyone what a player just won
? Admin Tools
- In-Game GUI Editor - Create, edit, and delete rewards without touching configs
- Action Editor - Add, edit, reorder, and remove actions per reward
- Set Preview From Cursor - Click with an item to set a reward's preview icon
- Mining Spawn GUI - Toggle and tune natural spawns entirely in-game
- Live Reload - Update configs without restarting
⚡ Performance Optimized
- Async Save System - Non-blocking saves prevent TPS drops
- O(1) HashSet Lookups - Instant Lucky Block verification
- Zero World Scans - Locations are cached, never scanned
- Cached Settings - Hot paths read from memory, not disk
- Graceful Shutdown - Synchronous final save guarantees no data loss
? Flexible Rewards
- Multiple Reward Types: Items, console/player commands, money (Vault compatible)
- Per-Reward Control: Weight, permission, cooldown, enabled state, preview item
- Effects & Spectacle: Titles, sounds, fireworks, explosions, mobs, potions, teleports
- Custom Hook: Fire a
CUSTOM_EVENT for other plugins to listen to
? Action Variety
✓ Give Item ✓ Console Command ✓ Player Command
✓ Message ✓ Title ✓ Sound
✓ Explosion ✓ Spawn Mob ✓ Potion Effect
✓ Firework ✓ Random Teleport ✓ Give Money
✓ Custom Event ✓ Hologram
? Installation
- Download the latest
.jar file
- Place in your server's
plugins folder
- Restart your server
- Configure
config.yml, rewards.yml, and lang/*.yml
- Reload with
/lb reload
? Commands
Player Commands
/lb or /luckyblocks - Show plugin help
- Break a Lucky Block to roll a reward
Admin Commands
/lb give <player> [amount] - Give Lucky Block items
/lb editor - Open the GUI editor
/lb list - List all rewards
/lb reload - Reload all configs
/lb debug - Toggle debug + show tracked block count
? Permissions
luckyblocks.use - Break Lucky Blocks for rewards (default: true)
luckyblocks.admin - All admin features (default: op)
luckyblocks.give - Give Lucky Block items (default: op)
luckyblocks.editor - Open the GUI editor (default: op)
luckyblocks.reload - Reload configs (default: op)
luckyblocks.debug - Debug command (default: op)
⚙️ Configuration
Clean, documented config files:
config.yml - Block material, holograms, mining spawn, economy, language
rewards.yml - Reward definitions, weights, and action lists
lang/en_US.yml, lang/id_ID.yml - Fully localized text (MiniMessage)
Example Mining Spawn Setup:
mining-spawn:
enabled: true
worlds: [world]
chance: 0.01
trigger-blocks: [STONE, DEEPSLATE]
min-y: -64
max-y: 320
? Compatibility
- Minecraft Version: 1.21+ (Paper)
- Java Version: 21+
- Optional Dependencies:
- Vault (economy / money rewards)
? Performance Stats
- ✅ Scales to thousands of Lucky Blocks with O(1) lookups
- ✅ Async, non-blocking saves — zero TPS impact
- ✅ No world scanning at any point
- ✅ Non-persistent holograms — no ghost entities after restarts
- ✅ Cached settings keep the break hot-path lightweight
? Support & Feedback
Found a bug or have a suggestion? Please report issues with:
- Server version (e.g., Paper 1.21)
- Plugin version
- Steps to reproduce
- Console errors (if any)
Made with ❤️ by ResistanceCore
If you enjoy this plugin, please leave a ❤️ love and share with other server owners!
评论 0
登录后参与评分
还没有评论,来抢沙发吧