七日杀A21 gameevents.xml文档注释详解

整篇由chatgpt翻译，正确与否请自行判断。

动作类型（action_type）- 动作序列的类型，可以是TwitchAction、TwitchVote或Game。

目标类型（target_type）- 动作序列的目标类型，可以是实体、POI或方块。

allow_while_dead - 如果目标已死亡，事件是否应继续进行。

要求（Requirements）可用于事件本身或事件中的单个操作。这些还控制while循环。

CVar - 检查目标是否设置了cvar。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

cvar - 要检查的cvar。

value - 要检查cvar的值。

FullHealth - 检查目标是否具有完全健康状态。

Gamestage - 检查玩家的游戏阶段。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

game_stage - 要检查的游戏阶段数字。

GameStatBool - 检查游戏的布尔游戏状态。

gamestat - 要测试的游戏状态名称。

GameStatFloat - 检查游戏的浮点游戏状态。

GameStatInt - 检查游戏的整数游戏状态。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

gamestat - 要测试的游戏状态名称。

GroupLiveCount - 检查目标组中活着的实体数量。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

target_group - 要测试的组。

count - 要检查的值。

HasBuff - 检查目标是否有一个buff。

buff_name - 要检查的buff的名称。

HasBuffByTag - 检查目标是否有任何buff标签。

buff_tags - 要检查的buff标签的名称。

HasSpawnedEntities - 检查是否存在生成的实体。

entity_tags - 生成实体的实体标签。

target_only - 是否生成目标的产物。

InQuestZone - 检查目标是否在任务区域内。

InSafeZone - 检查目标是否在安全区域内。

InVehicle - 检查目标是否在车辆内。

IsIndoors - 检查玩家是否在室内。

invert - 可用于检查他们是否不在室内。

IsTwitchActive - 检查目标是否启用了twitch集成。

NearbyEntities - 检查目标是否有附近的实体。

entity_tags - 附近实体的实体标签（如果没有标签，则默认为任何敌人或动物）。

max_distance - 要检查附近实体的最大距离。

target_is_owner - 如果车辆/炮塔归目标所有。

RandomRoll - 检查值是否符合随机掷骰子。

min_max - 要检查的数字范围。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

value - 要检查数字的值。

VarFloat - 检查游戏事件中的浮点变量。

VarInt - 检查游戏事件中的整数变量。

操作（operation）- 允许检查常见操作（None、Equals、NotEquals、Less、LessThan、LT、Greater、GreaterThan、GT、LessOrEqual、LessThanOrEqualTo、LTE、GreaterOrEqual、GreaterThanOrEqualTo、GTE）

var_name - 要测试的变量。

所有操作的通用属性：

Phase - 这是操作运行的阶段。
其中大部分动作需要提供目标组，以下是一些可以将实体添加到目标组的动作：

    AddClosestEntityToGroup - 将最近的实体添加到组中。
    AddEntitiesToGroup - 将所有符合特定条件的实体添加到组中。
        group_name - 要添加到的组名称，可以任意定义。
        entity_tags - 要搜索的实体标签。（如果未提供标签，则默认为任何敌人或动物）
        max_distance - 目标离实体的距离。
        twitch_negative - 定义 Twitch 是否禁用添加的目标。注意：当玩家死亡时，他们被认为是被禁用的 Twitch。
        target_is_owner - 如果车辆/炮塔由目标所有。
        y_height（AddEntitiesToGroup）- 重写使用的高度。
        exclude_target - 排除目标以外的实体。
        allow_player - 允许实体成为玩家。
    AddPartyToGroup - 将目标的队友添加到组中。
        group_name - 要添加到的组名称，可以任意定义。
        twitch_negative - 定义 Twitch 是否禁用添加的目标。注意：当玩家死亡时，他们被认为是被禁用的 Twitch。
        exclude_target - 排除操作目标。
        exclude_twitch_active - 排除任何正在直播的人，除了目标。
    AddPlayerToGroup - 将指定的队友添加到组中。（注意：他们必须在目标的队伍中。）
        player_name - 要添加的队友的名称。
        group_name - 要添加到的组名称，可以任意定义。
        twitch_negative - 定义 Twitch 是否禁用添加的目标。注意：当玩家死亡时，他们被认为是被禁用的 Twitch。
    AddSpawnedEntitiesToGroup - 将所有生成的敌人添加到组中。
        group_name - 要添加到的组名称，可以任意定义。
        entity_tags - 要搜索的实体标签。
        target_only - 是否必须在目标上生成僵尸或任何已生成的僵尸。

此外，还有一些玩家动作：

    AddBuff - 在目标或目标组中添加增益效果。
        buff_name - 要添加到目标的增益效果。
        removes_buff - 如果该增益效果已激活，则删除它而不是添加定义的增益效果。
        alt_vision_buff_name - 如果定义了此内容，如果某人将“允许视觉效果”设置为 false，则会应用此增益效果。
        check_already_exists - 在允许添加增益效果之前检查是否已存在它。
    AddChatMessage - 向玩家的聊天中添加消息。
        text - 要显示的文本。
        text_key - 要显示的本地化键。
    AddItemDurability - 增加玩家物品的耐久度。
        items_location - 受此项影响的位置。（工具腰带、背包、设备、手持物品）
        items_tags - 您要受此影响的物品的标签。
        amount - 要添加的耐久度量。
        is_percent - 如果数量是百分比。
    AddItems - 向玩家添加物品。
        added_items - 要添加的物品的逗号分隔列表。必须与 added_item_counts 相匹配。
        added_item_counts - 要添加的物品计数的逗号分隔列表。必须与 added_items 相匹配。
    AddJournalTip - 向玩家添加日志提示。
        tip_name - 日志提示的名称。
        show_window - 是否显示弹出提示窗口。
    AddQuest - 向玩家添加任务。
        quest - 添加到玩家的任务。
    AddRandomBuff - 向目标或目标组添加随机增益效果
        buff_names - 要从中随机选择用于添加到目标的增益效果列表。
        removes_buff - 如果该增益效果已激活，则删除它而不是添加定义的增益效果。
    AddSkillPoints - 向目标或目标组添加 x 个技能点。
        skill_points - 要添加的技能点数量。
    AddXP - 向目标或目标组添加 x 经验值。
        xp_amount - 要添加的经验值数量。
    AddXPDeficit - 向目标玩家添加经验值赤字。
        xp_amount - 要添加的经验值赤字数量。
    BeltTooltip - 显示腰带信息提示。
        text - 要显示的文本。
        text_key - 要显示的本地化键。
        sound - 可以与腰带消息一起播放的声音。
    CallGameEvent - 从此游戏事件调用另一个游戏事件。注意：如果意外触发太多事件，这可能会导致问题。使用时要非常小心。
        game_events - 要选择的游戏事件列表。这将随机选择其中一个。这可以像神秘随机事件一样使用。
    CloseWindow - 关闭指定的窗口。
        window - 要关闭的窗口。如果没有指定窗口，则关闭所有窗口。
    Delay - 用于在动作之间延迟。常见用法是将其放入自己的阶段中，以便该阶段延迟直到完成此操作。
        time - 要延迟的时间。
    DestroySafeZone - 销毁安全区域区域。
        destruction_type - 要执行的破坏类型。这可以是逗号分隔列表，随机选择其中一个。（立方体，球体，圆柱体，仅土地声明）
        new_name - 在坑洞周围的标志牌上显示的名称。您可以使用 {viewer} 表示观看者。
    DropHeldItem - 释放目标手持的物品。
    EjectFromVehicle - 使目标从车辆中弹出。
    EmptyContainers - 清空所有容器/工作站。
        targeting_type - 安全区域或距离
        new_name - 要在标志箱上显示的名称。您可以使用 {viewer} 表示观看者。
        include_fuel - 包括任何工作站的燃料。
        include_inputs - 包括工作站的输入区域。铸造炉熔炼材料就是一个示例。
        include_outputs - 包括工作站的输出区域。（将清除配方队列）
        include_tools - 包括工作站上的任何工具。（将清除配方队列）
    EnemyToCrawler - 强制目标成为爬行者。（不适用于玩家）


    Explode - 在目标位置上产生一个爆炸。
    blast_power - 爆炸的威力。
    block_damage - 对方块造成的伤害量。
    block_radius - 方块伤害的范围半径。
    block_tags - 受到方块伤害的方块。
    entity_damage - 对实体造成的伤害量。
    entity_radius - 实体伤害的范围半径。
    particle_index - 爆炸的粒子效果索引。

    FillSafeZone - 用指定的方块填充安全区域。
    fill_type - 填充土地声明区域的形状。可以是逗号分隔的列表，从中随机选择。（方块、球体、圆柱体和金字塔）
    destroy_claim - 是否破坏土地声明（默认为 false）。
    block - 用于填充土地声明的方块。默认为 terrDirtTwitch。
    new_name - 在填充的基地周围的标志牌上显示的名称。您可以使用 {viewer} 表示触发它的查看者。
    block_tags - 要替换的方块的标签。

    FlipRotation - 将玩家面朝的方向变为背后。

    GetNearbyPoint - 设置可用于一起生成多个僵尸的目标点。
    min_distance - 目标点最小距离。
    max_distance - 目标点最大距离。
    safe_spawn - 点是否可以出现在安全区内。
    air_spawn - 这定义了是否应完成地面检查以查看点是否有效。秃鹫使用这项功能允许在飞行中生成。
    yOffset - 这允许在 y 轴上偏移点。

    GetLandClaimPosition - 设置附近土地声明的目标点。

    Kill - 杀死目标或目标组。

    ModifyCVar - 修改 CVar 的值。
    cvar - 要设置的 cvar。
    value - 要将 CVar 设置为的值。
    operation - 应该发生什么操作（设置、添加、减去、乘以）。

    ModifyEntityStat - 修改目标或目标组的实体统计信息。
    stat - 要修改的统计信息（健康、耐力、食物、水）。
    value - 要将 CVar 设置为的值。
    operation - 应该发生什么操作（设置、添加、减去、乘以）。

    PauseBuff - 暂停一个增益效果，停止更新并隐藏图标。
    buff_tags - 要暂停增益效果的增益标签。
    state - 是否暂停。（true/false）

    PlaySound - 为目标播放声音。
    sound - 要播放的声音名称。
    inside_head - 声音是否在目标的头部播放。
    behind_player - 是否应在玩家背后选择一个位置播放声音（不适用于“inside_head”。）
    loop_duration - 如果是循环声音，则仅播放这么多秒。

    PrimeEntity - 使警察/恶魔僵尸的爆炸装置在指定的秒数内爆炸。
    override_time - 从开始发出哔哔声到爆炸的秒数。
    min_override_time - 随机爆炸时间的最小值。
    max_override_time - 随机爆炸时间的最大值。

    PullEntities - 强制所有实体在目标周围重生。
    target_group - 拉向目标的组。（这与大多数用法不同，因此属性名称可能会更改。）
    min_distance - 它们可以生成的最小距离。
    max_distance - 最大距离它们可以生成。
    pull_sound - 当实体被拉动时播放的声音。

    PushEntity - 将玩家/僵尸推向指定距离的方向。
    direction - 推动实体的方向。（随机、向前、向后、向右、向左）
    distance - 推动实体的距离。

    Ragdoll - 翻倒目标或目标组。
    stun_duration - 应用于目标/目标组的眩晕持续时间。

    RandomCVar - 用随机值修改 CVar 的值。
    cvar - 要设置的 CVar。
    min_value - 要将 CVar 设置为的最小值。
    max_value - 要将 CVar 设置为的最大值。
    operation - 应该发生什么操作（设置、添加、减去、乘以）。

    RandomDelay - 使用随机值进行延迟。
    min_time - 延迟的最短时间。
    max_time - 延迟的最长时间。
RandomizeRotation - 随机旋转目标对象的角度。

RandomTeleport - 随机传送目标对象/目标群组。
min_distance - 传送最小距离。
max_distance - 传送最大距离。

RemoveBuff - 移除指定的增益效果。
buff_name - 要移除的增益效果名称。

RemoveEntities - 移除目标群组中的所有实体。如果试图对目标（即玩家）使用此功能，可能会导致错误。

RemoveItems - 从玩家身上移除道具。
items_location - 受此命令影响的物品位置。（工具腰带、背包、两者都包括、装备、全部）
items_tags - 要移除的物品标记。

RemoveSpawnedBlocks - 移除所有已生成的方块。
target_only - 仅对目标移除。

RemoveVehicles - 从游戏世界中移除一辆车或一个炮塔。
return_items - 将车上的所有物品放置在地面的一个袋子中。
include_vehicle - 在放置的袋子中包括车本身。

ReplaceBuff - 使用另一种增益效果替换一个增益效果。
replace_buff - 要替换的增益效果名称。
replace_with_buff - 用于替换已被替换的增益效果的新增益效果名称。

ReplaceEntities - 用另一种实体替换目标群组中的所有实体。如果试图对目标（即玩家）使用此功能，可能会导致错误。
entity_names - 用于替换目标群组的实体名称。如果有多个，则将随机选择一个。
single_choice - 如果要替换多个实体，则仅选择一次并将其用于全部实体。

ReplaceItems - 用另一种物品替换指定的物品。
items_location - 受此命令影响的物品位置。（工具腰带、背包、两者都包括、装备、全部）
replaced_by_item - 使用此物品替换标记的物品。
items_tags - 应被替换的物品标记。

