Home › Enums › Lua events

Available out of the box. Usable from Lua in the unmodified game.

Lua events

Events a script can subscribe to with Events.<Name>.Add(handler). Each handler receives the parameters listed here, in this order.

The list and the parameters come from the Civilization VI Modding Companion (ChimpanG, expanded and maintained by WildW). We matched each one to an engine event id in the game library, so the event exists; the parameters themselves have not been checked against the game library. "none listed" means the Companion lists no parameters, which can also mean it does not document them.

256 of the 352 engine event ids appear here. The rest are in the engine ids list only: the Companion does not list them as Lua events (some may be, under a different spelling).

Lua event Parameters Kind Engine id
AllianceAvailable playerID (number), otherplayerID (number), allianceIndex (number) GameCoreEvent ALLIANCE_AVAILABLE
AllianceEnded playerID (number), otherplayerID (number), allianceIndex (number) GameCoreEvent ALLIANCE_ENDED
AnarchyBegins none listed GameCoreEvent ANARCHY_BEGINS
AnarchyEnds none listed GameCoreEvent ANARCHY_ENDS
BarbarianClanConversionDisabled none listed GameCoreEvent BARBARIAN_CLAN_CONVERSION_DISABLED
BarbarianClanConversionEnabled none listed GameCoreEvent BARBARIAN_CLAN_CONVERSION_ENABLED
BarbarianRaidStarted none listed GameCoreEvent BARBARIAN_RAID_STARTED
BarbarianSpottedCity playerID (number), unitID (number), cityOwner (number), cityID (number) GameCoreEvent BARBARIAN_SPOTTED_CITY
BeliefAdded playerID (number), beliefID (number) GameCoreEvent BELIEF_ADDED
BuildingAddedToMap x (number), y (number), buildingIndex (number), playerID (number), cityID (number), percentComplete (number), isPillaged (boolean) GameCoreEvent BUILDING_ADDED_TO_MAP
BuildingChanged x (number), y (number), buildingID (number), playerID (number), percentComplete (number), unknown (number) GameCoreEvent BUILDING_CHANGED
BuildingRemovedFromMap x (number), y (number) GameCoreEvent BUILDING_REMOVED_FROM_MAP
BuildingVisibilityChanged none listed GameCoreEvent BUILDING_VISIBILITY_CHANGED
CapitalCityChanged playerID (number), cityID (number) GameCoreEvent CAPITAL_CITY_CHANGED
CityAddedToMap playerID (number), cityID (number), x (number), y (number) GameCoreEvent CITY_ADDED_TO_MAP
CityChanged none listed GameCoreEvent CITY_CHANGED
CityCommandStarted cityOwnerID (number), cityID (number), districtOwnerID (number), districtID (number), CityCommandTypes commandType ((enum)), data1 (number) GameCoreEvent CITY_COMMAND_STARTED
CityDefenseStatusChanged playerID (number), value (number) GameCoreEvent CITY_DEFENSE_STATUS_CHANGED
CityFocusChanged playerID (number), cityID (number) GameCoreEvent CITY_FOCUS_CHANGED
CityInitialized playerID (number), cityID (number), x (number), y (number) GameCoreEvent CITY_INITIALIZED
CityLiberated playerID (number), cityID (number) GameCoreEvent CITY_LIBERATED
CityLoyaltyChanged playerID (number), cityID (number) GameCoreEvent CITY_LOYALTY_CHANGED
CityMadePurchase playerID (number), cityID (number), x (number), y (number), EventSubTypes eventSubType ((enum)), purchasableItemIndex (number) GameCoreEvent CITY_MADE_PURCHASE
CityNameChanged playerID (number), cityID (number) GameCoreEvent CITY_NAME_CHANGED
CityOccupationChanged playerID (number), cityID (number) GameCoreEvent CITY_OCCUPATION_CHANGED
CityPopulationChanged playerID (number), cityID (number), cityPopulation (number) GameCoreEvent CITY_POPULATION_CHANGED
CityPowerChanged none listed GameCoreEvent CITY_POWER_CHANGED
CityProductionChanged playerID (number), cityID (number), productionID (number), objectID (number), wasCancelled (boolean) GameCoreEvent CITY_PRODUCTION_CHANGED
CityProductionCompleted playerID (number), cityID (number), constructionType (number), unitID (number), wasCancelled (boolean) GameCoreEvent CITY_PRODUCTION_COMPLETED
CityProductionQueueChanged none listed GameCoreEvent CITY_PRODUCTION_QUEUE_CHANGED
CityProductionUpdated playerID (number), cityID (number), objectID (number), productionID (number) GameCoreEvent CITY_PRODUCTION_UPDATED
CityPropertyChanged none listed GameCoreEvent CITY_PROPERTY_CHANGED
CityReligionChanged playerID (number), cityID (number), eVisibility (number), otherCityID (number) GameCoreEvent CITY_RELIGION_CHANGED
CityReligionFollowersChanged playerID (number), cityID (number), eVisibility (number), influencingCItyID (number) GameCoreEvent CITY_RELIGION_FOLLOWERS_CHANGED
CityRemovedFromMap playerID (number), cityID (number) GameCoreEvent CITY_REMOVED_FROM_MAP
CitySiegeStatusChanged playerID (number), cityID (number), isBesieged (boolean) GameCoreEvent CITY_SIEGE_STATUS_CHANGED
CityTileOwnershipChanged playerID (number), cityID (number), x (number), y (number) GameCoreEvent CITY_TILE_OWNERSHIP_CHANGED
CityTransfered newOwnerID (number), cityID (number), oldOwnerID (number), CityTransferTypes transferType ((enum)) GameCoreEvent CITY_TRANSFERED
CityVisibilityChanged playerID (number), cityID (number), eVisibility (number) GameCoreEvent CITY_VISIBILITY_CHANGED
CivicBoostTriggered playerID (number), civicIndex (number), unknownA (number), unknownB (number) GameCoreEvent CIVIC_BOOST_TRIGGERED
CivicChanged playerID (number), civicIndex (number) GameCoreEvent CIVIC_CHANGED
CivicCompleted playerID (number), civicIndex (number), isCancelled (number) GameCoreEvent CIVIC_COMPLETED
CivicQueueChanged none listed GameCoreEvent CIVIC_QUEUE_CHANGED
CivicsUnlocked none listed GameCoreEvent CIVICS_UNLOCKED
ClimateChangeEvent none listed GameCoreEvent CLIMATE_CHANGE_EVENT
Combat combatResult (table) GameCoreEvent COMBAT
CorporationAdded none listed GameCoreEvent CORPORATION_ADDED
CorporationNameChanged none listed GameCoreEvent CORPORATION_NAME_CHANGED
CorporationRemoved none listed GameCoreEvent CORPORATION_REMOVED
CulturalIdentityCitizenConverted none listed GameCoreEvent CULTURAL_IDENTITY_CITIZEN_CONVERTED
CulturalIdentityCityConverted playerID (number), cityID (number), influencingPlayerID (number) GameCoreEvent CULTURAL_IDENTITY_CITY_CONVERTED
CulturalIdentityConversionOutcomeChanged playerID (number), cityID (number), IdentityConversionOutcome conversionOutcome ((enum)) GameCoreEvent CULTURAL_IDENTITY_CONVERSION_OUTCOME_CHANGED
CulturalIdentityPerturnFromModifiersChanged none listed GameCoreEvent CULTURAL_IDENTITY_PER_TURN_FROM_MODIFIERS_CHANGED
CultureChanged none listed GameCoreEvent CULTURE_CHANGED
CultureYieldChanged playerID (number) GameCoreEvent CULTURE_YIELD_CHANGED
DiplomacyDealEnacted none listed GameCoreEvent DIPLOMACY_DEAL_ENACTED
DiplomacyDealExpired none listed GameCoreEvent DIPLOMACY_DEAL_EXPIRED
DiplomacyDeclareWar firstPlayerID (number), secondPlayerID (number) GameCoreEvent DIPLOMACY_DECLARE_WAR
DiplomacyIncomingDeal fromPlayerID (number), toPlayerID (number), DiplomacyActionTypes actionType ((enum)) GameCoreEvent DIPLOMACY_INCOMING_DEAL
DiplomacyMakePeace firstPlayerID (number), secondPlayerID (number) GameCoreEvent DIPLOMACY_MAKE_PEACE
DiplomacyMeet player1ID (number), player2ID (number) GameCoreEvent DIPLOMACY_MEET
DiplomacyMeetMajorMinor none listed GameCoreEvent DIPLOMACY_MEET_MAJOR_MINOR
DiplomacyMeetMajors none listed GameCoreEvent DIPLOMACY_MEET_MAJORS
DiplomacyRefusePeace actingPlayerID (number), reactingPlayerID (number) GameCoreEvent DIPLOMACY_REFUSE_PEACE
DiplomacyRelationshipChanged player1ID (number), player2ID (number) GameCoreEvent DIPLOMACY_RELATIONSHIP_CHANGED
DiplomacySessionClosed sessionID (number) GameCoreEvent DIPLOMACY_SESSION_CLOSED
DistrictAddedToMap playerID (number), districtID (number), cityID (number), x (number), y (number), districtIndex (number), percentComplete (number) GameCoreEvent DISTRICT_ADDED_TO_MAP
DistrictCombatChanged EventSubTypes eventSubType ((enum)), playerID (number), districtID (number) GameCoreEvent DISTRICT_COMBAT_CHANGED
DistrictDamageChanged playerID (number), districtID (number), DefenseTypes defenseType ((enum)), newDamage (number), oldDamage (number) GameCoreEvent DISTRICT_DAMAGE_CHANGED
DistrictRemovedFromMap playerID (number), districtID (number), cityID (number), x (number), y (number), districtIndex (number) GameCoreEvent DISTRICT_REMOVED_FROM_MAP
DistrictVisibilityChanged playerID (number), districtID (number), eVisibility (number) GameCoreEvent DISTRICT_VISIBILITY_CHANGED
DroughtAddedToMap none listed GameCoreEvent DROUGHT_ADDED_TO_MAP
DroughtRemovedFromMap none listed GameCoreEvent DROUGHT_REMOVED_FROM_MAP
EmergenciesUpdated none listed GameCoreEvent EMERGENCIES_UPDATED
EmergencyAvailable targetPlayerID (number), emergencyIndex (number) GameCoreEvent EMERGENCY_AVAILABLE
EmergencyAvailableParticipant none listed GameCoreEvent EMERGENCY_AVAILABLE_PARTICIPANT
EmergencyCompleteParticipants none listed GameCoreEvent EMERGENCY_COMPLETE_PARTICIPANTS
EmergencyRejected none listed GameCoreEvent EMERGENCY_REJECTED
EmergencyStarted playerID (number), targetPlayerID (number), turn (number) GameCoreEvent EMERGENCY_STARTED
EventPopupRequest popupData (table) GameCoreEvent EVENT_POPUP_REQUEST
EventPopupResponse none listed GameCoreEvent EVENT_POPUP_RESPONSE
EventSoundRequest sound (string), playerID (number) GameCoreEvent EVENT_SOUND_REQUEST
FaithChanged playerID (number), yield (number), balance (number) GameCoreEvent FAITH_CHANGED
FavorChanged none listed GameCoreEvent FAVOR_CHANGED
FeatureAddedToMap x (number), y (number) GameCoreEvent FEATURE_ADDED_TO_MAP
FeatureChanged none listed GameCoreEvent FEATURE_CHANGED
FeatureRemovedFromMap x (number), y (number) GameCoreEvent FEATURE_REMOVED_FROM_MAP
FloodplainRevealed none listed GameCoreEvent FLOODPLAIN_REVEALED
GameEraChanged previousEraIndex (number), newEraIndex (number) GameCoreEvent GAME_ERA_CHANGED
GameHistoryMomentRecorded momentIndex (number), unknown (number) GameCoreEvent GAME_HISTORY_MOMENT_RECORDED
GamePropertyChanged none listed GameCoreEvent GAME_PROPERTY_CHANGED
GeothermalFissureRevealed none listed GameCoreEvent GEOTHERMAL_FISSURE_REVEALED
GoodyHutReward playerID (number), unitID (number), unknown1 (number), unknown2 (number) GameCoreEvent GOODY_HUT_REWARD
GovernmentChanged playerID (number), governmentID (number) GameCoreEvent GOVERNMENT_CHANGED
GovernmentPolicyChanged playerID (number), policyID (number) GameCoreEvent GOVERNMENT_POLICY_CHANGED
GovernmentPolicyObsoleted playerID (number) GameCoreEvent GOVERNMENT_POLICY_OBSOLETED
GovernorAppointed playerID (number), governorID (number) GameCoreEvent GOVERNOR_APPOINTED
GovernorAssigned cityPlayerID (number), cityID (number), governorPlayerID (number), governorID (number) GameCoreEvent GOVERNOR_ASSIGNED
GovernorChanged playerID (number), governorID (number) GameCoreEvent GOVERNOR_CHANGED
GovernorEjected none listed GameCoreEvent GOVERNOR_EJECTED
GovernorEstablished none listed GameCoreEvent GOVERNOR_ESTABLISHED
GovernorPointsChanged playerID (number), delta (number) GameCoreEvent GOVERNOR_POINTS_CHANGED
GovernorPromoted playerID (number), governorIndex (number), promotionIndex (number) GameCoreEvent GOVERNOR_PROMOTED
GreatPeoplePointsChanged playerID (number) GameCoreEvent GREAT_PEOPLE_POINTS_CHANGED
GreatPeopleTimelineChanged none listed GameCoreEvent GREAT_PEOPLE_TIMELINE_CHANGED
GreatWorkCreated playerID (number), unitID (number), cityPlotX (number), cityPlotY (number), buildingID (number), greatWorkID (number) GameCoreEvent GREAT_WORK_CREATED
GreatWorkMoved fromCityPlayerID (number), fromCityID (number), toCityPlayerID (number), toCityID (number), buildingID (number), greatWorkTypeIndex (number) GameCoreEvent GREAT_WORK_MOVED
ImprovementActivated x (number), y (number), unitOwner (unspecified), unitID (number), improvementType (unspecified), improvementOwner (unspecified), activationType (unspecified) GameCoreEvent IMPROVEMENT_ACTIVATED
ImprovementAddedToMap x (number), y (number), improvementIndex (number), playerID (number) GameCoreEvent IMPROVEMENT_ADDED_TO_MAP
ImprovementChanged x (number), y (number), improvementIndex (number), improvementPlayerID (number), resourceIndex (number), isPillaged (boolean), isWorked (boolean) GameCoreEvent IMPROVEMENT_CHANGED
ImprovementOwnershipChanged none listed GameCoreEvent IMPROVEMENT_OWNERSHIP_CHANGED
ImprovementRemovedFromMap x (number), y (number), owningPlayerID (number) GameCoreEvent IMPROVEMENT_REMOVED_FROM_MAP
ImprovementVisibilityChanged x (number), y (number), improvementIndex (number), eVisibility (number) GameCoreEvent IMPROVEMENT_VISIBILITY_CHANGED
InfluenceChanged none listed GameCoreEvent INFLUENCE_CHANGED
InfluenceGiven citystateID (number), playerID (number) GameCoreEvent INFLUENCE_GIVEN
LevyCounterChanged originalOwnerID (number) GameCoreEvent LEVY_COUNTER_CHANGED
LocalPlayerChanged localPlayerID (number), prevLocalPlayerID (number) GameCoreEvent LOCAL_PLAYER_CHANGED
LocalPlayerTurnBegin none listed GameCoreEvent LOCAL_PLAYER_TURN_BEGIN
LocalPlayerTurnEnd none listed GameCoreEvent LOCAL_PLAYER_TURN_END
LocalPlayerTurnUnready none listed GameCoreEvent LOCAL_PLAYER_TURN_UNREADY
MapYieldsChanged none listed GameCoreEvent MAP_YIELDS_CHANGED
MonopolyGained none listed GameCoreEvent MONOPOLY_GAINED
MonopolyLost none listed GameCoreEvent MONOPOLY_LOST
NationalParkVisibilityChanged none listed GameCoreEvent NATIONAL_PARK_VISIBILITY_CHANGED
NaturalWonderRevealed x (number), y (number), featureIndex (number), wasFirstToFind (boolean) GameCoreEvent NATURAL_WONDER_REVEALED
NotificationActivated playerID (number), notificationID (number), wasActivatedByUser (boolean) GameCoreEvent NOTIFICATION_ACTIVATED
NotificationAdded playerID (number), notificationID (number) GameCoreEvent NOTIFICATION_ADDED
NotificationDismissed playerID (number), notificationID (number) GameCoreEvent NOTIFICATION_DISMISSED
NotificationRefreshRequested none listed GameCoreEvent NOTIFICATION_REFRESH_REQUESTED
NuclearReactorChanged none listed GameCoreEvent NUCLEAR_REACTOR_CHANGED
ObjectPairing EventSubTypes eventSubType ((enum)), parentOwner (unspecified), parentType (unspecified), parentID (number), childOwner (unspecified), childType (unspecified), childID (number) GameCoreEvent OBJECT_PAIRING
PantheonFounded playerID (number) GameCoreEvent PANTHEON_FOUNDED
PhaseBegin none listed GameCoreEvent PHASE_BEGIN
PhaseEnd none listed GameCoreEvent PHASE_END
PlayerAgeChanged playerID (number) GameCoreEvent PLAYER_AGE_CHANGED
PlayerBordersChanged none listed GameCoreEvent PLAYER_BORDERS_CHANGED
PlayerDarkAgeChanged playerID (number) GameCoreEvent PLAYER_DARK_AGE_CHANGED
PlayerDefeat playerID (number), defeatIndex (number), eventID (number) GameCoreEvent PLAYER_DEFEAT
PlayerDiscoveredHero none listed GameCoreEvent PLAYER_DISCOVERED_HERO
PlayerEraChanged playerID (number), eraIndex (number) GameCoreEvent PLAYER_ERA_CHANGED
PlayerEraScoreChanged playerID (number), amountAwarded (number) GameCoreEvent PLAYER_ERA_SCORE_CHANGED
PlayerEraTransitionBegins playerID (number) GameCoreEvent PLAYER_ERA_TRANSITION_BEGINS
PlayerIntroduced none listed GameCoreEvent PLAYER_INTRODUCED
PlayerOperationComplete none listed GameCoreEvent PLAYER_OPERATION_COMPLETE
PlayerResourceChanged ownerPlayerID (number), resourceTypeID (number) PlayerGameCoreEvent PLAYER_RESOURCE_CHANGED
PlayerRestored none listed GameCoreEvent PLAYER_RESTORED
PlayerTurnActivated playerID (number), isFirstTurn (boolean) GameCoreEvent PLAYER_TURN_ACTIVATED
PlayerTurnCompleteIgnored none listed GameCoreEvent PLAYER_TURN_COMPLETE_IGNORED
PlayerTurnDeactivated playerID (number) GameCoreEvent PLAYER_TURN_DEACTIVATED
PlotMarkerChanged x (number), y (number) GameCoreEvent PLOT_MARKER_CHANGED
PlotPropertyChanged x (number), y (number) GameCoreEvent PLOT_PROPERTY_CHANGED
PlotVisibilityChanged x (number), y (number), visibilityType (number) GameCoreEvent PLOT_VISIBILITY_CHANGED
PlotYieldChanged x (number), y (number) GameCoreEvent PLOT_YIELD_CHANGED
PostTourismBomb none listed GameCoreEvent POST_TOURISM_BOMB
PowerGeneratedFromResource none listed GameCoreEvent POWER_GENERATED_FROM_RESOURCE
PreTurnBegin none listed GameCoreEvent PRE_TURN_BEGIN
QuestChanged CityStateID (number), CompletedQuestPlayerID (number) GameCoreEvent QUEST_CHANGED
RandomEventOccurred none listed GameCoreEvent RANDOM_EVENT_OCCURRED
ReligionFounded playerID (number), religionID (number) GameCoreEvent RELIGION_FOUNDED
RemotePlayerTurnBegin none listed GameCoreEvent REMOTE_PLAYER_TURN_BEGIN
RemotePlayerTurnEnd none listed GameCoreEvent REMOTE_PLAYER_TURN_END
RemotePlayerTurnUnready none listed GameCoreEvent REMOTE_PLAYER_TURN_UNREADY
ResearchChanged playerID (number), technologyIndex (number) GameCoreEvent RESEARCH_CHANGED
ResearchCompleted playerID (number), technologyIndex (number) GameCoreEvent RESEARCH_COMPLETED
ResearchQueueChanged playerID (number), technologyIndex (number) GameCoreEvent RESEARCH_QUEUE_CHANGED
ResearchYieldChanged playerID (number) GameCoreEvent RESEARCH_YIELD_CHANGED
ResourceAddedToMap x (number), y (number), resourceIndex (number) GameCoreEvent RESOURCE_ADDED_TO_MAP
ResourceRemovedFromMap iX (number), iY (number), resourceIndex (number) GameCoreEvent RESOURCE_REMOVED_FROM_MAP
ResourceVisibilityChanged x (number), y (number), resourceIndex (number), visibilityType (number) GameCoreEvent RESOURCE_VISIBILITY_CHANGED
RiverAddedToMap none listed GameCoreEvent RIVER_ADDED_TO_MAP
RiverRemovedFromMap none listed GameCoreEvent RIVER_REMOVED_FROM_MAP
RouteAddedToMap none listed GameCoreEvent ROUTE_ADDED_TO_MAP
RouteChanged x (number), y (number) GameCoreEvent ROUTE_CHANGED
RouteRemovedFromMap none listed GameCoreEvent ROUTE_REMOVED_FROM_MAP
RouteVisibilityChanged none listed GameCoreEvent ROUTE_VISIBILITY_CHANGED
SecretSocietyDiscovered none listed GameCoreEvent SECRET_SOCIETY_DISCOVERED
SecretSocietyJoined none listed GameCoreEvent SECRET_SOCIETY_JOINED
SecretSocietyLeft none listed GameCoreEvent SECRET_SOCIETY_LEFT
SpyAdded spyPlayerID (number), spyUnitID (number) GameCoreEvent SPY_ADDED
SpyMissionCompleted playerID (number), missionID (number) GameCoreEvent SPY_MISSION_COMPLETED
SpyMissionUpdated none listed GameCoreEvent SPY_MISSION_UPDATED
SpyRemoved spyPlayerID (number), counterSpyPlayerID (number) GameCoreEvent SPY_REMOVED
SpyUpdated none listed GameCoreEvent SPY_UPDATED
StormAddedToMap none listed GameCoreEvent STORM_ADDED_TO_MAP
StormChanged none listed GameCoreEvent STORM_CHANGED
StormRemovedFromMap none listed GameCoreEvent STORM_REMOVED_FROM_MAP
TeamVictory none listed GameCoreEvent TEAM_VICTORY
TechBoostTriggered playerID (number), techBoosted (number), unknownA (number), unknownB (number) GameCoreEvent TECH_BOOST_TRIGGERED
TerrainTypeChanged none listed GameCoreEvent TERRAIN_TYPE_CHANGED
TradeRouteActivityChanged playerID (number), originPlayerID (number), originCityID (number), targetPlayerID (number), targetCityID (number) GameCoreEvent TRADE_ROUTE_ACTIVITY_CHANGED
TradeRouteAddedToMap playerID (number), x (number), y (number) GameCoreEvent TRADE_ROUTE_ADDED_TO_MAP
TradeRouteCapacityChanged playerID (number) GameCoreEvent TRADE_ROUTE_CAPACITY_CHANGED
TradeRouteRangeChanged none listed GameCoreEvent TRADE_ROUTE_RANGE_CHANGED
TradeRouteRemovedFromMap playerID (number), x (number), y (number) GameCoreEvent TRADE_ROUTE_REMOVED_FROM_MAP
TreasuryChanged playerID (number), yield (number), balance (unspecified) GameCoreEvent TREASURY_CHANGED
TurnBegin none listed GameCoreEvent TURN_BEGIN
TurnEnd none listed GameCoreEvent TURN_END
UnitAbilityGained playerID (number), unitID (number), unitAbilityIndex (number) GameCoreEvent UNIT_ABILITY_GAINED
UnitAbilityLost playerID (number), unitID (number), unitAbilityIndex (number) GameCoreEvent UNIT_ABILITY_LOST
UnitActivate none listed GameCoreEvent UNIT_ACTIVATE
UnitActivityChanged playerID (number), unitID (number), ActivityTypes activityType ((enum)) GameCoreEvent UNIT_ACTIVITY_CHANGED
UnitAddedToMap playerID (number), unitID (number) GameCoreEvent UNIT_ADDED_TO_MAP
UnitAirlifted none listed GameCoreEvent UNIT_AIRLIFTED
UnitArtifactChanged playerID (number), unitID (number) GameCoreEvent UNIT_ARTIFACT_CHANGED
UnitAttacksRemainingChanged none listed GameCoreEvent UNIT_ATTACKS_REMAINING_CHANGED
UnitCaptured currentUnitPlayerID (number), unitID (number), owningPlayerID (number), capturingPlayerID (number) GameCoreEvent UNIT_CAPTURED
UnitChargesChanged playerID (number), unitID (number), newCharges (number), oldCharges (number) GameCoreEvent UNIT_CHARGES_CHANGED
UnitCommandStarted playerID (number), unitID (number), UnitCommandTypes commandType ((enum)), data1 (number) GameCoreEvent UNIT_COMMAND_STARTED
UnitDamageChanged playerID (number), unitID (number), newDamage (number), prevDamage (number) GameCoreEvent UNIT_DAMAGE_CHANGED
UnitEnteredBarbarianCamp none listed GameCoreEvent UNIT_ENTERED_BARBARIAN_CAMP
UnitEnterFormation firstUnitPlayerID (number), firstUnitID (number), secondUnitPlayerID (number), secondUnitID (number) GameCoreEvent UNIT_ENTER_FORMATION
UnitExitFormation firstUnitPlayerID (number), firstUnitID (number), secondUnitPlayerID (number), secondUnitID (number) GameCoreEvent UNIT_EXIT_FORMATION
UnitExperienceChanged none listed GameCoreEvent UNIT_EXPERIENCE_CHANGED
UnitFormArmy playerID (number), unitID (number) GameCoreEvent UNIT_FORM_ARMY
UnitFormationChanged none listed GameCoreEvent UNIT_FORMATION_CHANGED
UnitFormCorps playerID (number), unitID (number) GameCoreEvent UNIT_FORM_CORPS
UnitFortificationChanged playerID (number), unitID (number) GameCoreEvent UNIT_FORTIFICATION_CHANGED
UnitGreatPersonActivated unitPlayerID (number), unitOwner (number), unitID (number), unitID (number), greatPersonClassID (number), greatPersonClassID (number), greatPersonIndividualID (number), greatPersonIndividualID (number) GameCoreEvent UNIT_GREATPERSON_ACTIVATED
UnitGreatPersonChanged none listed GameCoreEvent UNIT_GREATPERSON_CHANGED
UnitGreatPersonCreated playerID (number), unitID (number), greatPersonClassID (number), greatPersonIndividualID (number) GameCoreEvent UNIT_GREATPERSON_CREATED
UnitHeroCreated none listed GameCoreEvent UNIT_HERO_CREATED
UnitKilledByFallout none listed GameCoreEvent UNIT_KILLED_BY_FALLOUT
UnitKilledInCombat killedPlayerID (number), killedUnitID (number), playerID (number), unitID (number) GameCoreEvent UNIT_KILLED_IN_COMBAT
UnitKilledLifespanExpired none listed GameCoreEvent UNIT_KILLED_LIFESPAN_EXPIRED
UnitMoveComplete playerID (number), unitID (number), x (number), y (number) GameCoreEvent UNIT_MOVE_COMPLETE
UnitMoved playerID (number), unitID (number), x (number), y (number), locallyVisible (unspecified), stateChange (unspecified) GameCoreEvent UNIT_MOVED
UnitMovementPointsChanged playerID (number), unitID (number), movementPoints (number) GameCoreEvent UNIT_MOVEMENT_POINTS_CHANGED
UnitMovementPointsCleared playerID (number), unitID (number) GameCoreEvent UNIT_MOVEMENT_POINTS_CLEARED
UnitMovementPointsRestored playerID (number), unitID (number), MovementPoints (number) GameCoreEvent UNIT_MOVEMENT_POINTS_RESTORED
UnitOperationAdded playerID (number), unitID (number), unknown (number), UnitOperationTypes operationType ((enum)) GameCoreEvent UNIT_OPERATION_ADDED
UnitOperationDeactivated playerID (number), unitID (number), UnitOperationTypes operationType ((enum)), data1 (number) GameCoreEvent UNIT_OPERATION_DEACTIVATED
UnitOperationsCleared playerID (number), unitID (number), UnitCommandTypes commandType ((enum)), data1 (number) GameCoreEvent UNIT_OPERATIONS_CLEARED
UnitOperationSegmentComplete playerID (number), unitID (number), UnitCommandTypes commandType ((enum)), data1 (number) GameCoreEvent UNIT_OPERATION_SEGMENT_COMPLETE
UnitOperationStarted ownerID (number), unitID (number), operationID (number) GameCoreEvent UNIT_OPERATION_STARTED
UnitParadropped none listed GameCoreEvent UNIT_PARADROPPED
UnitPromoted playerID (number), unitID (number) GameCoreEvent UNIT_PROMOTED
UnitPropertyChanged playerID (number), unitID (number) GameCoreEvent UNIT_PROPERTY_CHANGED
UnitRemovedFromMap playerID (number), unitID (number) GameCoreEvent UNIT_REMOVED_FROM_MAP
UnitTeleported playerID (number), unitID (number), x (number), y (number) GameCoreEvent UNIT_TELEPORTED
UnitTourismBomb none listed GameCoreEvent UNIT_TOURISM_BOMB
UnitTradeChanged playerID (number), unitID (number) GameCoreEvent UNIT_TRADE_CHANGED
UnitUpgraded playerID (number), unitID (number) GameCoreEvent UNIT_UPGRADED
UnitVisibilityChanged playerID (number), unitID (number) GameCoreEvent UNIT_VISIBILITY_CHANGED
VolcanoRevealed none listed GameCoreEvent VOLCANO_REVEALED
WMDCountChanged playerID (number), WMDIndex (number) GameCoreEvent WMD_COUNT_CHANGED
WMDDetonated x (number), y (number), playerID (number), WMDIndex (number) GameCoreEvent WMD_DETONATED
WMDFalloutChanged none listed GameCoreEvent WMD_FALLOUT_CHANGED
WMDFalloutVisibilityChanged none listed GameCoreEvent WMD_FALLOUT_VISIBILITY_CHANGED
WorldCongressEmergencyReady none listed GameCoreEvent WORLD_CONGRESS_EMERGENCY_READY
WorldCongressPlayersChoice none listed GameCoreEvent WORLD_CONGRESS_PLAYERS_CHOICE
WorldCongressRibbonUpdate none listed GameCoreEvent WORLD_CONGRESS_RIBBON_UPDATE
WorldCongressSpecialSessionBeingCalled none listed GameCoreEvent WORLD_CONGRESS_SPECIAL_SESSION_BEING_CALLED
WorldCongressStage1 none listed GameCoreEvent WORLD_CONGRESS_STAGE1
WorldCongressStage2 none listed GameCoreEvent WORLD_CONGRESS_STAGE2
WorldCongressStage3 none listed GameCoreEvent WORLD_CONGRESS_STAGE3
WorldTextMessage ReportingStatusTypes reportingStatusType ((enum)), gossipIndex (number), x (number), y (number), text (string) GameCoreEvent WORLD_TEXT_MESSAGE

