
MatchboxPlugin
Matchbox is a social deduction game where 7 players work together to identify and eliminate the impostor (Spark) before it's too late. Every player looks identical, and the Spark must eliminate others without being caught.
Matchbox
Matchbox is a Minecraft social deduction minigame where everyone looks identical, but one player is secretly the Spark.
The Spark must infect players without getting caught. Everyone else must watch carefully, talk it out, and vote out the Spark before too many players are eliminated.
No names. No obvious skins. No easy proof. Just observation, paranoia, and trust.
How It Works
Each round has three phases:
1. Swipe Phase
Players move around the map while the Spark secretly infects someone.
The Medic can try to find and cure the infected player before it is too late.
2. Discussion Phase
Everyone is brought together to discuss what happened.
If an infected player was not cured, they are eliminated.
3. Voting Phase
Players vote on who they think the Spark is.
If enough players agree, that player is eliminated. If not, the game continues and the pressure increases next round.
The game ends when:
- The Spark is voted out, or
- The Spark eliminates enough players to win
Roles
Spark
The hidden impostor.
The Spark can infect players and may receive a special ability such as:
- Hunter Vision: briefly reveal nearby players
- Spark Swap: secretly swap positions with another player
- Delusion: create fake infections to confuse the Medic
Medic
The only player who can save others.
The Medic can use Healing Sight to detect infections and cure one player each round.
Innocents
Everyone else.
Watch, remember, discuss, and vote carefully.
Why Matchbox Feels Different
- Everyone looks identical during the game
- Player names and identities are hidden
- The Spark can mislead players using special abilities
- Voting uses a dynamic threshold, so players must actually agree
- Games are session-based, clean, and safe for servers
- Multiple games can run at the same time
Nicknames
Players can choose a custom nickname that becomes their identity during a game.
- Your nick replaces your real name in chat, the player list, and above your head
- Nicks are unique per game, no duplicates are allowed
- They activate when a game starts and are removed when it ends
- Your preferred nick is saved, so you don’t need to set it every time
- You can generate a random, realistic username if you don’t want to pick one
This keeps identities consistent within a match while still preserving anonymity.
For Server Owners
Matchbox is built for Paper servers and is designed to be safe, configurable, and easy to run.
Features include:
- Automatic player state restoration
- No block breaking or world damage during games
- Configurable phase lengths, roles, abilities, voting, cosmetics, and chat
- Parallel game sessions
- Official map support
- ProtocolLib-based skin and visual handling
Setup
-
Download:
- Matchbox.jar
- ProtocolLib-5.4.0.jar
-
Place both files in your server’s plugins/ folder
-
Download the official M4tchb0x map:
https://www.planetminecraft.com/project/m4tchb0x-maps/ -
Extract the map into your server folder so it sits alongside your other worlds
-
Open server.properties and set: level-name=
-
Restart the server
Matchbox ships with a ready-to-play default setup for the official map, including spawns, discussion seats, timings, and player limits.
Requirements:
Paper 1.21.10+
Java 21+
2–20 players
Basic Commands
Players
- /matchbox join
- /matchbox leave
- /matchbox list
Admins
- /matchbox start
- /matchbox begin
- /matchbox stop
- /matchbox setspawn
- /matchbox setseat
Aliases: /mb, /mbox
Links
- Source & Docs: https://github.com/OhACD/MatchboxPlugin
- Discord Support: https://discord.gg/BTDP3APfq8
