HotPotato - Round-Based Minigame v1.0.0

Round-based hot potato minigame. Standalone, rarity-weighted powerups, EN/FR, PAPI, MySQL.
  • image_2026-06-20_181109808.png
  • 2026-06-20_21.50.05.png
  • 2026-06-20_21.50.08.png
  • 2026-06-20_21.50.12.png
  • 2026-06-20_21.50.16.png
  • image_2026-06-20_181109808.png
  • 2026-06-20_21.50.05.png
  • 2026-06-20_21.50.08.png
  • 2026-06-20_21.50.12.png
  • 2026-06-20_21.50.16.png
🥔 HotPotato
A round-based, last-player-standing minigame. Pass the potato or get eliminated.
By zArrowTan, part of Arrow Plugins.



at_hotpotato_hero.png
hp1.png
hp2.png
hp3.png

at_hotpotato_footer2.png



📋 Overview

HotPotato is a round-based, last-man-standing minigame. Players are handed a hot potato, and when the round timer runs out, anyone still holding one is eliminated. Pass it by hitting another player before time's up, and the last player standing wins. It runs on its own purpose-built game engine, with arena, queue, and round logic all in-plugin, so it's lightweight and self-contained with no external minigame framework needed.

YATgBXSTrf.png

The hot potato item, pass it before the timer ends



🎮 How a Match Works

  1. Players join a lobby queue for an arena.
  2. Once enough are queued, an on-screen countdown begins.
  3. A round starts, one or more players hold the potato, and a timer counts down.
  4. Hit another player to pass the potato before the timer ends.
  5. When the timer hits zero, everyone still holding a potato is eliminated.
  6. Rounds repeat until one player remains. The winner gets fireworks and configurable rewards.

2026-06-20_21.50.12.png

The current holder glows so everyone can spot them

Discord_qk4hebJbse.png

The in-game scoreboard during a round



✨ Core Features

  • Self-Built Engine: no external arena framework, one tick loop drives every active game
  • Multiple Arenas: each with its own lobby, spawns, spectator and return points, min/max players, potato count, and round length
  • Configurable Potatoes: set how many are in play, the holder is marked with a hotbar item and a colored head indicator so everyone can spot them, with configurable holder and runner potion effects
  • Anti-Grief: players in a game can't break, place, or bucket blocks, so the map stays intact between rounds
  • Lobby Leave Item: a right-click item to leave the queue, same as /hotpotato leave
  • Rewards: run console or player commands on win or loss, with PlaceholderAPI substitution
  • Stats & Leaderboards: tracks wins, losses, and potato transfers, stored in YAML, SQLite, or MySQL
  • PlaceholderAPI: exposes %hotpotato_*% placeholders for scoreboards, chat, and other plugins
  • Live Reload: /hotpotato reload applies config and powerup changes to running games, no restart

Discord_yXZrAnAam9.png

The leave item in the waiting lobby



🎁 Powerups

Floating, pickup-able powerups placed per arena, fully config-driven in powerups.yml.

  • Built-in types: Speed, Jump, Invisibility, a Knockback Stick, and a Blindness Wand
  • Rarity-weighted spawns: common, rare, and unique, with optional random rolls each respawn
  • Eye-catching: each shows a floating name and lore, bobs and spins, and uses a custom head texture or material icon
  • Forgiving pickup: a horizontal radius plus a vertical band so they're easy to grab
  • Respawn each round to keep the action going

9BxMmxqliy.png

A powerup with its custom texture and floating hologram

2026-06-20_21.50.05.png

Hit by an enemy's Blindness Wand while holding the potato



🔲 Arena Bounds

  • Draw an invisible box around the play area with two corners
  • Spectators who fly out are returned to the spectator spawn
  • Players still in the round are held inside: walkers get a gentle shove back, and anyone flying out in creative or spectator is teleported to the edge
  • Tunable push strength, with an option to let admins fly out
  • Fully optional per arena



⌨️ Commands & Permissions

Main command /hotpotato (alias /hp).

Player Commands
  • /hotpotato join join an arena queue
  • /hotpotato leave leave the queue
  • /hotpotato list list available arenas
  • /hotpotato help show the help menu

