TR Function

温馨提示：本文档由付费版版的ChatGPT o3-mini-high协助翻译，翻译内容自行验证，不保证绝对准确。。如需要使用旧文档，请访问旧版文档

• trActivateTrigger(<eventID>) : Activates (sets active = true) the trigger specified by the given eventID.

  trActivateTrigger(<eventID>)：激活指定事件ID的触发器（设置 active = true）。

• trAddArmyToPlan(armyname, planname): Adds the units in the specified army to the specified plan.

  trAddArmyToPlan(armyname, planname)：将指定军队中的单位添加到指定计划中。

• trAICommsAttackUnits(playerID, armyToAttack): playerID will attack armyToAttack, sent via player Comms.

  trAICommsAttackUnits(playerID, armyToAttack)：通过玩家通信系统，playerID 将攻击 armyToAttack。

• trAICommsCancelOrder(sendToPlayerID): tell player sendToPlayerID to cancel order, sent via player Comms.

  trAICommsCancelOrder(sendToPlayerID)：通过玩家通信系统，指示 sendToPlayerID 取消当前订单。

• trAICommsClaim(sendToPlayerID): tell player sendToPlayerID to claim TradePost at (locX, locY, locZ), sent via player Comms.

  trAICommsClaim(sendToPlayerID)：通过玩家通信系统，指示 sendToPlayerID 占领位于 (locX, locY, locZ) 的贸易站。

• trAICommsDefendPoint(playerID, defendX, defendY, defendZ): playerID will defend point (defendX, defendY, defendZ), sent via player Comms.

  trAICommsDefendPoint(playerID, defendX, defendY, defendZ)：通过玩家通信系统，playerID 将守卫指定点 (defendX, defendY, defendZ)。

• trAICommsRequestTribute(fromPlayerID, resource, amount): fromPlayerID will send resource of x amount, sent via player Comms.

  trAICommsRequestTribute(fromPlayerID, resource, amount)：通过玩家通信系统，fromPlayerID 将请求以指定数量发送资源。

• trAICommsTrain(sendToPlayerID, unitTypeName): tell player sendToPlayerID to train Units of type unitTypeName, sent via player Comms.

  trAICommsTrain(sendToPlayerID, unitTypeName)：通过玩家通信系统，指示 sendToPlayerID 训练指定类型（unitTypeName）的单位。

• trAIFunc( <playerID> <functionName> <param> ): Makes the camera shake.

  trAIFunc( <playerID> <functionName> <param> )：使摄像机震动。

• trArmyDispatch( <parameters> ): creates the units in the army specified.

  trArmyDispatch( <parameters> )：创建指定军队中的单位。

• trArmyPlayerDefakify(armyname) : Defakifies the army.

  trArmyPlayerDefakify(armyname)：将指定军队转换为真实状态（解除假状态）。

• trArmyPlayerFakify(armyname, fakeplayerindex) : Fakifies the army to the specified fake player index.

  trArmyPlayerFakify(armyname, fakeplayerindex)：将指定军队转换为指定假玩家的军队。

• trArmySelect(army info string): selects the units in the army specified.

  trArmySelect(army info string)：选中指定军队中的单位。

• trArmySelectInt(int playerID, int armyID): selects the units in the army specified.

  trArmySelectInt(int playerID, int armyID)：选中指定玩家的指定军队中的单位。

• trAttackUnits(srcArmyname, armyToAttack, planname): srcArmy units will attack armyToAttack in the given planname.

  trAttackUnits(srcArmyname, armyToAttack, planname)：源军队中的单位将在指定计划下攻击目标军队。

• trBlockAllAmbientSounds : blocks all ambient sounds from this point forward.

  trBlockAllAmbientSounds：从此处开始阻止所有环境音效。

• trBlockAllSounds(excludeDialog): Blocks all sounds from playing from this point forward.

  trBlockAllSounds(excludeDialog)：从此处开始阻止所有声音播放（可排除对话音效）。

• trBranchScenario( <dialog message> ): pop up a dialog allowing choice to load a scenario.

  trBranchScenario( <dialog message> )：弹出对话框，允许选择加载场景。

• trBuildingIsOnCursor(protoname) : Returns true if the proto unit specified is on the cursor and is a building.

  trBuildingIsOnCursor(protoname) ：如果指定的 proto 单位正位于鼠标光标上且是建筑，则返回 true。

• trCameraCut( pos, dir, up, right ) : puts the camera in the specified location.

  trCameraCut( pos, dir, up, right )：将摄像机切换到指定的位置。

• trCameraLockOnUnit( <enable> <time to orient> <trigger ID> ) : Orients the camera to the selected unit, and keeps it locked on that unit.

  trCameraLockOnUnit( <enable> <time to orient> <trigger ID> )：将摄像机锁定在选中单位上，并保持锁定。

• trCameraPanWithUnit( <enable> <trigger ID> ) : Moves the camera in the same direction that a particular unit moves.

  trCameraPanWithUnit( <enable> <trigger ID> )：使摄像机与指定单位移动方向同步移动。

• trCameraShake( <duration> <strength> ) : Makes the camera shake.

  trCameraShake( <duration> <strength> )：使摄像机震动。

• trCampaignAdvance() : advances the campaign (advance user profile, AND plays the next scenario).

  trCampaignAdvance()：推进战役（更新用户档案并播放下一个场景）。

• trCampaignAdvanceProgress() : advances the user progress through the campaign (updates user profile only).

  trCampaignAdvanceProgress()：推进战役进度（仅更新用户档案）。

• trCampaignPlayCurrent() : plays the current scenario in the campaign.

  trCampaignPlayCurrent()：播放战役中的当前场景。

• trCamTrackLoad( <filename> ) : Loads a camera track.

  trCamTrackLoad( <filename> )：加载摄像机轨迹。

• trCamTrackPlay( <duration> <eventID> ) : plays the current camera track.

  trCamTrackPlay( <duration> <eventID> )：播放当前摄像机轨迹。

