Introdução aos Scripts Mod (API)

Como posso instalar um script Mod (API) utilizando a 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. No menu suspenso Biblioteca de scripts, localize o script necessário.
4. Clique no botão Adicionar Script.
5. Agora pode começar a utilizar o script no seu jogo!

Como posso instalar um script Mod (API) se pretendo escrever o meu próprio código ou utilizar código de uma fonte externa?

É um processo semelhante à instalação de um script utilizando a nossa biblioteca de scripts com 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 Definições do Mod (API), clique no separador Novo Script.
4. Será direcionado 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 mesmo.
6. Clique no botão Guardar Script.
7. A área restrita do Mod (API) será reiniciada e poderá começar a utilizar o script no jogo.

Caso tenha obtido o script de uma fonte externa, consulte a descrição do script para obter informações e instruções importantes.

Ajuda! Não consigo fazer o meu script funcionar.

Se você estiver buscando assistência geral com a resolução de problemas do Mod (API), consulte o nosso artigo aqui. Se estiver à procura de conselhos e informações mais avançadas sobre depuração, consulte o nosso artigo aqui. Caso continue a enfrentar dificuldades, sinta-se à vontade paracriar uma publicação no nosso Fórum Mod (API).

Caso eu deseje escrever um script, o que é necessário para começar?

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

Para começar, a sua primeira parada deve ser o Guia de Utilização Avançada.

Como funciona?

Escreve scripts que monitorizam os eventos que ocorrem durante o jogo. Os scripts podem verificar se as regras estão a ser seguidas, alterar propriedades em objetos e tokens e até mesmo fornecer comandos de chat personalizados. Os seus guiões têm um impacto em todo o jogo, influenciando tanto as ações do GM como as de todos os jogadores. Os scripts avançados também podem ser executados de forma independente, realizando ações automáticas, como mover um token numa rota de patrulha ou alertar os jogadores quando a sua vez está a demorar muito.

Onde posso encontrar scripts pré-criados?

A comunidade Mod (API) Script é bastante ativa, com membros criando e discutindo scripts constantemente. Existem três locais básicos para procurar novos scripts:

• Repositório oficial de scripts Roll20 Mod (API)no GitHub. Aqui encontrará a versão atual dos scripts que os autores enviaram para inclusão no repositório.
• Fórum de scripts Roll20 Mod (API). É aqui que os scripts tendem a aparecer primeiro e onde ocorrem discussões sobre scripts que estão a ser escritos ou que necessitam de alterações. Este também é o local onde pode publicar e solicitar assistência da comunidade para criar um script que tenha idealizado ou para encontrar um script que atenda às suas necessidades.
• Índice de scripts do Wiki's Mod (API). Esta é uma excelente fonte de informação sobre os scripts disponíveis.

Contribuir com scripts Mod (API) para a comunidade

Caso crie um script que deseja disponibilizar para o restante da comunidade Roll20, é possível enviá-lo para inclusão no Repositório de Scripts Roll20 Mod (API). A aprovação do seu script pela equipa do Roll20 e a sua inclusão no repositório desbloquearão a etiqueta do fórum "API Scripter"para a sua conta e permitirão que você anuncie através do Patreon ou de sites semelhantes ao Patreon (veja mais informações abaixo). Para saber o que é necessário fazer para enviar corretamente o seu script para o repositório, aceda ao Repositório Oficial de Scripts Roll20 Mod (API).

Regras de ligação do Patreon e Tipeee para colaboradores da folha da comunidade

Para autores de scripts Mod (API) que contribuem para o Repositório de Scripts Mod (API) do Roll20, eles estão autorizados a anunciar através de sites de serviços de assinatura/doação: Patreon e Tippee. A Roll20 não se responsabiliza por quaisquer transações de pagamento e não pode fazer cumprir quaisquer acordos privados.

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

Recomenda-se incluir as informações da sua conta Patreon ou Tipeee no ficheirosheet.json, que deve ser incluído com o envio do seu script no GitHub.

O ficheiro json deve conter um destes campos adicionados, caso pretenda anunciar com o Patreon ou o Tipeee:

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

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

Ligação para Patreon/Tipeee nos fóruns Roll20

A partilha de links para o Patreon ou Tipeee nos fóruns do Roll20 é permitida apenas para membros pré-aprovados da comunidade que tenham contribuído com fichas de personagens ou scripts Mod (API). Caso deseje solicitar financiamento diretamente aos utilizadores, poderá fazê-lo em privado, mas tais links não são permitidos em fóruns públicos sem qualquer material contribuído.