Tools
Garry's Mod

Écran de chargement personnalisé en HTML et JavaScript

Un écran de chargement GMod est une page web ordinaire. Pendant la connexion, Garry's Mod y appelle cinq fonctions JavaScript et lui transmet les données du serveur et la progression du chargement.

En bref

Définissez dans votre page les fonctions globales GameDetails, SetFilesTotal, SetFilesNeeded, DownloadingFile et SetStatusChanged. Garry's Mod les appelle à la connexion. Écrivez le JavaScript en ES5, pour qu'il fonctionne aussi dans l'ancien navigateur intégré.

Les cinq fonctions

  • GameDetails(servername, serverurl, mapname, maxplayers, steamid, gamemode, volume, language) : une fois au début, avec le nom du serveur, la map, les slots, le SteamID64 du joueur, le mode de jeu, le volume de la musique (0 à 1) et la langue du jeu.
  • SetFilesTotal(total) : le nombre de fichiers à charger.
  • SetFilesNeeded(needed) : combien il en manque encore. La progression est (total - needed) / total.
  • DownloadingFile(fileName) : le fichier en cours de chargement.
  • SetStatusChanged(status) : l'état du jeu, par exemple « Mounting Addons » ou « Sending client info… ».

Un exemple minimal

Cette base affiche la map, la progression et l'état. Elle n'utilise que de l'ES5, donc pas de let, pas de fonctions fléchées et pas de template strings.

<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>

Points à surveiller

  • Technologie de navigateur ancienne : selon le système, Garry's Mod utilise un navigateur nettement plus ancien que Chrome. Testez dans le jeu, pas seulement sur PC.
  • Laisser libre le coin en bas à droite : Garry's Mod y affiche sa propre fenêtre avec l'état et « Annuler ».
  • Rester léger : la page se charge en parallèle des addons. Des images compressées et peu de scripts la rendent plus rapide.
  • Musique : respectez volume de GameDetails, pour que les joueurs qui ont coupé la musique n'entendent rien.

Questions fréquentes

Les fonctions sont-elles toujours appelées ?

Pas toutes, pas toujours. Sans téléchargements, DownloadingFile n'est presque pas appelée, et SetFilesTotal peut manquer. Attendez-vous à ce que des valeurs restent vides.

Puis-je utiliser jQuery ou un framework ?

Oui, tant que la version fonctionne dans l'ancien navigateur intégré. Pour un écran de chargement, du JavaScript pur suffit le plus souvent.

Un écran de chargement prêt sans écrire de HTML

Le générateur crée la page et la ligne pour server.cfg, et gère la progression, la musique et le nom Steam. Vous choisissez un design et saisissez vos textes.

Créer un écran de chargement

Gratuit. Connexion avec votre compte Nexthosting ; créer un compte ne coûte rien.

L'éditeur est disponible en anglais et en allemand. Vous rédigez vous-même les textes de votre écran de chargement, dans la langue de votre choix.