• trChatHistoryClear : forces the chat history to reset.

  trChatHistoryClear：强制重置聊天历史。

• trChatHistoryContains(text) : returns whether the current chat history contains the given text as a substring.

  trChatHistoryContains(text) ：检查当前聊天历史中是否包含指定子字符串。

• trChatSend(fromID, message) : Changes the chat status.

  trChatSend(fromID, message) ：发送聊天消息，改变聊天状态。

• trChatSendSpoofed(fromID, message) : Changes the chat status, but does not append player.

  trChatSendSpoofed(fromID, message) ：发送伪装的聊天消息，不附加玩家信息。

• trChatSendSpoofedToPlayer(fromID, toID, message) : Changes the chat status, but does not append player. Goes to specific player.

  trChatSendSpoofedToPlayer(fromID, toID, message) ：向指定玩家发送伪装的聊天消息，不附加玩家信息。

• trChatSendToPlayer(fromID, toID, message) : Changes the chat status for one specific player.

  trChatSendToPlayer(fromID, toID, message) ：向指定玩家发送聊天消息。

• trChatSetStatus( <onOff> ) : Changes the chat status.

  trChatSetStatus( <onOff> )：设置聊天状态（开/关）。

• trCinematicAbort() : returns the abort cinematic status.

  trCinematicAbort()：返回终止电影的状态。

• trCinematicDoAbort() : aborts the cinematic.

  trCinematicDoAbort()：终止电影播放。

• trClearCounterDisplay:

  trClearCounterDisplay：清除计数器显示。

• trCounterAbort(name) : abort a counter.

  trCounterAbort(name) ：中止指定计数器。

• trCounterAddTime(name, start, stop, message, event) : start a counter that may or may not fire an event.

  trCounterAddTime(name, start, stop, message, event) ：启动一个计数器，该计数器可能触发事件，也可能不触发。

• trCounterAddTimeMs(name, start, stop, message, event) : start a counter (in milliseconds) that may or may not fire an event.

  trCounterAddTimeMs(name, start, stop, message, event) ：以毫秒为单位启动一个计数器，该计数器可能触发事件，也可能不触发。

• trCounterAddUnit(name, playerid, count, protounit, message, event) : start a counter that may or may not fire an event.

  trCounterAddUnit(name, playerid, count, protounit, message, event) ：启动一个计数器（单位计数），该计数器可能触发事件，也可能不触发。

• trCounterAddXP(name, playerid, count, message, event) : start a counter that may or may not fire an event.

  trCounterAddXP(name, playerid, count, message, event) ：启动一个计数器（经验值计数），该计数器可能触发事件，也可能不触发。

• trCountUnitsInArea(centerUnit, matchPlayer, matchType, range):

  trCountUnitsInArea(centerUnit, matchPlayer, matchType, range)：统计指定区域内的单位数量。

• trCreateAttackPlan(armyName, PlanName, attackPlayerID, attackX, attackY, attackZ, engageRange, evaluationFrequency) : No help.

  trCreateAttackPlan(armyName, PlanName, attackPlayerID, attackX, attackY, attackZ, engageRange, evaluationFrequency)：创建攻击计划。（无详细说明）

• trCreateDefendPlan(armyName, defendPlanName, defendX, defendY, defendZ, engageRange, evaluationFrequency, gatherdistance) : No help.

  trCreateDefendPlan(armyName, defendPlanName, defendX, defendY, defendZ, engageRange, evaluationFrequency, gatherdistance)：创建防守计划。（无详细说明）

• trCreateRevealer(playerID, revealerName, position, revealerLOS, blackmapOnly) : Creates a revealer with the given attributes.

  trCreateRevealer(playerID, revealerName, position, revealerLOS, blackmapOnly) ：使用指定属性创建一个揭示器。

• trCreateTreaty:

  trCreateTreaty：创建条约。

• trCurrentPlayer() : returns the current player.

  trCurrentPlayer()：返回当前玩家。

• trDamageUnit(amt) : does a specific amount of damage to HP in instant typeless damage.

  trDamageUnit(amt) ：对单位造成指定量的即时无类型伤害（扣除 HP）。

• trDamageUnitPercent(percent) : does % percent of a unit's total HP in instant typeless damage.

  trDamageUnitPercent(percent)：对单位造成其总生命值百分之 percent 的即时无属性伤害。

• trDamageUnitsInArea(player, unitType, dist, damage) : All units within dist of the selected ref object that match type take dmg.

  trDamageUnitsInArea(player, unitType, dist, damage)：在指定参照物周围距离 dist 内，所有匹配 unitType 的单位均受到 damage 伤害。

• trDefendUnits(srcArmyname, defendedArmyname, planname, evaluationFrequency, gatherdistance) : srcArmy units will defend defendedArmyUnits in the given planname.

  trDefendUnits(srcArmyname, defendedArmyname, planname, evaluationFrequency, gatherdistance)：源军队中的单位将在指定计划 planname 下保护目标军队中的单位，评估频率为 evaluationFrequency，集合距离为 gatherdistance。

• trDelayedRuleActivation(<rulename>) : adds a rule to the runtime to be activated on the next update.

  trDelayedRuleActivation(<rulename>)：将规则 rulename 添加到运行时，待下一次更新时激活。

• trDisableTrigger(<eventID>) : Disables (sets active = false) the trigger specified by the given eventID.

  trDisableTrigger(<eventID>)：禁用指定事件ID eventID 的触发器（将 active 置为 false）。

• trEcho(<echoString>) : Trigger echo.

  trEcho(<echoString>)：触发器回显指定的字符串 echoString。

• trEchoStatValue(player, stat) : fetch a stat value from the KB and echo to chat.

  trEchoStatValue(player, stat)：从知识库中获取统计数据 stat 并在聊天中回显，适用于玩家 player。

• trEndGame : Signal that the game has ended.

  trEndGame：发出游戏结束的信号。

