// documentation

Docs / MineTrick

A competitive 4v4 PvP minigame — collect 7 gems to win. Inspired by the original Ninja Trick browser game.

gameplay

7 gems spawn randomly in chests, and 2 teams have to fight to collect the most gems in 5 minutes. The first team to collect all the gems automatically wins. Eliminate opponents to steal their gems.

core_features

  • 4v4 Team BattlesTwo teams fight for supremacy
  • Gem CollectionCollect from chests or steal from enemies
  • Multiple ArenasCreate unlimited game arenas
  • Team ChatSend private messages to teammates
  • PartiesQueue with friends against enemies
  • Auto-StartGames start when enough players join
  • Player StatisticsTrack wins, kills, deaths, gems
  • Interactive SignsClick signs to join games
  • Team BalanceAutomatic team balancing
  • No Friendly FireTeammates can't hurt each other
  • KitsATTACK · DISTANCE · DEFENSE · MAGE
  • Power-upsRandom spawns: explosive, speed, strength, resistance, heal, invisibility
  • Hologram ScoreboardTop players with the best scores
  • Lobby HologramDynamic game info in the lobby
  • Custom MOTDReal-time game status in server list
  • Secured InventoriesProtection against drag, drop, menu exploits
  • Command ProtectionBlocks external commands during games
  • BungeeCord SupportHub & game-server modes with custom MOTD

game_rules

  • teamsTeam 1 (BLUE) vs Team 2 (RED) — 4 players each
  • objectiveFirst team to collect 7 gems wins
  • gemsSpawn in chests on start, on death, and when dropped
  • combatPlayers spawn with sword, bow, arrows and shield
  • respawn5 seconds after death with full equipment
  • victoryCollect 7 gems or have most when time runs out

how_to_play

1. Join a game using /mt join or click a join sign
2. Wait for the game to start (minimum 4 players)
3. Collect gems from chests scattered across the arena
4. Eliminate opponents to steal their gems
5. First team to collect 7 gems wins!

player_commands

  • /mt helpShow all commands
  • /mt joinJoin a random game
  • /mt join <game>Join a specific game
  • /mt leaveLeave the current game
  • /mt lobbyReturn to the main lobby
  • /mt invite <player>Send an invite to a player
  • /mt accept · /mt denyAccept / deny an invitation
  • /mt partyCheck your party informations
  • /mt teamchatEnable / disable team chat
  • /mt statsView your statistics
  • /mt stats <player>View a specific player's stats

admin_commands

  • /mt create <game>Create a new game arena
  • /mt delete <game>Delete a game arena
  • /mt setmainlobbySet the main lobby location
  • /mt setlobby <game>Set game waiting lobby
  • /mt addspawn team1 <game>Add Team 1 spawn point
  • /mt addspawn team2 <game>Add Team 2 spawn point
  • /mt addchest <game>Add chest location for gems
  • /mt pos1 <game>Set game zone corner 1
  • /mt pos2 <game>Set game zone corner 2
  • /mt start <game>Force start a game
  • /mt stop <game>Force stop a game
  • /mt listList all games
  • /mt checksetup <game>Check game setup status
  • /mt sethologramSet leaderboard hologram at your location
  • /mt setlobbyhologram <game>Set lobby hologram for a game
  • /mt updatehologramUpdate leaderboard hologram
  • /mt mode <game> <normal|ranked>Set game mode
  • /mt clearpowerups <game>Clear all power-ups in a game
  • /mt cleanupchests <game>Remove duplicate chest locations
  • /mt reloadReload configuration

quick_setup

1. Set main lobby:        /mt setmainlobby
2. Create a game:         /mt create arena1
3. Set game lobby:        /mt setlobby arena1
4. Add Team 1 spawns:     /mt addspawn team1 arena1   (add multiple)
5. Add Team 2 spawns:     /mt addspawn team2 arena1   (add multiple)
6. Add chest locations:   /mt addchest arena1         (add multiple)
7. (Optional) Lobby holo: /mt setlobbyhologram arena1
8. (Optional) Game zone:  /mt pos1 arena1 / /mt pos2 arena1
9. Create a join sign     (see below)

join_signs

Create interactive signs that players can click to join. The sign will automatically show game status and player count.

Line 1: [MineTrick]
Line 2: &lt;game-name&gt;

bungeecord_integration

MineTrick supports BungeeCord networks with two operating modes.

hub mode

Hub server

Central hub that redirects players to game servers.

  • Players click signs or use /mt join to connect to game servers
  • Automatic server routing based on game availability
  • Dynamic MOTD showing all games status
game mode

Game server

Dedicated server for one specific game.

  • Players auto-join the configured game on connect
  • Automatically sent back to hub after games
  • Dynamic MOTD with current game status & player count
  • Configurable return delay

config.yml

bungee:
  enabled: true
  mode: "game"          # or "hub"
  hub-server: "hub"
  auto-join-game: "arena1"   # for game mode
  return-delay-seconds: 5
  custom-motd: true

MOTD examples

  • hub mode"3 Open · 1 Playing · 12 Online"
  • game mode"● WAITING · 4/8 players · Join now!"

Note: MOTD lines can be left empty in messages.yml to give more space to the other line.

permissions

  • minetrick.joindefault: true — join games
  • minetrick.leavedefault: true — leave games
  • minetrick.spectatedefault: true — spectate ongoing games
  • minetrick.statsdefault: true — view statistics
  • minetrick.partydefault: true — invite a player
  • minetrick.spydefault: op — see all messages
  • minetrick.admindefault: op — all admin commands
  • minetrick.createdefault: op — create games
  • minetrick.deletedefault: op — delete games
  • minetrick.setupdefault: op — setup arenas
  • minetrick.startdefault: op — force start
  • minetrick.stopdefault: op — force stop

requirements

  • Minecraft1.18.2+
  • ServerSpigot / Paper
  • Java17+