MurderCraft

A multiplayer Minecraft mod inspired by the Murder game mode designed by Squeezie & Théodore Bonnet (itself inspired by Garry's Mod Murder). 2 hidden murderers, 1 armed detective, innocents who must survive.

---

✦ Concept

At the start of each round, three roles are randomly assigned:

Role	Count	Weapon	Goal
☠ Murderer	2 (configurable)	Knife (one-shot)	Discreetly eliminate all innocents. Murderers cannot keep a pistol. The two murderers don't know each other directly — but they can spot each other thanks to the soul-flame awareness particles.
⚭ Detective	1	Pistol	Identify the murderers and shoot them. Shooting an innocent makes you lose your pistol permanently (dropped on the ground for any innocent to pick up).
☺ Innocent	The rest	None	Survive. Help the detective. Find the hidden pistol that drops mid-game to become the new Detective.

Session structure

A session consists of 4 rounds. Each round lasts up to 15 minutes. The team with the most round wins wins the session.

Tasks (from round 3)

Starting at round 3, one task appears per round. Any participant can attempt it:

• Exploration: a glowing chest appears nearby with a Mystery Token inside
• Crafting: an item is announced (torch, bread, etc.) — first to craft it wins

The winner of the task receives a 30-second window to use /murder task reveal <player> and learn that player's role privately. Whether to share the info with others (in voice chat) is entirely up to the player.

Win conditions

• Innocents (+ Detective) win if both murderers are eliminated OR the timer runs out
• Murderers win if they kill every non-murderer before the timer ends

---

⚙ Installation

1. Install Fabric Loader for Minecraft 1.21.1
2. Download the latest version from Modrinth
3. Place the .jar file in your mods/ folder
4. Install required dependencies:
   • Fabric API (required)
   • Cloth Config (recommended — config GUI)
   • Mod Menu (recommended — access config in-game)

Multiplayer

The mod must be installed on both the server AND every client. The mod loads in singleplayer but cannot start a match alone (minimum 4 players required, recommended 5+).

---

🎮 Commands

Command	Description	Permission
/murder join	Join the lobby	Everyone
/murder leave	Leave the lobby	Everyone
/murder status	Show current game state	Everyone
/murder task reveal <player>	Reveal a player's role (only valid after winning a task)	Everyone
/murder start	Start the session	OP
/murder stop	Stop the current game	OP
/murder config show	Print current config	OP
/murder config minPlayers <n>	Change min players	OP
/murder config duration <s>	Change round duration	OP
/murder kick <player>	Remove a player from lobby	OP

Debug commands (debug build only)

The debug build adds /murder debug ... commands for testing in solo. Not available in the public build.

---

⚒ Build from source

Requirements

• JDK 21
• IntelliJ IDEA Community (recommended)

Manual build

./gradlew build                       # Public build (debug OFF)
./gradlew build -PbuildType=debug     # Debug build (debug ON, separate JAR)

The output .jar is generated in build/libs/:

• Public: murdercraft-X.Y.Z.jar
• Debug: murdercraft-debug-X.Y.Z.jar

First setup (IntelliJ)

1. Open IntelliJ IDEA
2. File → Open → select the MurderCraft folder
3. Wait for Gradle to finish importing (it downloads Minecraft + Fabric Loom)
4. Run the runClient or runServer configuration

See SETUP.md for the full step-by-step guide.

---

📦 Automatic Modrinth publishing

GitHub Actions automatically publishes to Modrinth when you push a tag:

git tag v1.0.0
git push origin v1.0.0

Required setup:

1. Create your project on Modrinth
2. Generate a Modrinth token at https://modrinth.com/settings/pats
3. Add the token as a GitHub secret named MODRINTH_TOKEN

The workflow builds both PUBLIC and DEBUG variants. Only the PUBLIC variant is uploaded to Modrinth. The DEBUG variant is attached to the GitHub Release.

---

🎯 Roadmap

• Three-role system (Murderer / Detective / Innocent)
• Knife + pistol + hidden pistol
• GameManager with phases (Lobby → Starting → InGame → Ending)
• Custom HUD (right-side scoreboard style)
• Configuration GUI (Cloth Config)
• Multilingual (FR / EN)
• 4-round session like GMod Murder
• 15-minute rounds
• Pistol drop rules (death, friendly fire, murderer pickup prevention)
• Auto-promotion of innocent picking up hidden pistol
• Task system (Exploration + Crafting) from round 3
• Reveal mechanic via /murder task reveal
• Title overlays on screen for important events
• Murderer awareness particles (visible only to fellow murderers)
• Better sounds and particles for weapons
• Public/Debug build variants
• Custom OGG sound files (currently uses vanilla sounds)
• Persistent statistics (kills, wins, MVP)
• Dedicated map integration
• Forge / NeoForge support

---

🐛 Reporting bugs

This is a public beta. Bugs are expected. Please report them on the GitHub Issues page with:

• Mod version (e.g., 0.5.0-beta.1)
• Minecraft version
• Steps to reproduce
• Crash log / video if applicable

---

📜 License

Released under the MIT License — fork, modify, redistribute freely with attribution.

---

🙌 Credits

• Direct inspiration: The "Murder" game mode designed by Squeezie & Théodore Bonnet (the rules implemented in this mod follow their variant, not the original GMod ruleset)
• Original concept: Garry's Mod — Murder (the genre origin)
• Mod design & development: Remilulz_91
• Other gameplay inspirations: UHC, UHC Werewolves, Hypixel Murder Mystery

Important note about rules

The ruleset in this mod (2 murderers who don't know each other, hidden pistol mid-game, friendly fire = lose your gun, 4 rounds of 15 minutes, task-based reveal mechanic) is based on the variant designed by Squeezie & Théodore Bonnet. It does not reproduce the exact rules of the original Garry's Mod Murder game mode.