Encadeamento de Interacoes

Visao Geral

O Hytale constroi comportamentos de gameplay complexos encadeando interacoes simples. Cada interacao tem um Type e um campo opcional Next apontando para a acao seguinte. Isso cria pipelines sequenciais que podem incluir condicoes, dano, efeitos, sons e mais.

Como as Cadeias de Interacao Funcionam

flowchart TD;
    A[Player Uses Item] --> B{Condition Check};
    B -->|"Game Mode = Adventure"| C[Apply Effect];
    B -->|"Wrong Game Mode"| X[Chain Stops];
    C -->|"EffectId: Burning"| D[Deal Damage];
    D -->|"BaseDamage: Fire 10"| E[Chain Complete];
    style A fill:darkgreen,color:white;
    style X fill:darkred,color:white;
    style E fill:steelblue,color:white;

Cadeia de Acerto de Projetil

flowchart LR;
    A[Projectile Hits Entity] --> B["DamageEntity<br>Fire: 15"];
    B --> C["RemoveEntity<br>Projectile destroyed"];
    style A fill:darkgoldenrod,color:white;
    style C fill:darkred,color:white;

Cadeia Complexa de Arma

flowchart TD;
    A[Player Swings Sword] --> B{Check Durability};
    B -->|"Has durability"| C[Damage Target];
    B -->|"Broken"| X[Play Break Sound];
    C --> D[Apply Knockback];
    D --> E{Critical Hit?};
    E -->|"Yes"| F[Apply Stun Effect];
    E -->|"No"| G[Play Hit Sound];
    F --> G;
    G --> H[Reduce Durability];
    style A fill:darkgreen,color:white;
    style X fill:darkred,color:white;

Estrutura da Cadeia

{
  "Type": "Condition",
  "RequiredGameMode": "Adventure",
  "Next": {
    "Type": "ApplyEffect",
    "EffectId": "Burning",
    "Next": {
      "Type": "Damage",
      "DamageCalculator": {
        "BaseDamage": { "Fire": 10 }
      }
    }
  }
}

Essa cadeia: verifica o modo de jogo -> aplica efeito de queimadura -> causa dano de fogo.

Tipos de Interacao

Type	Proposito	Campos Principais
Condition	Condicao baseada em requisitos	RequiredGameMode
ApplyEffect	Aplica um efeito de status	EffectId
Damage	Causa dano	DamageCalculator, BaseDamage
DamageEntity	Dano ao acertar projetil	DamageCalculator
RemoveEntity	Destroi a entidade	—
Simple	Interacao basica	Varia
Consume	Usa um item consumivel	Consume_Charge, efeitos

Onde as Cadeias Sao Usadas

• Interacoes de Itens (Server/Item/Interactions/) — quebra de blocos, uso de ferramentas
• Configs de Projeteis (Server/ProjectileConfigs/) — acoes ao acertar e ao quicar
• Acoes de NPCs — sequencias de habilidades de combate

Exemplo de Interacao de Projetil

{
  "Interactions": {
    "ProjectileHit": {
      "Cooldown": 0,
      "Interactions": [
        {
          "Type": "DamageEntity",
          "DamageCalculator": { "BaseDamage": { "Fire": 15 } },
          "Next": {
            "Type": "RemoveEntity"
          }
        }
      ]
    }
  }
}

Paginas Relacionadas

• Item Interactions — cadeias de interacao de blocos e itens
• Projectile Configs — cadeias de eventos de projeteis
• Damage Types — hierarquia de tipos de dano