JSON da rotação

Atualizado em 18/10/2026

O JSON é a descrição completa de uma rotação avançada: tudo o que o texto KRC tem, mais os IDs de feitiços, as flags dos slots e as configurações do perfil. O construtor o mostra na página Texto e JSON, e a KeyRota o aceita como arquivo (Novo — De um arquivo…, Importar). O formato se chama keyrota-rotation, versão 1. Há um JSON Schema para validá-lo.

Arquivo de exemplo#

A menor rotação útil: Ruptura com 5 ou mais pontos de combo quando ela não estiver no alvo; caso contrário, Mutilar.

{
  "format": "keyrota-rotation",
  "version": 1,
  "title": "Assassinato: mínimo",
  "specID": 259,
  "resources": ["PlayerHP", "TargetHP", "Energy", "Combo_Points"],
  "auras": [{"n": 1, "alias": "Rupture_DoT", "label": "Ruptura no alvo [1943]", "spell": 1943}],
  "slots": [
    {"n": 2, "alias": "Rupture", "label": "Ruptura", "spell": 1943},
    {"n": 4, "alias": "Mutilate", "label": "Mutilar", "spell": 1329}
  ],
  "rules": [
    {
      "use": "Rupture",
      "name": "Ruptura",
      "when": [{"all": ["Combo_Points >= 70", "Rupture_DoT.down"], "comment": "5+ pontos de combo, sem sangramento"}]
    },
    {"use": "Mutilate", "name": "Mutilar"}
  ]
}

Tudo o que o arquivo omite assume o valor padrão: os slots ficam visíveis Com alvo e não têm flags, o contador de inimigos é de 8 metros e conta só inimigos em combate. Uma regra sem when é sempre atendida.

Campos de nível superior#

Qualquer outro campo é um erro, “campo extra”: erros de digitação não passam despercebidos. Por isso, não adicione "$schema" ao arquivo; associe o schema no seu editor ou validador.

Em quase todo lugar, null pode ocupar o lugar de um valor; significa o mesmo que omitir o campo.

format e version#

"format": "keyrota-rotation" e "version": 1 são obrigatórios. Se version for maior que 1, a KeyRota recusa o arquivo: “a versão 2 é mais nova do que esta KeyRota entende: atualize-a”. Sem version: “é preciso a versão 1”.

title#

Uma string sem aspas duplas ". As quebras de linha viram espaços. No texto KRC, é rotation "…". Um bom lugar para a versão: "Assassinato v1.3".

specID#

O ID da especialização no jogo. Ele define os recursos da rotação (quando ela é criada no construtor) e a classe e a especialização no perfil do Better Assistant. 0 significa qualquer especialização: a rotação funciona, mas o perfil do Better Assistant não é montado (“Escolha uma especialização: o perfil do Better Assistant precisa dela”).

ignoreMainIcon#

true (padrão): a KeyRota pressiona apenas pelas regras; quando nenhuma é atendida, ela espera. false: nesse caso, ela pressiona a sugestão do jogo, como o perfil da Blizzard. A sugestão é o último recurso, depois de todas as regras; ela nunca passa na frente de uma regra.

enemies#

"enemies": {"range": 8, "combatOnly": true}

A condição enemies lê esse contador (veja Inimigos por perto). No construtor, são as opções “Raio do contador de inimigos, metros” e “Só inimigos em combate” da página Geral. Os valores também vão para o perfil do Better Assistant.

notes e footer#

A descrição da rotação (notes) e os comentários depois da última regra (footer). Uma lista de strings ou uma única string com \n. Uma string vazia "" é uma linha em branco no texto. As linhas em branco nas bordas são descartadas.

"notes": ["Baseado em um guia e nos melhores logs, patch 12.1", "", "v1.1: Envenenar mais cedo com 4+ alvos"]

No texto KRC, são linhas # … antes das declarações. Não afetam o funcionamento da rotação.

resources#

Os nomes dos recursos, em ordem: o primeiro item é resource1, o segundo é resource2 e assim por diante. O número define qual é o recurso; o nome é apenas como você o escreve nas condições:

• resource1 é a vida do jogador, e resource2, a vida do alvo;
• de resource3 em diante vêm os recursos da especialização, na ordem da tabela de specID: para um ladino, resource3 é a energia, e resource4, os pontos de combo.

"resources": ["PlayerHP", "TargetHP", "Energy", "Combo_Points"]

Use os nomes padrão da tabela: o construtor os mostra em palavras comuns (“Vida do jogador”, “Energia”), e outras pessoas e agentes de IA entendem as condições na hora. null pula um número: ["PlayerHP", null, "Energy"] declara apenas resource1 e resource3. Um recurso não declarado não pode ser lido: “resource2 não declarado”.

Todos os recursos são porcentagens do máximo, de 0 a 100. Como converter pontos de combo, energia e runas em porcentagem: Recursos, em Condições.

auras#

As auras são os seus bônus e as suas penalidades no alvo. A aura n da rotação é a aura n da lista do Better Assistant.

