ITA ‐ Modalità Gamemaster

Dalle release di questo repository si può scaricare un particolare programma, chiamato Egobalego at Home.

Si tratta nient'altro che della cosiddetta "Console da Gamemaster", una webapp che permette a chiunque abbia ricevuto il consenso di prendere il controllo della mod nell'istanza di un altro giocatore, e fare cose come controllare lo spawn delle strutture, i dialoghi e gli scambi del ricercatore, eseguire comandi e tanto altro!

Per utilizzarla è necessario prima di tutto avere Python (i test sono stati eseguiti con Python 3.10 e 3.12, le dipendenze sono state congelate per evitare di avere problemi in futuro).

Una volta fatto ciò, scaricate dalle release corrispondente alla versione della mod che volete usare il zip, estraete la cartelle contenuta al suo interno e lanciate (basta doppio click) lo script start-server-italian.bat. Si dovrebbe aprire un terminale, che potrai chiudere in seguito per terminare il programma.

Il primo avvio richiederà un po' di tempo (per gli smanettoni: crea un ambiente virtuale di Python all'interno della cartella e installa le dipendenze per avviare la webapp). Una volta finito si aprirà nel browser la console, e da lì si possono seguire le guide delle varie pagine.

Uno dei metodi più semplici per rendere accessibile il server dall'esterno è quello di usare Ngrok.

Breve guida per Ngrok

• Andare nella dashboard sul sito di Ngrok (dovrebbe aprirsi sulla pagina "Setup & Installation", bisogna creare un account per accedervi);
• Installare Ngrok da terminale con il comando choco install ngrok o scaricando direttamente l'exe (tab "Download" affianco a "Chocolatey"), se questo non funziona;
• Copiare il comando che inizia con ngrok config add-authtoken ed eseguirlo da terminale per eseguire l'accesso (se si ha scaricato l'exe bisogna prima aprirlo per avere il terminale nella cartella giusta);
• Andare nella sezione domains della dashboard di Ngrok, riscattare il proprio dominio statico gratuito e salvarlo da qualche parte;
• Per aprire il server basta usare nello stesso modo il comando ngrok http --url=<YOUR-STATIC-DOMAIN> 5000 (5000 è la porta del localhost su cui runna la console) ogni volta che si usa Egobalego at Home.

Passando alla configurazione della mod per chi si connetterà all'endpoint, è consigliato che configuriate la mod al loro posto in modo da evitare che si becchino spoiler. Ecco quindi i passaggi da fare:

• Aprite il gioco per generare il file di configurazione ruins-of-growsseth.jsonc nella cartella config della vostra istanza moddata.
• Disattivate lo spawn di tutte le strutture dalla categoria structures.
• Andate nella sezione web, attivate la sincronizzazione web (prima opzione) e impostate l'URL del vostro server (se state usando Ngrok è il vostro dominio statico).
  Se pensate possa servire attivate anche l'impostazione comandi remoti per eseguire qualsiasi tipo di comando vanilla (si presume che la persona che si affida a voi abbia fiducia che non facciate danni), e il servizio di Live Update per sfruttare la funzionalità del websocket (permette di mandare eventi in tempo reale senza aspettare che la mod ricarichi ogni x minuti; abilitatela e mettete lo stesso URL della sinc. web per usarlo).
• Passate il file di config e fatelo mettere nella istanza di chi deve giocare, e potete finalmente iniziare!

Se siete admin di un server, potete anche usare il comando /gmaster per configurare il tutto ingame, e anche per monitorare lo stato e le connessioni della modalità GM.

Nota importante: ricordate sempre di testare in un mondo di prova i vari eventi prima della sessione vera e propria!

Altra nota importante: Spawnare una struttura genera lo scambio della mappa corrispondente.