O que o robô sabe: state
Tudo o que os sensores captaram no último turno.
scan() devolve o state, com o que o robô sabe no começo do turno:
state.me: o seu robô (posição, vida, energia, escudo, peças e atributos).state.scanned: os inimigos que o radar está vendo, com os ângulos prontos para mirar. Girar o corpo embearing(this.turn(enemy.bearing)) aponta o canhão para eles.state.events: o que aconteceu no último turno (tiros que acertaram, colisões…). Veja Eventos.state.hazards: os eventos do cenário anunciados, com o lugar e o turno do golpe.
A arena pode ser circular ou quadrada, pequena (44), média (58) ou grande (90 unidades). Use me.distanceToEdge para a borda real e me.centerBearing para voltar ao centro. me.parts e me.specs descrevem a sua montagem.
Todos os campos
| JavaScript / TypeScript | Python / Ruby / Lua | O que faz |
|---|---|---|
| specialReady | special_ready | Verdadeiro quando a vida está em 30% ou menos e o golpe especial ainda não foi usado. |
| items | items | Seus itens (até 3, declarados na classe com items). Cada um: id, usable, ready, cooldown, charges, running, temporary e expires. |
| usable | usable | O item tem habilidade para use_item (os só-passivos não têm). |
| ready | ready | use_item funcionaria agora: sem recarga, com usos e energia. |
| cooldown | cooldown | Ticks até poder usar o item de novo. |
| charges | charges | Usos restantes do item; nil/None = ilimitado. |
| running | running | Ticks restantes do efeito do item (nitro, bubble, cloak, overcharge). |
| temporary | temporary | Item temporário de uma caixa mistério: um uso, some em expires ticks. |
| helpers | helpers | No robô: as instâncias declaradas em helpers (new Drone()...), sempre na mesma ordem. Em me: seus ajudantes vivos (dados). No estado: ajudantes inimigos que o radar viu (com owner, distance e bearing); eles não entram em scanned. |
| alive | alive | Ajudante ainda na batalha; falso depois de destruído (ele continua na lista helpers). |
| enemies | enemies | No state de um ajudante: inimigos que o radar do dono ou o sensor dele veem, do mais perto ao mais longe. |
| enemyHelpers | enemy_helpers | No state de um ajudante: ajudantes inimigos ao alcance do sensor. |
| owner | owner | Id do robô dono de um ajudante. |
| mode | mode | Modo do Drone: follow, attack, guard ou repair. |
| navigation | navigation | Navegação no início do tick: status idle/moving/arrived/failed, target e reason. goTo retorna aceitação imediata; arrived confirma a chegada. |
| status | status | Estado da navegação: idle, moving, arrived ou failed. |
| target | target | Destino solicitado à navegação, com x e z; null quando não há destino. |
| reason | reason | Falha: outside_map (inclui falta de margem), obstacle ou no_path; null sem falha. |
| map | map | Grade estática do robô (this.map/self.map/map): rows[z][x], 0=vazio, 1=chão, 2=obstáculo. |
| rows | rows | Linhas do bitmap; cada caractere é uma célula: 0, 1 ou 2. |
| cellSize | cell_size | Tamanho de uma célula em unidades do mundo. |
| origin | origin | Canto inicial do bitmap. Centro da célula = origin + (índice + 0,5) × cellSize. |
| arena | arena | Formato (shape) e dimensões (width, height) da arena. A navegação usa os mesmos sensores em todos os formatos. |
| centerBearing | center_bearing | Quanto girar o corpo para apontar ao centro: turn(me.centerBearing). Funciona em qualquer formato. |
| specs | specs | Atributos efetivos da própria montagem: velocidade, aceleração, alcance, recarga e custos. bulletSpeed multiplica (1,2 − 0,2 × potência). |
| shape | shape | Formato da arena: circle ou square. |
| width | width | Largura da arena em unidades do motor. |
| height | height | Altura da arena no plano XZ, em unidades do motor. |
| maxVelocity | max_velocity | Velocidade máxima efetiva da montagem (unidades por tick). |
| bulletSpeed | bullet_speed | Multiplicador da velocidade do tiro: (1,2 − 0,2 × potência) × bulletSpeed. |
| charging | charging | Se está parado preparando ou recarregando a bateria. |
| rechargeRemaining | recharge_remaining | Ticks restantes da preparação; zero durante a recarga gradual. |
| tick | tick | Número do tick atual (30 por segundo). |
| arenaRadius | arena_radius | Raio da arena; além dele o robô cai e está fora. |
| others | others | Inimigos ainda vivos. |
| me | me | O seu robô. |
| scanned | scanned | Inimigos no arco do radar, do mais próximo ao mais distante. |
| events | events | O que aconteceu com você no último tick. |
| supplies | supplies | Entregas do drone: vida, energia ou baú surpresa (pode explodir). Colete após land; desaparece em end. |
| hazards | hazards | Eventos do cenário anunciados (bomba de lava, granizo, raio, meteoro, gêiser, pedra rolante). |
| kind | kind | Tipo do evento: lavaBomb, firePool, hail, lightning, meteor, geyser ou boulder. |
| radius | radius | Raio do golpe do evento. |
| impact | impact | Tick em que o evento atinge (antes disso é só o aviso). |
| x | x | Posição x. |
| z | z | Posição z. |
| heading | heading | Direção do corpo (radianos): é para onde ele atira. |
| radarHeading | radar_heading | Direção do radar. |
| velocity | velocity | Unidades por tick (máximo 0,26 com esteiras; depende do corpo). |
| strafeVelocity | strafe_velocity | Velocidade de lado (positivo = direita). |
| punchCooldown | punch_cooldown | Ticks até poder socar de novo (0 = pronto). |
| health | health | Vida: tiros e colisões tiram; chegou a 0, o robô é destruído. |
| maxHealth | max_health | Vida máxima (depende do corpo). |
| energy | energy | Energia: gasta nas ações; recharge() espera 1 s parado e recupera 1,75 por tick com a bateria padrão. |
| maxEnergy | max_energy | Energia máxima (depende da bateria). |
| shield | shield | Escudo (defesa shield): absorve dano antes da vida e recarrega. |
| maxShield | max_shield | Escudo máximo (30 com a defesa shield, senão 0). |
| outsideTicks | outside_ticks | Ticks fora da arena até agora (patas de aranha aguentam um tempo). |
| edgeGrace | edge_grace | Quantos ticks o robô aguenta fora da arena (aranha: 30, outros: 0). |
| parts | parts | As peças efetivas do inimigo (body, head, torso, weapon, armor). |
| body | body | Base de locomoção: rodas (explorador, operario, batedor, oficina), esteiras (guardiao, carregador, engenheiro, transporte), pernas (mecanico, assistente, forca, tita) ou aranha (aranha, pesquisador, resgate, coletor). |
| weapon | weapon | Canhão do antebraço direito: cannon, railgun, shotgun ou minigun. Cada arma tem um modelo 3D próprio; substitui a mão direita. |
| armor | armor | Defesa: none, plating, shield ou reactive. |
| head | head | Cabeça e sensores integrados: ID completo, como pesquisador.head. Define alcance, abertura, giro e consumo. |
| torso | torso | Tronco com energia, recarga e habilidade integradas: ID completo, como mecanico.torso. |
| gunHeat | gun_heat | O canhão só atira com gun_heat igual a 0. |
| remainingMove | remaining_move | Quanto ainda falta andar. |
| remainingTurn | remaining_turn | Quanto o corpo ainda vai girar. |
| remainingStrafe | remaining_strafe | Quanto ainda falta andar de lado. |
| remainingRadarTurn | remaining_radar_turn | Quanto o radar ainda vai girar. |
| distanceToEdge | distance_to_edge | Distância até a borda da arena (abaixo de 0, caiu). |
| distance | distance | Distância até o inimigo. |
| bearing | bearing | Quanto girar o corpo (e o canhão, que fica no braço) para mirar no inimigo: turn(alvo.bearing). |
| absoluteBearing | absolute_bearing | Ângulo absoluto de você até o inimigo. |
| radarBearing | radar_bearing | Quanto girar o radar para continuar vendo o inimigo. |
| id | id | Identificador do robô. |
| name | name | Nome do robô. |