GameCallback

Erklärung der Funktionsweise

Ein Game Callback wird aufgerufen, wenn sein Trigger ausgelöst wird. Dabei kann das Callback auch Parameter übernehmen, sofern dies vorgesehen ist. Diese Parameter erlauben eine weitere Fallunterscheidung.

Ein Beispiel zur Nutzung eines Callbacks:

GameCallback_PlayerLeft_OrigEXAMPLE = GameCallback_PlayerLeft;
GameCallback_PlayerLeft = function( _PlayerID )
    Logic.DEBUG_AddNote( GetPlayerName(_PlayerID) .. "hat das Spiel verloren!");
    GameCallback_PlayerLeft_OrigEXAMPLE(_PlayerID);
end

In diesem Beispiel wird die Originalfunktion erst kopiert und danach das Original überschrieben. Das alte Original gibt jetzt nur noch eine Nachricht zurück und ruft dann seine Kopie auf. Die Kopie beinhalten den alten Funktionscode und wird diesen nach der Ausgabe ausführen.

Es ist generell nie eine gute Idee ein Game Callback direkt zu überschreiben. Man sollte immer die Originalfunktion kopieren und von der Überschriebenen Funktion ausführen lassen. Wenn man ein Callback mehrstufig überschreibt, muss man bei der Namensgebung der Kopien aufpassen, dass diese Namen eindeutig sind, andernfalls provoziert man einen Stack Overflow.

Liste der Gamecallbacks

Um zu einem GameCallback eine Seite zu schreiben, den Link anklicken und beim Bearbeiten den Startinhalt "GameCallback" auswählen.