"auras": [
  {"n": 1, "alias": "Garrote_DoT", "label": "Garrote no alvo [703]", "spell": 703},
  {"n": 2, "alias": "Rupture_DoT", "label": "Ruptura no alvo [1943]", "spell": 1943}
]

A ordem na lista não importa; o que importa é n. Pode haver lacunas na numeração, mas, para o perfil do Better Assistant, as auras com ID precisam estar em sequência a partir da primeira.

slots#

Os slots são os botões da rotação. O slot n da rotação é o slot n do Better Assistant.

show#

• "target": o slot é mostrado quando você tem um alvo. Vale para quase todos os ataques.
• "combat": o slot é mostrado em combate, mesmo sem alvo. Para cura e defesas: o Frasco Rubro precisa funcionar quando não há alvo.

Um slot só fica pronto quando o Better Assistant o mostra. Um slot "target" sem alvo não está pronto, e as regras dele são puladas.

Flags do slot#

As flags dizem como pressionar um slot depois que a regra dele é escolhida. No construtor, são as chaves de Como pressionar.

Por que O + Q, e não só O: um botão só com O é pressionado na hora, no meio do GCD, antes de o golpe anterior acertar. Sumir depois de Ruína dos Reis só com O seria pressionado antes de chegarem os pontos de combo de Ruína dos Reis, e a regra de Sumir (Combo_Points < 65) verificaria o valor antigo. Com Q, o botão espera o fim do GCD.

Prioridade estrita: uma regra fora do GCD mais abaixo na lista não passa na frente de uma regra mais acima que está esperando o GCD.

"slots": [
  {"n": 1, "alias": "Adrenaline_Rush", "label": "Adrenalina (macro com Matança)", "spell": 13750, "offGcd": true, "queue": true},
  {"n": 4, "alias": "Keep_It_Rolling", "label": "Sorte Grande", "spell": 381989, "offGcd": true},
  {"n": 8, "alias": "Killing_Spree", "label": "Matança", "spell": 51690, "channel": true},
  {"n": 11, "alias": "Crimson_Vial", "label": "Frasco Rubro", "spell": 185311, "show": "combat"}
]

rules#

As regras, em ordem de prioridade: a primeira da lista é verificada primeiro.

when: grupos e condições#

{
  "use": "Garrote",
  "name": "Garrote",
  "note": ["Renovar na janela de pandemia"],
  "when": [
    {"all": ["Garrote_DoT.down"], "comment": "sem DoT"},
    {"all": ["Garrote_DoT.up", "Garrote_DoT.duration <= 30"], "comment": "restam 30% ou menos"}
  ]
}

Um mesmo slot pode aparecer em várias regras: por exemplo, Garrote a partir da Furtividade no alto da lista e a manutenção normal do Garrote mais abaixo.

Condições no JSON#

Cada condição é uma string na sintaxe KRC: Garrote_DoT.down, Rupture_DoT.duration <= 25, Kingsbane.cd <= 3, Combo_Points >= 70, enemies >= 2, target.distance <= 8, cd == 1. A lista completa está em Condições.

• Faça referência pelo nome (Garrote_DoT) ou pelo número: buff1, slot3, resource4.
• and dentro de uma string a divide em duas condições: "Combo_Points >= 70 and Energy >= 70" são duas condições, e as duas contam para o limite de 16.
• Sem # e sem quebras de linha em uma string.
• É o próprio mecanismo da KeyRota que lê as condições, por isso o JSON e o texto sempre significam o mesmo.

Nomes#

Um nome (alias) é como auras, slots e recursos são chamados nas condições e em use.

• O primeiro caractere é uma letra (de qualquer alfabeto) ou _; depois vêm letras, dígitos 0–9 e _. Letras acentuadas e de outros alfabetos servem; espaços, hifens e pontos, não: Fan_of_Knives, e não Fan-of-Knives.
• Um nome é único entre todas as auras, slots e recursos.
• Reservados: use, when, and, or, rotation, gcd, enemies, target, aoe, st, cd, defensives, ground_spells, movement e nomes como buffN, slotN, resourceN.
• As palavras-chave são sempre em minúsculas: use, or, .up. Use, OR e .UP são erros.

Um nome a partir do rótulo. Sem alias, a KeyRota cria um a partir de label: os colchetes e o que há dentro deles são descartados, as letras e os dígitos ficam, e todo o resto vira _. Por exemplo, "Garrote no alvo [703]" vira Garrote_no_alvo. Um nome vazio ou inutilizável vira Aura_N ou Slot_N; um nome já usado ganha _2, _3. Se uma regra fizer referência a buffN ou slotN que não estão nas listas, eles são declarados automaticamente como Aura_N e Slot_N.

Campos obrigatórios e valores padrão#

Limites#

Exatamente 16 grupos de 16 condições é permitido; 17 é um erro.

Erros#

Uma rotação com erro não é carregada de jeito nenhum: não existe execução parcial. Um erro sempre indica o local. No JSON, é um caminho: rules[3].when[1]: nome desconhecido Foo (contando a partir de zero). No construtor, “Regra 4, grupo 2: nome desconhecido Foo” (contando a partir de um). No texto KRC, um número de linha.

