Status
SteamPeaks
ChartsSalesUpcomingPatchesNewsCalculator
New on SteamEvery app, DLC and depot the minute Steam creates itAppsEvery app on Steam, newest change firstPackagesSubs and bundles, and what each containsDepotsDepots, manifests and install sizesTagsSteam's user tags and the games under themDevelopers & publishersCompanies and their cataloguesTechnologiesEngines, SDKs and anti-cheat found in the filesChange historyEvery PICS changelist as it lands
SignalsNineteen readings of the whole catalogueCompareAny games side by sideRecordsAll-time peaks and the days they were setReportsWeekly and monthly write-upsAlerts & newsroomWatch a game, get told when it movesSteam statusIs Steam up, right nowWeb API explorerTry the endpoints in the browser
NewsSteam's own announcements and the sales calendarCalculatorWhat a Steam account is worth, and its pile of shame
/
Sign in
/
SteamPeaks
The ultimate resource for Steam data.
ExploreChartsSalesSales and festsUpcomingPatchesNewsRecordsTrendingSignals
DatabaseAppsPackagesDepotsTagsDevelopersTechnologiesChange history
ToolsCalculatorCompareSearchAlertsSteam statusAPI
SiteMethodologyFAQDiscordSupportSign in via Steam
Not affiliated with Valve or Steam. Game names and artwork belong to their owners. All times UTC.
PrivacyCookiesFair useStatus
Fall of an EmpireNewsDev Diary: Events and Modding
Community

Dev Diary: Events and Modding

Fall of an Empire · published 24 Feb 2026, 12:10 UTC

All newsPlayers around this dateRead on Steam

Hello all! This week we're going to look at two of the systems that have been the most interesting to develop: the dynamic event system, and the modding framework that lets you create your own content for Fall of an Empire.

You'll be familiar with event pop-ups if you've played a grand strategy game before: a bit of flavour text, a scenario, and a set of options for the player to choose between. Fall of an Empire has these too but rather than being entirely hand-written, many of the game's events are generated dynamically by a local langauge model that runs alongside the game. This is, of course, optional: the models that generate these events are quite large (2, 4 and 8GB - the 8GB model will be an optional separate download).

How it works: The game keeps a library of event topics - high-level scenarios like "a governor is skimming taxes", "an allied faction requests military aid", or "your heir's education needs guidance". Every month or so, the system picks a topic that fits the current state of your empire. It then gathers context from the game world: which characters are involved, what settlements are relevant, what factions are at war, and so on. All of this gets fed to the model, which writes the actual event text and options.

An example of one of the generated events.

The result is that events feel specific to your playthrough. If you're at war with the Himmelsvolci and your treasury is running out, you might get an event about a desperate general requesting funds for a siege - naming real characters, real settlements and real armies from your game. If your heir is being educated by a clever courtier, the events about their upbringing will reflect both that courtier's personality and your heir's developing traits.

Events can also chain together. If you choose to investigate a corrupt governor rather than punish them immediately, a follow-up event will appear weeks later with the results of that investigation, written with full knowledge of what happened before. The AI keeps summaries of previous events in the chain so that continuity is maintained across the whole story.

Each option in an event has consequences: gold gained or lost, changes to character stats and traits, shifts in loyalty, unrest in settlements, character deaths. Options are decided by traits, so a merciful emperor will see different choices than a cruel one. To keep the model from going off the rails, the system uses a grammar that constrains the model's output. It can only reference characters, factions and settlements that actually exist in your game, and it can only apply effects from a defined set. So you'll never get an event that mentions a character who doesn't exist or gives you a million gold by accident.

Alongside all of this, there are also hand-written scripted events for the most important moments: great famines, barbarian hordes, plagues, crises of succession. These follow the same presentation and effect system.

I've also wanted to make Fall of an Empire moddable as it can be. The game's content is built on a system of auto-discovery: rather than registering each trait, building, unit or interaction in some central list, the game simply searches for all classes that extend a base type and makes them available. This means that adding new content is as simple as dropping a script file into the right folder.

Mods live in a Mods/ directory. Each mod is a folder with a mod.json file describing it, and then whatever content the modder wants to add: AngelScript files for gameplay logic, DataTables for icons and data, and optionally a PAK file for packaged assets like textures and sounds.

Here's what you can create:

Traits - new character modifiers with stat effects, inheritance chances, gain/loss conditions and conflicts with other traits. Want to add a "Paranoid" trait that boosts cunning but tanks loyalty? A few lines of AngelScript will do it.

Buildings - new settlement structures with resource costs, economic effects, and level-up progression. Each building can have custom logic for what happens when it's built or destroyed.

Units - new military unit types with their own damage profiles, recruitment costs, and special abilities. These can be tied to specific cultures, so a Tarhanic steppe mod could add new cavalry types that only Tarhanic factions can recruit.

Interactions - new diplomatic actions, spy operations, personal schemes, and political manoeuvres. Each interaction has its own success chance calculation, cost, requirements, and effects.

Policies and Edicts - new governance options for factions. Policies are sliders that the player can adjust over time; edicts are one-off decrees.

Cultures and Religions - entirely new cultural and religious groups, complete with their own naming conventions, stat bonuses, and gameplay modifiers.

Scripted Events - hand-authored event chains with branching narratives, context requirements, and mechanical consequences. These use the same system as the base game's events.

Event Topics - new scenarios for the event system. Modders can add their own topic prompts to the DataTable, and the model will generate events from them using whatever context the topic requires.

The icon system is also fully moddable. Icons are stored in DataTables that get merged at runtime - the base game loads its tables first, then each mod's tables are layered on top in load order. Later mods can override earlier ones, so compatibility patches are straightforward.

In addition to these I'm also working on improving it some more so that you'll be able to use an Unreal plugin that includes all the game's systems and tools, so you'll be able to produce entirely new campaigns and scenarios and edit the UI as much as you want. This should be ready to go a couple of weeks after release.

All user-facing text goes through the localisation system, so mods can be translated into any of the game's nineteen supported languages.

I've included an example mod in the game's files that demonstrates a custom trait, building, diplomacy interaction, and scripted event. It should serve as a good starting point for anyone who wants to get their hands dirty.

The modding documentation - covering content types, interactions, events, assets and packaging - will be available on the game's website.

Thank you for reading! Next up is the game's launch which is coming up quickly!

More from Fall of an Empire

Other announcements

All news
In-game event8 Sep 2026Fall of an Empire is now available on macOSHi all, I've just released a native Apple Silicon version of the game. If you're on a Mac you can download it from Steam the same as Windows. This is Apple Silicon only - M1 and later - on macOS Sonoma (14) or newer, with 16 GB of memory running on Metal. Intel Macs aren't supported unfortunately, I looked at doing both but it would have meant maintaining two Mac builds and I don't own an Intel…Game update3 Sep 2026Beta Patch 2.07 - Economy Work, Bugfixes, RebalancingHi all, New update to the beta branch: I've been working on some bugs and QOL changes to try and get everything working as smoothly as possible before starting on the next DLC. The main features here are a redone economy screen and a change to the resources map mode that makes it easier to see where resources are coming from and going to. Additionally, I've rebalanced the gameplay to make civil…In-game event30 Aug 2026Patch 2.06 - New Buildings, Faction Selection and BugfixesHi all, 2.06 is now ready to go and I've added quite a few more bugfixes and a couple of features vs the beta. The main updates though are QOL changes - I've tried to see as many little places where the game is harder to understand or work with. I've also added a few other things like new unique religious buildings (one per religion) and a 3D faction selection screen. This is going to be very i…