Mission editing

In the mission file (MissionDescription.json in your scenario folder) you can define what factions are in your scenario, how they behave in diplomacy, which diplomatic rights are unlocked and who knows which maps and has which map policies.

Faction definition

Defines faction specific data like diplomatic quests, map exploration, immigration status, faction progression, schedules, wealth etc. The order of the factions in this file is important, as they are saved and loaded by index (the position in this file). There has to be one player faction and at least one passive faction (for the animals).

You find ait in: MissionDescription.json > Diplomacy > Factions

Faction top level entry

Entry key	Type	Description
ActiveEvents	array of event string keys	Usually empty and filled while playing the game.
ActiveQuests	array of event string keys	Usually empty and filled while playing the game.
Diplomacy Quests	Diplomacy quest entries	Use the template / copy from other faction
Exploration	array of { "Discovery state":number, "Map filename":string, "ItemID":number, "ItemTargetCount":number, "ProgressTargetTime":number }	Discovery state is usually 0 (undiscovered). Set to 2 if you want it to be discovered already on scenario start. ItemID (optional) default is 16777223 [bread]. ItemTargetCount (optional) is the amount of the Item is needed. Default is 10. ProgressTargetTime is the time in worksteps, that has to be processed before unlocking the new region.
Faction name	string	Name of the faction. You can use translation keys to be localized.
Immigration	{ "CounterPush":number, "EventPush":number, "Pull":number }	Usually set by the game at runtime. Pull states how high the immigration desire is based on your attractiveness, CounterPush how the pull is reduced by events, deaths, problems etc., EventPush how many extra people you get through events.
Passive	boolean	True will hide it from the diplomatic actions and do not grant them any protection or permission.
Player	boolean	Are you sure you want to exist?
Schedule	Schedule entry	Copy or leave empty. It is generated for every new map.
Wealth	Number	How many hundredth coins you have in 1x/100 (100 equals one coin)

Diplomacy Quest Entry (E.g. Collaboration)

Entry key	Type	Description
Preconditions	array of DiplomacyRight keys	Which diplomatic right is needed to unlock this one? Empty if there is no precondition. Everything else is interpreted as a custom "quest unlock" players can solve in the scenario (displayed as "Quest solved: YOUR TEXT"). This precondition always result to false and this blocks the diplomatic quest.
Request	array of { "ID":Number, "TargetCount":Number }	What items and how much they want to unlock it. Empty if they do not ask for anything.
Reward	array of { "ID":Number, "TargetCount":Number }	What item and how much they give you if you unlock it. Empty if they do not give you anything (how rude!).
IgnoreCustomPreconditions (optional)	boolean	Set by the game when the custom precondition got unlocked by the scenario.

Faction relation definition

You find all scenario faction definition in: MissionDescription.json > Diplomacy > Status matrix

Each faction entry has a relation to another faction. For example factions A B C D E can have 10 relations. Each relation is defined in one entry in a fixed order (by the position defined in the first part).

	A	B	C	D	E
A	-	A-B	A-C	A-D	A-E
B	-	-	B-C	B-D	B-E
C	-	-	-	C-D	C-E
D	-	-	-	-	D-E
E	-	-	-	-	-

Status matrix Entry

Entry key	Type	Description
Collaboration	Boolean	Are they working together? True if they established this diplomatic right.
FreeTrade	Boolean	Are they not collecting any taxes for their trades? True if they established this diplomatic right.
Join	Boolean	Did they join the player? True if they established this diplomatic right.
RightOfWay	Boolean	Are they allowed to pass through their land? True if they established this diplomatic right.
Settling	Boolean	Ar they allowed to settle on their land? True if they established this diplomatic right.
Trading	Boolean	Are they trading with each other? True if they established this diplomatic right.