Tools
Garry's Mod

Własny ekran ładowania w HTML i JavaScript

Ekran ładowania GMod to zwykła strona internetowa. Podczas łączenia Garry's Mod wywołuje na niej pięć funkcji JavaScript i przekazuje dane serwera oraz postęp ładowania.

W skrócie

Zdefiniuj na swojej stronie globalne funkcje GameDetails, SetFilesTotal, SetFilesNeeded, DownloadingFile i SetStatusChanged. Garry's Mod wywołuje je podczas łączenia. Pisz JavaScript w ES5, żeby działał też w starszej wbudowanej przeglądarce.

Pięć funkcji

  • GameDetails(servername, serverurl, mapname, maxplayers, steamid, gamemode, volume, language): raz na początku, z nazwą serwera, mapą, slotami, SteamID64 gracza, trybem gry, głośnością muzyki (od 0 do 1) i językiem gry.
  • SetFilesTotal(total): liczba plików, które trzeba załadować.
  • SetFilesNeeded(needed): ile z nich jeszcze brakuje. Postęp to (total - needed) / total.
  • DownloadingFile(fileName): plik, który właśnie się ładuje.
  • SetStatusChanged(status): status gry, na przykład „Mounting Addons” albo „Sending client info…”.

Minimalny przykład

Szkielet pokazuje mapę, postęp i status. Używa tylko ES5, czyli bez let, bez funkcji strzałkowych i bez template stringów.

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

Na co zwrócić uwagę

  • Stara technologia przeglądarki: Garry's Mod używa, zależnie od systemu, wyraźnie starszej przeglądarki niż Chrome. Testuj w grze, nie tylko na PC.
  • Zostaw wolny prawy dolny róg: Garry's Mod wyświetla tam własne okno ze statusem i przyciskiem „Anuluj”.
  • Trzymaj ją małą: Strona ładuje się równolegle z dodatkami. Skompresowane obrazy i mało skryptów przyspieszają ją.
  • Muzyka: Stosuj się do volume z GameDetails, żeby gracze z wyłączoną muzyką nic nie słyszeli.

Częste pytania

Czy funkcje są zawsze wywoływane?

Nie zawsze wszystkie. Bez pobierania prawie nie ma wywołań DownloadingFile, a SetFilesTotal może się nie pojawić. Zakładaj, że wartości mogą pozostać puste.

Czy mogę używać jQuery albo frameworka?

Tak, o ile wersja działa w starej wbudowanej przeglądarce. Do ekranu ładowania zwykle wystarcza czysty JavaScript.

Gotowy ekran ładowania bez HTML

Generator tworzy stronę i linijkę do server.cfg oraz zajmuje się postępem, muzyką i nickiem ze Steam. Ty wybierasz styl i wpisujesz swoje teksty.

Stwórz ekran ładowania

Za darmo. Logowanie kontem Nexthosting, założenie konta nic nie kosztuje.

Edytor jest dostępny po angielsku i niemiecku. Teksty na swoim ekranie ładowania piszesz sam, w dowolnym języku.