Admin Commands (require hotpotato.admin)
  • /hotpotato reload reload config and powerups
  • /hotpotato arena the full setup subtree: create, set lobby, add spawn, set spectator, set return, set min, set max, set potatoes, set round time, set corner1, set corner2, and save

Discord_xcij1GOAHE.png

The help menu, including the admin setup commands



🌐 Localization

Ships with English and French. All player-facing text lives in language files, with support for legacy color codes and hex colors.



🧪 Requirements

  • Minecraft: 1.18+ (Spigot or Paper)
  • Java: 17 or higher
  • Storage: YAML out of the box, SQLite or MySQL optional
  • Optional: PlaceholderAPI for placeholders



📦 Installation

  1. Drop the jar into your plugins/ folder.
  2. Start the server once to generate the config files.
  3. Set up an arena with the /hotpotato arena commands, then /hotpotato reload.
First start needs internet once so the server can download the plugin's libraries (cached afterward).



📈 Metrics

This plugin uses bStats to collect anonymous usage stats. You can opt out anytime in plugins/bStats/config.yml.

HotPotato-Minigame.svg



📚 Support & Docs

Full setup and configuration guides are in the documentation. Need help, found a bug, or want to suggest a feature? Join the Discord.

Read the documentation
Click here to join the Discord

Pass it fast. Don't get caught.
Buy a license now
$4.99
EULA
Standard EULA
Use on any projects you own with attribution
Support
Standard
Includes:
Download the resource
Access new updates
Support from the creator
Support duration
Lifetime
Share and earn
Refer this resource and earn a 15% commission.
187 Views
1 Purchases
2 Downloads
Jun 25, 2026 Published
N/A Updated
Not yet rated
165.9 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
AI use in marketing
No
AI Content Disclosure
Used AI for code autocompletion and minor boilerplate while developing the plugin.
Type
  1. Gameplay
  1. Minigame
  1. Fun
Game mode
  1. Minigame
  1. KitPVP
Supported software
  1. Spigot
  1. Paper
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
Supported languages
  1. English
  1. French
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
Second-ever Modern OneBlock setup, crafted for addictive, feature-rich gameplay.
5.00 star(s) 6 ratings
87 purchases
A modern, feature-rich Survival setup with custom menus, events, and immersive gameplay systems.
5.00 star(s) 20 ratings
83 purchases
All Versions | Crates | Ranks | Upgrades | Perks | Shop | Worlds | Chunk Hoppers
5.00 star(s) 4 ratings
57 purchases
A bedwars server setup made in 1.20.4 to match the Modern theme of experience.
5.00 star(s) 5 ratings
55 purchases
1.17-1.21.8 | Native 1.21.8 | Coinshop | Playtime rewards | Chat games | Gui menus | Custom Terrain
4.50 star(s) 8 ratings
46 purchases
Share and earn
Refer this resource and earn a 15% commission.
187 Views
1 Purchases
2 Downloads
Jun 25, 2026 Published
N/A Updated
Not yet rated
165.9 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
AI use in marketing
No
AI Content Disclosure
Used AI for code autocompletion and minor boilerplate while developing the plugin.
Type
  1. Gameplay
  1. Minigame
  1. Fun
Game mode
  1. Minigame
  1. KitPVP
Supported software
  1. Spigot
  1. Paper
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
Supported languages
  1. English
  1. French
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
Second-ever Modern OneBlock setup, crafted for addictive, feature-rich gameplay.
5.00 star(s) 6 ratings
87 purchases
A modern, feature-rich Survival setup with custom menus, events, and immersive gameplay systems.
5.00 star(s) 20 ratings
83 purchases
All Versions | Crates | Ranks | Upgrades | Perks | Shop | Worlds | Chunk Hoppers
5.00 star(s) 4 ratings
57 purchases
A bedwars server setup made in 1.20.4 to match the Modern theme of experience.
5.00 star(s) 5 ratings
55 purchases
1.17-1.21.8 | Native 1.21.8 | Coinshop | Playtime rewards | Chat games | Gui menus | Custom Terrain
4.50 star(s) 8 ratings
46 purchases
Top