Tartarus Features

A simple guide to the punishment system.

🔨 Bans & Mutes

The basics of keeping bad actors away.

What is it?

• Ban: Stops a player from joining the server.
• Mute: Stops a player from chatting or using commands.

How it works

• IP Bans: If you ban a player, the plugin also remembers their IP address. If they try to join on an "alt" account from the same house, they are blocked too.
• Duration: You can ban someone for 10m (10 minutes), 5d (5 days), or perma (forever).

---

⛓️ The Prison

A time-out corner for players acting up.

What is it?

Instead of kicking them off the server, you lock them in a jail cell.

How it works

1. Admin runs /prison <player> 10m.
2. The player is teleported to the jail cell (set with /setprison).
3. They are Frozen! They cannot move, jump, or break blocks.
4. They just have to sit there and think about what they did.
5. When the time is up, they are automatically teleported back to where they were.

---

🖥️ Screenshare Checks

Freeze a suspicious player for inspection.

What is it?

If you think someone is cheating (x-ray, fly hacks), you can freeze them to check their computer (over Discord screenshare, usually).

How it works

1. Admin runs /screenshare <player>.
2. The player is frozen and sees a big message: "You are being checked. Join Discord."
3. The Trap: If they panic and disconnect (log out) while frozen, the system automatically bans them. This catches cheaters who try to run away!

---

📈 Punishment Scaling

Automated discipline that gets stricter every time.

What is it?

The plugin remembers a criminal record for every player. If they break the rules again, the punishment gets worse automatically.

Modes

1. "Linear" Mode (Three Strikes)

• Threshold-Based: This mode tracks the number of offenses.
• Logic: Once a player reaches a specific threshold (e.g., 3rd offense), a specific action is triggered (e.g., 24h ban).
• Configuration: Set linear-threshold (count), linear-action (type), and linear-duration.

2. "Fractal" (Step-based) Mode

Define a specific sequence of punishments for each offense number using a list of steps.

• Step 1: ["mute", "1h"] -> 1st Offense
• Step 2: ["mute", "12h"] -> 2nd Offense
• Step 3: ["ban", "3d"] -> 3rd Offense
• Step 4: ["ban", "perma"] -> 4th Offense or higher

The plugin tracks this per player, per reason. So being muted for spamming won't make your "x-raying" status worse.

---

🔗 Cross-Ban (JanusMCD Integration)

Banning one account bans them all.

What is it?

If you have JanusMCD installed and players have linked their Discord accounts:

• Banning PlayerA will verify who they are on Discord.
• It sees that PlayerB is also linked to that same Discord account.
• Both PlayerA and PlayerB are banned instantly.