TTT – Trouble in Terrorist Town

Traitors are hiding among the players. The Innocents have to find them before they are all dead themselves, and the Detectives help them. It plays like on GommeHD:

• Chests with weapons and the traitor tester
• Corpses that you identify
• Karma and a points shop for Traitors and Detectives
• Passes that you buy with coins

TTT is a game mode (license gm:ttt); everything can be configured per task.

Setting up

1. Create a task: Cloud → Spielmodi ("Game modes") → TTT → Task erstellen ("Create task"). 1.5 GB RAM is enough for 24 players.
2. Maps: at least one waiting lobby and one arena. Several arenas are better, because then there is a map vote.
3. Set markers on the setup server (/gsetup tp <Karte>, /gsetup marker <Typ>):

1. Chests you simply build into the map: every chest (trapped chests too) gives a random item when opened and disappears. An ender chest gives the strong item (default: iron sword).
2. Finish setup.

How a round works

Roles:

• Traitors: players × Traitor share (Anteil Traitor), at least 1.
• Detectives: only from Detectives from players (Detective ab Spielern) on; they are visible to everyone (blue name, blue helmet).
• Innocents: everyone else.

Traitors see the other Traitors in red and write in the traitor chat (@Nachricht, i.e. @ followed by the message, or /tc). The dead and spectators only chat among themselves and see all roles.

Corpses

Whoever dies stays behind as a corpse with their head („Unbekannte Leiche“, "Unknown corpse"). A right-click identifies it; everyone then learns who it was and which role they had. Detectives additionally see how long the person has been dead. Optionally they also see whether the killer was a Traitor (Detective sees killer's role, Detective sieht Täterrolle).

Traitor tester

One player stands on the tester spot, another one presses the tester button. After the Test duration (Prüfdauer) the lamps light up red (Traitor) or green; after that the tester needs a cooldown.

The traitor trap: once per round a Traitor presses the trap button. The tester then always shows green for a while.

Karma

• Starting value: Everyone starts with 1000, which is also the maximum.
• Less damage: With Damage by karma (Schaden nach Karma), players below the starting karma deal less damage (karma ÷ start, at least 50 %).
• Lockout: With Lockout below karma (Sperre unter Karma), players with too little karma are no longer allowed to play at all.

Shop

Traitors and Detectives get a shop item (emerald, right-click). Payment is in points: Starting points (Startpunkte) at the start of the round, plus Points per kill (Punkte pro Kill) for every enemy.

Every price is configurable. With 0, an item is not in the shop. Kills by explosions count for whoever triggered them. The map itself always stays intact.

Passes

With a Traitor or Detective pass you are guaranteed the role as long as slots are free.

• How many: At most Max. via pass (Höchstens per Pass) of the slots, by default half.
• Redeeming: in the lobby via the pass item. The pass is only used up once you actually get the role.
• Buying: in the same menu with coins (Traitor pass price (Preis Traitor-Pass) and Detective pass price (Preis Detective-Pass); 0 = cannot be bought).
• Free: Anyone with eternal.ttt.pass.free redeems passes for free.
• Granting: /ttt givepass <player> <traitor|detective> [amount] (permission eternal.ttt.pass.give; minus takes away) or in the dashboard under Cloud → Gamemodes → task → Pässe, with a history.
• Web shop (real money too): REST API with an API key or the permission eternal.web.gamemodes.passes:

POST /api/gamemodes/ttt/passes/player/{name or UUID}
{ "kind": "traitor", "amount": 1, "reference": "order-1234", "reason": "Web shop" }
→ { "ok": true, "duplicate": false, "count": 3, "uuid": "…", "name": "…" }

• A reference (order id) is booked once: if the payment provider repeats the call, the answer is "duplicate": true and no second pass is granted.
• A negative amount takes passes away (e.g. for a chargeback); if the player has fewer, the API answers 409.
• A UUID also works for players who have never joined.
• GET /api/gamemodes/ttt/passes/player/{player} returns count and history, GET /api/gamemodes/ttt/passes/reference/{reference} the booking of an order.
  • Passes belong to the player network-wide. Buying, granting and redeeming are separate bookings; nothing overwrites anything (not even while the player is in a round).

Rewards and statistics

Coins are awarded for a win (Coins per win (Coins für Sieg), everyone in the winning team) and for every enemy kill (Coins per kill (Coins pro Kill)). For this the server needs the Coins module. If a coins cluster is set on the TTT server, they go into that cluster's balance.

/ttt stats [Spieler] shows:

• Games, wins and karma
• Kills (correct and wrong), deaths and K/D
• Wins per role and your own passes

The data applies across the whole network and to all TTT tasks.

Commands

Permissions and packages

Packages:

• TTT Premium: double vote, join full rounds, spectate.
• TTT YouTuber: additionally fix the map and shorten the start.
• TTT Team: eternal.ttt.*.

Assigned under Task → Rechte-Pakete ("Permission packages"), see Game modes.

Settings

All values are in the dashboard under Task → Einstellungen ("Settings") and are explained there one by one: