|
 |
|
|
| HTGT.app (HAPPYTEC Ghosttool) |
Verfügbare Hilfetexte in dieser Kategorie:
| Was ist die HTGT.app? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Ein Programm zur einfachen (grafischen) Verwaltung der enthaltenen Geister der OfflineProfiles.xml Datei.
Zusätzlich ist es eine unkomplizierte Möglichkeit für den Geist Up-/Download über den HAPPYTEC-Server.
Mittlerweile unterstützt es auch einige weitere Aktionen rund um das Spiel. Dazu zählt z.B. die Profilverwaltung.
|
| Alternative: ONLINE-Modus |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Viele Funktionen sind seit einiger Zeit direkt im Spiel integriert, über den sogenannten ONLINE-Modus. Zur Teilnahme an Rennen ist der ONLINE-Modus seit der OC:24 sogar eine zwingende Voraussetzung!
Dennoch bietet die HTGT.app einige erweiterte Möglichkeiten zur Profil-/Geistverwaltung, die mit dem OC-Patch nur schwer bis gar nicht umsetzbar wären.
|
| Wieso wird Java 8 nicht mehr unterstützt? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
HTGT.app v0.1.15 ist die letzte Version, die unter Java 8 lauffähig ist! Beginnend mit v0.1.16 muss mindestens Java 9 (oder höher) vorhanden sein.
Neuere Versionen können für Java 8 aus technischen Gründen nicht mehr bereitgestellt werden, weil u.a. native2ascii auf den meisten Plattformen nicht mehr existiert.
Neuere Java-Versionen sollten aber für alle unterstützten Systeme problemlos installiert werden können...
|
| Die JAR-Datei kann nicht geöffnet werden? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Beim Doppelklick auf die JAR-Datei passiert nichts, obwohl Java installiert ist!
Lösung: Lade stattdessen die ZIP-Datei herunter und extrahiere (entpacke) sie vollständig! Danach kannst du versuchen das enthaltene Batch-Script Start-HTGT-Windows_vX.X.X.bat zu starten. Für macOS und Linux gibt es Scripte mit ähnlichen Namen. Sollte auch das nicht funktionieren, bitte im Forum um Hilfe.
Es ist ein bekanntes Problem, dass einige (Windows 10) Benutzer Probleme haben, die JAR-Datei zu starten. Das BAT-Script ist seit Version 0.1.3 ein Workaround dafür.
|
| Seit Version 0.1.9 erscheint eine SocketTimeoutException! |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Wichtiger Hinweis: Dieses Problem sollte mit v0.1.16 (oder neuer) endgültig behoben sein!
Da der ursprüngliche Beitrag aber interessante Details enthält, bleibt er unverändert online.
| Zitat: | Wenn dieser Fehler nach einem Upgrade auf v0.1.9 plötzlich auftaucht...
| Zitat: | Der Server gab bei der API-Anfrage einen Fehler zurück!
Fehlercode: INTERNAL_NETWORK_ERROR
Überprüfe deine Internetverbindung
java.net.SocketTimeoutException: connect timed out |
Kann es sich lohnen, es einmal mit der älteren Version 0.1.8 zu probieren.
- Wenn es mit v0.1.8 auch nicht funktioniert, liegt ein anderes Problem vor, das in diesem Hilfethema nicht behandelt wird. Überprüfe in diesem Fall Deine Firewalleinstellungen und melde dich im Forum.
- Wenn es mit v0.1.8 einwandfrei funktioniert, liegt es mit ziemlicher Sicherheit an IPv6. Seit v0.1.9 ist IPv6 standardmäßig aktiv, davor wurde ausschließlich IPv4 verwendet. Wenn IPv6 nicht korrekt funktioniert, ist das oftmals schlimmer, als wenn es gar nicht verfügbar ist. Im Browser fallen solche Probleme aber bei Websites meistens nicht auf, weil dort eine Technologie mit dem Namen Happy Eyeballs (RFC 6555) zum Einsatz kommt. Das ist bei Java und somit der HTGT.app jedoch nicht der Fall!
Um die Probleme weiter einzugrenzen, solltest du den nachfolgenden Test ausführen: test-ipv6.com
In weiterer Folge solltest du die Einstellungen deines Internetzugangs bzw. des Routers überprüfen.
Falls alles nichts hilft, gibt es auch eine versteckte Option, um IPv6 in der HTGT.app wieder zu deaktivieren. Es gibt mehrere Möglichkeiten dazu:
- Über den Debugmodus: Lade die ZIP-Datei herunter, entpacke (extrahiere) sie vollständig und starte anschließen das Script HTGT-Debug! Je nach Betriebssystem ist der Name leicht unterschiedlich.
In der rechten oberen Ecke der HTGT.app findest du nun ein [DEBUG] Menü. Klicke dort auf: [Network] System default behavior for IP version
Beende die HTGT.app und starte sie wie gewohnt. Der Debugmodus ist zukünftig nicht mehr notwendig! IPv6 sollte nun innerhalb der HTGT.app deaktiviert sein und alles wieder funktionieren.
- Alternativ kannst du auch manuell eine Änderung im Java Preferences Storage für die HTGT.app vornehmen. Beende dazu zuerst die HTGT.app!
- Unter Windows ist die Konfiguration der HTGT.app in der Registry gespeichert. Öffne dazu den Registrierungs-Editor (Windowstaste + R: regedit) und navigiere zum Pfad HKEY_CURRENT_USER\SOFTWARE\JavaSoft\Prefs\/H/T/G/T und erstelle eine neue Zeichenfolge mit dem Namen ipv4. Als Wert kannst du eine beliebige Zeichenfolge eintragen, z.B. "true". Alternativ kannst du hier auch eine fertige REG-Datei herunterladen, die diese Änderung vornimmt.
- Unter Linux liegt die Konfiguration der HTGT.app in der Datei ~/.java/.userPrefs/HTGT/prefs.xml Füge dort vor </map> eine neue Zeile mit diesem Inhalt ein: <entry key="ipv4" value="true"/>
- Unter macOS ist es ähnlich, wie unter Linux. Dort liegt die Datei aber angeblich unter ~/Library/Preferences/HTGT/prefs.xml!
|
|
| Die einzelnen Menüs im Detail erklärt... |
|
|
| Geschrieben von killerbees19 |
Nach oben |
- Datei - alle typischen Aktionen rund um die OfflineProfiles.xml
- XML-Datei öffnen: Hiermit kann eine beliebige OfflineProfiles-Datei mit Geistern geöffnet werden, egal in welchem Ordner diese gespeichert ist.
- Standardpfad öffnen: Die einfachste Möglichkeit, um die Standard-XML-Datei der SC zu öffnen.
Falls das Spiel in einen anderen Ordner oder auf ein anderes Laufwerk installiert wurde, kann dieser unter Hilfe » Standardpfad einstellen angepasst werden. Oder man nutzt Datei » XML-Datei öffnen.
- Speichern: Um die Datei zu speichern. Ungespeicherte Änderungen erkennt man übrigens am * im Fenstertitel!
- Speichern unter: Um die Datei wird unter einem anderen Namen oder Ort zu speichern.
- Schließen: Die Datei wird geschlossen.
- Beenden: Das Programm wird beendet.
- Bearbeiten - Aktionen rund um die (markierten) Geister
- Rückgängig/Wiederholen: Nimmt die letzte Änderung zurück oder stellt sie wieder her. Der Änderungsverlauf umfasst bis zu zehn Aktionen.
- Ausschneiden, Kopieren, Einfügen: Copy & Paste Aktionen über die Zwischenablage.
- Löschen: Löscht den oder die markierten Geister.
- Alles markieren: Wählt alle Geister des aktuellen Profiles in der Tabelle aus.
- Auswahl umkehren: Wählt Geister aus, die nicht markiert sind und umgekehrt.
- Nichts auswählen: Die Markierung aller ausgewählten Geister aufheben.
- Zu anderem Profil kopieren: Kopiert die ausgewählten Geister in das gewünschte Profil.
- In anderes Profil verschieben: Verschiebt die ausgewählten Geister in das gewünschte Profil.
- Aus Datei importieren: Fügt allen Geister einer anderen XML-Datei zur aktuellen Tabelle hinzu.
- In Datei exportieren: Speichert die ausgewählten Geister in einer XML-Datei ab.
- Geistliste sortieren: Sortiert die aktuelle Tabelle nach Spielmodus, Strecke und Wetter.
- Ansicht - alles rund um die Anzeige der Daten
- Profil wählen: In einer OfflineProfiles-Datei können mehrere Benutzerprofile enthalten sein.
Über diesen Menüeintrag kann zu einem anderen User gewechselt oder das (versteckte) Standardprofil sowie Spezialprofil ausgewählt werden.
Das aktuell gewählte Profil steht übrigens auch im Fenstertitel!
- Zum [...] Profil wechseln: Wechselt direkt zum gewünschten Profil, ohne Umweg über den Auswahldialog.
- Vorheriges/Nächstes Profil: Wechselt zum nächsten oder vorherigen Profil in der XML-Datei.
- Profil hinzufügen/umbenennen/entfernen: Profilmanager für die Ingame-Profile des Spiels.
Ideal, falls mehrere Familienmitglieder oder Freunde am gleichen PC zocken.
DAS SPIEL MUSS UNBEDINGT GESCHLOSSEN SEIN, WENN DIESE FUNKTIONEN GENUTZT WERDEN!
- Aktualisieren: Lädt die geöffnete Datei erneut, um (externe) Änderungen einzulesen.
- Server - alle Onlinefunktionen von HAPPYTEC (bzw. der eSports-API)
- Markierte Geister hochladen: Sendet einen oder mehrere markierte Geister aus der Tabelle zum Server.
Um die Verwechslungsgefahr zu minimieren, wird vor der Übernahme eines Ergebnisses jeweils eine Bestätigungsfrage angezeigt.
- Geist aus Rangliste herunterladen: Bietet alle Geister der aktuellen Rangliste einer gewählten Strecke zum Download an.
Bitte beachte, dass es für Training und Rennen jeweils eigene Einträge gibt! Die jeweilige Rennrangliste ist spätestens 15 Minuten nach Rennstart auswählbar.
- Geister durch ID(s) herunterladen: Geister können direkt durch die Identifikationsnummern heruntergeladen werden.
Mehrere ID's können durch jedes nicht-numerische Trennzeichen angegeben werden, also z.B. ein Leerzeichen oder Beistrich.
Normalerweise braucht man diese Funktion nur für versteckte eigene Geister oder vorherige Geister eines anderen Users, die nicht mehr in der Rangliste stehen.
- Fast-Follow-Modus: Während dieser Modus aktiviert ist (= solange der entsprechende Dialog geöffnet ist), werden neue Geister automatisch eingelesen und zum Server hochgeladen.
Man kann damit einfach SC spielen, das Programm meldet sich bei neuen Geistern automatisch mit einer Rückfrage, ob der Geist übernommen werden soll.
Bei "nur pB's hochladen" erfolgt vor dem Upload ein Abgleich, ob die gefahrene Zeit besser als die bereits eingetragene der Rangliste ist. Falls nicht, wird der Geist nicht hochgeladen.
Bei "im alles hochladen" wird der Geist auf jeden Fall hochgeladen, auch wenn man langsamer unterwegs war. Dadurch hat man ein persönliches (nicht öffentliches) Archiv auf HAPPYTEC, in dem alle Fahrten enthalten sind.
- Spieler-/Bewerbsdetails anzeigen: Es wird eine kurze Zusammenfassung angezeigt, welcher API-Token im Programm hinterlegt ist.
- Token ins aktuelle Profil kopieren: Kopiert den in der Anwendung hinterlegten API-Token ins aktuelle Profil der XML-Datei, damit er z.B. für den 3TC genutzt werden kann.
Falls man bei der Installation der OC:18 keinen Token angegeben hat, oder er sich zwischenzeitlich geändert hat, kann man diesen Schritt hiermit wiederholen.
- Token aus aktuellem Profil verwenden: Kopiert den API-Token aus dem aktuellen Profil der XML-Datei in das Programm, damit er für die Serverfunktionen genutzt werden kann.
- Token aus aktuellem Profil entfernen: Entfernt den API-Token aus dem aktuellen Profil der XML-Datei.
- API-Token ändern: Hier kann der Zugangsschlüssel für die HAPPYTEC-eSports-API eingetragen werden.
- API-Token löschen: Entfernt den hinterlegten Zugangsschlüssel aus der Konfiguration des Programms.
- Hilfe - diverses Zeugs...
- Über diese App: Versionsinformation und Lizenztext.
- Datenschutzhinweise: Öffnet die Datenschutzhinweise im Browser.
- Online Dokumentation: Öffnet diese Hilfeseite im Browser.
- Support kontaktieren: Öffnet den Forenthread im Browser.
- Automatische Updateprüfung: Aktiviert oder deaktiviert die tägliche Updateprüfung.
- Manuelle Updateprüfung: HTGT.app (Sofern aktiviert, passiert das automatisch einmal täglich beim Programmstart.)
- Manuelle Updateprüfung: OC-Patch: (Sofern aktiviert, passiert das automatisch einmal täglich beim Öffnen einer XML-Datei.)
- Standardpfad einstellen/zurücksetzen: Ändert die zu öffnende Datei für Datei » Standardpfad öffnen.
- Datei als Standardpfad nutzen: Setzt den Standardpfad auf die aktuell geladene XML-Datei.
Sehr praktisch, falls der Installationsordner der SC:16 woanders liegt und die Datei bereits manuell geöffnet wurde.
- Bestätigungsfragen deaktivieren: Alle Dialoge, bei denen Immer oder Nie ausgewählt werden kann, werden ab sofort nicht mehr angezeigt.
Das betrifft vor allem die Rückfragen vom Geistupload bzw. Fast-Follow-Modus bezüglich einem Geistdownload.
- Bestätigungsfragen aktivieren: Alle Dialoge, bei denen irgendwann Immer oder Nie ausgewählt wurde, werden beim nächsten Mal wieder angezeigt.
Das betrifft vor allem die Rückfragen vom Geistupload bzw. Fast-Follow-Modus bezüglich einem Geistdownload.
- Konfiguration löschen: Entfernt alle gespeicherten Daten des Programms vom System.
Dazu zählt z.B. der API-Token, der Zeitpunkt des letzten Updatechecks, die letzte Auswahl in Dialogen, der Standardpfad und abgerufene Streckeninformationen vom Server.
Bitte beachte, dass die Konfiguration spätestens beim nächsten Programmstart wieder angelegt wird!
|
| Typischer Workflow: Ein paar Beispiele... |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Beispiel 1: Fast-Follow-Modus
Die bequemste Möglichkeit, um es zu nutzen...
- Das Programm starten und über Datei » Standardpfad öffnen loslegen.
- Sofern ein Geist gewünscht ist, diesen zuerst über Server » Geister auswählen und herunterladen einbauen.
- Nun kann über Server » Fast-Follow-Modus auf Änderungen gewartet werden.
- Die SC starten und eine Strecke sowie Wetter auswählen.
- Und jetzt einfach runterfahren! Immer und immer wieder.
- Sobald man eine neue Bestzeit hat, wird sich der Fast-Follow-Modus nach spätestens fünf Sekunden mit einer Bestätigungsfrage in den Vordergrund stellen.
- Danach kann sofort wieder in der SC neu gestartet werden, bei Bedarf mit einem neuen Geist, der zuvor heruntergeladen wurde.
Beispiel 2: ? ? ?
[...]
Beispiel 3: ? ? ?
[...]
|
| Die 30 Sekunden Geschichte: Wenn Geister verschwinden... |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Wenn man sich im Spiel außerhalb einer Strecke (z.B. im Hauptmenü) befindet, überschreibt das Spiel alle 30 Sekunden die XML-Datei. Heruntergeladene Geister könnten somit plötzlich nicht mehr vorhanden sein. Es wird empfohlen, dass man Geister erst herunterlädt, wenn die Strecke geöffnet ist! Neue Geister werden im Spiel bei jedem Neustart der Fahrt (R-Taste) bzw. beim Gang zum Starthaus erneut eingelesen.
|
| Warum nur ein Geist je Spielmodus/Strecke/Wetter? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Es kann nur einen Geist pro Spielmodus/Strecken/Wetter Kombination geben! Das ist eine Einschränkung des Spiels.
Falls beim Geistdownload oder Einfügen/Importieren doppelte Einträge entstehen würden, erfolgt eine Bestätigungsfrage.
Tipp: Im Spezialprofil sind auch mehrere Geister der gleichen Spielmodus/Strecken/Wetter Kombination erlaubt! Das ist ideal für den Videomodus oder die Multighost-Nutzung.
|
| Nutzung des Spiels mit mehreren Personen |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Damit jeder eigene Skieinstellungen sowie ein eigenes Anzugdesign haben kann, müssen zuerst weitere Profile über das Menü Ansicht angelegt werden.
Für die Onlinefunktionen (Rangliste, ...) muss außerdem jeder Teilnehmer einen eigenen HAPPYTEC-Account haben und für den Bewerb angemeldet sein.
Um HTGT mit mehreren Teilnehmern nutzen zu können, benötigt jede Person einen eigenen (Windows) Account auf diesem PC.
HTGT muss dann jeweils unter dem richtigen Account gestartet werden. Nur so kann der API-Token korrekt zugeordnet werden!
Alternativ kann für den Geistupload auch die Selbsteintragungsfunktion auf der Website verwendet werden, da man sich dort erst explizit einloggen muss...
Bitte beachte jedoch, dass dabei immer alle verfügbaren Geister der XML-Datei (auch fremde) am Server landen und mindestens für die Rennleitung sichtbar sind.
|
| Tastenkombinationen und Tastaturbedienung |
|
|
| Geschrieben von killerbees19 |
Nach oben |
HTGT unterstützt für nahezu jedes Menüelement Tastenkürzel. Diese sind in den Menüs überall aufgelistet.
(Leider derzeit immer auf Deutsch, unabhängig von der gewählten Sprache. Der Bug wird noch gesucht...)
Dialoge können bei Bedarf wie gewohnt bedient werden. Unterstützte Tasten: Esc (Abbrechen), Tab (anderen Button auswählen), Pfeiltasten (anderes Element aus Liste), Enter (Bestätigung), ...
Zusätzlich können die Geister in der Tabelle mit der Tastatur ausgewählt werden. Neben den Pfeiltasten gibt es zahlreiche allgemein bekannte Möglichkeiten.
Dazu zählen diverse Kombinationen aus Pfeiltasten, Umschalt, Strg, Pos1, Ende, ... - sowie natürlich Copy & Paste über Strg + X/C/V. (siehe Quellcode)
Tipp: Eine Mehrfachauswahl ist auch durch Klicken und Ziehen mit der Maus möglich! Oder durch Klicken, während die Strg-Taste gedrückt wird.
|
| Welche Informationen werden an den Server übertragen? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Neben den explizit ausgewählten Daten (z.B. den Geistern) gibt es ein paar Dinge, die im Hintergrund eventuell automatisch zum Server übertragen werden:
- Updateprüfung: Dabei wird die verwendete Version der HTGT-Applikation an den Server gesendet und verglichen, um bei Updates eine Benachrichtigung zu erhalten.
Zusätzlich wird die Betriebssystem-/Javaversion, die verwendete CPU-Architektur und die eingestellte Sprache (z.B. Windows 10; x86; 10.0; Java(TM) SE Runtime Environment; 1.8.0_111; de_DE) übermittelt und für eine anonyme Statistik verwendet.
- DLL-Check: Falls die Datei Assembly-CSharp.dll im SC-Programmordner existiert, wird die SHA512-Prüfsumme der Datei an den Server gesendet und verglichen, um bei Updates des Patches eine Benachrichtigung zu erhalten.
Diese Daten werden immer ohne den persönlichen API-Token übermittelt, eine Zuordnung zu einem bestimmten User ist somit nicht möglich!
|
| Was muss ich eventuell in der Firewall erlauben? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Die HTGT.app ist ein Java-Programm und kommuniziert über Port 443 (HTTPS) mit den Hosts htgt.app und (in früheren Versionen) www.esports.happytec.at. Zusätzlich wird die DNS-Auflösung benötigt.
Falls Du eine sehr restriktive Firewallkonfiguration verwendest, solltest Du die oben genannten Ziele explizit für die HTGT.app bzw. Java erlauben.
|
| Wo findet man alte Programmversionen? |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Es sollte immer nur die aktuellste Version des Programms genutzt werden!
Falls trotzdem einmal ein vorheriges Build gesucht wird, kann dieses hier heruntergeladen werden.
Zusätzlich ist jedes offizielle Release als eigener Branch bzw. mit eigenem Tag auf GitHub verfügbar.
|
| Quellcode / Lizenz |
|
|
| Geschrieben von killerbees19 |
Nach oben |
Den aktuellen Source-Tarball gibt es immer direkt bei den Downloads im Forum. Der Entwicklungszweig ist außerdem auf GitHub einsehbar.
Der Quellcode des Programms sowie die Binärpakete selbst sind unter der GPLv3 (GNU GENERAL PUBLIC LICENSE Version 3) lizenziert.
Das Programm und sein Java-Code dürfen somit frei verteilt und bearbeitet werden - allgemein auch als Opensource bzw. FOSS bekannt.
Verbesserungen am Java-Code können als Pull Request direkt auf GitHub übermittelt werden. Einen Bugtracker gibt es dort ebenfalls.
Trotz all dieser Freiheiten bitte ich jeden, keine inoffiziellen Builds zu veröffentlichen, in denen HAPPYTEC bzw. HTGT unverändert im Namen vorkommt! Prefixe/Suffixe wie z.B. "inoffiziell" sind in Ordnung. Die Versionsnummer sollte das ebenfalls widerspiegeln, falls sie von "git-master" abweicht. 
|
|
Verwendete Zeitzone: CET (Europe/Berlin)
Aktuelles Datum & Uhrzeit: 11.12.2024, 19:45 |
Nach oben |
|
|
|
|
|
|
News
Online-Tools
Kontakt
