Come posso installare uno script Mod (API) usando la libreria degli script con un solo clic?
- Vai alla pagina di destinazione del gioco desiderato.
- Fai clic sul menu Impostazioni e seleziona gli Script Mod (API).
- Nel menu a tendina Biblioteca script, individua lo script necessario.
- Fai clic sul pulsante Aggiungi script.
- Ora puoi iniziare ad utilizzare lo script nel tuo gioco!
Come posso installare uno script Mod (API) se desidero scrivere il mio codice o utilizzare codice da una fonte esterna?
È un processo simile all'installazione di uno script utilizzando la nostra libreria degli script con un solo clic.
- Vai alla pagina di destinazione del gioco desiderato.
- Fai clic sul menu Impostazioni e seleziona gli Script Mod (API).
- Nella pagina Impostazioni Mod (API), fai clic sulla scheda Nuovo Script.
- Verrai portato a una finestra dell'editor di codice dove puoi inserire il codice dello script e dare un nome allo script.
- Copia-incolla il codice dello script e fornisce un nome per lo script.
- Fai clic sul pulsante Salva script.
- Il sandbox Mod (API) si riavvierà e ora puoi iniziare ad usare lo script in gioco.
Se hai ottenuto lo script da una fonte esterna, fai riferimento alla descrizione dello script per informazioni importanti e istruzioni.
Aiuto! Non riesco a far funzionare il mio script!
Se stai cercando assistenza generale con la risoluzione dei problemi dei Mod (API), consulta il nostro articolo qui. Se stai cercando consigli e informazioni più avanzati per il debug, consulta il nostro articolo qui. Se stai ancora riscontrando problemi, sentiti libero di creare un post sul nostro Forum Mod (API).
Se voglio scrivere uno script, di cosa ho bisogno per iniziare?
Gli script per i Mod di Roll20 (API) sono scritti in JavaScript. Per iniziare è sufficiente una conoscenza di base del linguaggio, ma se desidera approfondire la conoscenza di JavaScript, questo corso di Codecademypuò aiutarla a imparare.
Per iniziare, la tua prima fermata dovrebbe essere la Guida all'Uso Avanzato.
Come funziona?
Scrivi script che ascoltano gli eventi che accadono durante il gioco. Gli script possono controllare che le regole siano seguite, modificare le proprietà degli oggetti e dei token e persino fornire comandi di chat personalizzati. I tuoi script hanno un impatto su tutto il gioco, influenzando le azioni sia del GM che di tutti i giocatori. Gli script avanzati possono anche funzionare in modo indipendente, eseguendo azioni automatiche come spostare un token su un percorso di pattuglia o spingere i giocatori quando il loro turno sta durando troppo a lungo.
Dove posso trovare gli script pre-fatti?
La community degli script Mod (API) è abbastanza attiva con membri che creano e discutono script tutto il tempo. Ci sono 3 posti di base in cui cercare nuovi script:
- Il Repository Ufficiale degli Script Mod (API) di Roll20 su GitHub. Qui troverai la versione attuale degli script che gli autori hanno inviato per essere inclusi nel repository.
- Il Forum degli Script Mod (API) di Roll20. Qui è dove gli script tendono a comparire per primi e dove avviene la discussione sugli script che vengono scritti o necessitano di modifiche. Qui è anche dove puoi pubblicare e chiedere aiuto alla community per creare uno script che hai pensato o trovare uno script per soddisfare una necessità.
- Il Indice degli Script dei Mod (API) della Wiki. Questa è una buona fonte di informazioni sugli script disponibili.
Contribuire agli Script Mod (API) della Community
Se crei uno script che desideri offrire al resto della comunità di Roll20, puoi inviarlo per essere incluso nel Repository degli Script Mod (API) di Roll20. Approvando il tuo script da parte del personale di Roll20 e includendolo nel repository, sbloccherai il tag del forum "API Scripter" per il tuo account e ti permetterà di fare pubblicità tramite Patreon o siti simili a Patreon (vedi sotto per ulteriori informazioni). Per scoprire cosa devi fare per inviare correttamente il tuo script al repository vai al Repository Ufficiale degli Script Mod (API) di Roll20.
Regole per il collegamento a Patreon e Tipeee per i contributori delle schede della comunità
Per gli autori di script Mod (API) che contribuiscono al Repository degli Script Mod (API) di Roll20, sono autorizzati a fare pubblicità tramite siti di abbonamento/donazione: Patreon e Tippee. Roll20 non si assume la responsabilità sulle transazioni di pagamento e non può in alcun modo far valere accordi privati.
Per poter essere idoneo, un autore di script Mod (API) deve prima avere il suo contributo di script approvato dal personale di Roll20 e incluso nel Repository degli Script Mod (API) di Roll20.
Dovrà includere le informazioni del suo account Patreon o Tipeee nel filesheet.json
che deve essere incluso nell'invio del suo script su GitHub.
Il file json deve contenere uno di questi campi se desidera fare pubblicità con Patreon o Tipeee:
patreon: Inserisca qui l'URL di una campagna Patreon, che apparirà sotto la descrizione del suo script quando verrà selezionato. (ad esempio"https://www.patreon.com/<name>").
tipeee: Inserisca qui l'URL di un Tipeee, che apparirà sotto la descrizione del suo script quando verrà selezionato. (ad esempio, "https://www.tipeee.com/<name>").
Per ulteriori informazioni, vedi https://github.com/Roll20/roll20-api-scripts#contributing.Collegamento a Patreon/Tipeee sui forum di Roll20
Inserire link a Patreon o Tipeee sui Forum di Roll20 è consentito solo ai membri della comunità pre-approvati che abbiano contribuito o Fogli Personaggio o Script Mod (API). Se desidera sollecitare direttamente gli utenti per un finanziamento, può farlo privatamente, ma non sono consentiti collegamenti di questo tipo in un forum pubblico senza alcun contributo.