Estrutura do JSON:

Condições e declarações (as mesmas do texto KRC):

O construtor também informa “o grupo não tem condições” (um grupo vazio), “nenhum slot selecionado” e “o nome não pode ter aspas”.

Texto KRC#

O texto KRC é a mesma rotação em forma de linhas. A página Texto e JSON o mostra, e você pode guardá-lo como arquivo .txt. O texto e o JSON se convertem um no outro sem perda de significado.

rotation "Assassinato: mínimo"

buff1	Rupture_DoT = "Ruptura no alvo [1943]"
slot2	Rupture = "Ruptura"
slot4	Mutilate = "Mutilar"
resource1	PlayerHP
resource2	TargetHP
resource3	Energy
resource4	Combo_Points

use Rupture when  # Ruptura
	Combo_Points >= 70 and Rupture_DoT.down  # 5+ pontos de combo, sem sangramento

use Mutilate when  # Mutilar

Linhas#

• # fora de aspas duplas inicia um comentário que vai até o fim da linha. Dentro de um "rótulo", # é um caractere comum.
• Linhas em branco e linhas só com comentário são ignoradas: é assim que se escrevem descrições e separadores.
• Qualquer outra linha é uma declaração, use, or ou uma linha de condições. Caso contrário, é um erro stray_line: “linha fora de regra: "…" (texto livre deve começar com #)”.
• Quaisquer espaços e tabulações entre as partes. A forma canônica usa uma tabulação depois de buffN/slotN e no início das linhas de condições.

Declarações#

Somente antes do primeiro use:

rotation "Nome"                    # opcional, no máximo uma vez
buff1	Garrote_DoT = "Garrote no alvo [703]"   # aura 1
slot1	Garrote = "Garrote"                     # slot 1
resource1	PlayerHP                            # recurso 1

buffN e slotN vão de 1 a 12, e resourceN, de 1 a 99. O rótulo entre aspas pode ser vazio: slot5 Filler = "". Uma declaração depois do primeiro use é um erro late_declaration.

Regras#

use Rupture when  # Ruptura
	Combo_Points >= 70 and Rupture_DoT.down  # sem DoT
	or
	Combo_Points >= 70 and Rupture_DoT.up and Rupture_DoT.duration <= 30  # pandemia

• use Slot when abre uma regra; um comentário nessa linha é o nome da ação.
• Cada linha de condições é um grupo (condições unidas com and). Os grupos são separados por uma linha que contém apenas a palavra or.
• Uma regra sem linhas de condições não tem condições.
• Duas linhas de condições seguidas sem or são um erro split_group; or no início, no fim ou duas vezes seguidas é empty_group.

Texto e JSON: a correspondência#

As linhas em branco nas bordas dos blocos de comentários são descartadas; no meio, elas ficam como "".

Importação e armazenamento#

• A KeyRota guarda a rotação dentro do perfil. Exportar, na janela principal, salva o perfil da KeyRota (JSON) com a rotação; Importar aceita um perfil da KeyRota e apenas o JSON de uma rotação.
• Novo — De um arquivo… aceita .txt com texto KRC, JSON de rotação e um perfil da KeyRota; Novo — Da área de transferência aceita o mesmo a partir da área de transferência.
• No construtor: Texto e JSON — Colar ou Abrir… substituem a rotação; os slots e as auras de mesmos números mantêm os IDs, Com alvo / Em combate e as flags se a nova versão não os tiver.
• Uma rotação em texto (sem JSON) pega os IDs e a visibilidade dos slots do perfil do Better Assistant já guardado no perfil da KeyRota, e os IDs das auras também das marcas [703] nos rótulos delas.

O perfil do Better Assistant a partir do JSON#

“Montar com slots e auras”, no construtor, cria o texto do perfil do Better Assistant a partir do JSON da rotação:

• 12 slots: o slot N é slots[n = N].spell, visível conforme show. Um slot sem ID fica vazio.
• Auras em ordem a partir da primeira: auras[n = 1].spell, auras[n = 2].spell… Uma aura sem ID no meio é um erro.
• Classe e especialização a partir de specID.
• Contador de inimigos a partir de enemies.range e enemies.combatOnly.
• Se o perfil da KeyRota já tiver um perfil do Better Assistant da mesma especialização, as demais configurações dele e os slots e as auras correspondentes são mantidos.

No jogo: /ba — Profile — colar — Apply.

JSON Schema#

O schema do formato: keyrota-rotation.schema.json (draft 2020-12). Ele verifica campos, tipos, intervalos, queue sem offGcd e a forma das strings de condição. Ele não verifica se n e os nomes são únicos, se os nomes usados nas condições existem nem o limite de 16 depois de dividir as strings em and : isso a KeyRota faz ao carregar.

Para validar um arquivo:

npx ajv-cli validate --spec=draft2020 -s keyrota-rotation.schema.json -d my-rotation.json

Não coloque um campo "$schema" em um arquivo de rotação: a KeyRota o trata como um campo extra.