Conhecendo a gladCode

A Competição

Na gladCode existe uma arena onde gladiadores virtuais batalham entre si até somente restar um vivo. Cada jogador, chamado mestre, possui a tarefa de programar o comportamento dos seus gladiadores, de modo que ele aja de maneira autônoma durante a batalha.

Os Gladiadores

Os gladiadores são os representantes dos mestres dentro da arena. E como tal, irão obedecer sua programação fielmente com o objetivo de derrotar os gladiadores dos adversários. Eles possuem características que determinam suas forças e fraquezas. Estas características são chamadas de atributos do gladiador. Eles também possuem um nível. Este nível indica o quão experiente este gladiador já se tornou dentro da arena.

Todos gladiadores iniciam em nível 1. Cada nível adicional concede a eles poder adicional na forma de melhorias de atributos. Os gladiadores possui três atributos principais, descritos a seguir:

• Força (STR): Força física e resistência do gladiador. Afeta o dano corpo-a-corpo que o gladiador causa e sua quantidade de pontos de vida.
• Agilidade (AGI): Agilidade, rapidez e destreza do gladiador. Afeta a precisão dos ataques à distância, o deslocamento do gladiador dentro da arena e a velocidade dos ataques dele.
• Inteligência (INT): Rapidez de raciocínio e Capacidade intelectual do gladiador. Afeta a velocidade do gladiador para executar uma habilidade e a quantidade de vezes que ele consegue executar uma habilidade até se esgotar mentalmente.

Cada um destes três atributos principais são responsáveis por atributos secundários, descritos a seguir:

• Dano físico (baseado em STR): Dano causado pelo gladiador ao realizar um ataque corpo-a-corpo. Representa a força bruta do gladiador.
• Pontos de vida, ou hp (baseado em STR): Dano que o gladiador suporta levar antes de morrer. Representa a resiliência física do gladiador.
• Precisão (baseado em AGI): Dano causado pelo gladiador ao realizar um ataque à distância. Representa a precisão do disparo do gladiador.
• Velocidade de ataque (baseado em AGI): Quantidade de ataques que o gladiador consegue executar por segundo. Representa a agilidade do gladiador em combate
• Velocidade de movimento (baseado em AGI): Distância que o gladiador consegue percorrer por segundo, medida em passos. Representa a rapidez com que o gladiador caminha.
• Velocidade de rotação (baseado em AGI): Quantos graus o gladiador consegue rotacionar por segundo.
• Poder mágico (baseado em INT): Dano causado pelo gladiador ao realizar um ataque usando uma habilidade mágica. Representa o nível de conhecimento que o gladiador possui a respeito das artes arcanas.
• Pontos de habilidade, ou ap (baseado em INT): Recurso gasto ao executar uma habilidade. Representa a resiliência mental do gladiador.
• Regeneração de ap (baseado em INT): Quantidade de pontos de habilidade regenerados por segundo. Representa a capacidade do gladiador de atuar sob pressão.
• Velocidade de habilidade (baseado em INT): Quantidade de habilidades que o gladiador consegue executar por segundo. Representa a rapidez de raciocínio do gladiador.

Atributos do gladiador

Ao criar um gladiador, os competidores precisam definir a distribuição inicial dos atributos básicos. Cada gladiador precisa receber atributos básicos que somados custam 50 pontos. O custo de cada ponto de atributo é variável, conforme a tabela abaixo:

Não se preocupe, você não precisa memorizar estes custos, pois o editor de gladiadores cuida disto para você.

Os efeitos dos atributos básicos sobre os secundários estão descritos a seguir:

• Força (STR)
• Dano físico(mdmg): 5 mdmg + 0.75 mdmg por ponto de STR
• Pontos de Vida (hp): 100 hp + 10 hp por ponto de STR
• Agilidade (AGI)
• Precisão(rdmg): 5 rdmg + 0.4 rdmg por ponto de AGI
• Velocidade de Ataque (as): 0.5 as + 0.05 as por ponto de AGI
• Velocidade de Movimento (ms): 1 ms + 0.05 ms por ponto de AGI
• Velocidade de Rotação (ts): 90 ts + 9 ts por ponto de AGI
• Inteligência (INT)
• Poder mágico(sdmg): 0.5 sdmg por ponto de INT
• Pontos de Habilidade (ap): 100 ap + 10 ap por ponto de INT
• Recuperação de ap (reg): 5 ap + 0.25 ap por ponto de INT
• Velocidade de uso de Habilidade (cs): 0.5 cs + 0.05 cs por ponto de INT

Existem também alguns atributos fixos dos gladiadores, que não sofrem mudanças em seus valores ao longo da simulação:

• Raio de visão: 120 graus - Arco de visão do gladiador
• Distância de visão: 9 passos - Distância máxima que o gladiador enxerga

O editor de gladiadores

A página onde você personaliza a aparência, distribui os atributos e programa o comportamento de seu gladiador chama-se editor de gladiadores. Nela você começa com uma interface que lhe permite escolher entre diversas opções de itens que configuram a aparência de seu gladiador.

Após isso você passa para a distribuição dos pontos de atributos do gladiador, onde você possui 25 pontos para distribuir entre os atributos força, agilidade e inteligência do gladiador. Conforme explicado anteriormente, estes atributos irão influenciar o quão bom seu gladiador é em determinadas ações.

Por último você deve programar seu gladiador usando o editor da página. Para tal você possui a disposição dezenas de funções que permitem o gladiador interagir e perceber o ambiente. Mais sobre a programação dos gladiadores será explicado adiante.

Ambiente de simulação

Ao construir um gladiador, os competidores usarão as funções da API gladCode para fazer o gladiador interagir com o ambiente. O ambiente representa uma arena, que possui dimensões 25x25 passos. As funções que lidam com distância usam a unidade Passos (p), que é uma unidade de medida específica da GladCode. Ela é um número float que representa 1/25 do comprimento total da arena, ou seja, isto quer dizer que a arena mede 25p.

Dentro da arena utilizamos um sistema de coordenadas cartesianas, isto quer dizer que um ponto dentro da arena é definido por um par de valores X e Y, onde X significa a distância em relação ao eixo vertical (aumentando da esquerda para a direita) e o Y a distância em relação ao eixo horizontal (aumentando de cima para baixo).

A simulação transcorre em intervalos de tempo de 0.1 segundos.

As funções que lidam com ângulo usam graus (g) como unidade de referência, e tomam por base uma circunferência de 360g que começa no topo e aumenta no sentido horário, conforme a figura ao lado.

Os gladiadores irão batalhar dentro da arena utilizando sua própria programação, de forma autônoma até que somente um saia vivo. Caso uma batalha já esteja acontecendo por 45 segundos, das bordas da arena surgirá um gás tóxico. Esta nuvem mortal lentamente se espalha pela arena em direção ao seu centro, com velocidade 0.1 p/s. Todos gladiadores que estiverem dentro desta nuvem levam dano continuamente. Esta é uma maneira de garantir que a rodada não irá durar para sempre, além de incentivar que os gladiadores se direcionem para o centro da arena após certo tempo, aumentando as chances de um confronto direto.

Experiência

Habilidades

Durante os confrontos, os gladiadores além de se movimentar, e utilizar ataques de curto e longo alcance, podem usar habilidades especiais. Cada habilidade possui um custo em pontos de habilidade (ap) ao ser executada, e causa um efeito específico, descrito na tabela abaixo:

Efeitos

Ao usar suas habilidades, os gladiadores podem causar em si mesmos ou em outros gladiadores uma série de efeitos temporários, descritos a seguir:

Programação

Para dar vida aos gladiadores, os competidores devem programar seu comportamento utilizando a sintaxe de uma linguagem de programação, por isso é recomendável que você tenha pelo menos um conhecimento básico de lógica de programação.

Atualmente a gladCode possui suporte para programação utilizando as linguagens Python, C, e Blocos. Mas se você conhece as estruturas básicas de qualquer linguagem imperativa, não vai achar difícil se adaptar.

O ambiente da simulação foi criado especialmente para a gladCode portanto existem funções específicas de entrada, que fazem com que o gladiador perceba o que está acontecendo na arena, e funções de saída que fazem com que o gladiador interaja com os elementos presentes na arena.

Para programar um gladiador, o código-fonte do programa deverá conter a função loop. Utilize o editor de gladiadores para criar o código de seu gladiador

O funcionamento é bem simples. Na função loop será colocado todo o comportamento do gladiador. A cada intervalo de tempo (0.1s) o gladiador irá tentar executar todas as tarefas descritas dentro desta função:

// Exemplo linguagem C
loop(){
    stepForward(); // função que faz mover para frente
}

# Exemplo linguagem Python
def loop():
    stepForward() # função que faz mover para frente

No código acima, a cada intervalo de tempo (0.1s) o gladiador irá mover-se o quanto conseguir (depende de sua agilidade) para frente, resultando em sucessivas chamadas da função stepForward ao longo do tempo.

Porém, existem situações em que o gladiador não consegue executar todos os comando da função loop() em um único intervalo da simulação, como no caso abaixo:

