Rotación en JSON

Actualizado el 18/10/2026

El JSON es la descripción completa de una rotación avanzada: todo lo que tiene el texto KRC, más los ID de hechizo, las marcas de ranura y los ajustes del perfil. El constructor lo muestra en la página «Texto y JSON», y KeyRota lo admite como archivo («Nuevo» — «Desde un archivo…», «Importar»). El formato se llama keyrota-rotation, versión 1. Hay un JSON Schema para validarlo.

Archivo de ejemplo#

La rotación útil más corta: Ruptura con 5 puntos de combo o más cuando no está en el objetivo y, si no, Mutilar.

{
  "format": "keyrota-rotation",
  "version": 1,
  "title": "Asesinato: mínimo",
  "specID": 259,
  "resources": ["PlayerHP", "TargetHP", "Energy", "Combo_Points"],
  "auras": [{"n": 1, "alias": "Rupture_DoT", "label": "Ruptura en el objetivo [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+ puntos de combo, sin sangrado"}]
    },
    {"use": "Mutilate", "name": "Mutilar"}
  ]
}

Todo lo que el archivo omite toma su valor predeterminado: las ranuras se muestran «Con objetivo» y no tienen marcas, el contador de enemigos es de 8 metros y solo cuenta enemigos en combate. Una regla sin when se cumple siempre.

Campos de primer nivel#

Cualquier otro campo es un error, «campo sobrante»: las erratas no se pasan por alto. Por eso no añadas "$schema" al archivo; asocia el esquema en tu editor o validador.

Casi en cualquier sitio, null puede ocupar el lugar de un valor; equivale a omitir el campo.

format y version#

"format": "keyrota-rotation" y "version": 1 son obligatorios. Si version es mayor que 1, KeyRota la rechaza: «la versión 2 es más nueva de lo que entiende esta KeyRota: actualízala». Sin version: «se necesita la versión 1».

title#

Una cadena sin comillas dobles ". Los saltos de línea se convierten en espacios. En el texto KRC es rotation "…". Es un buen sitio para la versión: "Asesinato v1.3".

specID#

El ID de la especialización en el juego. Determina los recursos de la rotación (cuando se crea en el constructor) y la clase y especialización del perfil de Better Assistant. 0 significa cualquier especialización: la rotación funciona, pero el perfil de Better Assistant no se crea («Elige una especialización: el perfil de Better Assistant la necesita»).

ignoreMainIcon#

true (predeterminado): KeyRota solo pulsa según las reglas; si no se cumple ninguna, espera. false: en ese caso pulsa la recomendación del juego, como el perfil de Blizzard. La recomendación es el último recurso, después de todas las reglas; nunca se adelanta a una regla.

enemies#

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

La condición enemies lee este contador (consulta Enemigos cerca). En el constructor son «Radio del contador de enemigos, metros» y «Solo enemigos en combate», en la página «General». Estos valores también pasan al perfil de Better Assistant.

notes y footer#

La descripción de la rotación (notes) y los comentarios después de la última regla (footer). Una lista de cadenas o una sola cadena con \n. Una cadena vacía "" es una línea en blanco en el texto. Las líneas en blanco de los extremos se descartan.

"notes": ["Basada en una guía y en los mejores logs, parche 12.1", "", "v1.1: Envenenar antes con 4+ objetivos"]

En el texto KRC son líneas # … antes de las declaraciones. No afectan al funcionamiento de la rotación.

resources#

Los nombres de los recursos en orden: el primer elemento es resource1, el segundo resource2, etc. El número determina qué recurso es; el nombre solo es cómo lo escribes en las condiciones:

• resource1 es la salud del jugador y resource2, la salud del objetivo;
• de resource3 en adelante son los recursos de la especialización, en el orden de la tabla de specID: para un pícaro, resource3 es la energía y resource4, los puntos de combo.

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

Usa los nombres estándar de la tabla: el constructor los muestra con palabras («Salud del jugador», «Energía») y otras personas y los agentes de IA entienden las condiciones a la primera. null se salta un número: ["PlayerHP", null, "Energy"] solo declara resource1 y resource3. Un recurso no declarado no se puede leer: «resource2 no declarado».

Todos los recursos son porcentajes del máximo, de 0 a 100. Cómo pasar a porcentaje los puntos de combo, la energía y las runas: Recursos, en Condiciones.

auras#

Las auras son tus beneficios y tus perjuicios sobre el objetivo. El aura n de la rotación es el aura n de la lista de Better Assistant.

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

El orden de la lista no importa; importa n. Puede haber huecos en la numeración, pero para el perfil de Better Assistant las auras con ID deben ir seguidas desde la primera.

slots#

Las ranuras son los botones de la rotación. La ranura n de la rotación es la ranura n de Better Assistant.

