原创 娱乐 CyuLucky | 幸运方块插件 | 自定义幸运值 | 自定义连环事件 | 支持Folia [1.16-26.x] 1.0

---

开幸运方块玩法最烦的就是要强制玩家下载几十兆材质包，进服慢还容易崩；想改改掉落物又得在长长的配置文件里抓瞎，更别说让玩家自己调点数了

CyuLucky 是一套专门为 Minecraft 各版本服务器打造的免材质包幸运方块插件

直接用原版玩家头颅皮肤作为方块外观，放下就是立体方块，客户端不用装任何额外材质包

玩家在原版工作台里就能自由加减幸运点数：放钻石金苹果提升好运，放腐肉蜘蛛眼增加恶作剧惩罚，手持动态进度条实时变色

开箱自带 4 大事件池与 127 种连环事件，不仅能掉落矿物与装备，还能播放多阶段倒计时、大标题、天降落雷与防拆家牢笼

自带野外新区块自然生成、全服限时好运时段与 9 字符可视化管理菜单，直接丢进 plugins 文件夹就能开玩

---

主要功能

● 原版头颅方块外观：支持皮肤站直链、Base64 与玩家名，免装材质包即放即玩
● 手持动态彩色进度条：描述栏实时渲染双向变色条，正数翠绿中立金黄负数绯红
● 工作台自由调谐幸运值：九宫格任意放置原料，钻石黄金加点，腐肉铁砧扣分
● 原料防误吞安全保护：自动识别附魔装备、定制武器与贵重 NBT，绝不当作点数材料误耗
● 动态指数概率倾斜：幸运值越高好运事件暴增，幸运值为负则恶作剧惩罚翻倍
● 127 种连环动作事件：支持分步按刻延迟，大标题、音效、落雷、刷怪与掉落一气呵成
● 外部模型道具直连：原生支持 ItemsAdder、Oraxen、CraftEngine、Nexo 与 CyuItems 物品
● 多维度触发环境门禁：支持按天气、黑夜白天、生物群系、血量、潜行与 PAPI 属性判定
● 主城防拆家与出生点保护：开启防拆家后囚笼只填空气，爆炸事件只炸飞人不毁坏地形
● 狂点防刷与手速限制：自动拦截连点器快速刷方块，支持出生点与有效高度保护
● 新区块野外自然生成：地表、矿洞、下界、末地与海底自动刷出野生方块，支持伴生祭坛
● 全服限时气运狂欢：定时开启全服幸运翻倍时段，顶部 BossBar 动态倒计时，野生方块刷新率翻倍
● 药水状态与属性共鸣：身上的幸运/霉运药水或 RPG 属性变量可直接折算进有效幸运值
● 9 字符可视化图形菜单：输入命令唤起界面，直观查阅模板外观、升级配方与管理员一键获取
● 一键健康体检与热重载：提供 doctor 诊断命令一览全服状态，改完配置输入 reload 秒级生效
● 多平台全版本支持：原生支持 Paper 与 Folia 区域调度，提供 1.16.5 经典核心独立运行包

---

原版头颅做方块外观

很多服主想开幸运方块玩法，但又担心让玩家加载动辄几十兆的客户端材质包导致卡顿退服

CyuLucky 直接使用原版玩家头颅作为方块外观载体：
支持官方皮肤 Base64 贴图字符
支持 Mojang 皮肤站直链 URL
支持正版玩家游戏名
也支持给装了资源包的服务器绑定 CustomModelData 自定义模型

玩家拿在手里是带有皮肤的立体物品，摆在地上就是实实在在的方块

自带贴心的物理防护规则：
活塞无法推动偷方块
水流和岩浆冲刷不会刷掉方块
底部垫脚方块被敲掉时方块不会异常脱落掉落物

服主还可以针对不同等级的方块定制挖掘规则：
限制必须使用镐子、斧头或指定品阶工具才能挖碎
支持精准采集配置，可以设定用精准采集挖下时完整回收方块，还是照样触发事件

---

工作台合成与加减幸运值

自由调整幸运值是幸运方块最经典好玩的核心机制

玩家可以在原版工作台里用 8 颗金锭环绕投掷器或发射器合成基础幸运方块

合成系统支持原料升级与降级调谐机制：
把已经拥有的幸运方块放在工作台任意一格
在周围放钻石、绿宝石、金苹果或下界之星，幸运值就会稳步增加
在周围放铁砧、腐肉、蜘蛛眼或毒马铃薯，幸运值就会逐步降低

工作台右侧产物格实时预览调谐结果：
物品描述里的双向彩色进度条实时变长或变短
正数显示绿色，中立显示黄色，负数显示红色
幸运点数严格限制在服主设定的区间内，防止数值无限叠加

合成系统自带防误吞保护：
带有自定义名称、说明 Lore、附魔属性或外部插件 NBT 的贵重装备
不会被误当成加减幸运值的材料消耗掉，玩家在工作台随意摆放也不用担心吞装

---

4 大事件池与连环动作编排

如果敲碎方块只是瞬间掉落几个原版矿物，玩家很快就会觉得乏味

CyuLucky 开箱自带 4 大独立事件池，共计 127 个现成预设事件：
正面幸运奖励池(矿物宝藏、金苹果雨、高阶装备、幸运喷泉)
负面厄运整蛊池(高空降铁砧、原地爆炸、黑曜石困人囚笼、女巫毒水池)
趣味奇遇池(彩虹羊群、迪斯科狂欢、高空弹射、盲盒抽奖)
工坊示范池(多阶段动作范例、外部联动范例)

