Mods de Roll20 (API)

¿Cómo instalo un script de Mod (API) usando la librería de scripts con un solo clic?

1. Ve a la página de inicio del juego deseado.
2. Haz clic en el menú desplegable de Configuración y selecciona Scripts de Mod (API).
3. En el menú desplegable Biblioteca de Scripts, localiza el script necesario.
4. Haz clic en el botón Agregar Script.
5. ¡Ahora puedes comenzar a usar el script en tu juego!

¿Cómo instalo un script de Mod (API) si quiero escribir mi propio código o quiero usar código de una fuente externa?

Es un proceso similar a la instalación de un script usando nuestra biblioteca de scripts de un solo clic.

1. Navega hasta la página de inicio del juego deseado.
2. Haz clic en el menú desplegable de Configuración y selecciona Scripts de Mod (API).
3. En la página de Configuración de Mod (API), haz clic en la pestaña Nuevo Script.
4. Serás llevado a una ventana de editor de código donde puedes insertar tu código de script y nombrar el script.
5. Copia y pega el código del script y proporciona un nombre para el script.
6. Haz clic en el botón Guardar Script.
7. El sandbox de Mod (API) se reiniciará, y ahora puedes empezar a usar el script en el juego.

Si obtuviste el script de una fuente externa, consulta la descripción del script para obtener información e instrucciones importantes.

¡Ayuda! No puedo hacer funcionar mi script.

Si estás buscando ayuda general con la resolución de problemas de Mod (API), echa un vistazo a nuestro artículo aquí. Si buscas consejos e información avanzada de depuración, consulta nuestro artículo aquí. Si sigues teniendo problemas, no dudes en crear un post en nuestro Foro de Mod (API).

Si quiero escribir un script, ¿qué necesito para comenzar?

Los scripts para los Mods (API) de Roll20 están escritos en JavaScript. Sólo necesita unos conocimientos básicos del lenguaje para empezar, pero si quiere aprender más sobre JavaScript, este curso de Codecademypuede ayudarle a aprender. 

Para comenzar, tu primera parada debe ser la Guía de Uso Avanzado.

¿Cómo funciona?

Escribes scripts que escuchan los eventos que ocurren durante el juego. Los scripts pueden verificar que se sigan las reglas, cambiar propiedades en los objetos y fichas, e incluso proporcionar comandos de chat personalizados. Tus guiones tienen un impacto en todo el juego, influyendo en las acciones tanto del GM como 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 avisar a los jugadores cuando su turno está tardando demasiado.

¿Dónde puedo encontrar scripts prehechos?

La comunidad de Scripts de Mods (API) es bastante activa con miembros que crean y discuten scripts todo el tiempo. Hay 3 lugares básicos para buscar nuevos scripts:

• El Repo Oficial de Scripts Mod (API) de Roll20 en GitHub. Aquí es donde encontrarás la versión actual de scripts que los autores han enviado para su inclusión en el repo.
• El Foro de Scripts Mod (API) de Roll20. Aquí es donde suelen aparecer los scripts primero y donde se discute sobre los scripts que se están escribiendo o necesitan cambios. Aquí también puedes publicar y pedir ayuda a la comunidad para crear un script que hayas pensado o encontrar un script que satisfaga una necesidad.
• El Índice de Scripts Mods (API) de la Wiki. Esta es una buena fuente de información sobre scripts que están disponibles.

Contribuyendo Scripts Mods (API) a la Comunidad

Si creas un script que te gustaría ofrecer al resto de la comunidad de Roll20, puedes enviarlo para que se incluya en el Repositorio de Scripts Mod (API) de Roll20. Tener tu script aprobado por el personal de Roll20 e incluido en el repositorio desbloqueará la etiqueta del foro "API Scripter" para tu cuenta y te permitirá hacer publicidad a través de Patreon u otros sitios similares (ver más abajo para más información). Para averiguar lo que necesitas hacer para enviar correctamente tu script al repositorio ve al Repo Oficial de Scripts Mod (API) de Roll20.

Reglas de Vinculación de Patreon y Tipeee para Colaboradores de Hojas de Personaje de la Comunidad

Para los autores de scripts Mod (API) que contribuyen al Repo de Scripts Mod (API) de Roll20, se les permite hacer publicidad a través de sitios de suscripciones/donaciones: Patreon y Tippee. Roll20 no se hace responsable por ninguna transacción de pago y no puede hacer valer ningún acuerdo privado.

Para calificar, un autor de scripts Mod (API) primero debe tener su contribución de script aprobada por el personal de Roll20 e incluida en el Repo de Scripts Mod (API) de Roll20.

Querrás incluir la información de tu cuenta de Patreon o Tipeee en el archivosheet.jsonque deberá ser incluido junto con tu script en GitHub.

El archivo json debe tener uno de estos campos agregados si deseas hacer publicidad con Patreon o Tipeee:

patreon: Coloca aquí la URL de una campaña de Patreon y aparecerá debajo de la descripción de tu script cuando sea seleccionado. (por ejemplo, "https://www.patreon.com/<name>")

tipeee: Coloca aquí la URL de Tipeee y aparecerá debajo de la descripción de tu script cuando sea seleccionado. (por ejemplo, "https://www.tipeee.com/<name>")

Enlazando a Patreon/Tipeee en los foros de Roll20

Enlazar a Patreon o Tipeee en los Foros de Roll20 solo está permitido para miembros de la comunidad preaprobados que hayan contribuido con Hojas de Personajes o Scripts Mod (API). Si deseas solicitar directamente a los usuarios por financiamiento, puedes hacerlo de forma privada, pero no se permiten este tipo de enlaces en un foro público sin ningún material contribuido.