show#

• "target": la ranura se muestra cuando tienes un objetivo. Es lo habitual en casi todos los ataques.
• "combat": la ranura se muestra en combate aunque no haya objetivo. Para sanación y habilidades defensivas: Vial carmesí debe funcionar cuando no hay objetivo.

Una ranura solo está lista cuando Better Assistant la muestra. Una ranura "target" sin objetivo no está lista y sus reglas se omiten.

Marcas de ranura#

Las marcas indican cómo pulsar una ranura una vez elegida su regla. En el constructor son los interruptores de «Cómo pulsar».

Por qué O + Q y no solo O: un botón solo con O se pulsa al momento, en mitad del GCD, antes de que haya llegado el golpe anterior. Esfumarse tras Perdición de Reyes solo con O se pulsaría antes de que lleguen los puntos de combo de Perdición de Reyes, y la regla de Esfumarse (Combo_Points < 65) comprobaría el valor antiguo. Con Q, el botón espera al final del GCD.

Prioridad estricta: una regla fuera del GCD que esté más abajo en la lista no se adelanta a una regla superior que espera al GCD.

"slots": [
  {"n": 1, "alias": "Adrenaline_Rush", "label": "Subidón de adrenalina (macro con Asesinato múltiple)", "spell": 13750, "offGcd": true, "queue": true},
  {"n": 4, "alias": "Keep_It_Rolling", "label": "Suerte prolongada", "spell": 381989, "offGcd": true},
  {"n": 8, "alias": "Killing_Spree", "label": "Asesinato múltiple", "spell": 51690, "channel": true},
  {"n": 11, "alias": "Crimson_Vial", "label": "Vial carmesí", "spell": 185311, "show": "combat"}
]

rules#

Las reglas por orden de prioridad: la primera de la lista se comprueba primero.

when: grupos y condiciones#

{
  "use": "Garrote",
  "name": "Garrote",
  "note": ["Renovar en la ventana de pandemia"],
  "when": [
    {"all": ["Garrote_DoT.down"], "comment": "sin sangrado"},
    {"all": ["Garrote_DoT.up", "Garrote_DoT.duration <= 30"], "comment": "queda un 30 % o menos"}
  ]
}

Una misma ranura puede aparecer en varias reglas: por ejemplo, Garrote desde Sigilo arriba en la lista y el mantenimiento normal de Garrote más abajo.

Condiciones en JSON#

Cada condición es una cadena con sintaxis KRC: Garrote_DoT.down, Rupture_DoT.duration <= 25, Kingsbane.cd <= 3, Combo_Points >= 70, enemies >= 2, target.distance <= 8, cd == 1. La lista completa está en Condiciones.

• Se hace referencia por nombre (Garrote_DoT) o por número: buff1, slot3, resource4.
• and dentro de una cadena la divide en dos condiciones: "Combo_Points >= 70 and Energy >= 70" son dos condiciones, y ambas cuentan para el límite de 16.
• Sin # ni saltos de línea dentro de una cadena.
• Las condiciones las lee el propio motor de KeyRota, así que el JSON y el texto siempre significan lo mismo.

Nombres#

Un nombre (alias) es cómo se llaman las auras, las ranuras y los recursos en las condiciones y en use.

• El primer carácter es una letra (de cualquier alfabeto) o _; después, letras, dígitos 0–9 y _. Se admiten letras con tilde, la ñ y otros alfabetos, como el cirílico; espacios, guiones y puntos no: Fan_of_Knives, no Fan-of-Knives.
• Un nombre es único entre todas las auras, ranuras y recursos.
• Reservados: use, when, and, or, rotation, gcd, enemies, target, aoe, st, cd, defensives, ground_spells, movement, y los nombres del tipo buffN, slotN, resourceN.
• Las palabras clave van solo en minúsculas: use, or, .up. Use, OR y .UP son errores.

Un nombre a partir de la etiqueta. Sin alias, KeyRota crea uno a partir de label: los corchetes y su contenido se descartan, las letras y los dígitos se quedan y todo lo demás pasa a ser _. Por ejemplo, "Garrote en el objetivo [703]" se convierte en Garrote_en_el_objetivo. Un nombre vacío o inservible pasa a ser Aura_N o Slot_N; uno ya ocupado recibe _2, _3. Si una regla hace referencia a buffN o slotN que no están en las listas, se declaran automáticamente como Aura_N y Slot_N.

Campos obligatorios y valores predeterminados#

Límites#

Exactamente 16 grupos de 16 condiciones está permitido; 17 es un error.

Errores#