• trEventFire(<eventID>) : cause an event to occur.

  trEventFire(<eventID>)：触发指定事件 eventID 的发生。

• trEventSetHandler(<eventID> <handler>) : sets a handler function for an event id.

  trEventSetHandler(<eventID> <handler>)：为指定事件ID eventID 设置处理函数 handler。

• trFadeOutAllSounds(<duration>) : Fades out all sounds over a given duration.

  trFadeOutAllSounds(<duration>)：在指定时长内逐渐淡出所有声音。

• trFadeOutMusic(<duration>) : Fades out current music over a given duration.

  trFadeOutMusic(<duration>)：在指定时长内逐渐淡出当前音乐。

• trForbidProtounit(player, protoname) : adds protounit to the forbidden list.

  trForbidProtounit(player, protoname)：将指定玩家 player 的 proto 单位 protoname 加入禁止列表。

• trForceNonCinematicModels() : forces models to be in non cinematic mode.

  trForceNonCinematicModels()：强制使模型进入非电影模式。

• trFormationScale(scale) : scales the formation size of formations in the game.

  trFormationScale(scale)：按比例 scale 缩放游戏中部队阵型的规模。

• trGameLoadScenario(<scenario name>) : start a game using scenario.

  trGameLoadScenario(<scenario name>)：使用指定场景开始游戏。

• trGamePause(<true/false>) : pause or unpause the game.

  trGamePause(<true/false>)：暂停或取消暂停游戏。

• trGetNumberNuggetsGathered : Returns the number of nuggets gathered by the specified player.

  trGetNumberNuggetsGathered：返回指定玩家采集到的金块数量。

• trGetNumberSelectedUnitIDs():

  trGetNumberSelectedUnitIDs()：返回当前选中单位ID的数量。

• trGetSelectedUnitID(int index):

  trGetSelectedUnitID(int index)：返回指定索引处的选中单位ID。

• trGetStatValue(player, stat) : fetch a stat value from the KB.

  trGetStatValue(player, stat)：从知识库中获取指定玩家 player 的统计数据 stat。

• trGetWorldDifficulty():

  trGetWorldDifficulty()：返回当前世界难度等级。

• trGrantVP(player, number) : Grants a number of Scenario VP to a player.

  trGrantVP(player, number)：向指定玩家授予 number 个场景胜利点。

• trHasNuggetBeenCollected : Returns true if the nugget has been collected; an optional playerID parameter can specify a particular player.

  trHasNuggetBeenCollected：如果金块已被采集则返回 true，可选参数 playerID 用于查询特定玩家。

• trHasPlayerSentHCShipment(<targetHCPlayerID>) : Returns true when the player has sent a shipment from the home city.

  trHasPlayerSentHCShipment(<targetHCPlayerID>)：如果玩家已从主城发送补给则返回 true，targetHCPlayerID 为目标主城玩家ID。

• trImmediateUnitGarrison(<unitScenarioName>) : Instantly garrisons units inside another unit without considering distance.

  trImmediateUnitGarrison(<unitScenarioName>)：立即将单位驻防到另一单位内，忽略距离限制，单位名称为 unitScenarioName。

• trIsGadgetVisible(<name>) : returns true if gadget is real.

  trIsGadgetVisible(<name>)：如果指定小工具处于显示状态（真实）则返回 true。

• trIsMovieNotPlaying() : returns false if a movie is currently playing.

  trIsMovieNotPlaying()：如果当前正在播放电影则返回 false。

• trIsPlayerSelectingHCBuilding(<hcBuildingName>) : Returns true if the current player is selecting the building in their HC which has the specified name.

  trIsPlayerSelectingHCBuilding(<hcBuildingName>)：如果当前玩家正在选中主城中名称为 hcBuildingName 的建筑，则返回 true。

• trIsPlayerSendingHCShipment(<targetHCPlayerID>) : Returns true when the player sends a shipment from home city.

  trIsPlayerSendingHCShipment(<targetHCPlayerID>)：当玩家从主城发送补给时返回 true。

• trIsPlayerVisitingHC(<targetHCPlayerID>) : Returns true if the current player is looking at the home city of the specified player.

  trIsPlayerVisitingHC(<targetHCPlayerID>)：如果当前玩家正在访问指定玩家的主城，则返回 true。

• trKillAIPlan(playerID, planName) : No help.

  trKillAIPlan(playerID, planName)：终止指定玩家的 AI 计划（无详细说明）。

• trLetterBox(<onOff>) : Turns letter box mode on or off.

  trLetterBox(<onOff>)：打开或关闭影院黑边模式。

• trMessageSetText(<text>, <timeout>) : displays the message text.

  trMessageSetText(<text>, <timeout>)：显示带有超时设置的消息文本。

• trMinimapFlare(<playerID> <duration> <position> <flash>) : Sends a Minimap flare to a certain player.

  trMinimapFlare(<playerID> <duration> <position> <flash>)：向指定玩家发送小地图闪光效果，持续时间为 duration，位置为 position，闪烁标志为 flash。

• trModeEnter(<name>) : enters the mode specified.

  trModeEnter(<name>)：进入指定模式 <name>。

• trModifyProtounit(unit, player, field, delta) : modifies proto unit data for this scenario only.

  trModifyProtounit(unit, player, field, delta)：仅在本场景中修改指定单位（unit）的 proto 单位数据，其所属玩家为 player，对字段 field 进行增量修改 delta。

• trMusicPlay(<filename> <duration>) : Plays the music file.

  trMusicPlay(<filename> <duration>)：播放指定的音乐文件，持续时间为 duration。

• trMusicPlayCurrent() : Plays the current music.

  trMusicPlayCurrent()：播放当前音乐。

• trMusicSetCurrentMusicSet() : sets the current music set.

  trMusicSetCurrentMusicSet()：设置当前音乐集。

• trMusicSetMood(<moodID>) : Changes the music to the mood associated with the mood id.

  trMusicSetMood(<moodID>)：将音乐切换至与指定 moodID 关联的情绪音乐。