Notes from real use

What real handlers show about these events, beyond the Companion list. Source: Gedemon's Civilization Overhaul (Gedemon, https://github.com/Gedemon/Civ6-GCO, state of 2021-05-20) unless the evidence column says the vanilla game's own Lua. Timing and ordering remarks are the mod author's comments, not re-tested here. See also event order and patterns from a large mod.

Lua event Note Evidence Status
RemotePlayerTurnBegin Handlers receive playerID, although the Companion lists no parameters. vanilla Lua (DiplomacyRibbon.lua OnTurnBegin(playerID)) and GCO PlayerScript.lua:1363 verified
RemotePlayerTurnEnd Handlers receive playerID, although the Companion lists no parameters. vanilla Lua (DiplomacyRibbon.lua OnTurnEnd(playerID)) and GCO PlayerScript.lua:1376 verified
LocalPlayerTurnEnd GCO's handler reads a playerID; the Companion lists none. Not seen in vanilla handlers (they take no arguments). GCO PlayerScript.lua:1394 inferred
ImprovementActivated There is an eighth argument, activationValue, after activationType; the Companion lists seven. Also, the first two arguments are the plot x, y. vanilla Lua (TutorialUIRoot.lua OnImprovementActivated) and GCO PlotScript.lua:2457 verified
CityProductionCompleted GCO's handler declares six arguments (playerID, cityID, productionID, objectID, bCanceled, typeModifier); the Companion lists five. A sixth value probably exists but its meaning is unconfirmed. Vanilla handlers only use the first two. GCO CityScript.lua:8006 inferred
ResearchCompleted GCO declares a third argument (a cancelled flag, as CivicCompleted has); the Companion lists two. GCO ResearchScript.lua:1636 inferred
RouteAddedToMap GCO's handlers read x, y; the Companion lists no parameters (vanilla handler ignores them). Same for RouteRemovedFromMap. GCO PlotScript.lua:3973-3984 inferred
FeatureAddedToMap Carries only x, y, not the feature type. To know which feature was removed, cache the feature per plot yourself (see the event-order page). Same for FeatureRemovedFromMap. GCO PlotScript.lua:3954-3967 inferred
UnitTeleported Also fires when a unit moves onto the tile of a unit it has just defeated, so it is not only for real teleports. author's comment, GCO AltHistScript.lua:123 inferred
UnitMoved Fires once per step of a move; use UnitMoveComplete for once per command. Changing game state from this handler may desync multiplayer (author's warning). GCO UnitScript.lua:6915-6950 inferred
UnitDamageChanged Fires after the engine has already healed or damaged the unit, with (playerID, unitID, newDamage, prevDamage). GCO calls unit:SetDamage(prevDamage) in the handler to cancel unwanted healing (it observed that pillaging units are healed by the engine). GCO UnitScript.lua:5470 inferred
UnitOperationStarted For the REMOVE_FEATURE operation the feature is already gone and the builder may already be off the map when this fires. author's comment, GCO UnitScript.lua:6821-6823 inferred
CityInitialized Fires after CityAddedToMap; city plots are not initialised yet at CityAddedToMap. author's comment, GCO CityScript.lua:8111, ModUtils.lua:1731 inferred
GovernmentChanged When this fires, policy queries (such as HasPolicyActive passed from the UI) may still return the old value. GCO delays its recalculation with a coroutine. Same for GovernmentPolicyChanged. author's comment, GCO CityScript.lua:8117 inferred
PlayerTurnActivated The author calls it the first general event after all CityProductionCompleted events of that player. author's comment, GCO UnitScript.lua:928 inferred