MuffinGames

# 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. **(https://www.patreon.com/posts/muffingames-pro-158603927?utm_medium=clipboard_copy&utm_source=copyLink&utm_campaign=postshare_creator&utm_content=join_link)** 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. 👉 **(https://www.patreon.com/posts/muffingames-pro-158603927?utm_medium=clipboard_copy&utm_source=copyLink&utm_campaign=postshare_creator&utm_content=join_link)** --- ## 🎮 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> ` | 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> ` | 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_