
How we're tuning BBox: Kingpin - Mod First design and The Director
One thing that shaped how we built everything: no data lives in the codebase. Every entity, every event, every rule is a JSON definition - what we call “Mod First” architecture. It's a bigger topic (separate post with code and demos), but the short version is that it forces a clean separation between logic and data, which makes the game much easier to tune and balance without touching code.
The Director is the system built on top of that. It's the pacing layer - the thing that decides when your comfortable operation starts falling apart.
It works by watching your activity in real time and building a threat score from it. Deals moved, territory held, money flowing - all of it feeds in with configurable weights. When the score crosses a threshold, an event fires. A rival gang moves product in your territory. A police informant gets a tip. A building gets hit.
We designed it this way because there's no realistic alternative. If you want moments like Johnny lost it during the cop raid and shot himself to actually happen in a session, you can't wait for players to stumble into that situation naturally - it could take days of play, or may never happen. The Director creates the conditions. The Scenario system (also in the screenshots) lets us author and test specific situations directly so we can make sure they feel right before a player ever sees them.
What we can tune without touching code:
Event threshold - the heat level that triggers something
Global and per-event cooldowns - rival gang attacks and street-level dealing events have completely separate pacing windows
Night multipliers - the city feels different at 2am than at noon, and that's tunable
Grace period on game start - new players get breathing room before pressure ramps
Score weights - activity (actual dealing) drives heat much more than cash alone
We're pushing toward a playtest, and when that happens, testers will be able to download the Director config from the game and share it. If someone finds a balance that works for a particular playstyle, that file is portable. The trailer down the line will show a lot of these events and scenarios in motion - this post is more about describing how it’s made.
Screenshots: the Director tuning panel and the Scenario selector, both in-game, both actively used for balancing.
- Thresher from ENGN Game Studio