¿Cómo instalo un script Mod (API) utilizando la biblioteca de scripts de un solo clic?
- Navegue hasta la página de inicio del juego que desee.
- Haga clic en el menú desplegable Configuración y seleccione Scripts Mod (API).
- En el menú desplegable Biblioteca de scripts, localice el script que necesite.
- Haga clic en el botón Añadir script.
- ¡Ya puede empezar a utilizar el script en su juego!
¿Cómo instalo un script Mod (API) si quiero escribir su propio código o utilizar código de una fuente externa?
Es un proceso similar a la instalación de un script utilizando nuestra biblioteca de scripts de un solo clic.
- Navegue hasta la página de inicio del juego que desee.
- Haga clic en el menú desplegable Configuración y seleccione Scripts Mod (API).
- En la página Configuración del mod (API), haga clic en la pestaña Nuevo script.
- Se le dirigirá a una ventana del editor de código donde podrá insertar el código de su script y asignarle un nombre.
- Copie y pegue el código del script y proporcione un nombre para el script.
- Haga clic en el botón Guardar script.
- El entorno de pruebas Mod (API) se reiniciará y ya podrá empezar a utilizar el script en el juego.
Si ha obtenido el script de una fuente externa, consulte la descripción del script para obtener información e instrucciones importantes.
¡Ayuda! ¡No consigo que mi script funcione!
Si busca ayuda general para solucionar problemas con Mod (API), consulte nuestro artículo aquí. Si busca consejos e información más avanzados sobre depuración, consulte nuestro artículo aquí. Si sigue teniendo problemas, no dude encrear una publicación en nuestro foro Mod (API).
Si quiero escribir un guion, ¿qué necesito para empezar?
Los scripts para Roll20 Mods (API) están escritos en JavaScript. Solo necesita tener conocimientos básicos del lenguaje para empezar, pero si desea aprender más sobre JavaScript, este curso de Codecademypuede ayudarle.
Para empezar, lo primero que debe hacer es consultar la Guía de uso avanzado.
¿Cómo funciona?
Usted escribe scripts que escuchan los eventos que ocurren durante el juego. Los scripts pueden comprobar que se sigan las reglas, cambiar las propiedades de los objetos y tokens, e incluso proporcionar comandos de chat personalizados. Sus guiones tienen un impacto en todo el juego, influyendo tanto en las acciones del GM como en las de todos los jugadores. Los scripts avanzados también pueden ejecutarse de forma independiente, realizando acciones automáticas como mover una ficha en una ruta de patrulla o dar un empujoncito a los jugadores cuando su turno se alarga demasiado.
¿Dónde puedo encontrar guiones ya escritos?
La comunidad Mod (API) Script es bastante activa, con miembros que crean y debaten sobre scripts constantemente. Hay tres lugares básicos donde buscar nuevos guiones:
- Repositorio oficial de scripts Mod (API)de Roll20en GitHub. Aquí encontrará la versión actual de los scripts que los autores han enviado para su inclusión en el repositorio.
- Foro de scripts de Roll20 Mod (API). Aquí es donde suelen aparecer primero los guiones y donde se debate sobre los guiones que se están escribiendo o que necesitan cambios. Aquí también puede publicar y pedir ayuda a la comunidad para crear un script que haya ideado o encontrar un script que satisfaga una necesidad.
- Índice de scripts del mod (API) de la wiki. Esta es una buena fuente de información sobre los scripts disponibles.
Contribución de scripts Mod (API) a la comunidad
Si crea un script que le gustaría ofrecer al resto de la comunidad Roll20, puede enviarlo para que se incluya en el repositorio de scripts Roll20 Mod (API). Una vez que el personal de Roll20 apruebe su script y lo incluya en el repositorio, se desbloqueará la etiqueta «API Scripter»en su cuenta y podrá anunciarse a través de Patreon o sitios similares (consulte más información a continuación). Para saber qué debe hacer para enviar correctamente su script al repositorio, vaya al repositorio oficial de scripts Roll20 Mod (API).
Normas de enlace a Patreon y Tipeee para colaboradores de hojas comunitarias
Los autores de scripts Mod (API) que contribuyen al repositorio de scripts Mod (API) de Roll20 están autorizados a anunciarse a través de sitios de servicios de suscripción/donación: Patreon y Tippee. Roll20 no se hace responsable de ninguna transacción de pago y no puede hacer cumplir ningún acuerdo privado.
Para poder optar a ello, el autor de un script Mod (API) debe primero obtener la aprobación de su contribución por parte del personal de Roll20 e incluirla en el repositorio de scripts Mod (API) de Roll20.
Deberá incluir la información de su cuenta de Patreon o Tipeee en el archivosheet.jsonque debe adjuntar a su script cuando lo envíe a GitHub.
El archivo json debe tener uno de estos campos añadidos si desea anunciarse en Patreon o Tipeee:
patreon: Coloque aquí la URL de una campaña de Patreon y aparecerá debajo de la descripción de su script cuando se seleccione. (por ejemplo,«https://www.patreon.com/<name>»)
tipeee: Coloque aquí la URL de Tipeee y aparecerá debajo de la descripción de su script cuando se seleccione. (por ejemplo,«https://www.tipeee.com/<name>»)
Para obtener más información, visite https://github.com/Roll20/roll20-api-scripts#contributing.Enlace a Patreon/Tipeee en los foros de Roll20
Solo se permite enlazar a Patreon o Tipeee en los foros de Roll20 a los miembros de la comunidad previamente aprobados que hayan contribuido con hojas de personaje o scripts Mod (API). Si desea solicitar financiación directamente a los usuarios, puede hacerlo de forma privada, pero no se permiten enlaces de este tipo en un foro público sin ningún material aportado.