Introduzione agli script Mod (API)

Come posso installare uno script Mod (API) utilizzando la libreria di script singolo-clic?

1. Si prega di accedere alla pagina iniziale del gioco desiderato.
2. Si prega di fare clic sul menu a tendina Impostazioni e selezionare Script Mod (API).
3. Nel menu a tendina Libreria script, individuare lo script richiesto.
4. Si prega di fare clic sul pulsante Aggiungi script.
5. Ora è possibile iniziare a utilizzare lo script nel proprio gioco.

Come posso installare uno script Mod (API) se desidero scrivere il mio codice o utilizzare codice proveniente da una fonte esterna?

È un processo simile all'installazione di uno script utilizzando la nostra libreria di script con singolo-clic.

1. Si prega di accedere alla pagina iniziale del gioco desiderato.
2. Si prega di fare clic sul menu a tendina Impostazioni e selezionare Script Mod (API).
3. Nella pagina Impostazioni Mod (API), selezionare la scheda Nuovo script.
4. Verrà reindirizzato a una finestra dell'editor di codice dove potrà inserire il codice dello script e assegnargli un nome.
5. Si prega di copiare e incollare il codice dello script e di assegnare un nome allo script.
6. Si prega di fare clic sul pulsante Salva script.
7. La sandbox Mod (API) verrà riavviata e sarà ora possibile iniziare a utilizzare lo script nel gioco.

Se avete ottenuto lo script da una fonte esterna, vi invitiamo a consultare la descrizione dello script per informazioni e istruzioni importanti.

Aiuto! Non riesco a far funzionare il mio script.

Se necessiti di assistenza generale per la risoluzione dei problemi relativi alle Mod (API), ti invitiamo a consultare il nostro articolo qui. Se siete alla ricerca di consigli e informazioni più approfondite sul debug, vi invitiamo a consultare il nostro articolo qui. Se dovesse ancora riscontrare difficoltà, la invitiamo apubblicare un post sul nostro forum Mod (API).

Se desidero scrivere una sceneggiatura, di cosa ho bisogno per iniziare?

Gli script per Roll20 Mods (API) sono scritti in JavaScript. Per iniziare è sufficiente una conoscenza di base del linguaggio, ma se desiderate approfondire JavaScript, questo corso di Codecademypuò essere di supporto. 

Per iniziare, si consiglia di consultare innanzitutto la Guida all'uso avanzato.

Come funziona?

Si scrivono script che monitorano gli eventi che si verificano durante il gioco. Gli script possono verificare che le regole vengano rispettate, modificare le proprietà di oggetti e segnalini e persino fornire comandi di chat personalizzati. I Suoi script hanno un impatto su tutto il gioco, influenzando sia le azioni del GM che quelle di tutti i giocatori. Gli script avanzati possono anche essere eseguiti in modo indipendente, eseguendo azioni automatiche come spostare un segnalino su un percorso di pattuglia o sollecitare i giocatori quando il loro turno richiede troppo tempo.

Dove posso reperire script già pronti?

La comunità Mod (API) Script è piuttosto attiva, con membri che creano e discutono script in modo costante. Esistono tre luoghi principali in cui cercare nuovi script:

• Repository ufficiale degli script Roll20 Mod (API)su GitHub. Qui troverete la versione attuale degli script che gli autori hanno inviato per l'inserimento nel repository.
• Forum dedicato allo script Roll20 Mod (API). È qui che gli script tendono ad apparire per la prima volta e dove si discute degli script che vengono scritti o che necessitano di modifiche. Qui è anche possibile pubblicare richieste di assistenza alla comunità per la creazione di uno script che avete ideato o per trovare uno script che soddisfi una vostra esigenza.
• Indice degli script Mod (API) del Wiki. Questa è un'ottima fonte di informazioni sugli script disponibili.

Contribuire con script Mod (API) alla comunità

Se si crea uno script che si desidera condividere con il resto della comunità Roll20, è possibile inviarlo affinché venga incluso nel Repository degli script Roll20 Mod (API). Una volta che il tuo script sarà stato approvato dallo staff di Roll20 e inserito nell'archivio, verrà sbloccato il tag "API Scripter"per il tuo account e potrai pubblicizzare il tuo script tramite Patreon o siti simili (vedi sotto per maggiori informazioni). Per scoprire cosa è necessario fare per inviare correttamente il proprio script al repository, si prega di visitare il repository ufficiale degli script Roll20 Mod (API) all'indirizzo.

Regole per i collegamenti a Patreon e Tipeee per i collaboratori delle schede della community

Gli autori di script Mod (API) che contribuiscono al Roll20 Mod (API) Script Repo sono autorizzati a pubblicizzare i propri servizi tramite siti di abbonamento/donazione quali Patreon e Tippee. Roll20 non è responsabile per alcuna transazione di pagamento e non può far rispettare alcun accordo privato.

Per ottenere la qualifica, l'autore di uno script Mod (API) deve prima ottenere l'approvazione del proprio contributo da parte dello staff di Roll20 e l'inserimento dello script nel Repository degli script Mod (API) di Roll20.

Si consiglia di includere le informazioni relative al proprio account Patreon o Tipeee nellascheda jsonche dovrebbe essere allegata allo script inviato su GitHub.

Il file json dovrebbe includere uno di questi campi se si desidera pubblicizzare su Patreon o Tipeee:

Patreon: inserisca qui l'URL di una campagna Patreon e questo apparirà sotto la descrizione del suo script quando selezionato. (ad esempio "https://www.patreon.com/<name>")

tipeee: Inserisca qui l'URL di Tipeee e apparirà sotto la descrizione del suo script quando selezionato. (ad esempio "https://www.tipeee.com/<name>")

Collegamento a Patreon/Tipeee sui forum Roll20

Il collegamento a Patreon o Tipeee sui forum Roll20 è consentito esclusivamente ai membri della comunità pre-approvati che hanno contribuito con schede dei personaggi o script Mod (API). Se desiderate sollecitare direttamente gli utenti per ottenere finanziamenti, potete farlo in privato, ma non è consentito pubblicare tali link in un forum pubblico senza aver contribuito con alcun materiale.