Macros

Los macros son accesos directos personalizados para comandos que se repiten con frecuencia. Por ejemplo, puedes crear un macro que haga que tu personaje grite un grito de batalla y realice automáticamente un ataque comúnmente usado. En lugar de escribir repetitivamente durante el juego, puedes usar un solo comando corto

Para acceder rápidamente, puedes añadir estos comandos a tu barra de accesos rápidos , Acciones de Token o Acciones de Token.

Creación y edición de macros

Ve a la pestaña "Colecciones" que se encuentra debajo de la pequeña imagen de lista punteada en la barra lateral. Para introducir una macro, escriba primero cómo desea llamar al comando. Ejemplo: "test". Luego, a la derecha, ponga el comando. Puede ser un texto escrito, un rollo o un emote. Pulse "Intro" después de esta información para guardar el comando.

Para llamar a una macro, escriba#y el comando (por ejemplo,#prueba) y pulse intro.

Autocompletar

Algunas áreas de texto admiten el autocompletado de llamadas a macros (utilizando "#"),llamadas a atributos(utilizando "@") yllamadas a habilidades(utilizando "%").

Las áreas de texto 'Acciones' de Macros (en la ventana Editar Macro) y Habilidades (en laPestaña de Atributos & Habilidades) admiten la autocompletación de llamadas de macro y atributos. El chat de textoadmite el autocompletado de macros y llamadas de habilidad.

