THE MIMIC
Social Deduction Minigame for Paper 1.21+
One predator. Many survivors. Who will you trust?
What is The Mimic?
The Mimic is a premium social deduction minigame plugin that brings the tension of hidden-role games directly into Minecraft. One or more players are secretly assigned as the Mimic — a predator who must infect or eliminate every Survivor before time runs out.
Survivors must work together, gather clues, and identify the Mimic before it's too late. Every round is unpredictable. Every player is a suspect.
Whether you run a competitive minigames network, a casual community server, or a dedicated game server behind a proxy — The Mimic gives you a complete, production-ready experience out of the box.
Key Features
- Fully customizable game modes — Create unlimited modes via simple YAML files or the in-game mode editor GUI. Adjust duration, mimic count, roles, win conditions, phases, mutators, betrayal, and special events.
- Powerful Mimic abilities — Sound imitation (copy and replay player sounds), web traps, melee infection, and partial invisibility (sneak to activate, configurable duration & cooldown). All configurable per mode.
- Narrative campaign mode — Multi-chapter story arcs with database persistence, configurable replay, and Discord webhook milestones.
- Folia support — Region-aware schedulers for arena timers and player actions on Folia servers.
- WorldEdit-style arena setup — Define play zones with a selection wand. Per-arena waiting lobbies, random in-zone spawns, and automatic player routing.
- Custom roles system — Create unique roles with custom names, descriptions, teams, and ModelEngine 3D models.
- Perk shop & reputation economy — Players earn reputation from games and spend it on permanent boosters (double XP, double coins, jackpot multipliers…).
- Game leveling system — Dedicated minigame profile XP and levels — independent from Minecraft XP. Fully configurable curve.
- Beautiful in-game GUIs — Join arena selector, statistics panel, and perk shop — all customizable via YAML.
- REST API — Built-in HTTP API for website leaderboards and player profiles. Perfect for server websites and Discord bots.
- PlaceholderAPI support — 20+ placeholders for scoreboards, tablists, and holograms.
- Multi-language — English and French included. Easy to add more languages.
- Proxy-ready — MULTIWORLD (single server) or DEDICATED_SERVER (BungeeCord/Velocity game server) deployment modes.
Gameplay Overview
How a round works
- Players join an arena lobby with /mimic join
- When enough players are present, a countdown begins automatically
- Roles are secretly assigned — Mimics vs Survivors
- Players are scattered to random locations inside the arena zone
- The Mimic hunts using unique abilities while Survivors investigate
- Win conditions are checked in real time (infection, elimination, objectives, timer…)
- Winners receive rewards: reputation, Vault coins, PlayerPoints, and game XP
- Arena enters COOLDOWN, releases players to the hub, then resets for the next round
Mimic Abilities
| Sound Imitation | Right-click a player to replay their most recent sound — perfect for deception and framing innocent players |
| Web Trap | Throw projectiles to deploy temporary cobweb traps and slow down Survivors |
| Infection | Melee attack Survivors to infect them. Configurable cooldown and custom ItemsAdder weapons |
| Partial Invisibility | Sneak to activate partial invisibility — configurable duration, cooldown, and chat messages. Disabled during all_roles_visible phases |
Win Conditions & Game Design
Build unique game experiences with multiple win condition types:
- INFECTION_TOTALE — Mimics win when all Survivors are infected or dead
- ALL_MIMICS_DEAD — Survivors win by eliminating every Mimic
- TIMEOUT_SURVIVORS_ALIVE — Survivors win if they survive until the timer ends
- COLLECT — Survivors must gather a specific amount of items
- ESCORT — Protect a special role until time runs out (Survivors win on timeout)
- RITUAL — Survivors must place a sequence of blocks in order
- Betrayal — Survivors can backstab Mimics with a required item (configurable cooldown)
- Interactive blocks — Right-click blocks to reveal players, teleport Mimics, or access hidden rooms
- Custom endings — Bonus rewards for perfect rounds, total infection, ritual completion, and more
Combine them with timed phases (speed boosts, per-phase infection cooldown, visibility toggles), mutators (low gravity, burning webs, random sound pitch), emergency votes, proximity chat, and special events (broadcasts, MythicMobs spawns, vote triggers) for deep, replayable gameplay.
Bundled game modes
- Normal — Classic single-Mimic rules
- Loups-Garous — Werewolves-style proximity chat, votes, guard & informant roles, in-match progression
- Demon Slayer — Full-featured day/night mode with betrayal, interactive blocks, custom endings, and MythicMobs events
- Nightfall — Lightweight day/night variant for simpler setups
For Server Owners
Easy setup — arena in 4 steps
Code:
/mimic admin create myarena
/mimic admin wand myarena # Left-click corner 1, right-click corner 2
/mimic admin setlobby myarena # Waiting lobby spawn
/mimic admin sethub # Global return pointCreate a custom mode in seconds
Code:
/mimic admin mode create hardcoreThen edit modes/hardcore.yml — change mimic count, duration, win conditions, abilities. Reload with /mimic admin reload.
Monetization-ready
- Perk shop with reputation currency — sell boosters that multiply game rewards
- Vault & PlayerPoints integration for real economy rewards
- Permission-based mode access (e.g. VIP-only hardcore mode)
- PlaceholderAPI for premium scoreboard/tablist displays
Integrations
| PlaceholderAPI | Scoreboards, tablists, holograms — %mimic_level%, %mimic_role%, %mimic_wins%, and more |
| Vault | Automatic coin rewards after each game |
| PlayerPoints | Point rewards integrated into the perk booster system |
| ItemsAdder | Custom infection weapons, web projectiles, and collect objectives |
| MythicMobs | Spawn custom mobs during special timed events |
| ModelEngine | Apply 3D creature models to Mimic and custom roles during games |
All integrations are optional — the plugin works perfectly with vanilla items and no external plugins.
REST API — Website Leaderboards
Enable the built-in HTTP API and connect your server website, Discord bot, or dashboard:
Code:
GET /api/leaderboard?limit=10&sort=level
GET /api/player?username=SteveReturns JSON with wins, losses, reputation, level, game XP, and more. Secured with API key authentication.
Technical Specifications
| Minecraft Version | Paper / Folia 1.21+ |
| Java Version | Java 21 |
| Database | SQLite (default, zero config) or MariaDB |
| Languages | English & French included |
| Configuration | YAML — config.yml, modes/, roles/, perks.yml, guis.yml, langs/ |
| Documentation | Full HTML guide included (Tailwind CSS, browser-ready) |
| Command | /mimic (alias /tm) |
What's Included
- TheMimic.jar plugin file
- 4 bundled game modes (Normal, Loups-Garous, Demon Slayer, Nightfall)
- 5 custom roles (Mimic, Survivor, Guard, Informant, Demon Slayer)
- Pre-configured perk shop with boosters
- Customizable GUI layouts (stats, shop, join)
- English & French language files
- SQL schema files (SQLite & MariaDB)
- Complete HTML documentation (EN + FR)
- JUnit unit tests in source package
- Future updates (see listing terms)
Commands at a Glance
Players
Code:
/mimic join [arena] — Join a game or open arena selector (blocked if already in an arena)
/mimic leave — Leave the arena (blocked during active match when arena lock is on)
/mimic stats — View your statistics
/mimic shop — Open the perk shop
/mimic role — Check your current role
/mimic vote <player> — Cast a vote during emergency meetings
/mimic campaign — View campaign progressAdmins
Code:
/mimic admin create <name> — Create arena
/mimic admin wand <arena> — Zone selection tool
/mimic admin start <arena> [mode] — Force start
/mimic admin mode create <id> — New game mode
/mimic admin mode edit <id> — In-game GUI mode editor
/mimic admin campaign set <arena> <id> — Bind narrative campaign
/mimic admin reload — Reload everything
/mimic admin givepoints <player> <amt> — Give reputationTransform your server into the ultimate social deduction arena.
The Mimic — Hunt. Deceive. Survive.