• trMusicStop() : Stops the current music.

  trMusicStop()：停止当前播放的音乐。

• trObjectGettingWorked(objectScenarioName) : Returns true if the object is currently being worked.

  trObjectGettingWorked(objectScenarioName)：如果指定对象（objectScenarioName）当前正在被工作，则返回 true。

• trObjectiveComplete(objectiveID, forceComplete, playSound) : Completes the specified objective. Forces a reoccurring objective complete if forceComplete is true.

  trObjectiveComplete(objectiveID, forceComplete, playSound)：完成指定目标；若 forceComplete 为 true，则强制完成重复性目标，同时可选择播放声音。

• trObjectiveDiscover(objectiveID, playSound) : 'Discovers' a previously unknown (to the player) objective.

  trObjectiveDiscover(objectiveID, playSound)：使玩家“发现”一个之前未知的目标，playSound 指定是否播放声音。

• trObjectiveHide(objectiveID) : Hides the specified objective on the UI.

  trObjectiveHide(objectiveID)：在用户界面上隐藏指定目标。

• trObjectiveShow(objectiveID) : Shows the specified objective on the UI.

  trObjectiveShow(objectiveID)：在用户界面上显示指定目标。

• trOverlayText(message, time, x, y, width, background) : puts up a big movie-credits style text overlay, optionally in a strange location, and now with a background.

  trOverlayText(message, time, x, y, width, background)：显示大屏幕电影字幕风格的文本覆盖，可选位置和背景。

• trPlayerActive(playerID) : returns true/false if the player is active.

  trPlayerActive(playerID)：返回指定玩家是否处于活跃状态（true/false）。

• trPlayerAtPopCap(playerID) : returns true if player is at pop cap.

  trPlayerAtPopCap(playerID)：如果指定玩家的人口达到上限，则返回 true。

• trPlayerBuildingCount(playerID) : returns the number of buildings for the player.

  trPlayerBuildingCount(playerID)：返回指定玩家的建筑数量。

• trPlayerControlsSocket(playerID, objectScenarioName) : Returns true if the specified player is built on the specified socket.

  trPlayerControlsSocket(playerID, objectScenarioName)：如果指定玩家在指定插槽（objectScenarioName）上建造了单位，则返回 true。

• trPlayerCountBuildingInProgress(playerID, protoname) : returns true if building is being built.

  trPlayerCountBuildingInProgress(playerID, protoname)：如果指定玩家的建筑（protoname）正在建设中，则返回 true。

• trPlayerCurrentXPCount(playerID) : Returns the current (not total) XP for the player.

  trPlayerCurrentXPCount(playerID)：返回指定玩家当前的经验值（非累计值）。

• trPlayerDefeated(playerID) : returns true/false if the player has been defeated.

  trPlayerDefeated(playerID)：返回指定玩家是否已被击败（true/false）。

• trPlayerGetDiplomacy(playerID, playerID) : gets the diplomacy status between players.

  trPlayerGetDiplomacy(playerID, playerID)：获取两个玩家之间的外交状态。

• trPlayerGetPopulation(playerID) : returns the player population.

  trPlayerGetPopulation(playerID)：返回指定玩家的人口数量。

• trPlayerGrantResources(player, resource, amount) : advances the campaign.

  trPlayerGrantResources(player, resource, amount)：向指定玩家授予指定数量的资源（同时推进战役进程）。

• trPlayerKillAllBuildings(<playerID>) : Kills all of the buildings of a given player.

  trPlayerKillAllBuildings(<playerID>)：摧毁指定玩家的所有建筑。

• trPlayerKillAllUnits(<playerID>) : Kills all of the units of a given player.

  trPlayerKillAllUnits(<playerID>)：摧毁指定玩家的所有单位。

• trPlayerModifyLOS(playerID, cansee, playerID) : Adds/removes LOS between players.

  trPlayerModifyLOS(playerID, cansee, playerID)：为玩家之间添加或移除视野。

• trPlayerOverrideArtCulture(playerID, culture) : Overrides the culture used for choosing the player's art.

  trPlayerOverrideArtCulture(playerID, culture)：覆盖用于选择玩家艺术风格的文化设置。

• trPlayerOverrideSoundCiv(playerID, civilization) : Overrides the civilization used for choosing the player's vocal sound effects.

  trPlayerOverrideSoundCiv(playerID, civilization)：覆盖用于选择玩家声音效果的文明设置。

• trPlayerResetBlackMap(<playerID>) : Resets the black map for a given HUMAN player.

  trPlayerResetBlackMap(<playerID>)：重置指定人类玩家的黑地图状态。

• trPlayerResetBlackMapForAllPlayers : Resets the black map for all HUMAN players.

  trPlayerResetBlackMapForAllPlayers：重置所有人类玩家的黑地图状态。

• trPlayerResourceCount(playerID, resource) : returns the number of resources for the player.

  trPlayerResourceCount(playerID, resource)：返回指定玩家的资源数量（针对 resource）。

• trPlayerSetActive(playerID) : sets the active player.

  trPlayerSetActive(playerID)：将指定玩家设为活跃玩家。

• trPlayerSetAge(playerID, age, displayEffect) : Sets the age of the specified player.

  trPlayerSetAge(playerID, age, displayEffect)：设置指定玩家的时代（age），并决定是否显示效果（displayEffect）。

• trPlayerSetDiplomacy(playerID, playerID, status) : sets the diplomacy status between players.

  trPlayerSetDiplomacy(playerID, playerID, status)：设置两玩家之间的外交状态，status 为状态值。

• trPlayerSetHCAccess(playerID, hcAccess) : Sets whether the player has access to the HC.

  trPlayerSetHCAccess(playerID, hcAccess)：设置指定玩家是否有权访问主城（HC）。