Para activar una lista de autocompletado, escribe un símbolo (#, @ o %) seguido de una secuencia de letras o números. La lista de autocompletado mostrará macros, atributos o habilidades con nombres que contengan esa secuencia

Sólo las macros que pueda ver en la pestaña Colecciones aparecerán en las listas de autocompletado. De la misma manera, solo las Atributos (o Habilidades) que pertenezcan a un Personajeque tengas permiso de controlar aparecerán en las listas de autocompletado.

Por ejemplo, si tienes permiso para controlar un Personaje que contiene un Atributo llamado “Inteligencia”, puedes escribir “@int” en el área de texto 'Acción' de una ventana de Edición de Macro. Esto mostrará una lista de auto-completar que contiene ese Atributo.

Comandos múltiples

Uno de los puntos fuertes del sistema de macros es su capacidad para ejecutar varias acciones con una sola orden. Para hacer esto, simplemente coloca cada elemento en su propia línea, y las acciones se ejecutarán en orden cuando ejecutes la macro.

Ejemplo

Si quiero crear una macro que incluya una emoción, más tu ataque y lanzamientos de daño, la macro se vería así:

Nombre de la macro:
dagger

Cuerpo macro:

/me clava su daga
/tirada 1d20+10 vs CA
/tirada 1d4+9 Daño

Las macros también pueden incluir una mezcla de líneas de comandos y no comandos, por ejemplo:

¡#lof
/me invoca el poder de Moradin!
¡Te golpeo!
/tiro 1d20+4 vs reflejo
/tiro 1d8+4 daño

Esto haría primero emote, luego enviaría "¡Te golpeo!" al chat, y después haría las dos tiradas.

Anidamiento de macros

Las macros pueden anidarse unas dentro de otras, lo que ofrece la posibilidad de combinar macros y llamar a varias macros con una sola acción. Para anidar una macro, simplemente incluya el nombre de la macro que desea llamar en su propia línea dentro de su macro.

Ejemplo

En este ejemplo, tendremos tres macros:#daño#ataquey#ambos

Macro #daño = /tirada 1d4+11
Macro #ataque = /tirada 1d20+9
Macro #ambos =
#ataque
#daño

Anidamiento en una Consulta de Lanzamiento de Dados

Si está anidando una macro en un Roll Query, asegúrese de que hay un espacio después del nombre de la macro para que se reconozca correctamente.

{¿Qué macro?|Atacar,#usar-espada |Defender,#usar-escudo }

Solución de problemas

Debido al orden de operaciones, las llamadas Macro anidadas dentro de las Consultas de Tiro de Dados se expanden por completo antes de que se ejecute la consulta completa. Esto significa que si una macro anidada dentro de una Consulta de Lanzamiento de Dados contiene algún "carácter problemático" que entra en conflicto con la sintaxis de la consulta (como "}" "," y "|"), esa macro puede hacer que la consulta completa se rompa. La razón es que la consulta tratará los caracteres problemáticos en la macro referenciada como parte de la sintaxis original.

Si este es el caso, puede ser necesario eliminar esos caracteres problemáticos (dentro de la propia macro llamada) o sustituirlos por entidades HTML.

Las macros que contienen sustituciones de entidades HTML ya no pueden funcionar fuera de un Roll Query. debe ser guardada comoHabilidades.

La reapertura de una macro de colecciones revierte las entidades HTML; si esa macro se guarda a continuación, esas reversiones también lo harán. Este comportamiento no está presente dentro deHabilidades.

Habilidades de anidamiento

Una habilidad es otro nombre para una macro que es específica de un cierto personaje y se crea en una hoja de personaje que se encuentra en la pestaña de diario. Al igual que las macros, las habilidades pueden estar anidadas entre sí, lo que te da la capacidad de encadenar habilidades y llamar a múltiples habilidades con una sola acción.

Anidar una habilidad es similar a anidar una macro, pero con un ligero giro. Al igual que una macro, simplemente incluya el nombre de la habilidad que desea llamar en su propia línea dentro de su habilidad de llamada. Pero además, tiene que cambiar el símbolo numérico (#) por un símbolo de porcentaje (%) y luego incluir el nombre del carácter delante del nombre de la habilidad utilizando una tubería vertical (|) para separarlos.

La tecla de la tubería vertical se encuentra encima de la tecla de la barra invertida (\) en la mayoría de los teclados. Esta tecla suele estar cerca de la tecla intro en un teclado estadounidense y en la fila numérica en los teclados europeos.

Ejemplo

En este ejemplo, tendremos tres habilidades:%damage%attacky%bothy nuestro personaje que se llamaráBugbear

Habilidad%damage = /tirada 1d4+11
Habilidad%attack = /tirada 1d20+9
Habilidad%both =
%{Bugbear|attack}
%{Bugbear|damage}

Más ejemplos

He aquí algunos ejemplos específicos del sistema:

Macros DnD 5e/Next

Macros Pathfinder

Botones de comando de habilidad

Los Botones de Comando de Habilidades pueden ser utilizados para llamar aHabilidades(o tiradas de botones de hojas) desde un botón clickeable en el Texto del Chat. They are very closely related to Mods (API) Command Buttons. 

Su sintaxis es la siguiente:

[Etiqueta](~<keyword>|<ability name>)

Al igual que conAtributoyHabilidad, la palabra clavees tu elección deseleccionado,objetivoo el nombre del personaje. También puede utilizar un character_id como palabra clave. 

Si tiene un botón de comando de habilidad guardado en alguna de las pestañas de la ventana de caracteres, puede optar por omitir una palabra clave:

[Etiqueta](~<ability name>)

Siguiendo con el ejemplo deHabilidades, Bob el Asesino podría insertar[¡¡¡Hacha oscilante!!!](~Hacha masiva) en otra de sus otras Habilidades para poder filetear a sus enemigos de forma más accesible.

Macros de atributos

Las macros de atributos combinan los ejemplos mencionados anteriormente. Al utilizar un atributo asignado a un personaje como un modificador de variable, puedes crear macros intrincadas basadas en el personaje. Como la variable en la macro está vinculada a un atributo del personaje, cualquier cambio realizado en el editor del personaje actualizará automáticamente el valor.

Uso de una ficha seleccionada con una macro

La palabra clave seleccionada te permitirá extraer información del elemento que está actualmente seleccionado en la pantalla cuando se ejecuta la tirada/macro. Por ejemplo, si quieres extraer el valor de la Barra 1 del token seleccionado durante una tirada, puedes escribir:

/tiro 1d20 + @{selected|bar1}

Puede utilizar "bar1", "bar2" o "bar3". Además, puedes extraer un atributo del personaje vinculado a ese token:

/tiro 1d20 + @{selected|Intelligence}

Puedes extraer el nombre de los tokens actualmente seleccionados mediante la variable "token_name":

/em @{selected|token_name} ¡dispara su arma!

Si el token seleccionado tiene un diario de personaje vinculado a él, puedes extraer el nombre del diario de personaje en lugar de utilizar la variable "character_name":

¡/em @{selected|character_name} bloquea con su escudo!

Puedes activar habilidades desde el diario de personaje vinculado usando el nombre de la habilidad como una variable:

>%{selected|Attack}

Por último, hemos introducido un tercer argumento para las variables, que te permite extraer el "valor máximo" de una barra o atributo:

/tiro 1d20 + @{Guard|Intelligence|max}
/tiro 1d20 + @{selected|bar2|max}

Todos los nombres, incluidos los de los personajes, atributos y habilidades, no distinguen entre mayúsculas y minúsculas cuando se usan. Esto significa que "GUARDIA" y "guardia" coinciden con el personaje llamado "Guardia".

Atributos y hojas de personaje

Las hojas de personaje introducen un gran número de atributos a los que puede querer hacer referencia en sus macros personalizadas. Una cosa ft h consciente de la Auto-Calc Formula Attribute. Las hojas de caracteres tienen a menudo atributos calculados basados en fórmulas que implican a otros atributos. Al hacer referencia a ese atributo se mostrará la fórmula en lugar del valor.

A @{selected|character_name} le quedan @{selected|action_points} puntos.

A Rolf le quedan ((ceil(((13+0)+(14+0))/12)+0)+0) puntos.

Para evitarlo, debe envolver la referencia del atributo en un rollo inline:

A @{selected|character_name} le quedan [[@{selected|action_points}]] puntos.

A Rolf le quedan 3 puntos.

Uso de un token dirigido con una macro

Similar al uso de la palabra clave „seleccionado“ para obtener información de un token seleccionado, la palabra clave „objetivo“ permite acceder a variables y habilidades de un token objetivo. Este comando permite a los jugadores elegir entre tokens que normalmente no pueden seleccionar, lo cual es útil para tirar contra enemigos. Por ejemplo, si le indicas a un jugador que tire un único 1d20 contra un objetivo con un atributo de „inteligencia“, la tirada aparecería de la siguiente manera:

/tirar 1d20 - @{target|intelligence}

Esto hará que aparezca una pantalla para que el jugador seleccione contra qué objetivo de fichas va a tirar:

La palabra clave objetivo se utiliza de manera similar a la palabra clave seleccionada mencionada anteriormente, con dos diferencias principales. En primer lugar, la palabra clave "objetivo" permite a los jugadores utilizar valores de fichas que no controlan. En segundo lugar, la sintaxis para referenciar la parte "máxima" de un atributo es ligeramente diferente. Consulte la subsección de uso avanzado a continuación para obtener más detalles sobre la sintaxis completa.

Uso avanzado para llamadas de atributos dirigidas

La sintaxis completa de la variable objetivo es:

@{target|<target_name>|<attribute_name>|<optional_flags>}

(Tenga en cuenta que 'nombre_objetivo' puede ser cualquier cosa que desee y puede incluir espacios).

Así que si quiere tener varios objetivos en su macro puede hacerlo:

@{target|Target1|HP} vs @{target|Target2|AC}

Y si quieres usar el máximo de un atributo:

@{target|Target1|HP|max}

Ten en cuenta que si quieres usar el "máximo" de un atributo, debes especificar el nombre del atributo, incluso si solo pones "objetivo1" como se muestra arriba.

Además, si utiliza el mismo target_name en varias consultas de atributos, sólo se le pedirá una vez y se utilizará el mismo token para satisfacer todas las consultas de atributos. Esto también se aplica cuando tiene macros o comandos de varias líneas:

¡/me golpea en @{target|foe|character_name}!
**Para golpear**: [[1d20+3]] vs. @{target|foe|npc_AC} CA

Referencia a atributos repetidos

Por RowIndex

Los atributos en una fila repetida se pueden referenciar por su IndiceFila. ElIndiceFila de un atributo comienza en 0 (el índice indica la posición desde arriba), por lo que la primera fila usa $0, la segunda usa $1, la tercera usa $2, etc.

Para una sección repetitiva llamada Ítems, podría acceder al atributo ItemBonus para el segundo ítem en un carácter con la siguiente sintaxis:

@{selected|repeating_items_$1_itembonus}

Por RowID

También puede utilizarRowIDpara hacer referencia al atributo. La ventaja de utilizar elRowIDes que no se ve afectado por un cambio de orden (ya sea por eliminación o reordenación de filas). Para obtener elRowID(si no lo proporciona el autor de la hoja de personaje de alguna manera), debe consultar la fuente de la hoja. Rastree hacia arriba en el HTML hasta que encuentre una etiqueta con una propiedad llamadadata-reprowid. El valor de esta propiedad es elRowID:

<div class="repitem" data-reprowid="-KC0zCLum1Rq3V5wssyE">

ElRowIDse utiliza entonces en lugar delRowIndex:

@{selected|repeating_items_-KC0zCLum1Rq3V5wssyE_itembonus}

Opciones de tirada de dados

Las opciones de tirada de dados son indicadores utilizados dentro de una tirada de dados para indicar acciones especiales que se realizarán con el resultado de la tirada.

Rodando por la iniciativa

Para enviar el resultado de una tirada directamente al Rastreador de Turnos , seleccione la ficha o la iniciativa e incluya la siguiente opción de tirada en su macro:

/tiro 1d20 + 5 &{tracker}

La opción de tirada de dados "rastreador" en Roll20 muestra los resultados de la tirada y utiliza el resultado como valor en el rastreador de turnos. Si el token seleccionado no tiene un turno en el orden de turno, se agregará uno nuevo. Si ya tiene turnos, se actualizarán con el nuevo valor.

Además, puede sumar el resultado de la tirada, o restar el resultado de la tirada, del valor del turno actual de la ficha seleccionada utilizando las siguientes banderas:

/tiro 1d20 + 5 &{tracker:+}
/tiro 1d20 + 5 &{tracker:-}

Para un juego como Shadowrun en el que quiera restar 10 a la iniciativa actual después de cada turno, podría tener una macro global como ésta:

/me @{selected|token_name} termina su turno. [[10 &{tracker:-}]]

Note that the tracker flag works both in regular rolls and inline rolls.

Incluso puedes hacer referencia a estos valores de la misma manera que harías con los Atributos utilizando la sintaxis:@{tracker|Item Name}

Supresión de mensajes de error

La opción "noerror" suprimirá cualquier mensaje de error (como errores de variable no encontrada) en un roll.

/roll 1d20 + @{selected|nonexistent_attribute} &{noerror}

Uso de una variable con una macro

La forma más sencilla de incluir una variable con una macro que especificas cuando se ejecuta es usando una Consulta de Lanzamiento. Por ejemplo, si quieres agregar un modificador de variable a un roll, puedes hacer una macro de esta manera:

/roll 2d20 + ?{Modifier|0}

Cuando se ejecuta la macro, aparecerá una solicitud pidiendo el modificador a incluir. Si no se especifica un modificador, la parte "|0" de la consulta indica que se utilizará 0 como valor predeterminado.

Más información sobre las Consultas de Tiradas está disponible en la Referencia de Dados .

Especificación de una variable en el chat

Si deseas utilizar un modificador de variable con tu lanzamiento de macro, simplemente termina el comando de la macro con el modificador y, a continuación, especifícalo al llamar a tu macro.

Por ejemplo: Si quieres una macro para 1d20+x (donde x es el valor de mi variable) podrías crear la siguiente macro:

#d20 /roll 1d20+

#d204

Cuadros de diálogo desplegables para consultas de lanzamiento

Puedes especificar una lista de opciones que se pueden presentar al jugador, en lugar de solo un campo de texto de forma libre.

Aquí está la sintaxis:

?{Name of Query|Option1|Option2|Option3|Option4|Option5}

También puedes especificar un valor diferente para el resultado que no sea la etiqueta, así:

?{Name of Query|Label 1, value1|Label 2, value2}

Ejemplos

Ataque especial:

... + [[ ?{Sneak Attack?|No, 0|Yes, 3d6} ]] + ?{Power Attack?|No, 0|Yes, 6 [Power Attack!]}

D&D 5e Tirada de Ataque:

[[ ?{Tipo de Ataque|Estándar, 1d20|Ventaja, 2d20kh1|Desventaja, 2d20kl1} ]]

Hechizo de Curación:

?{Hechizo|
   Cure Light Wounds, **Cure Light Wounds** El Objetivo Regenera [[1d8+5]] PS. | 
   Cure Moderate Wounds, **Cure Moderate Wounds** El Objetivo Regenera [[2d8+8]] PS. | 
   Cure Serious Wounds, **Cure Serious Wounds** El Objetivo Regenera [[3d8+8]] PS.
}

Ejemplo (anidamiento de Consultas con Tiradas)

?{Nombre de la Consulta|
   Etiqueta 1, ?{valor1|
      Etiqueta 1A, valor1A |
      Etiqueta 1B, valor1B 
   } |
   
   Etiqueta 2, ?{value2|value2} 
}

Es posible alcanzar niveles de anidamiento adicionales mediante el "apilamiento" de entidades HTML:

Ejemplo

?{Nombre de la consulta|
   Etiqueta 1, ?{valor1|
      Etiqueta 1A, ?{valor1A|
         Etiqueta 1Ai, valor1Ai |
         Etiqueta 1Aii, valor1Aii
      } |
      
      Etiqueta 1B, ?{valor1B|
         Etiqueta 1Bi, valor1Bi |
         Etiqueta 1Bii, valor1Bii
      }
   } |

   Etiqueta 2, ?{value2|value2} 
}

Macrobarra

Puedes crear botones de acceso rápido para cualquiera de tus macros que aparecerán en una barra en la parte inferior de la pantalla. Primero, crea tu macro como de costumbre. Para habilitar la barra de macros rápidas, marca la opción "Mostrar barra de macros rápidas" en el menú de configuración.

Para añadir una macro a la barra, simplemente marca la opción "En barra" junto al nombre de la macro. Si olvidaste activar la barra rápida de macros, activar una macro habilitará automáticamente la barra rápida para mostrarla.

La barra rápida y las macros seleccionadas ahora se mostrarán en la parte inferior de la pantalla, debajo de los retratos de los personajes. Para reorganizar los botones, coloca el cursor sobre un botón y usa el control ubicado en su lado derecho para arrastrarlo. Haz clic en el control para reorganizar el botón o arrástralo para eliminarlo.

Al hacer clic con la tecla Mayús en una macro en la barra rápida de macros se abrirá el editor para esa macro específica.

Menú de macro

Usted, como jugador o GM, puede hacer clic con el botón derecho del ratón en un botón de macro en la barra rápida de macros para que aparezca un menú de configuración que le da acceso a un par de características sencillas que afectan a la forma en que se muestra la macro.

Cambiar nombre

Seleccione la entradaRenombrarpara que aparezca un diálogo pidiéndole un nuevo nombre para la macro. Esto es particularmente útil para macros creadas arrastrando botones fuera de las hojas de personajes.

Color

Seleccione la entradaColorpara que aparezca un selector de color. Esto le permite cambiar el color de fondo del botónMacro Buttonpara que le resulte más fácil distinguir visualmente los distintos botones. El color del texto del botón cambiará para mantener el contraste con el color de fondo elegido.

Tablas de Pifia

Las macros pueden utilizar Rollable Tables en ellas. El DJ debe crearlas y hacerlas visibles para los jugadores si estos quieren poder utilizarlas en macros.

Cómo usar Plantillas de Tiro de Dados

Cuando uses una Hoja de Personaje, es probable que uses una Plantilla de Tiro de Dados al hacer clic en el botón de tirada o al llamar a una tirada de hoja en una macro o habilidad. No se requiere ninguna acción adicional de tu parte ya que el autor de la hoja ya lo ha configurado de antemano para ti.

Si estás interesado en usar Plantillas de Lanzamiento en tus propios macros personalizados o crear tus propias plantillas personalizadas, sigue leyendo.

Usar una plantilla de tirada es sencillo. Incluye una indicación en tu mensaje de chat para indicar que estás usando una plantilla de tirada y proporciona los datos deseados. Aquí tienes un ejemplo que utiliza la plantilla predeterminada, disponible en todos los juegos independientemente del sistema o la hoja de personaje:

&{template:default} {{name=Test Attack}} {{attack=[[1d20]]}} {{damage=[[2d6]]}}

El &{template:<template_name>} especifica la plantilla de tirada a utilizar con el nombre especificado. Luego simplemente proporcionas todos los datos para la plantilla en el formato {{<propertyname>= <value>}}. La "nombredepropiedad" que debes usar depende de la plantilla -- la documentación de la Hoja de Personaje debería indicarte qué está disponible, y hemos proporcionado documentación sobre todas las plantillas incorporadas a continuación. "Valor" puede ser texto o un lanzamiento en línea, incluyendo macros, habilidades, etc. Ten en cuenta que si usas un macro o una habilidad, debe ser un lanzamiento en línea, no un comando "/tirar".

Aquí tienes un ejemplo que utiliza una habilidad "%{Character|attack}":

&{template:default} {{name=Test With Ability}} {{attack= %{Character_Name|attack} }} {{damage= #damagemacro }}

¿Cuándo puedo usar plantillas de tiradas?

Puedes usar una plantilla de tiradas en mensajes generales (sin un comando como "/desc" o "/emote") y susurros. No puedes usar plantillas de tiradas con el comando "/roll"; en cambio, las plantillas de tiradas están pensadas para usarse con tiradas en línea. Siempre que se usen tiradas en línea, puedes usar plantillas de tiradas con macros, habilidades de personajes y los autores de las hojas de personaje pueden usarlas en sus botones de tirada en las hojas.