Una rotación con un error no se carga en absoluto: no hay ejecución parcial. Un error siempre indica el lugar. En JSON es una ruta: rules[3].when[1]: nombre desconocido Foo (contando desde cero). En el constructor, «Regla 4, grupo 2: nombre desconocido Foo» (contando desde uno). En el texto KRC, un número de línea.

Estructura del JSON:

Condiciones y declaraciones (igual que en el texto KRC):

El constructor también indica «el grupo no tiene condiciones» (un grupo vacío), «no se ha elegido ranura» y «el nombre no puede llevar comillas».

Texto KRC#

El texto KRC es la misma rotación en forma de líneas. La página «Texto y JSON» lo muestra y puedes guardarlo como archivo .txt. El texto y el JSON se convierten el uno en el otro sin perder significado.

rotation "Asesinato: mínimo"

buff1	Rupture_DoT = "Ruptura en el objetivo [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+ puntos de combo, sin sangrado

use Mutilate when  # Mutilar

Líneas#

• # fuera de comillas dobles inicia un comentario hasta el final de la línea. Dentro de una "etiqueta", # es un carácter normal.
• Las líneas en blanco y las que solo tienen un comentario se omiten: así se escriben las descripciones y los separadores.
• Cualquier otra línea es una declaración, use, or o una línea de condiciones. Si no, es un error stray_line: «línea fuera de una regla: "…" (el texto libre debe empezar con #)».
• Se admite cualquier cantidad de espacios y tabulaciones entre las partes. La forma canónica usa una tabulación después de buffN/slotN y al principio de las líneas de condiciones.

Declaraciones#

Solo antes del primer use:

rotation "Nombre"                        # opcional, como mucho una vez
buff1	Garrote_DoT = "Garrote en el objetivo [703]"   # aura 1
slot1	Garrote = "Garrote"                         # ranura 1
resource1	PlayerHP                               # recurso 1

buffN y slotN van de 1 a 12; resourceN, de 1 a 99. La etiqueta entre comillas puede estar vacía: slot5 Filler = "". Una declaración después del primer use es un error late_declaration.

Reglas#

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

• use Ranura when abre una regla; un comentario en esa línea es el nombre de la acción.
• Cada línea de condiciones es un grupo (condiciones unidas con and). Los grupos se separan con una línea que solo contiene la palabra or.
• Una regla sin líneas de condiciones no tiene condiciones.
• Dos líneas de condiciones seguidas sin or son un error split_group; or al principio, al final o dos veces seguidas es empty_group.

Texto y JSON: correspondencia#

Las líneas en blanco de los extremos de los bloques de comentarios se descartan; las del interior se conservan como "".

Importación y almacenamiento#

• KeyRota guarda la rotación dentro del perfil. «Exportar» en la ventana principal guarda el perfil de KeyRota (JSON) con su rotación; «Importar» admite un perfil de KeyRota y un JSON de rotación suelto.
• «Nuevo» — «Desde un archivo…» admite .txt con texto KRC, JSON de rotación y perfiles de KeyRota; «Nuevo» — «Desde el portapapeles», lo mismo desde el portapapeles.
• En el constructor: «Texto y JSON» — «Pegar» o «Abrir…» sustituyen la rotación; las ranuras y auras con el mismo número conservan sus ID, «Con objetivo» / «En combate» y sus marcas si la versión nueva no los trae.
• Una rotación en texto (sin JSON) toma los ID y la visibilidad de las ranuras del perfil de Better Assistant ya guardado en el perfil de KeyRota, y los ID de las auras también de las marcas [703] de sus etiquetas.

El perfil de Better Assistant a partir del JSON#

«Crear desde ranuras y auras», en el constructor, genera la cadena del perfil de Better Assistant a partir del JSON de la rotación:

• 12 ranuras: la ranura N es slots[n = N].spell, mostrada según show. Una ranura sin ID queda vacía.
• Auras, en orden desde la primera: auras[n = 1].spell, auras[n = 2].spell… Un aura sin ID en medio es un error.
• Clase y especialización, a partir de specID.
• Contador de enemigos, a partir de enemies.range y enemies.combatOnly.
• Si el perfil de KeyRota ya contiene un perfil de Better Assistant de la misma especialización, se conservan sus demás ajustes y las ranuras y auras que coinciden.

En el juego: /ba — Profile — pega — Apply.

JSON Schema#

El esquema del formato: keyrota-rotation.schema.json (draft 2020-12). Comprueba los campos, los tipos, los rangos, queue sin offGcd y la forma de las cadenas de condición. No comprueba que n y los nombres sean únicos, que existan los nombres usados en las condiciones ni el límite de 16 tras dividir las cadenas por and : eso lo hace KeyRota al cargar.

Para validar un archivo:

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

No pongas un campo "$schema" en un archivo de rotación: KeyRota lo toma por un campo sobrante.