Tools
Garry's Mod

Schermata di caricamento personalizzata con HTML e JavaScript

Una schermata di caricamento GMod è una normale pagina web. Durante la connessione Garry's Mod richiama al suo interno cinque funzioni JavaScript e passa i dati del server e l'avanzamento del caricamento.

In breve

Definisci nella tua pagina le funzioni globali GameDetails, SetFilesTotal, SetFilesNeeded, DownloadingFile e SetStatusChanged. Garry's Mod le richiama durante la connessione. Scrivi il JavaScript in ES5, così gira anche nel vecchio browser integrato.

Le cinque funzioni

  • GameDetails(servername, serverurl, mapname, maxplayers, steamid, gamemode, volume, language): una volta all'inizio, con nome del server, mappa, slot, SteamID64 del giocatore, gamemode, volume della musica (da 0 a 1) e lingua del gioco.
  • SetFilesTotal(total): numero dei file da caricare.
  • SetFilesNeeded(needed): quanti ne mancano ancora. L'avanzamento è (total - needed) / total.
  • DownloadingFile(fileName): il file in caricamento in questo momento.
  • SetStatusChanged(status): lo stato del gioco, per esempio «Mounting Addons» o «Sending client info…».

Un esempio minimo

Lo scheletro mostra mappa, avanzamento e stato. Usa solo ES5, quindi niente let, niente arrow function e niente template string.

<p id="map"></p>
<div id="bar" style="height:6px;width:0;background:#5143d9"></div>
<p id="status"></p>
<script>
var total = 0;
function GameDetails(servername, serverurl, mapname, maxplayers, steamid, gamemode, volume, language) {
  document.getElementById('map').textContent = mapname;
}
function SetFilesTotal(n) { total = n; }
function SetFilesNeeded(n) {
  if (total > 0) { document.getElementById('bar').style.width = Math.round((total - n) / total * 100) + '%'; }
}
function DownloadingFile(file) { document.getElementById('status').textContent = file; }
function SetStatusChanged(status) { document.getElementById('status').textContent = status; }
</script>

Cosa tenere presente

  • Tecnologia browser datata: a seconda del sistema, Garry's Mod usa un browser molto più vecchio di Chrome. Prova nel gioco, non solo sul PC.
  • Lascia libero l'angolo in basso a destra: lì Garry's Mod mostra la sua finestra con stato e «Annulla».
  • Resta leggero: la pagina si carica in parallelo agli addon. Immagini compresse e pochi script la rendono più veloce.
  • Musica: rispetta volume di GameDetails, così i giocatori con la musica spenta non sentono nulla.

Domande frequenti

Le funzioni vengono richiamate sempre?

Non sempre tutte. Senza download DownloadingFile viene richiamata a malapena e SetFilesTotal può mancare. Metti in conto che alcuni valori restino vuoti.

Posso usare jQuery o un framework?

Sì, purché la versione giri nel vecchio browser integrato. Per una schermata di caricamento di solito basta JavaScript puro.

Schermata di caricamento pronta, senza HTML

Il generatore crea la pagina e la riga per la server.cfg, e gestisce avanzamento, musica e nome Steam. Tu scegli un design e inserisci i tuoi testi.

Crea la schermata di caricamento

Gratis. Accedi con il tuo account Nexthosting: creare un account non costa nulla.

L'editor è disponibile in inglese e tedesco. I testi della tua schermata di caricamento li scrivi tu, in qualsiasi lingua.