Funktion Parameter Beschreibung G L
GameCallBack_AI_TraceMessage
GameCallback_AIDefendArmyNeedsBowmen
GameCallback_AIDefendArmyNeedsSwordmen
GameCallback_AIOnArmyDisbanded
GameCallback_AIOnClaimCompleted
GameCallback_AIOnClaimFailed
GameCallback_AIOnTerritoryOwnershipChanged
GameCallback_AIShouldRebuild
GameCallback_AITraceGoal
GameCallback_BuildingDestroyed (_EntityID, _PlayerID, _KnockedDown) Wird aufgerufen, wenn ein Gebäude zerstört wird
GameCallback_CanPlayerPlaceBuilding ( _PlayerID, _Type, _X, _Y ) Prüft, wenn es aufgerufen wird, ob der Spieler da bauen kann
GameCallback_CartEnteredStoreHouse ( _CartID, _StoreHouseID ) Wird aufgerufen, wenn ein Karren ins Lagerhaus fährt
GameCallback_CartFreed ( _OldEntityID, _OldEntityPlayerID, _NewEntityID, _NewEntityPlayerID )
GameCallback_CityLevelUpgradeFestivalEnded (_PlayerID) ? ?
GameCallback_CityLevelUpgradeFestivalStarted (_PlayerID) ? ?
GameCallback_ConsumeGood (_Consumer, _Good, _Building) Wird aufgerufen, wenn waren von Siedlern konsumiert werden
GameCallback_CreateKnightByTypeOrIndex
GameCallback_EndOfMonth (_LastMonth, _CurrentMonth) Wird am Monatsende aufgerufen
GameCallback_EntityCaptured ( _OldEntityID, _OldEntityPlayerID, _NewEntityID, _NewEntityPlayerID ) Wird aufgerufen, wenn eine Einheit gefangen genommen wird
GameCallback_EntityDiscovered (_PlayerID, _EntityID) Wird aufgerufen, wenn eine Entity entdeckt wird
GameCallback_EntityHurt (_AttackedEntityID, _AttackedPlayerID, _AttackingEntityID, _AttackingPlayerID) Wird aufgerufen, wenn eine Einheit von Spieler 1 - 8 verletzt wird
GameCallback_EntityKilled (_AttackedEntityID, _AttackedPlayerID, _AttackingEntityID, _AttackingPlayerID, _AttackedEntityType, _AttackingEntityType) Wird aufgerufen, wenn eine Einheit von Spieler 1 - 8 zerstört wird
GameCallback_FarmAnimalChangedPlayerID (_PlayerID, _NewEntityID, _OldEntityID) Wird aufgerufen, wenn ein Nutztier erobert wird
GameCallback_Feedback_BuildingBurnedDown ( _PlayerId, _BuildingID, _UpgradeLevel) ? ?
GameCallback_Feedback_BuildingKnockedDown ( _PlayerId, _BuildingID, _UpgradeLevel) ? ?
GameCallback_GetCityReputation
GameCallback_GetPlayerMorale
GameCallback_GetTaxAmountForBuilding
GameCallback_GoodsSendDuringQuest (_QuestIndex)
GameCallback_InitMPResources
GameCallback_InitVictoryCondition
GameCallback_IsShallowWaterFloodingAllowed ()
GameCallback_KnightAbilityStarted
GameCallback_KnightAbilityUsed (_PlayerID, _KnightType) Wird aufgerufen, sobald ein Held seine Fähigkeit einsetzt
GameCallback_KnightTitleChanged
GameCallback_LoadScriptFiles
GameCallback_NewGame ()
GameCallback_NewStriker (_PlayerID, _EntityType) Wird aufgerufen, sobald ein Siedler zu streiken beginnt
GameCallback_ObjectInteraction () ? ?
GameCallback_OnBuildingBurning (_PlayerID, _EntityID) Wird aufgerufen, sobald ein Gebäude Feuer fängt
GameCallback_OnBuildingConstructionComplete (_PlayerID, _EntityID) Wird aufgerufen, wenn ein Gebäude fertig gestellt wird.
GameCallback_OnBuildingUpgradeFinished (_PlayerID, _EntityID, _NewUpgradeLevel) Wird aufgerufen, sobald ein Ausbau abgeschlossen ist.
GameCallback_OnGameStart
GameCallback_OnGeologistRefill
GameCallback_OnKnightComatose (_PlayerID, _KnightID) Wird aufgerufen, sobald ein Held besiegt wird.
GameCallback_OnMPGameStart
GameCallback_OnNPCInteraction (_EntityID, _PlayerID)
GameCallback_OnObjectInteraction (_EntityID, _PlayerID) Wird bei Interaktionen aufgerufen.
GameCallback_OnThiefDeliverEarnings (thiefPlayerID, thiefID, buildingID, goldAmount) Wird aufgerufen, wenn ein Dieb Beute abliefert.
GameCallback_OnThiefDeliverInformations (thiefPlayerID, infoSource, buildingPlayerID, thiefID, buildingID) Wird aufgerufen, wenn ein Dieb Informationen liefert.
GameCallback_OnThiefStealBuilding (_ThiefID, _ThiefPlayerID, _BuildingID, _BuildingPlayerID) Wird aufgerufen, wenn ein Dieb ein Gebäude bestiehlt
GameCallback_OnUpgradeLevelCollapsed ( _PlayerID, _BuildingID, _NewLevel) Wird aufgerufen, wenn eine Gebäudestufe einstürzt.
GameCallback_PlayerLeft ( _PlayerID ) Multiplayer: Wenn ein Spieler das Spiel verlässt.
GameCallback_PlayerLost ( _PlayerID ) Wird aufgerufen, wenn ein Spieler besiegt wird.
GameCallback_PredatorsStoleOutstock (_PackMemberID, _BuildingID, _BuildingPlayerID) Wird aufgerufen, wenn Raubtiere Nahrungsproduzenten angreifen.
GameCallback_QuestSytemBehavior_GetNumberOfParameter
GameCallback_QuestSytemBehavior_GetParameterName
GameCallback_QuestSytemBehavior_GetParameterType
GameCallback_QuestSytemBehavior_Parameter_GetCustomData
GameCallback_QuestSytemBehavior_Parameter_GetNumberOfCustomData
GameCallback_QuestSytem_GetBehaviorDescriptionByName
GameCallback_QuestSytem_GetBehaviorName
GameCallback_QuestSytem_GetBehaviorTypeByName
GameCallback_QuestSytem_GetHighestNumberOfTable
GameCallback_QuestSytem_GetKnightTitleByIndex
GameCallback_QuestSytem_GetLowestNumberOfTable
GameCallback_QuestSytem_GetNumberOfBehaviors
GameCallback_QuestSytem_GetNumberOfKnightTitle
GameCallback_QuestSytem_GetTableByIndex
GameCallback_RecreateGameLogic
GameCallback_RegularFestivalEnded ()
GameCallback_RegularFestivalStarted ()
GameCallback_ReportAttackEnd
GameCallback_ReportAttackEndCondition
GameCallback_ReportAttackStart
GameCallback_ResourceAddedToPlayerStock (_PlayerID, _GoodType, _Amount) Wird aufgerufen, wenn ein Spieler Rohstoffe abbaut.
GameCallback_ResourceDiscovered (_PlayerID, _EntityID, _GoodType) Wird aufgerufen, wenn Rohstoffe entdeckt werden.
GameCallback_SetDefaultValues
GameCallback_SetSoldierPaymentLevel (_PlayerID, _Level) Wird aufgerufen, wenn die Besoldung geändert wird.
GameCallback_SetTraitorType
GameCallback_SettlerFlees (_FleePlayerID, _FleeEntityID, _FrighteningPlayerID, _FrighteningEntityID) Wird aufgerufen, wenn Siedler fliehen.
GameCallback_SettlerSpawned (_PlayerID, _EntityID) Wird aufgerufen, wenn Siedler erzeugt werden.
GameCallback_SpouseGone (_PlayerID, _WorkerID, _WorkplaceID) Wird aufgerufen, wenn eine Ehefrau die Siedlung verlässt.
GameCallback_Street_Placed_Global (_PlayerID, _X, _Y) Wird aufgerufen, wenn eine Straße gebaut wird.
GameCallback_TaxCollectionFinished (_PlayerID, _TotalTaxAmountCollected, _AdditionalTaxesByAbility) Wird aufgerufen, sobald alle Steuereintreiber in der Burg sind.
GameCallback_TerritoryOwnershipChanged (_TerritoryID, _NewPlayerID, _OldPlayerID) Wird aufgerufen, wenn ein Territorium den Besitzer wechselt.
GameCallback_TerritoryVisible (_PlayerID, _TerritoryID) Wird aufgerufen, wenn ein Territorium sichtbar wird.
GameCallback_TradeGatheringFailed (playerID, entityID, goodType)
GameCallback_UpdatePrestigePoints
GameCallback_Wall_Placed_Global (_PlayerID, _X, _Y) Wird aufgerufen, wenn eine Mauer gebaut wird.
Zurück zu Referenz | print | tags
Sofern nicht anders angegeben, steht der Inhalt dieser Seite unter Lizenz Creative Commons Attribution-ShareAlike 3.0 License