Kingdoms commands

[SigniferOne]

Yeah hmmm, "pagan_unit" is nowhere in EDU.

EDIT: I'd like to make this thread a more or less central reference for the new Kingdoms commands. I don't want to type over again my thread about earlier entries, so:

send_character_off_map - see the explanatory thread here.
recruit_priority_offset - see explanatory thread here.


CHANGE_SETTLEMENT_NAME

This is used to change the settlement name dynamically in-game, according to certain conditions. Here is the vanilla code:

;;;;; Louisiana - Choctaw

	declare_counter Choctaw_France
	
	;;; France captures Choctaw
	monitor_conditions I_SettlementOwner Choctaw = france
		and I_CompareCounter Choctaw_France = 0
		
		set_counter Choctaw_France 1
		change_settlement_name Choctaw Louisiana

 	end_monitor

	;;; Natives capture Choctaw
	monitor_conditions not I_SettlementOwner Choctaw = spain
		and not I_SettlementOwner Choctaw = england
		and not I_SettlementOwner Choctaw = france
		and I_CompareCounter Choctaw_France = 1

		set_counter Choctaw_France 0
		change_settlement_name Choctaw Choctaw

 	end_monitor

Brief run-down -- if the owner of Choctaw province becomes france, rename that province to "Lousiana". If neither spain nor england nor france own that province, rename it back to Choctaw.

Choctaw_France is a counter used to keep track of things. monitor_conditions will not monitor just once a turn, it will monitor every second, and thus, when france occupies Choctaw, it will keep firing off and keep re- and re-renaming Choctaw into Lousiana. Thus the counter is set to 1, and the monitor checks to make sure it is zero before changing the name again.

Important Note: the names to which you change settlements must be contained in /text/expanded.txt. They must contain the following format:

{Louisiana}Louisiana

The name in brackets should not be upper-cased, and instead must be letter-for-letter identical to how you write it in "change_settlement_name". It must not be all caps (unless that's what you want it to be called).

Further: even the name you change it back to, here namely Choctaw, must be contained in expanded.txt. Names of settlements are not stored as variables; once they are parsed from descr_regions.txt, the game forgets about them, how to properly spell them, etc. You must keep both varieties of the settlement's name in expanded.txt if you intend it to be allowed to be renamed back and forth.

Thus, the Spanish have a starting city Vera Cruz:



After a few seconds, it is renamed under my name: