API Roll20) Mods

Como instalar um script de Mod API Roll20) usando a biblioteca de scripts com um clique?

1. Vá para a página de destino do jogo desejado.
2. Clique no menu suspenso Configurações e selecione Scripts Mod API).
3. Na lista suspensa Biblioteca de Scripts, localize o script necessário.
4. Clique no botão Adicionar Script.
5. Agora você pode começar a usar o script em seu jogo!

Como instalar um script de Mod API Roll20) se eu quiser escrever meu próprio código ou quiser usar código de uma fonte externa?

É um processo semelhante à instalação de um script usando nossa biblioteca de scripts de um clique.

1. Navegue até a página inicial do jogo desejado.
2. Clique no menu suspenso Configurações e selecione Scripts Mod API).
3. Na página de Configurações de Mod API), clique na guia Novo Script.
4. Você será levado para uma janela do editor de código onde poderá inserir o código do seu script e nomear o script.
5. Copie e cole o código do script e forneça um nome para o script.
6. Clique no botão Salvar Script.
7. O sandbox de Mod API) reiniciará, e você poderá começar a usar o script no jogo.

Se você obteve o script de uma fonte externa, consulte a descrição do script para obter informações importantes e instruções.

Ajuda! Eu não consigo fazer meu script funcionar!

Se você está procurando assistência geral com solução de problemas de Mod API), confira nosso artigo aqui. Se você está procurando conselhos e informações mais avançadas sobre depuração, confira nosso artigo aqui. Se ainda estiveres a ter problemas, não hesites em criar uma publicação no nosso Fórum Mod (API).

Se eu quiser escrever um script, o que eu preciso para começar?

Os scripts para Modificações Roll20 (API) são escritos em JavaScript. Só precisa de um conhecimento básico da linguagem para começar, mas se quiser aprender mais sobre JavaScript, este curso Codecademypode ajudá-lo a aprender. 

Para começar, a sua primeira paragem deve ser o Advanced Use Guide.

Como funciona?

Você escreve scripts que ouvem eventos que acontecem durante o jogo. Os scripts podem verificar se as regras estão sendo seguidas, alterar propriedades de objetos e tokens e até mesmo fornecer comandos de chat personalizados. Seus scripts têm um impacto em todo o jogo, influenciando tanto o GM quanto as ações de todos os jogadores. Scripts avançados também podem ser executados independentemente, realizando ações automáticas, como mover um token em uma rota de patrulha ou cutucar jogadores quando sua vez está demorando muito.

Onde posso encontrar scripts prontos?

A comunidade de Scripts Mod (API) é bastante ativa, com membros a criar e discutir scripts o tempo todo. Existem 3 lugares básicos para procurar novos scripts:

• O Repositório Oficial de Scripts Mod (API) Roll20 no GitHub. É aqui que encontrarás a versão atual dos scripts que os autores submeteram para inclusão no repositório.
• O Fórum de Scripts Mod (API) Roll20. É aqui que os scripts tendem a aparecer primeiro e onde acontece a discussão sobre scripts que estão a ser escritos ou que necessitam de alterações. Aqui também é onde você pode postar e pedir ajuda da comunidade para criar um script que você pensou ou encontrar um script para suprir uma necessidade.
• O Índice de Scripts Mod (API) da Wiki. Esta é uma boa fonte de informação sobre os scripts disponíveis.

Contribuir com Scripts Mod (API) para a Comunidade

Se criaste um script que gostarias de oferecer ao resto da comunidade do Roll20, podes submetê-lo para ser incluído no Repositório de Scripts Mod (API) do Roll20. Ter o teu script aprovado pela equipa do Roll20 e incluído no repositório vai desbloquear a tag "Scripter da API" do fórum para a tua conta e permitir-te anunciar através do Patreon ou sites semelhantes ao Patreon (ver abaixo para mais informações). Para descobrires o que precisas de fazer para submeter corretamente o teu script para o repositório, vai para o Repositório Oficial de Scripts Mod (API) Roll20.

Regras de vinculação do Patreon e Tipeee para contribuidores de folhas comunitárias

Para autores de scripts Mod (API) que estão a contribuir para o Repositório de Scripts Mod (API) Roll20, têm aprovação para anunciar através de sites de subscrição/doação: Patreon e Tippee. O Roll20 não é responsável por quaisquer transações de pagamento e não pode fazer valer quaisquer acordos privados.

Para se qualificar, um autor de scripts Mod (API) deve primeiro ter a sua contribuição de script aprovada pela equipa do Roll20 e incluída no Repositório de Scripts Mod (API) Roll20.

Deve incluir as informações da sua conta Patreon ou Tipeee no ficheirosheet.jsonque deve ser incluído na submissão do seu script no GitHub.

O arquivo json deve ter um desses campos adicionados se você deseja fazer propaganda com o Patreon ou Tipeee:

patreon: Insira a URL de uma campanha do Patreon aqui e ela aparecerá abaixo da descrição do seu script quando selecionada. (por exemplo,"https://www.patreon.com/<name>")

tipeee: Insira a URL do Tipeee aqui e ela aparecerá abaixo da descrição do seu script quando selecionada. (por exemplo, "https://www.tipeee.com/<name>")

Linkando com o Patreon/Tipeee nos Fóruns do Roll20

Colocar links para o Patreon ou Tippee nos Fóruns do Roll20 só é permitido para membros da comunidade pré-aprovados que tenham contribuído com Folhas de Personagem ou Scripts Mod (API). Se você deseja solicitar financiamento diretamente dos usuários, pode fazê-lo de forma privada, mas nenhum link desse tipo é permitido em um fórum público sem qualquer material contribuído.