Dokumentation
GhostClient benutzen
Installation
- Fabric Installer herunterladen und für Minecraft 1.21.11 ausführen (Fabric Loader 0.20.1 oder neuer).
- Fabric API für 1.21.11 und die GhostClient-JAR von der Download-Seite herunterladen.
- Beide Dateien in den Ordner
modslegen. Unter Windows ist das%appdata%\.minecraft\mods, unter macOS~/Library/Application Support/minecraft/modsund unter Linux~/.minecraft/mods. - Im Minecraft Launcher das Profil „fabric-loader-1.21.11“ starten.
Automatisierte Builds und Clienttests werden unter Linux ausgeführt. Der Mod enthält keinen betriebssystemspezifischen Code und sollte überall laufen, wo Minecraft 1.21.11 läuft.
Bedienung
| Taste | Aktion |
|---|---|
| Rechts-Shift | GhostClient-Menü (Click-GUI) öffnen |
| Z halten | Zoom; Mausrad ändert dabei die Zoomstufe |
| / oder einfach tippen | Im Menü: Module durchsuchen |
| Esc | Im Menü: Suche leeren, dann Menü schließen |
Die Tasten für Menü und Zoom lassen sich wie alle Minecraft-Tasten unter Optionen → Steuerung → Tastenbelegung in der Kategorie „GhostClient“ ändern.
Im Menü
- Links wählst du eine Kategorie, in der Mitte stehen die Module, rechts die Einstellungen des ausgewählten Moduls.
- Der Schalter neben einem Modul schaltet es ein oder aus. Ein Rechtsklick auf die Zeile tut dasselbe.
- Regler ziehst du mit der Maus. Auswahlfelder wechseln per Klick: links zurück, rechts vor.
- Fährst du mit der Maus über ein Modul oder eine Einstellung, erscheint eine Erklärung.
- Tastenkürzel: Auf das Feld klicken und eine Taste drücken. Esc bricht ab, Entf entfernt das Kürzel. Kürzel wirken nur, wenn kein Menü und kein Chat offen ist.
Module
Diese Module sind im aktuellen Stand enthalten:
| Modul | Kategorie | Beschreibung |
|---|---|---|
| Koordinaten | HUD | Zeigt X, Y, Z, Blickrichtung und optional Biom, Chunk und Nether-Koordinaten an. |
| FPS-Anzeige | HUD | Bilder pro Sekunde, Frametime und Speicherauslastung. |
| Ping-Anzeige | HUD | Latenz zum Server laut Spielerliste. |
| Uhr | HUD | Echte Uhrzeit im 24- oder 12-Stunden-Format. |
| Rüstungsstatus | HUD | Getragene Rüstung und Haltbarkeit auf einen Blick. |
| Geschwindigkeit | HUD | Aktuelle Bewegungsgeschwindigkeit in Blöcken pro Sekunde oder km/h. |
| Spielzeit | HUD | Spieltag, Uhrzeit in der Spielwelt und optional das Wetter. |
| Keystrokes | HUD | Zeigt gedrückte Bewegungs- und Maustasten sowie Klicks pro Sekunde an. |
| Fullbright | Visuell | Erhöht die lokale Helligkeit über den Vanilla-Regler hinaus. |
| Zoom | Visuell | Zoomt das Sichtfeld, solange die Zoom-Taste gehalten wird. |
| Freecam | Visuell | Löst die Kamera vom Spieler und fliegt frei durch die Welt. |
| Scoreboard | Visuell | Blendet die Scoreboard-Seitenleiste oder ihre Punktzahlen aus. |
| Koordinaten kopieren | Werkzeuge | Kopiert die aktuelle Blockposition per Tastenkürzel in die Zwischenablage. |
| Wetterhinweise | Werkzeuge | Benachrichtigt, wenn Regen oder Gewitter beginnt oder endet. |
| Stash Finder | Welt-Scanner | Findet Häufungen von Truhen, Fässern und Shulker-Boxen in geladenen Chunks. |
| Benachrichtigungen | Client | Kurze Hinweise mit einstellbarer Position, Anzahl, Dauer und Ton. |
| Click-GUI | Client | Ingame-Menü mit Kategorien, Suche, Einstellungen und Profilen. |
| Block Notifier | Welt-Scanner | Meldet ausgewählte Blöcke in geladenen Chunks. |
| Spawner Notifier | Welt-Scanner | Meldet Spawner und Prüfungsspawner in geladenen Chunks. |
| Chunk Finder | Welt-Scanner | Findet geladene Chunks anhand konfigurierbarer Block-Kriterien. |
| Block Finder | Welt-Scanner | Sucht und markiert ausgewählte Blöcke in geladenen Chunks, mit Höhenfilter und Farbe je Blocktyp. |
| X-Ray-Ansicht | Welt-Scanner | Hebt ausgewählte Erze in geladenen Chunks als Boxen durch Wände hervor, ohne Grafikoptionen zu ändern. |
| Block ESP | Welt-Scanner | Hebt Spawner, Kolben und Bienenstöcke in geladenen Chunks hervor; die Blockliste ist frei wählbar. |
| Entity ESP | Welt-Scanner | Markiert ausgewählte Entities, die der Client kennt, mit Box, Beschriftung und optional Tracern. |
| Item ESP | Welt-Scanner | Markiert gedroppte Items mit Name und Anzahl. |
| Hole/Tunnel ESP | Welt-Scanner | Markiert 1×1-Löcher, eingeschlossene Lufteinschlüsse und gerade 1×2-Tunnel in geladenen Chunks. |
| Deepslate ESP | Welt-Scanner | Markiert Tiefenschiefer oberhalb der natürlichen Schicht oder seitlich gedreht, meist von Spielern platziert. |
| Light ESP | Welt-Scanner | Markiert Fackeln und Laternen in geladenen Chunks, standardmäßig unter Y 50. |
| Beeren-ESP | Welt-Scanner | Markiert Süßbeerensträucher und Leuchtbeeren in geladenen Chunks, standardmäßig nur erntereife. |
| Player Detection | Welt-Scanner | Zeigt andere Spieler, die der Server an den Client sendet, mit Name und Entfernung, meldet Auftauchen und Verschwinden und merkt sich, wo sie zuletzt gesehen wurden. |
| Tab Detector | Welt-Scanner | Meldet, wer laut Spielerliste (Tab) dem Server beitritt oder ihn verlässt, auch außerhalb der Sichtweite. |
| Makro 1 | Werkzeuge | Eigenes Befehlsmakro mit Wartezeiten, erwarteten Chat-Antworten, Wiederholung und Abbruch. Startet per Tastenkürzel. |
| Makro 2 | Werkzeuge | Eigenes Befehlsmakro mit Wartezeiten, erwarteten Chat-Antworten, Wiederholung und Abbruch. Startet per Tastenkürzel. |
| Makro 3 | Werkzeuge | Eigenes Befehlsmakro mit Wartezeiten, erwarteten Chat-Antworten, Wiederholung und Abbruch. Startet per Tastenkürzel. |
| RTP-Makro | Werkzeuge | Zufälliger Teleport per Tastenkürzel. Vorlage mit /rtp; Befehl und Antwortmuster an den eigenen Server anpassen. |
| TPA-Makro | Werkzeuge | Teleportanfrage an einen eingestellten Spieler per Tastenkürzel. Vorlage mit /tpa; an den eigenen Server anpassen. |
| Home-Makro | Werkzeuge | Teleport zu einem eingestellten Home per Tastenkürzel. Vorlage mit /home; an den eigenen Server anpassen. |
| Auto Tool | Werkzeuge | Wählt beim Abbauen das schnellste Werkzeug aus der Hotbar und wechselt danach zurück. |
| Hotbar Refill | Werkzeuge | Füllt einen leer werdenden Hotbar-Slot mit demselben Item aus dem Inventar auf. |
| Hotbar-Vorlage | Werkzeuge | Sortiert die Hotbar per Tastenkürzel in eine gespeicherte Belegung, mit Items aus dem Inventar. |
| Anti-AFK | Werkzeuge | Springt, schlägt oder dreht sich in festen Abständen, damit der eigene Server nicht wegen Untätigkeit kickt. |
| InvCleaner | Werkzeuge | Wirft ausdrücklich eingetragene Itemtypen aus dem Hauptinventar weg, mit Vorschau und geschützten Gegenständen. |
| AutoArmor | Werkzeuge | Legt bessere Rüstung aus dem Inventar an, mit Schutzbewertung und Haltbarkeitsschutz. |
| Auto Totem | Werkzeuge | Füllt eine leere Nebenhand mit einem Totem aus dem Spielerinventar. |
| Inventory Totem | Werkzeuge | Füllt eine leere Nebenhand nur bei geöffnetem Spielerinventar mit einem Totem. |
| Legit Auto Totem | Werkzeuge | Wechselt nach einstellbarer Reaktionszeit ein Totem in die leere Nebenhand. Keine Zusage zur Erkennbarkeit. |
| Spotify HUD | HUD | Zeigt Titel, Künstler und Fortschritt aus Spotify. Die Windows-Brücke startet automatisch. |
| Synced Lyrics in the Sky | Visuell | Zeigt Spotify-Lyrics im Himmel. Lädt Zeitstempel von LRCLIB oder nutzt eine eigene passende LRC-Datei. |
| Bedrock Hole Finder | Welt-Scanner | Findet Luftlücken in der untersten Bedrock-Schicht oder dem Nether-Dach. Unbekannte Nachbarn bleiben unbewertet. |
| Sus Chunks | Welt-Scanner | Markiert geladene Chunks mit vielen ausgewachsenen Amethyst-Clustern als Aktivitätshinweis. Kein Nachweis einer Basis. |
| Anti D-Tap | Werkzeuge | Trennt nach einem empfangenen Explosions-Schadensereignis die Verbindung. Kein Schutz vor tödlichem Erstschaden oder Combat-Logging-Regeln. |
| Auction-House Sniper · Beobachtung | Werkzeuge | Liest Preisangebote aus einem konfigurierten geöffneten AH-Menü. Käufe, Bestätigung und Verschenken sind noch nicht angebunden. |
| Ely Mace | Werkzeuge | Wechselt per Tastendruck zwischen Elytra und Brustpanzer aus der Hotbar; beim Brustpanzer wird ein Streitkolben ausgewählt. Standardtaste H. |
| Crystal Macro | Werkzeuge | Platziert oder schlägt anvisierte Kristalle bei gehaltener Benutzen-Taste. |
| Shield Breaker | Werkzeuge | Wechselt bei Angriff auf ein blockendes Ziel zu einer Axt in der Hotbar. |
| Skin Changer | Visuell | Ersetzt den Skin des lokalen Spielers durch eine eigene PNG-Textur. Ändert keinen Account-Skin. |
| Custom Capes | Visuell | Zeigt einen eigenen Umhang am lokalen Spieler. Andere Spieler sehen diese Änderung nicht. |
| Tool Skins | Visuell | Verwendet eigene lokale Modelle für Werkzeuge und Schwerter. |
| Butterfly Knife | Visuell | Zeigt Schwerter lokal als Butterfly-Messer mit einer zusätzlichen Schwunganimation. |
| Damage Numbers | Visuell | Zeigt beobachtete Gesundheitsverluste geladener Lebewesen als schwebende Zahlen. |
| Custom Block Break | Visuell | Ergänzt erfolgreich abgebaute Blöcke um ein lokales Partikelmuster. |
| Totem Pop Effect | Visuell | Ergänzt empfangene Totem-Aktivierungen um farbige lokale Partikel. |
| Pearl Prediction | Visuell | Zeigt eine geschätzte Flugbahn geladener Enderperlen bis zur ersten Blockkollision. Entitäten und Serverkorrekturen können abweichen. |
| Custom Fog | Visuell | Färbt den lokalen Nebel mit einer einstellbaren Farbe. |
| Swing Animation | Visuell | Ergänzt die lokale Schwunganimation um eine einstellbare Drehung. |
| Custom Crosshair | Visuell | Ersetzt das normale Fadenkreuz durch ein farbiges Kreuz mit einstellbarer Größe. |
| Hit Particles | Visuell | Zeigt zusätzliche lokale Partikel bei empfangenen Schadensereignissen. |
| Kill Effect | Visuell | Zeigt einen lokalen Effekt, wenn ein kürzlich von dir angegriffenes Ziel stirbt. |
| Wind Burst Effect | Visuell | Ergänzt den Windstoß eines Streitkolbens um lokale Partikel. |
HUD-Elemente werden über Anker (Bildschirmecke) und Abstand X/Y positioniert. Elemente am selben Anker stapeln sich automatisch, statt sich zu überlappen. Bei geöffnetem Debug-Bildschirm (F3) werden Elemente oben links ausgeblendet.
Profile und Konfiguration
Einstellungen werden automatisch alle fünf Sekunden (wenn sich etwas geändert hat), beim Schließen des Menüs und beim Beenden des Spiels gespeichert. Die Dateien liegen im Minecraft-Ordner:
config/ghostclient/
├── client.json aktives Profil
└── profiles/
├── default.json Standardprofil
└── <name>.json weitere Profile- Im Menü unter „Profile“ legst du ein neues Profil aus den aktuellen Einstellungen an, wechselst Profile oder löschst sie.
- „Aktives Profil auf Standard zurücksetzen“ stellt alle Module auf ihre Standardwerte zurück.
- Ist eine Profildatei beschädigt, wird sie als
*.json.corrupt-<Zeitstempel>gesichert und durch Standardwerte ersetzt. Das Spiel stürzt dabei nicht ab. - Ungültige Einzelwerte werden übersprungen, und du bekommst im Spiel eine Benachrichtigung.
- Profilnamen dürfen Buchstaben, Ziffern, „_“ und „-“ enthalten und höchstens 32 Zeichen lang sein.
Server und verfügbare Weltdaten
Scanner und ESP werten die empfangenen Weltdaten aus. Verborgene oder nicht gesendete Blöcke bleiben unbekannt. Freecam bewegt die Kamera; sie erweitert nicht automatisch die vom Server übertragenen Bereiche. Welche Module du nutzen kannst, hängt außerdem von den Regeln und der Konfiguration des jeweiligen Servers ab.
Fehlerbehebung
Das Spiel startet nicht oder meldet fehlende Abhängigkeiten
Prüfe, dass Fabric API im mods-Ordner liegt und Minecraft-Version, Fabric Loader und GhostClient zusammenpassen. Der Fabric-Fehlerdialog nennt die fehlende Abhängigkeit.
Rechts-Shift öffnet das Menü nicht
Eine andere Mod nutzt die Taste vielleicht schon. Belege „GhostClient-Menü öffnen“ in den Steuerungsoptionen neu.
Einstellungen sind weg
Suche im Ordner config/ghostclient/profiles nach Dateien mit der Endung .corrupt-…. Das sind Sicherungen beschädigter Profile. Das Log (logs/latest.log) nennt den Grund.
Weitere Hilfe gibt es auf der Support-Seite.
Galaxy-Menü und Texture-Pack
Das Galaxy-Menü ist bereits integriert. Das optionale Pack gestaltet Himmel, Hotbar, Inventar sowie Herzen und Hungeranzeige im Galaxy-Stil. Es wird mit der Mod ausgeliefert und lässt sich in den Ressourcenpaket-Einstellungen aktivieren.
Stash Finder und Base-Kandidaten
Der Stash Finder wertet geladene Chunks aus. Bekannte Behälter in deiner Nähe werden nachgeprüft; nahe zurückgezogene Behälter bleiben bei erneutem Auftauchen vorübergehend verdächtig. Entladene Chunks sind unbekannt, kein Fake-Beweis.
Die Beschriftungen „unbestätigt“, „mehrfach beobachtet“ und „verdächtige Daten“ beschreiben Beobachtungen. Es gibt keine Bewertung wiederkehrender Bauweisen. Base-Kandidaten können im gesamten geladenen Suchbereich nach mehrfacher Beobachtung und standardmäßig 20 Sekunden unveränderten Daten mit Ton gemeldet werden. Globale Benachrichtigungen müssen aktiviert sein. Ein Kandidat ist kein Nachweis einer echten Base.
Profile und Panic-Taste
Profile speichern deine Modul-Einstellungen lokal. Du kannst ein Profil exportieren und als Sicherung aufbewahren. Die konfigurierbare Panic-Taste deaktiviert aktive Module; prüfe deine Belegung in den Minecraft-Steuerungsoptionen.
Weitere Hilfe
Für Installation und Bedienung ist diese Anleitung der zentrale Einstieg. Bei Problemen hilft die Support-Seite.