ReplaceItemsContainers - 替换附近容器或土地领主的容器中的内容。
targeting_type - 安全区域或距离。
new_name - 显示在标记箱上的名称。您可以使用 {viewer} 来表示观众。
max_distance - 容器的最大距离。
include_outputs - 包括工作站的输出区域。（将清空配方队列）
replaced_by_item - 使用此物品替换标记的物品。
items_tags - 应被替换的物品标记。

ResetPlayerData - 将玩家重置为等级一，并可选择删除所有领地/床垫。
reset_skills - 技能恢复到等级1。
reset_levels - 等级重置为1（如果选择了此选项，则自动重置技能）。
reset_crafting - 制作等级恢复到等级1。
reset_books - 将所有技能书特权重置为0。
remove_landclaims - 移除所有领地。
remove_bedroll - 移除玩家的床垫。

RespawnEntities - 重新生成指定目标群组中的所有死亡实体。
target_group - 要重新生成的实体群组。
is_multi - 是否连续运行此命令。
respawn_sound - 实体重新生成时播放的声音。

SetFuel - 设置目标车辆的燃料量。
target_group - 要操作车辆的群组。
setting_type - 完成车辆的哪种操作。（删除、加满）

SetHordeNight - 将下一次血月夜设置为今天。
day_offset - 当前游戏日距离血月夜还有几天。
keep_bm_day - 保留上一个血月夜。

SetScreenEffect - 设置本地玩家的屏幕效果。
screen_effect - 要设置的屏幕效果。
intensity - 屏幕效果的强度。
fade_time - 渐变到该强度所需的时间（以秒为单位）。

SetWeather - 将全局天气设置为定义的天气组。
weather_group - 要设置世界的天气组。

ShuffleContainers - 打乱所有附近的容器中的内容。注意：这可能会让玩家非常生气。请谨慎使用。
targeting_type - 安全区域或距离。
new_name - 显示在标记箱上的名称。您可以使用 {viewer} 来表示观众。
max_distance - 容器的最大距离。
include_outputs - 包括工作站的输出区域。（将清空配方队列）

ShuffleItems - 打乱目标物品的背包/工具腰带中的内容。
items_location - 要打乱的位置（背包、工具腰带）。

SpawnContainer - 在地面上生成一个容器。（处理箱子共享代码）
SpawnEntity - 在地面上生成一个实体。
entity_names - 要生成的实体。如果有多个，随机选择一个。
entity_group - 从该实体组中生成。（不能与entity_names同时使用）
single_choice - 如果要生成多个实体，则只随机选择一次。
spawn_count - 要生成的实体数量。
min_distance - 最小生成距离。
max_distance - 最大生成距离。
safe_spawn - 如果生成可以在安全区域内进行。
target_group - 可用于在玩家组（如队伍）中生成。
add_to_group - 将生成的实体添加到指定组。（可能需要重命名以避免混淆）
attack_target - 如果生成应立即攻击目标。（不适用于不攻击的箱子或动物。）
air_spawn - 这定义了它是否应完成地面检查以查看是否应生成。秃鹫使用此选项允许在飞行中生成。
yOffset - 这允许生成偏移y。
spawn_type - 生成类型（NearTarget，Position，NearPosition，WanderingHorde）
clear_position_on_complete - 完成后清除目标位置。

Teleport - 将目标传送到定义的位置或偏移量。
target_position - 要将目标传送到的位置/偏移量。
offset_type - None：传送到世界位置。Relative：相对于您的位置进行传送。World：根据您的位置相对于世界进行传送。

TeleportNearby - 将目标传送到定义的附近位置（使用GetNearbyPoint）。

TeleportToSpecial- 将目标传送到特殊位置。（仅适用于玩家。）
special_type - 这可以是Bedroll，Landclaim或Backpack。

TeleportToTarget - 将目标传送到目标。
target_group - 要传送到目标的目标组。（默认为操作目标）
teleport_to_group - 要传送到的目标组。如果组中有多个，则传送到其中一个随机选择。（默认为操作目标）
min_distance - 最小传送距离。
max_distance - 最大传送距离。
safe_spawn - 如果传送可以在安全区域内进行。
air_spawn - 这定义了它是否应完成地面检查以查看是否应传送。
yOffset - 这允许传送偏移y。

TimeChange - 根据time_preset和offset向前或向后移动时间。
time_preset - 将时间设置为预定义时间（Current，Morning，Noon，Night，NextMorning，NextNoon，NextNight，HordeNight）
min_time - 基于time_preset移动时间的最小时间量。
max_time - 基于time_preset移动时间的最大时间量。