• trPlayerToggleAllowNewCWSpawning(playerID, allowSpawning) : Toggles whether the player can spawn new covered wagons.

  trPlayerToggleAllowNewCWSpawning(playerID, allowSpawning)：切换指定玩家是否允许生成新的覆盖马车。

• trPlayerToggleAllowTCSpawning(playerID, allowSpawning) : Toggles whether the player's TC can spawn units.

  trPlayerToggleAllowTCSpawning(playerID, allowSpawning)：切换指定玩家的城镇中心（TC）是否允许生成单位。

• trPlayerTribute(from, resource, amount to) : tributes resources to a player.

  trPlayerTribute(from, resource, amount to)：向指定玩家缴纳资源作为贡品，数量为 amount。

• trPlayerUnitAndBuildingCount(playerID) : returns the number of units and buildings for the player.

  trPlayerUnitAndBuildingCount(playerID)：返回指定玩家的单位与建筑总数。

• trPlayerUnitCount(playerID) : returns the number of units for the player.

  trPlayerUnitCount(playerID)：返回指定玩家的单位数量。

• trPlayerUnitCountSpecific(playerID, protoName) : returns the number of units for the player.

  trPlayerUnitCountSpecific(playerID, protoName)：返回指定玩家特定 proto 单位的数量。

• trPlayerVPCount(playerID) : returns the number of victory points for the player.

  trPlayerVPCount(playerID)：返回指定玩家的胜利点数。

• trPlayMovie(<FileName>) : plays movies from the AVI directory.

  trPlayMovie(<FileName>)：从 AVI 目录中播放电影。

• trPlayNextMusicTrack() : Plays the next song in the music play list.

  trPlayNextMusicTrack()：播放音乐播放列表中的下一首歌曲。

• trQuestVarCopy(var1, var2) : copies value of one of the trigger scratch variables.

  trQuestVarCopy(var1, var2)：将一个触发器临时变量的值复制到另一个变量中。

• trQuestVarEcho(varname, value) : chats out the value of one of the trigger scratch variables.

  trQuestVarEcho(varname, value)：在聊天中显示指定触发器临时变量 varname 的值 value。

• trQuestVarGet(varname) : retrieve value of a trigger scratch variable, returns zero if unset.

  trQuestVarGet(varname)：获取指定触发器临时变量 varname 的值，若未设置则返回 0。

• trQuestVarSet(varname, value) : sets one of the trigger scratch variables.

  trQuestVarSet(varname, value)：设置指定触发器临时变量 varname 的值为 value。

• trQuestVarSetFromRand(varname, minval, maxval, round) : sets one of the trigger scratch variables within a random range.

  trQuestVarSetFromRand(varname, minval, maxval, round)：在指定随机范围内设置触发器临时变量 varname 的值，范围为 [minval, maxval]，round 表示是否取整。

• trRateConstruction(<rate>) : modify construction rate.

  trRateConstruction(<rate>)：修改建筑施工速度，按指定比例 <rate>。

• trRateResearch(<rate>) : modify research rate.

  trRateResearch(<rate>)：修改科技研究速度，按指定比例 <rate>。

• trRatesNormal(void) : restore all rates to normal.

  trRatesNormal(void)：将所有速度恢复到正常状态。

• trRateTrain(<rate>) : modify training rate.

  trRateTrain(<rate>)：修改训练速度，按指定比例 <rate>。

• trRenderRain(<float percent>) : controls rain rendering.

  trRenderRain(<float percent>)：控制雨水渲染，指定百分比。

• trRenderSky(<true/false> <skyName>) : turn sky rendering on/off and set which sky to use.

  trRenderSky(<true/false> <skyName>)：打开或关闭天空渲染，并设置使用的天空类型。

• trRenderSnow(<float percent>) : controls snow rendering.

  trRenderSnow(<float percent>)：控制雪景渲染，指定百分比。

• trRevealEntireMap() : shows whole map, similar to how revealed mode works.

  trRevealEntireMap()：显示整个地图，类似于完全揭示模式。

• trSetCinematicUnitSpeaking(objectScenarioName, speaking, duration) : Sets the unit as speaking or not.

  trSetCinematicUnitSpeaking(objectScenarioName, speaking, duration)：设置指定单位（objectScenarioName）是否正在讲话，持续时间为 duration。

• trSetCounterDisplay(text):

  trSetCounterDisplay(text)：设置计数器显示文本为 text。

• trSetCurrentPlayerStatus(<active>) : sets the current player as active or inactive.

  trSetCurrentPlayerStatus(<active>)：将当前玩家状态设置为活跃或不活跃，active 为 true/false。

• trSetFogAndBlackmap(<true/false> <true/false>) : turn fog and black map on/off.

  trSetFogAndBlackmap(<true/false> <true/false>)：打开或关闭雾和黑地图效果。

• trSetLighting(setname, fadetime) : fades to the specified lighting set over fadetime.

  trSetLighting(setname, fadetime)：在 fadetime 时间内渐变到指定的照明设置 setname。

• trSetObscuredUnits(<bool>) : Sets whether or not units can be drawn obscured or not.

  trSetObscuredUnits(<bool>)：设置单位是否以被遮蔽方式绘制，bool 为 true 或 false。

• trSetPauseInObjectiveWindow():

  trSetPauseInObjectiveWindow()：设置在目标窗口中暂停。

• trSetPauseOnAgeUpgrade():

  trSetPauseOnAgeUpgrade()：在升级时代时暂停。

• trSetPlayerDefeated : call this when a player is defeated on the local machine (meaning that this func must be called synchronously on all machines, it will not pass around a command.).

  trSetPlayerDefeated：当玩家在本地机器上被击败时调用此函数（该函数需在所有机器上同步调用）。

• trSetPlayerWon : call this when a player has won on the local machine (meaning that this func must be called synchronously on all machines, it will not pass around a command.).

  trSetPlayerWon：当玩家在本地机器上获胜时调用此函数（该函数需在所有机器上同步调用）。

