Hardcoded IF — chk(249, …) Gateway Functions¶
← CHK Functions · CHK code catalog
chk(249, …) (CheckHardcodedIF, CHK code 249) is a second-level dispatcher: its first argument is a sub-function number. It is the read-side workhorse in shipped logic (e.g. chk(249,1,CHARID,9) rolls a skill, chk(249,17,ZONEID) counts a zone's hexes). Each sub-function below gets a friendly name; they all compile to chk(249, sub, …). See the chk 249 catalog row and the chk(249) section of the CHK reference.
Numeric IDs may be replaced by
$N$S&S-ID references or flag instructions (e.g.ZONEID,REGID,CHARID) exactly as in raw CHK.che(249, …)is an accepted alias forchk(249, …).
SkillRoll¶
SkillRoll(char_ID: int, skill_Type_ID: int, n1_just_return_skill_level_no_roll: int) · chk 249,1
Parameters
char_ID(int) — Char IDskill_Type_ID(int) — Skill Type IDn1_just_return_skill_level_no_roll(int) — 1 = just return skill level (no roll)
Example: chk(249,1,1,2,2)
StratagemCardCount¶
StratagemCardCount(card_Stratagem_ID: int, skill_filter: int) · chk 249,2
Parameters
card_Stratagem_ID(int) — Card/Stratagem IDskill_filter(int) — (skill filter)
Example: chk(249,2,1,2)
InversePercentage¶
InversePercentage(original_value: int, percentage: int, maximum: int) · chk 249,3
Parameters
original_value(int) — Original valuepercentage(int) — Percentagemaximum(int) — Maximum
Example: chk(249,3,1,50,1)
TroopPowerPoints¶
TroopPowerPoints(zone_ID: int, regime_ID: int, mode: int) · chk 249,4
Parameters
zone_ID(int) — Zone IDregime_ID(int) — Regime IDmode(int) — mode
Example: chk(249,4,1,4,1)
WhoMadeTheRoll¶
WhoMadeTheRoll(char_ID: int, skill_Type_ID: int) · chk 249,5
Parameters
char_ID(int) — Char IDskill_Type_ID(int) — Skill Type ID
Example: chk(249,5,1,2)
OrgCount¶
OrgCount(regime_ID: int, n0_count_0_PP_cost_tier: int) · chk 249,6
Parameters
regime_ID(int) — Regime IDn0_count_0_PP_cost_tier(int) — 0 = count, ≠0 = PP-cost tier
Example: chk(249,6,4,1)
RandomCityZoneID¶
RandomCityZoneID(regime_ID: int, n0_must_have_city_1_any: int, closest_to_current_neighbour: int) · chk 249,7
Parameters
regime_ID(int) — Regime IDn0_must_have_city_1_any(int) — 0 = must have city, 1 = anyclosest_to_current_neighbour(int) — closest-to-current / neighbour
Example: chk(249,7,4,1,1)
RandomBinaryTech¶
RandomBinaryTech(regime_ID: int, n0_any_1_already_discovered: int) · chk 249,8
Parameters
regime_ID(int) — Regime IDn0_any_1_already_discovered(int) — 0 = any, 1 = already discovered
Example: chk(249,8,4,200)
RandomMiningAsset¶
RandomMiningAsset(zone_ID: int, max_easy_level: int, max_reserves_left: int) · chk 249,9
Parameters
zone_ID(int) — Zone IDmax_easy_level(int) — Max easy levelmax_reserves_left(int) — Max reserves left
Example: chk(249,9,1,1,1)
AssetInfo¶
AssetInfo(asset_ID: int, info_type_1_mining_ease: int, extra: int) · chk 249,10
Parameters
asset_ID(int) — Asset IDinfo_type_1_mining_ease(int) — Info type (1 = mining ease)extra(int) — (extra)
Example: chk(249,10,1,1,1)
AssetFamilyLevel¶
AssetFamilyLevel(zone_ID: int, asset_Family_ID: int) · chk 249,11
Parameters
zone_ID(int) — Zone IDasset_Family_ID(int) — Asset Family ID
Example: chk(249,11,1,1)
HasLeaderFeat¶
HasLeaderFeat(char_ID: int, leader_Feat_ID: int) · chk 249,12
Parameters
char_ID(int) — Char IDleader_Feat_ID(int) — Leader Feat ID
Example: chk(249,12,1,1)
HighestCharID¶
HighestCharID() · chk 249,13
Example: chk(249,13)
TotalSpies¶
TotalSpies(spying_regime_ID: int, target_regime_ID: int) · chk 249,14
Parameters
spying_regime_ID(int) — Spying regime IDtarget_regime_ID(int) — Target regime ID
Example: chk(249,14,4,4)
FactionID¶
FactionID(regime_ID: int, rank_1_biggest_2_2nd: int) · chk 249,15
Parameters
regime_ID(int) — Regime IDrank_1_biggest_2_2nd(int) — Rank (1 = biggest, 2 = 2nd…)
Example: chk(249,15,4,1)
DiplomaticDifficultyModifier¶
DiplomaticDifficultyModifier(regime_ID: int, target_regime_ID: int) · chk 249,16
Parameters
regime_ID(int) — Regime IDtarget_regime_ID(int) — Target regime ID
Example: chk(249,16,4,4)
ZoneHexCount¶
ZoneHexCount(zone_ID: int) · chk 249,17
Parameters
zone_ID(int) — Zone ID
Example: chk(249,17,1)
ZonePerkCount¶
ZonePerkCount(zone_ID: int, perk_category_ID_or_0: int, perk_ID_or_0: int) · chk 249,18
Parameters
zone_ID(int) — Zone IDperk_category_ID_or_0(int) — Perk category ID or 0perk_ID_or_0(int) — Perk ID or 0
Example: chk(249,18,1,1,1)
UnitFeatCount¶
UnitFeatCount(unit_His_ID: int, unit_Feat_ID: int) · chk 249,19
Parameters
unit_His_ID(int) — Unit His IDunit_Feat_ID(int) — Unit Feat ID
Example: chk(249,19,1,1)
UnitSubFormationCount¶
UnitSubFormationCount(unit_His_ID: int) · chk 249,20
Parameters
unit_His_ID(int) — Unit His ID
Example: chk(249,20,1)
RandomTechToDiscover¶
RandomTechToDiscover(regime_ID: int, n0_any_1_must_be_discoverable: int) · chk 249,21
Parameters
regime_ID(int) — Regime IDn0_any_1_must_be_discoverable(int) — 0 = any, 1 = must be discoverable
Example: chk(249,21,4,1)
MakeProspectDiscovery¶
MakeProspectDiscovery(zone_ID: int) · chk 249,22
Parameters
zone_ID(int) — Zone ID
Example: chk(249,22,1)
MakeArchaeologicalDiscovery¶
MakeArchaeologicalDiscovery(zone_ID: int) · chk 249,23
Parameters
zone_ID(int) — Zone ID
Example: chk(249,23,1)
Fn3rdPartyCharacterCreation¶
Fn3rdPartyCharacterCreation(language_ID: int, sex_1_M_2_F: int, final_Career_ID: int) · chk 249,24
Parameters
language_ID(int) — Language IDsex_1_M_2_F(int) — Sex (1=M, 2=F)final_Career_ID(int) — Final Career ID
Example: chk(249,24,1,1,13)
DestroyAssets¶
DestroyAssets(zone_ID: int, asset_type_stringlist_col_0: int, levels_to_destroy: int) · chk 249,25
Parameters
zone_ID(int) — Zone IDasset_type_stringlist_col_0(int) — Asset-type stringlist col# (>0)levels_to_destroy(int) — Levels to destroy
Example: chk(249,25,1,1,1)
FindLeaderByJob¶
FindLeaderByJob(jobtype_ID: int, specific_job_zone_org_ID: int, regime_ID: int) · chk 249,26
Parameters
jobtype_ID(int) — Jobtype IDspecific_job_zone_org_ID(int) — Specific job (zone/org ID)regime_ID(int) — Regime ID
Example: chk(249,26,10,1,4)
ProfileRelationRoll¶
ProfileRelationRoll(char_ID: int, profile_number: int) · chk 249,27
Parameters
char_ID(int) — Char IDprofile_number(int) — Profile number
Example: chk(249,27,1,1)
CharSZoneID¶
CharSZoneID(char_ID: int) · chk 249,28
Parameters
char_ID(int) — Char ID
Example: chk(249,28,1)
SeniorityRank¶
SeniorityRank(regime_ID: int, char_ID: int) · chk 249,29
Parameters
regime_ID(int) — Regime IDchar_ID(int) — Char ID
Example: chk(249,29,4,1)
HasRegimeFeat¶
HasRegimeFeat(regime_ID: int, regime_Feat_ID: int) · chk 249,30
Parameters
regime_ID(int) — Regime IDregime_Feat_ID(int) — Regime Feat ID
Example: chk(249,30,4,4)
RandomNeighbouringZone¶
RandomNeighbouringZone(zone_ID: int, n0_any_1_excl_hostile_2_excl_friendly: int) · chk 249,31
Parameters
zone_ID(int) — Zone IDn0_any_1_excl_hostile_2_excl_friendly(int) — 0 = any, 1 = excl hostile, 2 = excl friendly
Example: chk(249,31,1,1)
HisUnitSZoneID¶
HisUnitSZoneID(unit_His_ID: int) · chk 249,32
Parameters
unit_His_ID(int) — Unit His ID
Example: chk(249,32,1)
LocIDOfARegime¶
LocIDOfARegime(regime_ID: int, n0_capitol_1_random_city: int) · chk 249,33
Parameters
regime_ID(int) — Regime IDn0_capitol_1_random_city(int) — 0 = capitol, 1 = random city
Example: chk(249,33,4,1)
CoordXYOfALocID¶
CoordXYOfALocID(loc_ID: int) · chk 249,34
Parameters
loc_ID(int) — Loc ID
Example: chk(249,34,1)
SetAPromise¶
SetAPromise(demand_ID: int, xY: int, deadline: int) · chk 249,35
Parameters
demand_ID(int) — Demand IDxY(int) — XYdeadline(int) — Deadline
Example: chk(249,35,1,1,1)
CheckAPromise¶
CheckAPromise(promise_ID: int) · chk 249,36
Parameters
promise_ID(int) — Promise ID
Example: chk(249,36,1)
FreeSpaceForHexFeat¶
FreeSpaceForHexFeat(zone_ID: int) · chk 249,37
Parameters
zone_ID(int) — Zone ID
Example: chk(249,37,1)
FreeSpaceForFreeFolk¶
FreeSpaceForFreeFolk(zone_ID: int) · chk 249,38
Parameters
zone_ID(int) — Zone ID
Example: chk(249,38,1)
JobCabinetFeatCount¶
JobCabinetFeatCount(jobtype_999_any_cabinet: int, leader_Feat_Type_ID: int) · chk 249,39
Parameters
jobtype_999_any_cabinet(int) — Jobtype (999 = any cabinet)leader_Feat_Type_ID(int) — Leader Feat Type ID
Example: chk(249,39,10,1)
OfMajorsAtWarWith¶
OfMajorsAtWarWith(regime_ID: int) · chk 249,40
Parameters
regime_ID(int) — Regime ID
Example: chk(249,40,4)
CoordXYOfAZoneSLoc¶
CoordXYOfAZoneSLoc(zone_ID: int) · chk 249,41
Parameters
zone_ID(int) — Zone ID
Example: chk(249,41,1)
TradeHouseBorders¶
TradeHouseBorders(regime_ID: int, inst1: int, inst2: int) · chk 249,42
Parameters
regime_ID(int) — Regime IDinst1(int) — (inst1)inst2(int) — (inst2)
Example: chk(249,42,4,1,1)
MarketTradeHubAuction¶
MarketTradeHubAuction(param: int, param: int) · chk 249,43
Parameters
param(int) — (param)param(int) — (param)
Example: chk(249,43,1,1)
CoastalHex¶
CoastalHex(zone_ID: int, mode: int) · chk 249,44
Parameters
zone_ID(int) — Zone IDmode(int) — (mode)
Example: chk(249,44,1,1)
RandomLeaderForMarketTradeHub¶
RandomLeaderForMarketTradeHub(param: int, param: int) · chk 249,45
Parameters
param(int) — (param)param(int) — (param)
Example: chk(249,45,1,1)
ItemQtyInAZoneSCityHQUnit¶
ItemQtyInAZoneSCityHQUnit(zone_ID: int, item_Type_ID: int) · chk 249,46
Parameters
zone_ID(int) — Zone IDitem_Type_ID(int) — Item Type ID
Example: chk(249,46,1,7)
TraderCredits¶
TraderCredits(trader_zone_ID: int, amount_to_add: int) · chk 249,47
Parameters
trader_zone_ID(int) — Trader-zone IDamount_to_add(int) — amount to add (+)
Example: chk(249,47,1,1)
ZoneCount¶
ZoneCount(regime_ID: int) · chk 249,48
Parameters
regime_ID(int) — Regime ID
Example: chk(249,48,4)
MineExtend¶
MineExtend(zone_ID: int, regime_ID: int) · chk 249,49
Parameters
zone_ID(int) — Zone IDregime_ID(int) — Regime ID
Example: chk(249,49,1,4)
AssetSubTypeLevels¶
AssetSubTypeLevels(zone_ID: int, sub_type_nr: int) · chk 249,50
Parameters
zone_ID(int) — Zone IDsub_type_nr(int) — Sub-type nr
Example: chk(249,50,1,1)
ItemQtyInAZoneCityLocHQUnitCombined¶
ItemQtyInAZoneCityLocHQUnitCombined(zone_ID: int, item_Type_ID: int) · chk 249,51
Parameters
zone_ID(int) — Zone IDitem_Type_ID(int) — Item Type ID
Example: chk(249,51,1,7)
RandomDifferingCultureNeighbourZone¶
RandomDifferingCultureNeighbourZone(zone_ID: int, mode: int) · chk 249,52
Parameters
zone_ID(int) — Zone IDmode(int) — (mode)
Example: chk(249,52,1,1)
ComputerCompuLeader¶
ComputerCompuLeader() · chk 249,53
Example: chk(249,53)
RandomLeaderFeatSSF¶
RandomLeaderFeatSSF(regime_ID: int, jobType_0_any_999_any_w_initial_cust: int) · chk 249,54
Parameters
regime_ID(int) — Regime IDjobType_0_any_999_any_w_initial_cust(int) — JobType (0=any, 999=any w/ initial.cust)
Example: chk(249,54,4,10)
SellALeaderFeatSSF¶
SellALeaderFeatSSF(char_ID: int, char_Feat_Type_ID: int) · chk 249,55
Parameters
char_ID(int) — Char IDchar_Feat_Type_ID(int) — Char Feat Type ID
Example: chk(249,55,1,1)
HasCharFeatSSF¶
HasCharFeatSSF(char_ID: int, char_Feat_Type_ID: int) · chk 249,56
Parameters
char_ID(int) — Char IDchar_Feat_Type_ID(int) — Char Feat Type ID
Example: chk(249,56,1,1)
RepublicaCardGeneralIF¶
RepublicaCardGeneralIF(card: int) · chk 249,60
Parameters
card(int) — Card
Example: chk(249,60,1)
RepublicaCardTargetLogicIF¶
RepublicaCardTargetLogicIF(card: int, target: int) · chk 249,61
Parameters
card(int) — Cardtarget(int) — Target
Example: chk(249,61,1,1)
RepublicaCardGeneralWeight¶
RepublicaCardGeneralWeight(card: int) · chk 249,62
Parameters
card(int) — Card
Example: chk(249,62,1)
FactionPopularityOfACharSFaction¶
FactionPopularityOfACharSFaction(char_ID: int) · chk 249,63
Parameters
char_ID(int) — Char ID
Example: chk(249,63,1)
MostPopularCabinetChar¶
MostPopularCabinetChar(regime_ID: int) · chk 249,64
Parameters
regime_ID(int) — Regime ID
Example: chk(249,64,4)
HighestPopularityFactionLeader¶
HighestPopularityFactionLeader(regime_ID: int) · chk 249,65
Parameters
regime_ID(int) — Regime ID
Example: chk(249,65,4)
FactionIDOfAChar¶
FactionIDOfAChar(char_ID: int) · chk 249,66
Parameters
char_ID(int) — Char ID
Example: chk(249,66,1)
PromiseCount¶
PromiseCount() · chk 249,67
Example: chk(249,67)
ZoneIDOfAnAsset¶
ZoneIDOfAnAsset(asset_ID: int) · chk 249,68
Parameters
asset_ID(int) — Asset ID
Example: chk(249,68,1)
CharJobSpecificValue¶
CharJobSpecificValue(char_ID: int, job_spec_key: int) · chk 249,69
Parameters
char_ID(int) — Char IDjob_spec_key(int) — (job-spec key)
Example: chk(249,69,1,1)
RemoveACharFeatSSFByForce¶
RemoveACharFeatSSFByForce(char_ID: int, feat_ID: int) · chk 249,70
Parameters
char_ID(int) — Char IDfeat_ID(int) — Feat ID
Example: chk(249,70,1,1)
OrgIDOfAGivenOrgType¶
OrgIDOfAGivenOrgType(regime_ID: int, org_Type_ID: int) · chk 249,71
Parameters
regime_ID(int) — Regime IDorg_Type_ID(int) — Org Type ID
Example: chk(249,71,4,1)
RandomFeudalFactionLeader¶
RandomFeudalFactionLeader(regime_ID: int) · chk 249,72
Parameters
regime_ID(int) — Regime ID
Example: chk(249,72,4)
HasActiveDipPactNonTrivialSystem¶
HasActiveDipPactNonTrivialSystem(regime_ID: int, target_regime_ID: int) · chk 249,73
Parameters
regime_ID(int) — Regime IDtarget_regime_ID(int) — Target regime ID
Example: chk(249,73,4,4)
RelationBelowDipPactThreshold¶
RelationBelowDipPactThreshold(regime_ID: int, target_regime_ID: int) · chk 249,74
Parameters
regime_ID(int) — Regime IDtarget_regime_ID(int) — Target regime ID
Example: chk(249,74,4,4)
CapitalZoneDerivedValue¶
CapitalZoneDerivedValue(regime_ID: int) · chk 249,75
Parameters
regime_ID(int) — Regime ID
Example: chk(249,75,4)
UnitSubCountInclHQ¶
UnitSubCountInclHQ(unit_His_ID: int) · chk 249,76
Parameters
unit_His_ID(int) — Unit His ID
Example: chk(249,76,1)
RandomNeighbourZoneWithAGivenRelation¶
RandomNeighbourZoneWithAGivenRelation(regime_ID: int, zone_ID: int, relation_RegimeRel_value: int) · chk 249,77
Parameters
regime_ID(int) — Regime IDzone_ID(int) — Zone IDrelation_RegimeRel_value(int) — Relation (RegimeRel value)
Example: chk(249,77,4,1,4)
RandomOtherCabinetCharInSameZone¶
RandomOtherCabinetCharInSameZone(char_ID: int) · chk 249,78
Parameters
char_ID(int) — Char ID
Example: chk(249,78,1)
FactionSupportOfACharSFaction¶
FactionSupportOfACharSFaction(char_ID: int) · chk 249,79
Parameters
char_ID(int) — Char ID
Example: chk(249,79,1)
ZoneOfALeaderFeatPlacement¶
ZoneOfALeaderFeatPlacement(regime_ID: int, jobType_filter: int) · chk 249,80
Parameters
regime_ID(int) — Regime IDjobType_filter(int) — JobType filter
Example: chk(249,80,4,10)
ElectionWeightedRandomCabinetChar¶
ElectionWeightedRandomCabinetChar(regime_ID: int) · chk 249,81
Parameters
regime_ID(int) — Regime ID
Example: chk(249,81,4)
RegimeHasLaw¶
RegimeHasLaw(regime_ID: int, law_ID: int) · chk 249,82
Parameters
regime_ID(int) — Regime IDlaw_ID(int) — Law ID
Example: chk(249,82,4,1)
SumOfResearchAppliedScienceOrgTask¶
SumOfResearchAppliedScienceOrgTask(regime_ID: int) · chk 249,83
Parameters
regime_ID(int) — Regime ID
Example: chk(249,83,4)
AIPickATargetZone¶
AIPickATargetZone(regime_ID: int) · chk 249,84
Parameters
regime_ID(int) — Regime ID
Example: chk(249,84,4)
JobPrestige¶
JobPrestige(char_ID: int, n0_use_storyId_scope: int) · chk 249,85
Parameters
char_ID(int) — Char IDn0_use_storyId_scope(int) — 0 = use storyId scope
Example: chk(249,85,1,1)
NewOrg¶
NewOrg(regime_context: int, inst1: int, inst2: int) · chk 249,101
Parameters
regime_context(int) — Regime/contextinst1(int) — inst1inst2(int) — inst2
Example: chk(249,101,4,1,1)
AppointDirector¶
AppointDirector(arg: int, arg: int, arg: int) · chk 249,102
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,102,1,1,1)
ResearchObjective¶
ResearchObjective(arg: int, arg: int, arg: int) · chk 249,104
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,104,1,1,1)
OOBObjective¶
OOBObjective(arg: int, arg: int, arg: int) · chk 249,105
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,105,1,1,1)
SetModelForOrg¶
SetModelForOrg(arg: int, arg: int, arg: int) · chk 249,106
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,106,1,1,1)
OrgOverview¶
OrgOverview(arg: int, arg: int, arg: int) · chk 249,203
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,203,1,1,1)
AppointCommander¶
AppointCommander(arg: int, arg: int, arg: int) · chk 249,601
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,601,1,1,1)
AppointGovernor¶
AppointGovernor(arg: int, arg: int, arg: int) · chk 249,602
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,602,1,1,1)
CouncilBudget¶
CouncilBudget(arg: int, arg: int, arg: int) · chk 249,603
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,603,1,1,1)
ZoneOrders¶
ZoneOrders(arg: int, arg: int, arg: int) · chk 249,604
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,604,1,1,1)
AppointAdvisor¶
AppointAdvisor(arg: int, arg: int, arg: int) · chk 249,605
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,605,1,1,1)
MakeDemand¶
MakeDemand(arg: int, arg: int, arg: int) · chk 249,801
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,801,1,1,1)
ResolveDemand¶
ResolveDemand(arg: int, arg: int, arg: int) · chk 249,803
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,803,1,1,1)
FactionJob¶
FactionJob(arg: int, arg: int, arg: int) · chk 249,831
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,831,1,1,1)
MakeSpeech¶
MakeSpeech(arg: int, arg: int, arg: int) · chk 249,910
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,910,1,1,1)
CreateCustomOOB¶
CreateCustomOOB(arg: int, arg: int, arg: int) · chk 249,916
Parameters
arg(int) — …arg(int) — …arg(int) — …
Example: chk(249,916,1,1,1)
This doc was generated from extracting data from Shadow Empire version 1.32a on 2026-06-05 06:56 UTC.