Macros

Macros são atalhos personalizados para comandos frequentemente repetidos. Por exemplo, pode criar uma macro que faça com que a sua personagem grite um grito de guerra e execute automaticamente um ataque habitualmente utilizado. Em vez de digitar repetidamente durante o jogo, pode utilizar um único comando curto

Para acesso rápido, você pode adicionar esses comandos à sua Barra Rápida ou Ações de Token .

Criando e Editando Macros

Aceda ao separador "Collections" que se encontra sob a pequena imagem de lista pontilhada na barra lateral. Para inserir uma macro, primeiro digite o que você quer chamar de comando. Exemplo: "teste". Em seguida, à direita, insira o comando. Isso pode ser texto digitado, um rolo ou uma ação. Pressione "Enter" após essas informações para salvar o comando.

Para chamar uma Macro, digite # e o comando (por exemplo, #test) e pressione enter.

Auto-completar

Algumas áreas de texto suportam o preenchimento automático de chamadas de macro (utilizando "#"),chamadas de atributo(utilizando "@") echamadas de capacidade(utilizando "%").

As áreas de texto 'Acções' de ambas as Macros (na janela Editar Macro) e Habilidades (no separadorAtributos & Habilidades) suportam o preenchimento automático de chamadas de Macro e Atributo. O Chat de Textosuporta o preenchimento automático de chamadas de Macro e de Habilidade.

Para acionar uma lista de preenchimento automático, escreva um símbolo (#, @ ou %) seguido de uma sequência de letras ou números. A lista de preenchimento automático mostrará Macros, Atributos ou Habilidades com nomes que contenham essa sequência

Somente Macros que você pode ver na guia de Coleções aparecerão nas listas de auto-completar. Da mesma forma, apenas os Atributos (ou Habilidades) que pertencem a umPersonagemque você tem permissão para controlar aparecerão nas listas de auto-completar.

Por exemplo, se você tem permissão para controlar um Personagem que contém um Atributo chamado “Inteligência”, você pode digitar “@int” na área de texto 'Ação' de uma janela de Edição de Macro. Isso irá exibir uma lista de preenchimento automático que contém esse Atributo.

Comandos Múltiplos

Uma das vantagens do sistema de macros é sua capacidade de executar várias ações com um único comando. Para fazer isso, basta colocar cada item em sua própria linha, e as ações serão executadas na ordem em que você executar a macro.

Exemplo

Se eu quiser criar uma macro que inclua uma emoção, além de seus rolagens de ataque e dano, a macro ficaria assim:

Nome da Macro:
adaga

Corpo da Macro:

/me enfia sua adaga em casa
/roll 1d20+10 vs CA
/roll 1d4+9 Dano

As macros também podem incluir uma mistura de linhas de comando e linhas não de comando, por exemplo:

#lof
/me invoca o poder de Moradin!
Eu te ataco!
/roll 1d20+4 vs reflexo
/roll 1d8+4 dano

Isso primeiro emote, então envia "Eu te ataco!" para o chat, e então faz as duas rolagens depois.

Macros aninhadas

As macros podem ser aninhadas umas dentro das outras, o que dá a capacidade de combinar macros e chamar várias macros com uma única ação. Para aninhar uma macro, simplesmente inclua o nome da macro que você deseja chamar em uma linha separada dentro de sua macro.

Exemplo

Neste exemplo, teremos três macros:#dano#ataquee#ambos

Macro #dano = /roll 1d4+11
Macro #ataque = /roll 1d20+9
Macro #ambos =
#ataque
#dano

Aninhamento em uma Consulta de Rolagem de Dados

Se você estiver aninhando uma macro em uma Consulta de Rolagem, certifique-se de que haja um espaço após o nome da macro para que ela seja reconhecida corretamente.

?{Qual macro?|Ataque,#use-sword |Defesa,#use-shield }

Solução de Problemas

Devido à ordem de operações, as chamadas de macro aninhadas nas consultas de lançamento de dados são totalmente expandidas antes de toda a consulta ser executada. Isso significa que se uma macro aninhada em uma Consulta de Rolagem de Dados contiver quaisquer "caracteres problemáticos" que entrem em conflito com a sintaxe da consulta (como "}" "," e "|"), essa macro pode fazer com que toda a consulta pare de funcionar. A razão é que a consulta tratará os caracteres problemáticos na macro referenciada como parte da sintaxe original.

Se esse for o caso, pode ser necessário remover esses caracteres problemáticos (dentro da própria macro chamada) ou substituí-los por entidades HTML.

Macros que contêm substituições de entidades HTML podem não funcionar mais fora de uma Consulta de Rolagem. deve ser guardado comoAbilities.

Reabrir uma Macro de Coleções reverte as entidades HTML; se essa Macro for então salva, essas reversões também serão. Este comportamento não está presente emAbilities.

Aninhamento de Habilidades

Uma habilidade é outro nome para uma macro que é específica para um determinado personagem e é criada em uma ficha de personagem encontrada na aba de diário. Assim como macros, habilidades podem ser aninhadas uma dentro da outra, o que lhe dá a capacidade de encadear habilidades e chamar várias habilidades com uma única ação.

Aninhar uma habilidade é semelhante a aninhar uma macro, mas com um pequeno detalhe. Como uma macro, simplesmente inclua o nome da habilidade que você deseja chamar em uma linha separada dentro de sua habilidade chamadora. Mas além disso, você tem que trocar o símbolo de número (#) pelo símbolo de porcentagem (%) e então incluir o nome do personagem na frente do nome da habilidade usando um pipe vertical (|) para separá-los.

A tecla de pipe vertical pode ser encontrada acima da tecla de barra invertida (\) na maioria dos teclados. Essa tecla geralmente estará próxima da tecla Enter em um teclado dos EUA e na fileira de números em teclados europeus.

Exemplo

Neste exemplo, teremos três habilidades: %damage %attack e %both e nosso personagem que será chamado Bugbear

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

Mais Exemplos

Aqui estão alguns exemplos específicos do sistema:

DnD 5e/Next macros

Macros de Pathfinder

Botões de Comando de Habilidades

Os Botões de Comando de Habilidades podem ser usados para chamarHabilidades(ou rolos de botões de folha) a partir de um botão clicável no Chat de Texto. They are very closely related to Mods (API) Command Buttons. 

Sua sintaxe é a seguinte:

[Rótulo](~<keyword>|<ability name>)

Tal como nas chamadasAttributeeAbility, a palavra-chaveé a sua escolha entreselected,targetou um character_name. Você também pode usar um character_id como palavra-chave. 

Se tiver um Botão de Comando de Habilidade guardado algures num dos separadores da Janela de Caracteres, pode optar por omitir uma palavra-chave:

[Rótulo](~<ability name>)

Continuando o exemplo deHabilidades, Bob, o Matador, pode inserir[Swing Axe!!](~Massive Axe) em outra de suas Habilidades para que ele possa fatiar seus inimigos de forma mais acessível.

Macros de Atributos

Os Macros de Atributo combinam os exemplos mencionados acima. Ao utilizar um Atributo atribuído a um Personagem como um modificador de variável, você pode criar macros intricadas com base no Personagem. Como a variável na Macro está vinculada a um Atributo do Personagem, quaisquer alterações feitas no editor do Personagem serão atualizadas automaticamente no valor.

Usando um Token Selecionado com uma Macro

A palavra-chave selecionada permitirá que você obtenha informações do elemento que está atualmente selecionado na tela quando a rolagem/macro for executada. Então, por exemplo, se você quiser obter o valor do Bar 1 do token selecionado durante uma rolagem, você pode escrever:

/roll 1d20 + @{selected|bar1}

Você pode usar "bar1", "bar2" ou "bar3". Além disso, você pode obter um atributo do Personagem vinculado a esse token:

/roll 1d20 + @{selected|Intelligence}

Você pode obter o Nome dos tokens atualmente selecionados usando a variável "token_name":

/em @{selected|token_name} dispara sua arma!

Se o token selecionado tiver um diário de personagem vinculado a ele, você pode obter o Nome do diário de personagem em vez de usar a variável "character_name":

/em @{selected|character_name} bloqueia com seu escudo!

Você pode ativar habilidades do diário de personagem vinculado usando o nome da habilidade como uma variável:

>%{selected|Attack}

Por fim, introduzimos um terceiro argumento para variáveis, permitindo que você obtenha o "valor máximo" de uma barra ou atributo:

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

Todos os nomes, incluindo os de Personagens, atributos e habilidades, não diferenciam maiúsculas e minúsculas quando usados. Isso significa que "GUARD" e "guard" serão correspondentes ao Personagem chamado "Guarda".

Atributos e Fichas de Personagens

As Fichas de Personagens introduzem um grande número de atributos que você pode querer referenciar em suas macros personalizadas. Tenha em atenção o atributo Auto-Calc Formula Attribute. As folhas de caracteres têm frequentemente atributos calculados com base em fórmulas que envolvem outros atributos. Referenciar esse atributo mostrará a fórmula em vez do valor.

@{selected|character_name} tem @{selected|action_points} pontos restantes.

Rolf tem ((ceil(((13+0)+(14+0))/12)+0)+0) pontos restantes.

Para contornar isso, você precisa envolver a referência do atributo em um rolo inline:

@{selected|character_name} tem [[@{selected|action_points}]] pontos restantes.

Rolf tem 3 pontos restantes.

Usando um Token Direcionado com uma Macro

Similar ao uso da palavra-chave "selecionado" para obter informações de um token selecionado, a palavra-chave "alvo" permite acessar variáveis e habilidades de um token alvo. Este comando permite que os jogadores escolham tokens que normalmente não podem selecionar, o que é útil para rolar contra inimigos. Por exemplo, se você instruir um jogador a rolar um único 1d20 contra um alvo com um atributo de "inteligência", o resultado será o seguinte:

/roll 1d20 - @{target|intelligence}

Isso abrirá uma tela de prompt para o jogador selecionar qual token alvo eles estão rolando contra:

A palavra-chave alvo é usada de forma semelhante à palavra-chave selecionada mencionada anteriormente, com duas diferenças principais. Primeiro, a palavra-chave "alvo" permite que os jogadores utilizem valores de fichas que não controlam. Segundo, a sintaxe para referenciar a parte "máxima" de um atributo é ligeiramente diferente. Consulte a subseção de uso avançado abaixo para mais detalhes sobre a sintaxe completa.

Uso Avançado para Chamadas de Atributo Direcionadas

A sintaxe completa para a variável alvo é:

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

(Observe que 'target_name' pode ser qualquer coisa que você quiser e pode incluir espaços.)

Então, se você quiser ter vários alvos em sua macro, você pode fazer:

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

E se você quiser usar o máximo de um atributo:

@{target|Target1|HP|max}

Observe que se você quiser usar o "máximo" de um atributo, você deve especificar o nome do atributo, mesmo que você apenas coloque "alvo1" como acima.

Além disso, se você usar o mesmo target_name em várias consultas de atributo, você só será solicitado uma vez e o mesmo token será usado para cumprir todas as consultas de atributo. Isso também se aplica quando você tem macros ou comandos em várias linhas:

/me ataca @{target|foe|character_name}!
**Para Acertar**: [[1d20+3]] vs. @{target|foe|npc_AC} CA

Referenciando Atributos Repetidos

Por RowIndex

Os atributos em uma linha repetida podem ser referenciados por seu ÍndiceLinha. O ÍndiceLinha de um atributo começa em 0 (o índice significa o deslocamento a partir do topo), então a primeira linha usa $0, a segunda usa $1, a terceira usa $2, etc.

Para uma seção repetida chamada Itens, você pode acessar o atributo ItemBonus para o segundo item de um personagem com a seguinte sintaxe:

@{selected|repeating_items_$1_itembonus}

Por RowID

Você também pode usar o RowID para referenciar o atributo. O benefício de usar oRowIDé que ele não é afetado por uma mudança na ordem (seja por exclusão ou reordenação das linhas). Para obter oRowID(se não for fornecido pelo autor da ficha de personagem de alguma forma), você deve olhar a fonte da ficha. Rastreie para cima no HTML até encontrar uma tag com uma propriedade chamadadata-reprowid. O valor dessa propriedade é oRowID:

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

ORowIDé então usado no lugar doRowIndex:

@{selected|repeating_items_-KC0zCLum1Rq3V5wssyE_itembonus}

Opções de Rolagem de Dados

As opções de rolagem de dados são marcadores usados dentro de uma rolagem de dados para indicar ações especiais a serem realizadas com o resultado da rolagem.

Rolagem de Iniciativa

Para enviar um resultado de rolagem diretamente para o Turn Tracker, selecione o Token ou iniciativa e inclua a seguinte opção de rolagem em sua macro:

/rolar 1d20 + 5 &{tracker}

A opção de rolagem de dados "rastreador" no Roll20 mostra os resultados da rolagem e usa o resultado como o valor no rastreador de turnos. Se o token selecionado não tiver uma vez na ordem de turnos, uma nova será adicionada. Se já tiver turnos, eles serão atualizados com o novo valor.

Além disso, você pode adicionar o resultado do lançamento ou subtrair o resultado do lançamento do valor atual da rodada para o token selecionado usando as seguintes flags:

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

Para um jogo como Shadowrun, onde você deseja subtrair 10 da iniciativa atual após cada rodada, você poderia ter uma macro global assim:

/me @{selected|token_name} encerra sua vez. [[10 &{tracker:-}]]

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

You can even reference these values the same way you would Attributes by using the syntax:@{tracker|Item Name}

Suprimindo mensagens de erro

A opção de rolagem "noerror" suprimirá quaisquer erros (como erros de variável não encontrada) em uma rolagem.

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

Usando uma variável com uma Macro

A maneira mais fácil de incluir uma variável com uma macro que você especifica quando ela é executada é usar uma Consulta de Rolagem. Por exemplo, se você deseja adicionar um modificador de variável a uma rolagem, você pode criar uma macro assim:

/roll 2d20 + ?{Modifier|0}

Quando a macro é executada, uma mensagem será exibida solicitando o modificador a ser incluído. Se nenhum modificador for especificado, a parte "|0" da consulta indica que deve ser usado 0 como valor padrão.

Mais informações sobre Consultas de Rolagem estão disponíveis no Dice Reference.

Especificar uma variável no chat

Se você deseja usar um modificador de variável com seu comando de macro, simplesmente termine o comando de macro com o modificador e, em seguida, especifique-o ao chamar sua macro.

Por exemplo: Se você quiser uma macro para 1d20+x (onde x é o valor da minha variável), você pode criar a seguinte macro:

#d20 /roll 1d20+

#d204

Prompts de seleção para consultas de rolagem

Você pode especificar uma lista de opções que podem ser apresentadas ao jogador, em vez de apenas um campo de texto livre.

Aqui está a sintaxe:

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

Você também pode especificar um valor diferente para o resultado, além do rótulo, da seguinte forma:

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

Exemplos

Ataque especial:

... + [[ ?{Ataque sorrateiro?|Não, 0|Sim, 3d6} ]] + ?{Ataque poderoso?|Não, 0|Sim, 6 [Ataque poderoso!]}

D&D 5e Rolagem de Ataque:

[[ ?{Tipo de Ataque|Padrão, 1d20|Vantagem, 2d20kh1|Desvantagem, 2d20kl1} ]]

Feitiço de Cura:

?{Feitiço|
   Curar Ferimentos Leves, **Curar Ferimentos Leves** O Alvo Recupera [[1d8+5]] PV. | 
   Curar Ferimentos Moderados, **Curar Ferimentos Moderados** O Alvo Recupera [[2d8+8]] PV. | 
   Curar Ferimentos Graves, **Curar Ferimentos Graves** O Alvo Recupera [[3d8+8]] PV.
}

Exemplo (aninhando Consultas de Rolagem)

?{Nome da Consulta|
   Rótulo 1, ?{valor1|
      Rótulo 1A, valor1A |
      Rótulo 1B, valor1B 
   } |
   
   Rótulo 2, ?{value2|value2} 
}

É possível alcançar níveis adicionais de aninhamento "empilhando" entidades HTML:

Exemplo

?{Nome da Consulta|
   Rótulo 1, ?{valor1|
      Rótulo 1A, ?{valor1A|
         Rótulo 1Ai, valor1Ai |
         Rótulo 1Aii, valor1Aii
      } |
      
      Rótulo 1B, ?{valor1B|
         Rótulo 1Bi, valor1Bi |
         Rótulo 1Bii, valor1Bii
      }
   } |

   Rótulo 2, ?{value2|value2} 
}

Barra de Macro

Você pode criar botões de acesso rápido para qualquer uma de suas macros que aparecerão em uma barra na parte inferior da tela. Primeiro, crie sua macro como de costume. Para ativar a barra de macros rápidas, marque "Mostrar barra de macros rápidas" no menu de configurações.

Para adicionar uma macro à barra, basta marcar a opção "Na barra" ao lado do nome da macro. Se você esqueceu de ativar a barra de macro rápida, ativar uma macro irá automaticamente habilitar a exibição da barra rápida.

A barra rápida e as macros selecionadas agora serão exibidas na parte inferior da tela, abaixo dos retratos dos personagens. Para rearranjar os botões, passe o mouse sobre um botão e use a alça que aparece no seu lado direito para arrastá-lo. Clique na alça para reorganizar o botão ou arraste-o para removê-lo.

Ao clicar com o botão direito em uma macro na barra de macro rápida, o editor para essa macro específica será aberto.

Menu de Macros

Você, como jogador ou GM, pode clicar com o botão direito do rato num botão de macro na barra rápida de macros para abrir um menu de configuração que lhe dá acesso a algumas funcionalidades simples que afectam a forma como a macro é apresentada.

Renomear

Selecione a entrada de Renomearpara abrir um diálogo solicitando um novo nome para exibir para a macro. Isso é particularmente útil para macros criadas arrastando botões de fichas de personagem.

Cor

Selecione a entrada de Corpara abrir um seletor de cores. Isso permite que você altere a cor de fundo do Botão de Macropara facilitar a identificação visual dos diferentes botões. A cor do texto do botão mudará para manter o contraste com a cor de fundo escolhida.

Tabelas Roláveis

As macros podem utilizar Rollable Tables nelas. O GM deve criar e torná-las visíveis para o jogador se os jogadores puderem usá-las em macros.

Usando Modelos de Rolagem de Dados

Ao usar uma Ficha de Personagem, é provável que você use um Modelo de Rolagem de Dados clicando no botão de rolagem ou chamando uma rolagem de ficha em uma macro ou habilidade. Nenhuma ação extra é necessária de sua parte, pois o autor da ficha já a configurou previamente para você.

Se você estiver interessado em usar Modelos de Rolagem em suas próprias macros personalizadas ou criar seus próprios modelos personalizados, continue lendo.

Usar um modelo de rolagem é simples. Inclua uma bandeira na sua mensagem de chat para indicar o uso de um Modelo de Rolagem e forneça os dados desejados. Aqui está um exemplo usando o modelo padrão, disponível em todos os jogos independentemente do sistema ou ficha de personagem:

&{template:default} {{name=Teste de Ataque}} {{ataque=[[1d20]]}} {{dano=[[2d6]]}}

O &{template:<template_name>} especifica o Modelo de Rolagem a ser usado com o nome especificado. Então você só precisa fornecer todos os dados para o modelo no formato {{<propertyname>= <value>}}. O "nome da propriedade" que você deve usar depende do modelo - a documentação da Ficha de Personagem deve informar o que está disponível, e nós fornecemos documentação para todos os modelos incorporados abaixo. "Valor" pode ser texto ou uma rolagem embutida, incluindo macros, habilidades, etc. Observe que se você usar uma macro ou habilidade, ela deve ser uma rolagem embutida, não um comando "/roll".

Aqui está um exemplo que usa uma habilidade "%{Character|attack}":

&{template:default} {{name=Teste com Habilidade}} {{ataque= %{Character_Name|attack} }} {{dano= #damagemacro }}

Quando é que posso utilizar os modelos de rolo?

Pode utilizar um modelo de rolo em mensagens gerais (sem um comando como "/desc" ou "/emote") e em sussurros. Não pode usar modelos de rolo com o comando "/roll"; em vez disso, os modelos de rolo destinam-se a ser usados com rolos em linha. Desde que usem lançamentos em linha, pode usar Modelos de Rolo com macros, Habilidades de Personagem, e os autores de folhas podem usá-los dentro dos seus Botões de Rolo nas folhas.