WaitForDead - 类似于Delay，直到指定的target_group全部死亡才进入下一个阶段。
phase_on_despawn - 如果其中一个目标被消失，则进入的阶段。

Block Actions：
共同属性：
min_offset - 偏移量的最小范围。
max_offset - 偏移量的最大范围。
spacing - 每个块操作之间的间距。
inner_offset - 从中心排除的空间量。
random_chance - 每个块在偏移范围内发生动作的随机机会。
safe_allowed - 是否允许在安全区域内进行此操作。
block_tags - 受块操作影响的块。
allow_terrain - 如果受影响的块可以是地形块。

 BlockAnimateBlock - 将所有在定义范围内的块设置为触发动画。
     animation_bool - 设置动画布尔值。
     animation_bool_value - 设置动画布尔值的值。
     animation_integer - 设置动画整数值。
     animation_integer_value - 设置动画整数值的值。
     animation_trigger - 启用动画触发器。

 BlockDoorState - 将定义范围内的所有门设置为所需的开启状态。
     set_open - 如果应将门设置为打开或关闭。（true/false）
     set_lock - 如果应锁定门（true/false）

 BlockDowngrade - 将定义范围内的所有块设置为其定义的Downgrade块。

 BlockGrowCrops - 将所有附近的植物设置为其下一个成长阶段。

 BlockUpgrade - 将定义范围内的所有块设置为其定义的Upgrade块。

 BlockHealth - 将定义范围内的所有块的健康状态设置为指定的值。
     health_state - 块的健康状态。（Full，Half，OneHealth）

 BlockReplace - 用定义的块替换块。
     block_to - 更改旧块的新块。
     empty_only - 仅在其为空气块时替换。

POI操作：
POISetLightState - 允许设置POI中灯的状态。
enable_lights - 确定POI中灯亮还是灭。
index_block_name - 指定需要打开/关闭灯光的索引块名称。

POIReset - 重置POI块。

Twitch操作：
TwitchAddPoints - 给指定的观众增加一定数量的积分。
amount - 增加积分的数量。
point_type - 积分类型 (PP, SP, Bits)。
recipient_type - 接收积分的对象 (Requester, All, Random)
注意：Bit Credit不能给予所有人。
award_text - 颁发积分时在Twitch聊天中显示的文本。
requester_only - 是否仅在发起请求的聊天频道显示。如果您正在与使用集成的其他主播多播，则如果设置为false，则会在他们的聊天中给予积分。

TwitchAddActionCooldown - 将定义动作添加到冷却时间。
    action_name - 将被设置为冷却时间的动作列表。这个是动作名称而不是 #命令名称。
    time - 动作处于冷却状态的时间。
    search_type - 我们是否使用命名或所有正数或所有负数。（Name，Positive，Negative）

TwitchEndCooldown - 结束当前冷却时间。

TwitchSendChannelMessage - 发送频道消息。您可以使用变量 {target} 和 {viewer}。
    text - 要发送的文本。
    text_key - 要发送的本地化文本。

TwitchStartCooldown - 开始定时冷却时间。
    time - 冷却时间的持续时间。

TwitchStartVote - 开始投票。
    vote_type - 要开始的投票组名称。

TwitchVoteDelay - 将下一个投票延迟指定的秒数。
    time - 要延迟的时间。

变量操作：
这些操作允许暂时存储一个值以在要求中使用。更多功能稍后会推出。

ModifyVarFloat - 修改变量的浮点值。
    var_name - 变量的名称。
    value - 将变量设置为的值。
    operation - 应执行的操作 (Set, Add, Subtract, Multiply)。

ModifyVarInt - 修改变量的整数值。
    var_name - 变量的名称。
    value - 将变量设置为的值。
    operation - 应执行的操作 (Set, Add, Subtract, Multiply)。

决策：
使用 <decision> 定义，可以包含任意数量的要求/操作。您目前无法在决策内部使用循环。

If - 检查是否满足操做的需求。
    condition_type - 这定义了所有或任何的需求。（All，Any）

循环：
使用 <loop> 定义，可以包含任意数量的操作/延迟。您不能在循环内部使用循环。

For - 循环指定次数。
    loop_count - 循环次数。
    min_loop_count - 如果需要随机次数，则为最小值。
    max_loop_count - 如果需要随机次数，则为最大值。
    loop_count_cvar - 循环次数也可以来自CVar。

While - 当需求条件成立时循环。

延迟：
使用 <wait> 定义，可以包含任意数量的需求。

共同属性：
    condition_type - 这定义了所有或任何的需求。（All，Any）

While - 在等待条件成立时等待。

Until - 在等待条件不成立时等待。