事件支持按游戏刻编排分步动作：
可以设置先播放音效，等待 20 刻后屏幕弹出金色大标题
再等待 10 刻天降落雷，紧接着从天上掉落带附魔装备的骑乘怪物或战利品宝箱
也可以直接生成带点燃引信的 TNT、给玩家施加负面药水，或者把玩家弹向高空

外部插件物品原生直连：
不用写复杂的代码，在掉落配置里加上对应前缀就能掉落外部装备：
ia:物品ID (ItemsAdder 物品)
ox:物品ID (Oraxen 物品)
ce:物品ID (CraftEngine 装备)
nexo:物品ID (Nexo 物品)
ci:物品ID (CyuItems 统一物品库道具)

每个事件还可以配置细致的触发门禁：
支持限定只有雷雨天、黑夜、指定群系才能触发奇遇
支持判断玩家当前血量、潜行状态、权限节点，或结合 PAPI 变量判断玩家等级与属性

---

野外自然生成与全服气运狂欢

除了让玩家在工作台合成，幸运方块还能在野外探索中带来意外惊喜

玩家在大世界探索生成新区块时，系统会按千分比概率自动在各个层位自然刷出野生方块：
支持地表、地下深层洞穴、下界地狱、末地浮空岛与海底遗迹等独立层位
可以设置只在特定高度范围和群系刷新
野生方块不仅能单块散落，还可以伴生石英基座或装饰祭坛，让野外探索更有辨识度

全服限时气运活动能够快速带动全服活跃氛围：
服主或管理随时可以通过命令开启限时活动：

/cyulucky event start hour 1800
/cyulucky event start 欧气狂欢 15 2.0 3600

也可以在配置文件里设定每日固定时间点自动开启
活动开启后，屏幕顶部出现 BossBar 或在底部操作栏显示实时倒计时
全服玩家敲方块的幸运值均获得额外加成，野外野生方块刷新率成倍提升

气运系统还会与玩家自身的实时状态产生联动：
喝下原版幸运药水或获得霉运效果时，每级药水都能直接折算增减幸运点数
通过 PlaceholderAPI 变量还能直接把玩家的 RPG 幸运属性实时累加进开箱结果中

---

主城防拆与安全保护

很多服主担心幸运方块放进主城或者领地里会毁坏建筑，CyuLucky 内置了完备的防护机制：

主城防拆家模式
主城或指定世界开启防拆家后：
事件生成黑曜石囚笼、水坑或方块结构时，系统只会填充空气格，不会覆盖原本地面和建筑方块
厄运事件刷出的爆炸 TNT 或苦力怕，只会造成伤害与击退，不会破坏任何地形方块

出生点与高度防护
主城出生点指定半径内自动禁止放置或破坏幸运方块，防止玩家在出生点恶作剧
服主也可以限制幸运方块生效的最低与最高 Y 轴高度，防止在虚空或建筑限高区被滥用

创造模式保护与手速限频
管理员在创造模式下随手敲掉方块时，只会正常清除方块，不会触发事件
自带频率限制功能，玩家如果短时间内快速连续敲碎多个方块，超频的敲击会被自动拦截，防止卡服与刷奖励漏洞

---

自带管理菜单

插件自带直观的字符布局管理界面：

/cyulucky menu

服主与玩家可以直接在界面里：
查阅所有已启用的幸运方块模板、外观与详情
直观浏览工作台加减点调谐配方，了解不同材料能增减多少点数
管理员点击直接获取对应幸运值的方块物品

菜单采用 9 字符可视化排版，想要调整界面布局或按钮材质，直接在 menus/ 文件夹修改即可

---

指令手册速查

/cyulucky menu 打开幸运方块图形菜单
/cyulucky list 查看所有方块模板与绑定的事件池
/cyulucky get <方块ID> [点数] [数量] 向自己发放指定方块
/cyulucky give <玩家> <方块ID> [点数] [数量] 向目标玩家发放方块
/cyulucky event start <名称> <幸运加成> <生成倍率> <秒数> 开启全服限时气运活动
/cyulucky event stop 提前结束当前全服气运活动
/cyulucky event status 查看当前气运活动运行状态
/cyulucky testoutcome <事件ID> 在脚下原地测试触发指定事件动作
/cyulucky testpool <池名> [幸运值] 按幸运值加权模拟抽取并触发事件
/cyulucky doctor 一键检查方块模板、事件池与系统健康状态
/cyulucky reload 热重载全部配置文件、模板、配方与语言

---

服主怎么配与怎么排查

修改方块模板与外观
打开 blocks.yml 即可自定义方块，支持修改头颅 Base64 皮肤、玩家名、允许的幸运区间以及绑定的事件池

调整工作台加减点材料
打开 recipes.yml 可以自由配置哪些矿物加点、哪些材料扣点，也可以新增基础 9 宫格合成配方

新增自定义事件与掉落
在 outcomes/ 目录下仿照现成示例增加事件条目，设置延迟刻、音效、标题、掉落物品或召唤怪物，保存后输入 /cyulucky reload 立即生效

日常排查与配置体检
配置改完后如果担心写错格式，输入 /cyulucky doctor 一键排查模板贴图、事件池与配方引用完整性
想要测试某个动作效果，无需反复摆方块敲碎，直接输入 /cyulucky testoutcome 或 /cyulucky testpool 即可原地预览演出效果

升级配置自动备份
升级插件新版本时，旧配置会自动完整备份至 backup 目录，无需担心覆盖服主已调整好的参数

---

适合什么服务器

● 生存探索与开荒服务器
● 空岛生存与小游戏竞技服务器
● RPG 副本通关奖励与野外奇遇探索
● 使用了 ItemsAdder、Oraxen 等材质包的特色服务器
● 定期举办全服节日活动与摸奖抽奖的服务器
● 想要原汁原味幸运方块玩法且不想让玩家下载材质包的服务器

---