Trouble in Trork Town (TTT)

Trouble in Trork Town (TTT) – Hytale Mod

Trouble in Trork Town is an open-source gamemode for Hytale, inspired by the classic Trouble in Terrorist Town
from Garry’s Mod. It can also be configured to be played as Murder Mystery. And its published in github, curseforge and modtale, supporting the latest Hytale version.

Players are assigned hidden roles each round and must rely on deduction, investigation, and deception to survive.
Innocents attempt to uncover the truth, traitors sow chaos from the shadows, and detectives use special tools to piece
everything together—before it’s too late.

The project was prototyped during Hytale’s first week and is designed to be modular, configurable, and extensible,
making it easy for the community to build on top of it.

Quick Start

To set up this mod, please follow the guide at: CONFIG.md
Open the special shop by using double-tap on the Alt key (while alive and in the appropriate role, Traitor or
Detective).
Open the scoreboard: press the O key.
Minimum players: configurable in the server configuration (e.g. config.json). Default: 3 players.
Maps: at least one map template must be configured under mods/ncode_ttt/maps (the map system requires a configured
map to run).
For maps you can use anything you want, but here you have some already configured: hytale-ttt-maps

Current Features

🎭 Roles System

Configurable roles. Default ones are:
- Innocents: need to survive and work together to identify and eliminate traitors.
- Traitors: must eliminate everyone without getting caught.
- Detectives: have special tools to help expose the truth.
Spectator – Dead players can freely observe without interacting.
Always-visible role UI for alive players.
Role ratios are fully configurable.

🔫 Weapons & Equipment

Configurable equipment store for traitors and detectives.
Items can be purchased with credits or looted from dead players.
Weapon spawning integrated directly into maps.
Weapon Categories & Ammunition: Support weapon types (e.g. melee, ranged, utility) and associated ammo pools.

🗺️ Custom Map System

Templates folder inside universe are interpreted as instances of maps that can be voted and played.
Player spawn positions are configurable.
Weapons spawn positions are configurable.
Amount of rounds per map configurable.
Preview images of the map you are voting.

Weapon Spawning on Maps

Custom Weapon Spawn Points: Define weapon spawn locations directly in map templates.
Weapon Categories & Ammunition: Support weapon types (e.g. melee, ranged, utility) and associated ammo pools.

🔁 Round & Phase System

Rounds are event-driven and divided into clear phases:

Waiting
1. Players spawn and explore freely.
2. Round starts automatically when enough players join.
Playing
1. Roles are assigned.
2. Deaths affect win conditions and karma.
3. Dead players become spectators.
Aftermatch
1. Cooldown before the next round.
2. Ideal for map voting or short downtime.

Win conditions are evaluated dynamically as players die.

⚖️ Karma System

A configurable karma system that encourages fair play:

Team kills reduce karma.
Correct kills increase karma.
All karma values are configurable.

🪦 Corpses / Graves & Body Confirmation

Dead players leave behind configurable corpses or graves.
Corpses / Graves can be inspected to:
- Confirm death
- Reveal information about the victim
Prevents instant role revelation and preserves deduction gameplay.

📊 Scoreboard

Displays:
- Kills / deaths
- Karma
Traitor roles are hidden from alive players.

🌍 Localization

Fully translation-ready.
All text is externalized via language files.
English and Spanish included by default.

🗺️ Backlog & Planned Features

This project is under active development. The short-term roadmap focuses on core infrastructure needed to support
richer gameplay and community-made content.

Expanded detective and traitor equipment:
- DNA Scanner
- Traitor Knife
- Detective skin
Separate chat channels (alive / dead / spectator)
Karma-based punishments and reputation system
Improved UI/UX polish
Better modding hooks for third-party extensions

Open-Source Philosophy

This mod is fully open-source and built with extensibility in mind.

ECS-oriented design
Contributions, maps, translations, and feature ideas are welcome

The goal is not just to recreate TTT, but to provide a community-driven foundation for gamemodes in Hytale.

AI Ussage

There is ussage of AI in this project as a tool to enhance creativity and productivity, always with human review and
testing, and limited to:

Code snippets.
Text content, descriptions, and documentation.
Provisional concept art used for mandatory logos, banners, and also for prototyping with temporary models.

Art and Images

Artowrk / Image	Description
	A Trork in Trouble - Artwork commissioned to IZANAGIOOZ
	Concept art made with ChatGPT - 4x4 logo picture of a dead troll, in the style of Goya and Beksinski, oil painting, cinematic, dark fantasy, gothic style, dark medieval background, gloomy atmosphere, masterpiece. Include the text Trouble in Trork Town