MuffinGames

MuffinGames turns your server into a high-stakes Runners vs Hunters race. The Runners must complete randomized goals — obtaining specific items or earning advancements — before the Hunters track them down and the clock runs out.

This is the free edition: the complete game, free to download and run, including on monetized servers and in monetized videos/streams. MuffinGames Pro adds the show — the animated Hweel, nickname/skin disguises, and a broadcast-grade win screen (see the comparison below).

Inspired by Sloimay's CamGames plugin, as used by Camman18 in his "Speedrunning random items while viewers hunt me down" series.

---

✨ What you get (free)

• Full Runners vs Hunters gameplay — two teams, one objective race, one timer. The complete game, not a demo.
• Seed-aware goal roller — /random_goal instantly picks a goal. It's smart about what it picks: items abundant near your world's spawn show up far more often, common starter items get a boost, and rare items stay rare but still possible.
• Items and advancements — roll for survival items, advancements, or a balanced 50/50 mix.
• Riggable goals — force a specific goal for events/showmatches via the optional rigging argument.
• Flexible game flow — timed games, untimed games, pause/resume, manual end, instant world regeneration.
• Admin quality-of-life — freeze players, timed whitelist, automatic stat resets.
• Zero dependencies — drop it in and play.

The free goal roll is instant and clean — it picks and announces the goal in chat with no animation. The full animated Hweel (a physical, spinning, ticking wheel that snaps onto the winner) is a Pro feature.

---

🆓 Free vs. 💎 Pro

	Free	Pro
Runners vs Hunters game	✅ Full game	✅ Full game
Seed-aware goal weighting	✅ Identical	✅ Identical
Goal rigging for events	✅	✅
All goal modes (items / advancements / mix)	✅	✅
Timed / untimed / pause / resume / regen	✅	✅
Freeze, timed whitelist	✅	✅
The Hweel — animated physical spinning wheel, ticking, easing snap, payoff	❌ Instant pick	✅ The full show
/nick — nickname players + swap their Minecraft skin (disguises)	❌	✅
Win screen — full-screen victory title + pinned winner banner	❌ Plain chat result	✅
Boss bar — segmented, color shifts green→yellow→red as time runs out	❌ Plain solid bar	✅

Free is the complete game and is great for playing with friends. Pro is for creators and shows: the spinning Hweel is the on-screen moment your audience watches, /nick lets you disguise players, and the win screen makes the finish look like a finale.

👉 Get MuffinGames Pro »

🎮 Commands

All commands require operator permission.

Game setup & flow

Command	Description
/start	Start the game (requires a created game and a set timer).
/timer <minutes> <seconds>	Set the game timer (shows on the boss bar immediately).
/new · /mg game new	Create / regenerate a fresh game world and reset stats.
/mg game force_start	Start with no timer and no time limit (needs at least one goal).
/mg game end	End the current game manually.
/mg game pause · /mg game resume	Pause / resume the game.

Goals

Command	Description
/pick_item_goal <item>	Add an item goal.
/pick_advancement_goal <advancement>	Add an advancement goal.
/clear_item_goals · /clear_advancement_goals	Clear goals.
/random_goal <goal_group> [<rigging>]	Roll a random goal (seed-weighted). Instant in free; the animated Hweel in Pro.
/mg game pick_item_goal · pick_advancement_goal · clear_item_goals · clear_advancement_goals	The same goal commands, also available under /mg game.

Teams & players

Command	Description
/mg game team <runners|hunters|clear> [player|@a]	Assign or clear a team. Use @a to move every online player at once.
/mg freeze <player> · /mg unfreeze <player>	Freeze / unfreeze a player in place.
/nick … · /mg nick …	💎 Pro only. In free, this responds with an upgrade notice.
/mg whitelist timed <player> · /mg whitelist remove <player>	Manage a temporary whitelist entry.

Misc

Command	Description
/mg credits	Broadcast the project credits.

---

🧩 How a game runs

1. /new (or /mg game new) generates a fresh world and clears goals, stats, and pods.
2. Sort players with /mg game team runners|hunters.
3. Pick goals manually (/pick_item_goal, /pick_advancement_goal) or roll them in with /random_goal.
4. Set a timer with /timer, or skip it entirely with /mg game force_start.
5. /start (timed) — the boss bar tracks goals and the countdown.
6. When the goals are completed, the timer expires, or the game is ended, the result is announced and the game resets ready for the next /new. (Pro adds a pinned on-screen winner banner.)

---

📋 Requirements

• A recent Paper server — MuffinGames uses Paper-only APIs, so Spigot/Bukkit are not supported.
• Java 21+.
• No other plugins required.

---

📦 Installation

1. Drop MuffinGames-Free-x.x.jar into your server's plugins/ folder.
2. Restart the server.

Only run one MuffinGames jar at a time — Free and Pro share the same plugin name and cannot both be loaded together.

---

🙏 Credits

Created by YuffinMuffin. Inspired by the plugin made by Sloimay named CamGames, used by Camman18. This plugin could not have been made without them.

📄 License

Proprietary — © 2026 YuffinMuffin. All rights reserved. Free to download and run, including on monetized servers and in monetized content. Redistribution, resale, modification, and reverse engineering are not permitted.