• trSetRevealerActiveState(revealerName, active) : Finds the specified revealer and sets it to active or inactive.

  trSetRevealerActiveState(revealerName, active)：查找指定的揭示器 revealerName，并将其状态设置为 active（true）或 inactive（false）。

• trSetShadowFarClip(<enable>, <distance>) : Enable or disable the shadow far clipping plane.

  trSetShadowFarClip(<enable>, <distance>)：启用或禁用阴影远裁剪面，参数为 enable 和距离 distance。

• trSetUnitIdleProcessing(<bool>) : Sets whether or not units can do their idle processing.

  trSetUnitIdleProcessing(<bool>)：设置单位是否执行空闲处理，布尔值参数决定开关。

• trSetUserControls(<active>) : sets the player controls on or off.

  trSetUserControls(<active>)：打开或关闭玩家控制，active 为 true/false。

• trShowCampaignDlg(NextCampaign) : shows the campaign dialog.

  trShowCampaignDlg(NextCampaign)：显示战役对话框，参数为 NextCampaign。

• trShowChoiceDialog(maintext, choice1, event1, choice2, event2) : displays a dialog with 2 choices and activates a trigger in response.

  trShowChoiceDialog(maintext, choice1, event1, choice2, event2)：显示带有两个选项的对话框，并根据选择激活相应触发器。

• trShowDamage:

  trShowDamage：显示伤害效果。

• trShowHCView(playerID) : Sets the view to the HC if the specified player is the current player.

  trShowHCView(playerID)：如果指定的 playerID 与当前玩家匹配，则切换视图到主城（HC）。

• trShowImageDialog(texture, subtitle) : displays a custom image in a dialog, with a subtitle.

  trShowImageDialog(texture, subtitle)：在对话框中显示自定义图片，并附带字幕。

• trShowSPCNote(<Title> <Text>) : Displays the SPC Note Dlg with the specified title and text.

  trShowSPCNote(<Title> <Text>)：显示带有指定标题和文本的 SPC 提示对话框。

• trShowWinLose(text, soundfile) : message and sound.

  trShowWinLose(text, soundfile)：显示胜负信息及播放指定的声音文件。

• trShowWorldView(playerID) : Sets the view to the world if the player specified is the current player.

  trShowWorldView(playerID)：如果指定的 playerID 与当前玩家一致，则切换视图到世界视图。

• trSoundPlayDialog(<filename>, <event>, <ignoreOnAbort>, <subtitle>, <portrait>) : Plays the sound associated with the filename.

  trSoundPlayDialog(<filename>, <event>, <ignoreOnAbort>, <subtitle>, <portrait>)：播放与指定文件名关联的对话音效，并可指定事件、是否忽略中止、字幕及头像。

• trSoundPlayDialogue(<stringID>, <eventID>, <ignoreOnAbort>, <seconds>) : Plays the sound associated with the dialogue.

  trSoundPlayDialogue(<stringID>, <eventID>, <ignoreOnAbort>, <seconds>)：播放与对话相关联的声音，参数包括字符串 ID、事件 ID、是否忽略中止以及持续秒数。

• trSoundPlayFN(<filename>) : Plays the sound associated with the filename.

  trSoundPlayFN(<filename>)：播放与指定文件名关联的声音。

• trSoundPlayPaused(<filename>) : Plays the sound associated with the filename.

  trSoundPlayPaused(<filename>)：播放与指定文件名关联的声音（处于暂停状态下播放）。

• trSoundTimer(long milliseconds, long eventID) : creates a high performance sound timer and passes the eventID as data.

  trSoundTimer(long milliseconds, long eventID)：创建一个高性能声音计时器，并将 eventID 作为数据传递。

• trStartGameRecord : add help string.

  trStartGameRecord：开始游戏记录。（提示：添加帮助说明）

• trStopGameRecord : add help string.

  trStopGameRecord：停止游戏记录。（提示：添加帮助说明）

• trTechSetStatus(playerID, techID, status) : sets the tech status for the player.

  trTechSetStatus(playerID, techID, status)：为指定玩家设置科技 techID 的状态为 status。

• trTechStatusActive(playerID, techID) : returns true if tech is active for player.

  trTechStatusActive(playerID, techID)：如果指定玩家的科技 techID 正在激活中，则返回 true。

• trTechStatusCheck(playerID, techID, techStatus) : returns true if tech's status is techStatus.

  trTechStatusCheck(playerID, techID, techStatus)：如果指定玩家的科技 techID 的状态等于 techStatus，则返回 true。

• trTechStatusResearching(playerID, techID) : returns true if tech is being researched for player.

  trTechStatusResearching(playerID, techID)：如果指定玩家的科技 techID 正在研究中，则返回 true。

• trTime(void) : Returns the current gametime in Seconds.

  trTime(void)：以秒为单位返回当前游戏时间。

• trTimeMS(void) : Returns the current gametime in Milliseconds.

  trTimeMS(void)：以毫秒为单位返回当前游戏时间。

• trTradeRouteSetLevel(traderouteindex, level) : Sets the specified trade route to the specified level from a trigger.

  trTradeRouteSetLevel(traderouteindex, level)：通过触发器将指定贸易路线 traderouteindex 设置为指定等级 level。

• trTradeRouteSetPosition(position) : Places train on a specified position on the route.

  trTradeRouteSetPosition(position)：将火车放置在贸易路线上的指定位置 position。

• trTradeRouteToggleState(position) : Enable or disables the unit from showing.

  trTradeRouteToggleState(position)：启用或禁用单位的显示状态（适用于贸易路线单位）。

• trUIFadeToColor(<r> <g> <b> <duration> <delay> <inout>) : fade in/out using color specified.

  trUIFadeToColor(<r> <g> <b> <duration> <delay> <inout>)：使用指定的 RGB 颜色在设定的时长和延迟内进行淡入或淡出。

