Comandos
Andar, girar, olhar, atirar, socar, recarregar e usar itens.
Em JavaScript e TypeScript, this.comando(…); em Python, Ruby e Lua, os nomes são em snake_case (self.turn_radar(…); em Ruby o self é opcional). Um comando vale até ser trocado: o robô continua andando ou girando o que falta.
Principais
| JavaScript / TypeScript | Python / Ruby / Lua | O que faz |
|---|---|---|
| run() | run() | Chamado uma única vez, no começo da batalha: o loop é seu. Dentro dele, scan() fecha cada turno. |
| scan() | scan() | Fecha o turno (os comandos dados até aqui valem) e devolve o state do turno seguinte. |
| walk(distance) | walk(distance) | Anda e espera chegar (desiste após 15 turnos sem progresso). Enquanto espera, o robô não reage. |
| rotate(angle) | rotate(angle) | Gira o corpo e espera terminar. |
| walkTo(x, z) | walk_to(x, z) | go_to que espera: segue a rota contornando obstáculos e devolve {ok, reason} ao chegar ou desistir (outside_map, obstacle, no_path, cancelled, stuck). |
| wait(turns) | wait(turns) | Deixa passar turnos (1 sem argumento). |
| goTo(x, z) | go_to(x, z) | Planeja e segue uma rota. Retorna {ok:true} ou {ok:false, reason: outside_map/obstacle/no_path}. Acompanhe a chegada em state.navigation. move/turn/recharge cancelam a rota. |
| recharge() | recharge() | Para e espera 1 s antes de recarregar até encher. Repetir não reinicia; andar, girar, atirar ou socar cancelam. O radar fica suspenso. |
| special() | special() | Uma explosão em área ao redor do robô. Só pode usar uma vez, quando a vida chegar a 30% ou menos; consulte state.me.specialReady. |
| useItem(id) | use_item(id) | Usa a habilidade de um item que o robô carrega (nitro, repair_kit, bubble, overcharge, mine, emp, cloak, dash). Um por tick; o resultado chega em events (item_used ou item_failed). |
| canUse(id) | can_use(id) | Verdadeiro se use_item(id) funcionaria agora: tem o item, sem recarga, com usos e energia. Em Ruby também can_use?. |
| move(distance) | move(distance) | Anda `distance` unidades (negativo = ré). |
| turn(angle) | turn(angle) | Gira o corpo `angle` radianos. O canhão fica no braço: mirar é girar o corpo (turn(alvo.bearing)). |
| strafe(distance) | strafe(distance) | Anda de lado `distance` unidades, sem virar (positivo = direita). Só com pernas ou patas de aranha; rodas e esteiras ignoram. |
| turnRadar(angle) | turn_radar(angle) | Gira os sensores da cabeça `angle` radianos. |
| fire(power) | fire(power) | Atira para a frente do corpo com potência entre 0,1 e 3 (metralhadora: até 1,5): custa 3 × potência de energia e devolve isso se acertar; mais forte causa mais dano e esquenta mais o canhão. A arma muda tudo isso. |
| punch() | punch() | Soca quem estiver colado à sua frente (até ~5 de distância, num cone de ~40°): 7 de dano (5,5 fora das esteiras), empurra o outro e custa 4 de energia. Espera 1,5 s entre socos (me.punchCooldown). |
Golpe especial
O golpe especial causa dano em área ao redor do robô e pode ser usado uma única vez, quando a vida chegar a 30% ou menos. Consulte state.me.specialReady antes de chamar this.special() (Python/Ruby: self.special()).
Atalhos e funções de apoio
| JavaScript / TypeScript | Python / Ruby / Lua | O que faz |
|---|---|---|
| follow(radius) | follow(radius) | Ajudante: orbita o dono (raio padrão 4). |
| fireAt(x, z) | fire_at(x, z) | Ajudante: atira no ponto, se estiver no alcance e a arma pronta. |
| followOwner(state) | follow_owner(state) | Drone: o modo follow (orbita o dono e atira no inimigo mais próximo). Reescreva numa subclasse para mudar. |
| attackTarget(state) | attack_target(state) | Drone: o modo attack (persegue o target e atira). |
| guardOwner(state) | guard_owner(state) | Drone: o modo guard (protege o dono com escudo). |
| repairOwner(state) | repair_owner(state) | Drone: o modo repair (devolve vida ao dono). |
| aim(state, enemy) | aim(state, enemy) | Drone: atira onde o inimigo vai estar quando o tiro chegar. |
| shield() | shield() | Ajudante: escudo neste tick (recebe 85% do dano, não atira). |
| repair() | repair() | Ajudante: conserta o dono neste tick, se estiver perto (não atira). |
| ahead(distance) | ahead(distance) | Anda para a frente. |
| back(distance) | back(distance) | Anda de ré. |
| turnLeft(angle) | turn_left(angle) | Gira o corpo para a esquerda. |
| turnRight(angle) | turn_right(angle) | Gira o corpo para a direita. |
| strafeLeft(distance) | strafe_left(distance) | Anda de lado para a esquerda. |
| strafeRight(distance) | strafe_right(distance) | Anda de lado para a direita. |
| turnRadarLeft(angle) | turn_radar_left(angle) | Gira os sensores da cabeça para a esquerda. |
| turnRadarRight(angle) | turn_radar_right(angle) | Gira os sensores da cabeça para a direita. |
| log(texto) | log(texto) | Escreve no log da batalha. |
| normalizeAngle(angle) | normalize_angle(angle) | Normaliza um ângulo para o intervalo (-π, π]. |