- Getting Started
- Command Reference
- Game Mechanics
- Configuration
- Troubleshooting
- Player Statistics
- ️ Admin GUI Guide
- Multi-Arena Setup
- Permissions System
Getting Started
To get started with ZPotato, follow these steps after installing the plugin:
- Create your first arena: /hp create <name> <min-players> <max-players>
- Set the lobby location: /hp setlobby <arena-name> (where players wait)
- Set the spectator area: /hp setspectate <arena-name> (where eliminated players go)
- Add spawn points: /hp addspawn <arena-name> (add multiple points around the arena)
- Optional: Set a main lobby: /hp setmainlobby (central hub for your server)
Command Reference
Player Commands:
- /hp join <arena> - Join a specific arena
- /hp leave - Leave the current arena
- /hp stats - View your personal statistics
Admin Commands:
- /hp create <arena> [min] [max] - Create a new arena
- /hp delete <arena> - Delete an arena
- /hp addspawn <arena> - Add a spawn point to an arena
- /hp setlobby <arena> - Set the lobby for an arena
- /hp setspectate <arena> - Set the spectator area
- /hp settings <arena> - Configure arena settings
- /hp start [arena] - Force start a game
- /hp stop [arena] - Force stop a game
- /hp setmainlobby - Set the main lobby
- /hp unsetmainlobby - Unset the main lobby
- /hp list - List all arenas
- /hp reload - Reload the plugin
- /hp gui or /hp admin - Open the GUI interface
Game Mechanics
- Players join an arena using /hp join <arena>
- When minimum player count is reached, a countdown begins
- Players are teleported to random spawn points
- One random player receives the hot potato
- The player with the hot potato must tag another player before time runs out
- If the timer expires, the potato explodes and eliminates that player
- Eliminated players become spectators
- The last player standing wins the game!
⚙️ Configuration
ZPotato uses three configuration files:
Code (YAML):
# Default time for the hot potato (in seconds)
default-potato-timer
: 20
# Countdown time before the game starts (in seconds)
countdown-time
: 30
# Main lobby location
main-lobby
: world:123:64:789:0:0
messages.yml
Customize all in-game messages, including prefix, countdown notifications, and game announcements.
arenas.yml
Stores arena configurations including spawn points, lobby locations, and player limits.
️ Admin GUI Guide
Access the admin interface with /hp gui or /hp admin:
- Arena List: View and manage all arenas
- Arena Settings: Configure specific arena parameters
- Color Indicators: Green = available, Yellow = starting, Red = in progress
Permissions System
- hotpotato.user - Access to player commands (join, leave, stats)
- hotpotato.admin - Access to all admin commands and features
- hotpotato.admin.create - Permission to create arenas
- hotpotato.admin.delete - Permission to delete arenas
- hotpotato.admin.start - Permission to force start games
- hotpotato.admin.stop - Permission to force stop games