• trUIFlash(<gadget name> <flashLimit> <colorR> <colorG> <colorB>) : flashes a UI element.

  trUIFlash(<gadget name> <flashLimit> <colorR> <colorG> <colorB>)：使指定小工具 gadget name 闪烁，闪烁上限为 flashLimit，颜色为 RGB。

• trUIFlashCategory(<category> <flash>) : flashes a UI element (maybe).

  trUIFlashCategory(<category> <flash>)：使指定类别的 UI 元素闪烁（可能）。

• trUIFlashTech(<tech id> <flash>) : flashes a UI element (maybe).

  trUIFlashTech(<tech id> <flash>)：使指定科技 ID 的 UI 元素闪烁（可能）。

• trUIFlashTrain(<proto name> <flash>) : flashes a UI element (maybe).

  trUIFlashTrain(<proto name> <flash>)：使指定 proto 单位的 UI 元素闪烁（可能）。

• trUIStopFlash(<gadget name>) : stops the flashing of a UI element.

  trUIStopFlash(<gadget name>)：停止指定小工具的闪烁效果。

• trUnBlockAllAmbientSounds() : Unblocks all ambient sounds that were previously blocked from playing.

  trUnBlockAllAmbientSounds()：解除对所有环境声音的屏蔽，允许其播放。

• trUnblockAllSounds() : Unblocks all sounds that were previously blocked from playing.

  trUnblockAllSounds()：解除对所有声音的屏蔽，允许其播放。

• trUnforbidProtounit(player, protoname) : removes protounit from the forbidden list.

  trUnforbidProtounit(player, protoname)：从禁止列表中移除指定玩家的 proto 单位 protoname。

• trUnitAlive(void) : Returns true if all selected units are alive.

  trUnitAlive(void)：如果所有选中的单位均存活，则返回 true。

• trUnitBuildUnit(<protoUnitName> <BVector position (x,y,z)>) : Selects units and makes them build a unit at the specified location.

  trUnitBuildUnit(<protoUnitName> <BVector position (x,y,z)>)：选中单位，并在指定位置构建 proto 单位。

• trUnitChangeName(name) : set an override name for a specific unit.

  trUnitChangeName(name)：为指定单位设置覆盖名称。

• trUnitChangeProtoUnit : changes the proto unit for a given set of units.

  trUnitChangeProtoUnit：更改一组单位的 proto 单位类型。

• trUnitCinematicRemoveControlAction() : Removes the current control action so the next thing can take effect immediately. (For IGC)

  trUnitCinematicRemoveControlAction()：移除当前控制动作，使下一动作能立即生效。（适用于 IGC）

• trUnitConvert(playerID) : converts the selected units to the specified player.

  trUnitConvert(playerID)：将选中单位转换归属到指定玩家（playerID）。

• trUnitCreate(<protoName> <scenarioName> <x> <y> <z> <heading> <playerID>) : creates a new unit.

  trUnitCreate(<protoName> <scenarioName> <x> <y> <z> <heading> <playerID>)：创建一个新单位，参数分别为 proto 名称、场景名称、位置 (x, y, z)、朝向以及所属玩家 ID。

• trUnitDead(void) : Returns true if all selected units are dead.

  trUnitDead(void)：如果所有选中单位均已死亡，则返回 true。

• trUnitDelete(remove) : removes or kills the selected unit(s).

  trUnitDelete(remove)：删除或杀死选中的单位，参数决定行为。

• trUnitDestroy(void) : destroys the selected unit(s).

  trUnitDestroy(void)：销毁选中的单位。

• trUnitDistanceToPoint(<x> <y> <z>) : Returns the shortest distance between the selected units and the point.

  trUnitDistanceToPoint(<x> <y> <z>)：返回选中单位与指定点之间的最短距离。

• trUnitDistanceToUnit(<unitScenarioName>) : Returns the shortest distance between the selected units and the given unit.

  trUnitDistanceToUnit(<unitScenarioName>)：返回选中单位与指定单位（unitScenarioName）之间的最短距离。

• trUnitDistanceToUnitID(<unitID>) : Returns the shortest distance between the selected units and the given unit.

  trUnitDistanceToUnitID(<unitID>)：返回选中单位与指定单位 ID 之间的最短距离。

• trUnitDoWorkOnUnit(<unitScenarioName> <eventID>) : Tasks the selected unit(s) to perform work on the given unit.

  trUnitDoWorkOnUnit(<unitScenarioName> <eventID>)：指派选中单位对指定单位（unitScenarioName）执行工作任务，事件 ID 为 eventID。

• trUnitEjectContained : ejects all contained units.

  trUnitEjectContained：弹出所有被包含的单位。

• trUnitFaceUnit(<unitScenarioName> <eventID>) : Moves the selected unit(s) to face the given unit.

  trUnitFaceUnit(<unitScenarioName> <eventID>)：使选中单位转向指定单位（unitScenarioName），并触发事件 eventID。

• trUnitGarrison(<unitScenarioName> <eventID>) : Tasks the selected unit(s) to garrison into another unit.

  trUnitGarrison(<unitScenarioName> <eventID>)：指派选中单位进入指定单位（unitScenarioName）进行驻防，并触发事件 eventID。

• trUnitGetContained : returns the number of units contained.

  trUnitGetContained：返回被包含单位的数量。

• trUnitGetHeading(<scenarioName>) : returns the unit's heading.

  trUnitGetHeading(<scenarioName>)：返回指定单位（scenarioName）的朝向角度。

• trUnitGetIsContained(protounit) : returns true if this unit is contained by the specified protounit.

  trUnitGetIsContained(protounit)：如果该单位被指定的 proto 单位包含，则返回 true。

• trUnitHasLOS(playerID) : returns true if the player can see the selected unit, otherwise returns false.

  trUnitHasLOS(playerID)：如果指定玩家能够看到选中单位，则返回 true；否则返回 false。

• trUnitHighlight(seconds) : does something to highlight the units selected.

  trUnitHighlight(seconds)：以指定秒数突出显示选中单位。

