Zeph's EggHunt
给你的玩家安排一个复活节活动吧!这是一款专为 Nexo 打造的复活节彩蛋寻宝游戏,让你能为玩家提供真实的彩蛋模型。在世界的各个角落隐藏彩蛋供玩家寻找,或者让服务器在玩家探索时自动在他们附近生成彩蛋。这两种模式可以同时运行。
工作原理
活动彩蛋(管理员隐藏)
使用放置法杖在世界各处隐藏 Nexo 家具风格的彩蛋。每位玩家都可以找到并认领每个彩蛋一次。一旦有人收集了彩蛋,该彩蛋对他们来说会变为“已领取”的外观。
随机彩蛋(玩家生成)
每隔几分钟,每位在线玩家都有机会在附近某个地方生成一个彩蛋。生成时会播放提示音,可选的粒子效果和环境音效会脉冲式出现,帮助玩家追踪目标。如果没有人拾取,彩蛋会在超时后消失。
法杖
通过 /egghunt wand 命令获得一根烈焰棒法杖。右键点击方块以放置朝向你方向的彩蛋。左键点击可切换层级——还有一个随机选项,每次放置时都会按权重随机抽取一个层级。潜行 + 右键点击移除最近的彩蛋。
层级与视觉多样性
你可以设置任意多个层级。每个层级可以包含多个 Nexo 家具 ID,从而在共享相同奖励池的同时实现视觉上的多样性。插件在放置时会随机选择一个。
奖励
奖励只是配置文件中的字符串。无需嵌套 YAML,也无需类型声明:
- "diamond 5"
- "golden_apple 1 &eShiny Apple"
- "cmd: eco give {player} 500"
每行的出现几率相等。想让某项奖励出现得更频繁?把它添加两次即可。
动作栏
动作栏显示收集进度。动作栏会出现在配置文件中设定的世界内。如果你计划在活动世界中隐藏彩蛋,默认设置为 "event"。你可以将其更改为 "world",使动作栏在主世界中显示。收集随机彩蛋时会显示一次性的快速确认提示。两者均可配置。
统计信息与排行榜
活动彩蛋和随机彩蛋分别进行统计。玩家可以使用 /egghunt stats 查看自己的统计数据,排行榜则展示两种模式下总收集量最高的玩家。活动结束后将公布顶级猎手。
PlaceholderAPI
可选功能——即使没有它也能正常运行。但如果你安装了 PlaceholderAPI,就可以获取关于玩家数量、活动状态、排行榜位置等的占位符。适用于记分板、Tab 列表、全息图或任何其他用途。
| 占位符 |
返回值 |
%egghunt_collected% |
玩家收集的彩蛋总数 |
%egghunt_event_collected% |
玩家收集的活动彩蛋数 |
%egghunt_random_collected% |
玩家收集的随机彩蛋数 |
%egghunt_total% |
全服累计收集总数 |
%egghunt_active% |
活动是否正在进行 |
%egghunt_rank% |
玩家在排行榜中的位置 |
%egghunt_top_1_name% |
第一名收集者的名称 |
%egghunt_top_1_count% |
第一名收集者的数量 |
命令
| 命令 |
权限 |
功能 |
/egghunt stats |
egghunt.stats |
个人统计数据详情 |
/egghunt leaderboard |
egghunt.leaderboard |
最高收集者排行榜 |
/egghunt start |
egghunt.admin |
开始活动 |
/egghunt stop |
egghunt.admin |
结束活动,显示结果 |
/egghunt wand |
egghunt.admin |
获取放置法杖 |
/egghunt clear [admin|player|all] |
egghunt.admin |
按模式清除彩蛋 |
/egghunt cleanup |
egghunt.admin |
清理孤立实体 |
/egghunt reload |
egghunt.admin |
重载配置文件 |
/egghunt status |
egghunt.admin |
一览活动信息 |
/egghunt debugspawn |
egghunt.admin |
在附近强制生成测试彩蛋 |
/egghunt reindex |
egghunt.admin |
区块问题后重新链接实体 ID |
权限
| 权限 |
默认值 |
描述 |
egghunt.admin |
op |
所有管理命令 |
egghunt.collect |
true |
收集彩蛋 |
egghunt.stats |
true |
查看个人统计 |
egghunt.leaderboard |
true |
查看排行榜 |
要求
- Paper 1.21.4+(不支持 Spigot —— 使用了 Paper API)
- Java 21
- Nexo 用于彩蛋家具模型
- ProtocolLib 用于个性化视觉效果
可选: PlaceholderAPI 用于记分板、Tab 列表、全息图等。
彩蛋模型
本插件不包含任何模型——你需要设置 Nexo 家具物品作为你的彩蛋。我们在 Cobble & Commons 服务器上使用的是来自 MCModels 的模型,开箱即用效果极佳:
MCModels 上的 Easter Egg Collection
如果你希望拥有精致的视觉效果而不想自行制作,强烈推荐此方案。只需将它们放入你的 Nexo 配置中,并在 EggHunt 配置中匹配相应的家具 ID 即可。
在线体验
想在部署之前看看实际效果吗?欢迎加入 Cobble & Commons 服务器体验——这是本插件开发和测试的地方。我们同时开启两种模式举办季节性彩蛋寻宝活动。
服务器地址: mc.cobblecommons.com
Zeph's EggHunt
Give your player's an activity to do this Easter! An Easter Egg hunt built for Nexo so you get real Egg Models for players to hunt. Hide eggs around your world for players to find, or let the server scatter them automatically near players as they explore. Both modes work at the same time.
How It Works
Event Eggs (Admin Hidden)
Use a placement wand to hide Nexo furniture eggs around your world. Every player can find and claim each egg once. Once someone collects an egg, it changes to a "claimed" look just for them.
Random Eggs (Player Spawning)
Every few minutes, each online player has a chance of an egg popping up somewhere nearby. A chime plays when it spawns, and optional particles and ambient sounds pulse to help players track it down. If nobody grabs it, it despawns after a timeout.
The Wand
You get a blaze rod wand via /egghunt wand. Right-click a block to place an egg facing your direction. Left-click to cycle tiers — there's also a Random option that rolls a weighted tier each time you place. Sneak + right-click removes the nearest egg.
Tiers and Visual Variety
Set up as many tiers as you want. Each tier can have multiple Nexo furniture IDs, so you get visual variety while sharing the same reward pool. The plugin picks one randomly when placing.
Rewards
Rewards are just strings in the config. No nested YAML, no type declarations:
- "diamond 5"
- "golden_apple 1 &eShiny Apple"
- "cmd: eco give {player} 500"
Equal chance per line. Want one to show up more? Add it twice.
Action Bar
Action bar shows the collection process. Action bar shows up in the world set by the config. By default, it's set to "event" if you plan to hide the eggs in an event world. You can change it to "world" to make the action bar show up in the main world. Collecting a random egg shows a quick one-shot confirmation. Both are configurable.
Stats and Leaderboard
Event eggs and random eggs are tracked separately. Players can check their own stats with /egghunt stats, and the leaderboard shows top collectors across both modes. Top hunters are announced when the event ends.
PlaceholderAPI
Optional — everything works without it. But if you have PlaceholderAPI, you get placeholders for player counts, event status, leaderboard positions, and more. Useful for scoreboards, tab, holograms, or whatever you're running.
| Placeholder |
What it returns |
%egghunt_collected% |
Player's total eggs |
%egghunt_event_collected% |
Player's event eggs |
%egghunt_random_collected% |
Player's random eggs |
%egghunt_total% |
Server-wide total collected |
%egghunt_active% |
Whether the event is running |
%egghunt_rank% |
Player's leaderboard position |
%egghunt_top_1_name% |
#1 collector's name |
%egghunt_top_1_count% |
#1 collector's count |
Commands
| Command |
Permission |
What it does |
/egghunt stats |
egghunt.stats |
Your personal stats breakdown |
/egghunt leaderboard |
egghunt.leaderboard |
Top collectors |
/egghunt start |
egghunt.admin |
Start the event |
/egghunt stop |
egghunt.admin |
End the event, show results |
/egghunt wand |
egghunt.admin |
Get the placement wand |
/egghunt clear [admin|player|all] |
egghunt.admin |
Remove eggs by mode |
/egghunt cleanup |
egghunt.admin |
Clean up orphaned entities |
/egghunt reload |
egghunt.admin |
Reload config |
/egghunt status |
egghunt.admin |
Event info at a glance |
/egghunt debugspawn |
egghunt.admin |
Force-spawn a test egg nearby |
/egghunt reindex |
egghunt.admin |
Re-link entity IDs after chunk issues |
Permissions
| Permission |
Default |
Description |
egghunt.admin |
op |
All admin commands |
egghunt.collect |
true |
Collect eggs |
egghunt.stats |
true |
View personal stats |
egghunt.leaderboard |
true |
View leaderboard |
Requirements
- Paper 1.21.4+ (not Spigot — uses Paper APIs)
- Java 21
- Nexo for the egg furniture models
- ProtocolLib for per-player visuals
Optional: PlaceholderAPI for scoreboards, tab, holograms, etc.
Egg Models
This plugin doesn't include any models — you'll need Nexo furniture items set up for your eggs. The ones we use on Cobble & Commons are from MCModels and work great out of the box:
Easter Egg Collection on MCModels
Highly recommended if you want a polished look without building your own. Just drop them into your Nexo config and match the furniture IDs in the EggHunt config.
Try It Live
Want to see it in action before setting it up? Come check it out on Cobble & Commons — the server where this plugin was built and tested. We run seasonal egg hunts with both modes active.
Server Address: mc.cobblecommons.com
评论 0
登录后参与评分
还没有评论,来抢沙发吧