// Exemplo linguagem C
loop(){
    int i;
    for (i=0 ; i<10 ; i++) // faz 10 chamadas da função stepForward
        stepForward();
    turnLeft(5); // função que rotaciona no sentido anti-horário
}

# Exemplo linguagem Python
def loop():
    for i in range(10): # faz 10 chamadas da função stepForward
        stepForward()
    turnLeft(5) # função que rotaciona no sentido anti-horário

Neste caso o gladiador executa o que conseguir (1 chamada da função que move para frente), e a cada novo intervalo de tempo da simulação ele segue executando os próximos passos. Eventualmente, quando ele concluir todas as etapas descritas em sua função loop (as 10 chamadas de stepForward mais a chamada de turnLeft), ele irá começar novamente a função loop. Este processo somente encerrará quando o gladiador morrer, ou quando a simulação terminar.

Note que existem algumas funções que levam mais tempo para serem executadas, como por exemplo as funções de ataque (ex. attackMelee) e habilidade (ex. fireball). Neste caso o gladiador ficará esperando até que possa agir de novo para seguir a execução de seu código. Existem também as funções que não levam tempo algum de simulação para serem executadas, como as funções que detectam o ambiente (ex. getTargetX).

Para uma lista completa das funções existentes, suas finalidades e exemplos de utilização acesse a documentação.

Batalhas ranqueadas

Após criar seu primeiro gladiador você estará apto a participar das batalhas ranqueadas da gladCode. Através das batalhas ranqueadas seus gladiadores ganharão renome, que é a pontuação utilizada para classificação dos gladiadores.

A decisão de quais serão seus oponentes em uma batalha é feita através da posição no ranking que o gladiador ocupa. Para cada batalha, são selecionados os 10 gladiadores cujas posições no ranking geral são mais próximas do gladiador selecionado, e destes 10, 4 são sorteados aleatoriamente para a composição de seus oponentes na batalha.

Renome

Após cada batalha ranqueada, de acordo com o desemprenho que seu gladiator ovteve na mesma, ele ganhará uma determinada quantidade de renome. A quantidade de renome que um gladiador ganhará se baseia nos seguintes critérios:

• Se o gladiador foi o vencedor da batalha
• Quanto tempo o gladiador sobreviveu dentro da arena
• O renome que o gladiador possui, comparado à média de renome de todos participantes da batalha
• O quão próximo de 1000 de renome o gladiador está

A recompensa em renome obtida segue a seguinte fórmula:

rewardBase = ( (Ntime + 1.5 * win) - avgReward ) / bestReward * 10
reward = ( rewardBase / mmr * avgmmr ) * ( 1 + ((0.001 * mmr - 1) * lowmmr) )

Onde:

rewardBase = recompensa obtida, considerando somente o desempenho na batalha.
Ntime = tempo que o gladiador sobreviveu, normalizado (entre 0 e 1).
win = 1 caso o gladiador foi o vencedor, 0 caso contrário.
avgReward = rewardBase médio calculado entre todos gladiadores participantes.
bestReward = rewardBase obtido pelo gladiador vencedor da batalha.
reward = recompensa final obtida pelo gladiador.
mmr = renome que o gladiador possuia antes da batalha.
avgmmr = média de renome de todos gladiadores participantes, antes da batalha.
lowmmr = 0 caso o gladiador possua renome pelo menos 1000, 1 caso contrário.

Moedas de prata

silver = ( (190 + 0.21 * mmr) * (5 * win + 1) ) / 10 - 20

silver = recompensa de moedas de prata obtida.
mmr = renome que o gladiador possuia antes da batalha.
win = 1 caso o gladiador foi o vencedor, 0 caso contrário.

Itens consumíveis

Ao encomendar os itens do apotecário, você precisa possuir espaços (ou compartimentos) de itens livres no seu perfil. Você possui quatro espaços de itens bloqueados a princípio, e estes compartimentos são automaticamente desbloqueadas conforme seu nível de mestre aumenta, nos níveis 5, 15, 25 e 35. Para cada espaço desbloqueado, você pode possuir um item encomendado. Tais itens ficam visíveis em seus compartimentos durante o tempo em que estão ativos.

Para usar um item durante o combate, seu gladiador precisa usar a função useItem. Como argumento você deve informar uma String com o identificador do item desejado. Cada item encomendado e ativo só poderá ser usado uma vez durante cada batalha.

// Linguagem C
loop(){
    if (getHp() < 100){
        useItem("pot-hp-1");
    }
}
                

# Linguagem Python
def loop():
    if getHp() < 100:
        useItem("pot-hp-1")
                

Lista de itens disponíveis