• trUnitIsOwnedBy(playerID) : determines if the selected units are owned by the specified player.

  trUnitIsOwnedBy(playerID)：判断选中单位是否归属于指定玩家。

• trUnitIsSelected : returns if the specified unit is selected.

  trUnitIsSelected：返回指定单位是否被选中。

• trUnitMakeInvulnerable( <enable> ) : Makes a unit invulnerable to damage. Turn it off to return the unit to normal.

  trUnitMakeInvulnerable( <enable> )：使单位免受伤害。关闭该功能可使单位恢复正常状态。

• trUnitMoveFromArea( <x> <y> <z> <eventID> <bAttackMove> <player> <unitType> <radius> ) : Moves all matching units near the selected unit(s) to the given position.

  trUnitMoveFromArea( <x> <y> <z> <eventID> <bAttackMove> <player> <unitType> <radius> )：将所有符合条件且靠近选定单位的单位移动到指定位置。

• trUnitMoveToPoint( <x> <y> <z> <eventID> <bAttackMove> <bUnitRun> <runSpeedMultiplier> ) : Moves the selected unit(s) to the given position.

  trUnitMoveToPoint( <x> <y> <z> <eventID> <bAttackMove> <bUnitRun> <runSpeedMultiplier> )：将选定单位移动到指定位置。

• trUnitMoveToUnit( <unitScenarioName> <eventID> <bAttackMove> <bUnitRun> <runSpeedMultiplier> ) : Moves the selected unit(s) to the spot occupied by the given unit.

  trUnitMoveToUnit( <unitScenarioName> <eventID> <bAttackMove> <bUnitRun> <runSpeedMultiplier> )：将选定单位移动到由指定单位占据的位置。

• trUnitPercentComplete : returns the percent complete as 0 to 100.

  trUnitPercentComplete：返回完成百分比，范围为0至100。

• trUnitPercentDamaged : returns the percent damaged as 0 to 100.

  trUnitPercentDamaged：返回受损百分比，范围为0至100。

• trUnitPlayerDefakify() : Sets the selected unit as not having a fake player.

  trUnitPlayerDefakify()：设置选定单位不使用虚假玩家。

• trUnitPlayerFakify(fakePlayerIndex) : Sets the selected unit as having the fake player with the specified index (0-7).

  trUnitPlayerFakify(fakePlayerIndex)：将选定单位设置为使用指定索引（0-7）的虚假玩家。

• trUnitSelect(<unitScenarioName>) : 'Selects' the unit in the trigger selection system.

  trUnitSelect(<unitScenarioName>)：在触发器选择系统中“选择”指定的单位。

• trUnitSelectByID(<unitID>) : 'Selects' the unit in the trigger selection system.

  trUnitSelectByID(<unitID>)：在触发器选择系统中选中指定单位 ID。

• trUnitSelectClear(void) : Clears the units in the trigger selection system.

  trUnitSelectClear(void)：清除触发器选择系统中所有选中的单位。

• trUnitSetAnimation(<AnimName> <versionIndex> <loop> <eventID> <destroyOnNextControlAction>) : Sets the cinematic animation version for the selected unit(s).

  trUnitSetAnimation(<AnimName> <versionIndex> <loop> <eventID> <destroyOnNextControlAction>)：为选中单位设置电影级动画，参数依次为动画名称、版本索引、是否循环、事件 ID 以及是否在下次控制动作时销毁。

• trUnitSetHeading(<degrees>) : sets the unit's heading.

  trUnitSetHeading(<degrees>)：将选中单位的朝向设置为指定角度 <degrees>（单位：度）。

• trUnitSetHP(<hitpoints>) : set the hitpoints for all selected units.

  trUnitSetHP(<hitpoints>)：为所有选中单位设置生命值为 <hitpoints>。

• trUnitSetStance : set the stance for the given set of units.

  trUnitSetStance：设置选中单位的站姿（战斗、待命等）。

• trUnitSuspendAction(actionName, <suspend>) : Makes an action on a unit suspended or not.

  trUnitSuspendAction(actionName, <suspend>)：使指定单位的动作 actionName 暂停或恢复，参数 suspend 为 true 或 false。

• trUnitTeleport : moves units from current position to the specified position.

  trUnitTeleport：将选中单位从当前位置瞬间移动到指定位置。

• trUnitTypeIsSelected : returns if the specified unit type is selected.

  trUnitTypeIsSelected：判断指定类型的单位是否被选中。

• trUnitVisToPlayer(playerID) : returns true if the player can see the selected unit, and it is on screen.

  trUnitVisToPlayer(playerID)：如果指定玩家能看到选中单位且该单位在屏幕上，则返回 true。

• trVPAnnualAwards(enable) : enables/disables the award of VP's each year.

  trVPAnnualAwards(enable)：启用或禁用每年颁发胜利点的功能，参数 enable 为 true/false。

• trWaypointAddPoint(<vector>) : Adds the waypoint into the trigger selection system.

  trWaypointAddPoint(<vector>)：将当前摄像机位置（向量形式）添加为触发器选择系统中的路径点。

• trWaypointAddUnit(<unitScenarioName>) : Adds the unit's position as a waypoint in the trigger selection system.

  trWaypointAddUnit(<unitScenarioName>)：将指定单位（unitScenarioName）的当前位置添加为触发器路径点。

• trWaypointClear(void) : Clears the waypoints in the trigger selection system.

  trWaypointClear(void)：清除触发器选择系统中的所有路径点。

• trWriteToLog(message) : Writes text to the Age3Log.

  trWriteToLog(message)：将指定消息写入 Age3Log 日志文件中。

• trYouLose(text) : player loses, specifies message.

  trYouLose(text)：玩家失败，显示指定消息 text。

• trYouWin(directToMenu) : player wins. If directToMenu is true, go directly to Campaign Menu.

  trYouWin(directToMenu)：玩家获胜；若 directToMenu 为 true，则直接进入战役菜单。