Horizon Dispatch Docs 0.7.4

Die ganze Plattform.
Eine Dokumentation.

Erstelle und führe deine VTC, richte den Discord-Bot ein, installiere den Tracker, verstehe die Zertifizierung, den Anti-Cheat und die Wachstumswerkzeuge: ganz Horizon Dispatch, Schritt für Schritt erklärt.

VTC & Discord Tracker ETS2 / ATS Vertrauen & Sicherheit API & Integrationen
Erste SchritteStart und Konto
Erste Schritte

Dein Fahrerkonto

Dashboard → Mein Profil enthält alles, was dich als Fahrer betrifft, unabhängig von deiner VTC. Dein öffentliches Profil findest du unter /drivers/<deine Discord-ID>.

Level, Titel und Erfolge

Jede Lieferung bringt Erfahrung: 1 XP pro km, 100 XP pro Lieferung und 500 XP pro Erfolgspunkt. Das nächste Level erfordert 4.000 XP, danach 2.000 XP mehr pro Level.

Titel: 🔰 Lehrling (Lvl 1), 🚚 Fahrer (5), 🛣️ Trucker (10), 📦 Erfahrener Trucker (18), 🚛 Fernfahrer (28), 🎖️ Veteran (40), 👑 Meister der Straße (55), 🌟 Legende (75). Freigeschaltete Abzeichen und Erfolge erscheinen auf deinem Profil, zusammen mit dem nächsten Erfolg, den du anpeilen kannst.

Verknüpfte Konten: Discord, Steam, TruckersMP

  • Discord: dein Anmeldekonto.
  • Steam: Schaltfläche Über Steam anmelden. Die Anmeldung läuft über die offizielle Steam-Seite: Niemand kann dein Steam an deiner Stelle verknüpfen. Ein Steam-Konto kann nur mit einem einzigen Discord-Konto verknüpft werden.
  • TruckersMP: wird automatisch verknüpft und als verifiziert markiert, sobald dein Steam verbunden ist. Andernfalls erstellt /link truckersmp auf Discord eine einfache (nicht verifizierte) Verknüpfung; eine über Steam verifizierte Verknüpfung hat immer Vorrang.

Du kannst Steam in deinem öffentlichen Profil ausblenden oder die Verknüpfung jederzeit trennen. Wenn du Steam verbindest, wird dir außerdem der Verlauf zugeordnet, den deine VTC bei einer Migration importiert hat.

Haupt-VTC und Zug-VTC

Wenn du zu zwei VTCs gehörst, wählst du unter Mein Profil, welche deine Haupt-VTC ist: Sie erhält 100 % deiner Lieferungen. Die zweite, die Zug-VTC, erhält zusätzlich eine Kopie jeder Lieferung zu 75 % (km, Einnahmen).

Gehalt und Kontostand

Jede Lieferung zahlt einen Teil ihrer Einnahmen in deine Geldbörse bei deiner Haupt-VTC ein (standardmäßig 30 %, von der VTC festgelegt). Mein Profil zeigt deinen Kontostand, deinen Prozentsatz und deine letzten 6 Transaktionen. Prämien und Auszahlungen verwaltet das Team der VTC.

Stream-Overlay (OBS)

Klicke auf Meinen Overlay-Link erzeugen, um eine Adresse /overlay/<token> zu erhalten, die du in OBS als „Browserquelle“ hinzufügst. Sie zeigt deine VTC, dein Level, die Fahrt, die Fracht, die Geschwindigkeit und den Fortschritt an und wird alle 3 Sekunden aktualisiert, solange die App läuft.

  • Optionen: ?theme=light und ?accent=ff8800.
  • Wenn du den Link neu erzeugst, wird der alte deaktiviert (praktisch, falls er weitergegeben wurde).

Anpassung und Supporter

  • Avatar (8 MB) und Banner (16 MB), oder zurück zu denen von Discord.
  • Bio (400 Zeichen), Akzentfarbe und Netzwerke: YouTube, Twitch, X, TikTok, Instagram, Steam, Discord, Website.
  • Supporter-Profilstudio (aktive monatliche Unterstützung oder dauerhafte Supporter-Rolle): Stil (klassisch, Glas, Sonnenuntergang, Neon, minimal), Rahmen, Muster, Layout, Deckkraft, Unschärfe, Leuchten, Status mit Emoji, 4 hervorgehobene Statistiken und 3 hervorgehobene Abzeichen. Siehe Premium & Boosts.

Eine VTC verlassen

Schaltfläche VTC verlassen im Banner der VTC (Grund optional). Der Gründer kann nicht austreten: Er muss zuerst das Eigentum übertragen (Einstellungen → Gefahrenzone). Nach dem Austritt musst du 12 Stunden warten, bevor du eine VTC erstellen oder einer beitreten kannst.

VTC-DashboardDeine VTC im Alltag verwalten
VTC-Dashboard

Mitglieder und Rekrutierung

Die Seite Mitglieder listet deine Fahrer mit Suche und Filtern (Rolle, Rang, Stufe). Jeder kann sie lesen; Aktionen erfordern die Berechtigung „Mitglieder verwalten“.

  • Ein Mitglied per Discord-ID hinzufügen, als Fahrer oder Manager. Die Standardrolle wird zugewiesen. Das Hinzufügen schlägt fehl, wenn die VTC voll ist oder die Person bereits in 2 VTCs ist.
  • Jemanden zum Manager machen gibt alle Rechte: Behalte das für Vertrauenspersonen vor.
  • Bis zu 5 Rollen pro Mitglied zuweisen.
  • Ein Mitglied entfernen, mit optionalem Grund.
  • Sehen, welche App-Version jeder Fahrer nutzt.
Ein Mitglied, das den Discord-Server der VTC verlässt, wird „inaktiv“; es wird nicht entfernt.

Fahrerkarte

  • Statistiken des Fahrers, Fortschritt beim Rang und Abzeichen.
  • Gehalt und Guthaben: „Prämie auszahlen“ (aus der VTC-Kasse bezahlt, der Fahrer erhält eine DM) und „Auszahlung“.
  • Disziplinarverlauf: Notiz, Verwarnung oder Sanktion, mit Grund (500 Zeichen).

Rekrutierungszentrale

Bewerbungen, die über deine öffentliche Seite gesendet werden, landen unter Bewerbungen (Berechtigung „Rekrutierung verwalten“), mit einem Badge im Menü und einer Push-Benachrichtigung an die Manager.

1 Neu2 Vorauswahl3 Gespräch4 Probezeit5 Angenommen oder abgelehnt
  • Zähler: gesamt, in Bearbeitung, Gespräche, Probezeiten, angenommen, abgelehnt.
  • Einen Verantwortlichen zuweisen (Gründer oder Manager) und interne Notizen schreiben (1.200 Zeichen).
  • Annehmen legt das Mitglied an (wenn die VTC Platz hat, die Person nicht in 2 VTCs ist und sich nicht in ihrer 12-Stunden-Wartezeit befindet) und postet die konfigurierte Discord-Nachricht.

Das Bewerbungsformular fragt nach: Erfahrung, Verfügbarkeit, Motivation (Pflicht), bevorzugtem Spiel, Zeitzone, vorheriger VTC, TruckersMP-Profil und Konvoi-Erfahrung.

VTC-Dashboard

Rollen, Ränge und Divisionen

Drei getrennte Systeme, die zusammenarbeiten:

SystemWofürVergabe
RollenBerechtigungen im Dashboard vergebenVon Hand, bis zu 5 pro Mitglied
Rank up (Ränge)Gefahrene Kilometer belohnenAutomatisch, nach gelieferten km
DivisionenFahrer spezialisieren (Tanker, Schwertransport…)Vom Fahrer in der App gewählt

Rollen

Berechtigung „Rollen verwalten“. Jede Rolle hat einen Namen (40 Zeichen), eine Farbe und eine Auswahl aus den 13 Berechtigungen. Ziehe die Rollen, um sie zu ordnen. Die Standardrolle (die neue Mitglieder erhalten) kann nicht gelöscht werden. Die Anzahl der Rollen hängt von den Boosts ab (5 bis 30, siehe Premium & Boosts).

Rank up

Jeder Rang hat einen Namen, die erforderlichen km, eine Farbe und optional eine Discord-Rolle. Nur gelieferte km zählen. Nach jeder Lieferung (oder mit Neu synchronisieren) erhält der Fahrer die Discord-Rolle seines Rangs, alte Rollen werden entfernt und eine Nachricht geht in den Kanal „rank“. Der Bot muss auf dem Server der VTC sein.

Divisionen

  • Aktiviere „Divisionen in der App aktivieren“ und wähle dann den Modus: nur eine Division pro Fahrer oder mehrere kombinierbar.
  • Bis zu 10 Divisionen, jede mit Name, Beschreibung, Bild, Farbe, Liste von Lkw und Anhängern sowie einer Discord-Rolle.
  • Die Fahrer wählen ihre Division in der App und erhalten die passende Discord-Rolle.
VTC-Dashboard

Statistiken, Fahrten und Protokoll

Jedes Mitglied kann diese Seiten lesen.

Statistiken

  • Leistung dieses Monats im Vergleich zum Vormonat, tägliche Aktivität, Top-Fahrer des Monats.
  • Distanz pro Fahrer, Rollenverteilung, Entwicklung über 12 Wochen, Aktivitäts-Heatmap, Lieblingsrouten und -fracht, Lieferungen nach Land, inaktive Fahrer (keine Lieferung seit 14 Tagen).
  • Monatsziele: eines pro Kennzahl und Monat (Berechtigung Einstellungen).
  • Manuelle Eingabe von Statistiken (Berechtigung „Statistiken bearbeiten“).

Fahrten

Die letzten 120 Lieferungen mit eingehaltener oder geänderter Route, Schaden, Höchstgeschwindigkeit, Geschwindigkeitsverstößen und Parken. Vom Anti-Cheat zurückgestellte Lieferungen bleiben sichtbar, markiert mit „🚫 In Prüfung“, „⚠️ Fahrer verwarnt“ oder „Betrug bestätigt“ und dem Hinweis „Nicht in den Statistiken gezählt“.

Duplikate bereinigen („Statistiken bearbeiten“) entfernt identische Lieferungen, die im Abstand von weniger als 6 Stunden erfasst wurden.

Operations

Das Live-Kontrollzentrum: Fahrer online, im Auftrag und offline, heutige km und Lieferungen, heutige Einnahmen, Live-Karte und Aktivitäts-Feed. Ein Fahrer ist „online“, wenn sich seine App vor weniger als 60 Sekunden gemeldet hat; die Seite aktualisiert sich alle 5 Sekunden.

Aktivitätsprotokoll

Berechtigung „Aktivitätsprotokoll ansehen“. Zeigt die letzten 100 Aktionen der VTC: Ein- und Austritte, Rollenänderungen, Events, Einstellungen, Empfehlungen… Es gibt keinen Export.

VTC-Dashboard

Events und Konvois

Der Tab Events (auch das Ansehen) wird mit 2 Boosts freigeschaltet. Erstellen oder Bearbeiten erfordert die Berechtigung „Events verwalten“.

  • Titel, Markdown-Beschreibung, Kategorie (Konvoi, Treffen, Training, Rennen, offiziell, sonstiges), Spiel, Server, Sprache, Banner, Farbe.
  • Start und Ziel, bis zu 20 Wegpunkte, geplante km, Karten-DLC, Treffpunkt- und Abfahrtszeiten.
  • Regeln, Sprachkanal, vorgeschriebene Lackierung, maximale Teilnehmerzahl (0 = unbegrenzt), bis zu 200 Konvoi-Plätze (standardmäßig 20).
  • Von TruckersMP importieren: Füge einen Link oder eine ID eines TruckersMP-Events ein, um das Formular vorauszufüllen.
  • „Auf der öffentlichen Seite sichtbar“ zeigt es auf /vtcs/deine-vtc und /events; sonst bleibt es den Mitgliedern vorbehalten.

Beim Erstellen: eine Discord-Nachricht im Kanal „events“ und eine Push-Benachrichtigung an die Mitglieder. Die Schaltfläche Erneut benachrichtigen sendet beides noch einmal. Die Fahrer melden sich über die Website oder die App an („Ich bin dabei“ oder „Vielleicht“); die App erinnert sie 30 Min. und 10 Min. vorher sowie zur Abfahrtszeit. Jedes öffentliche Event lässt sich außerdem als Kalenderdatei (.ics) herunterladen.

VTC-Dashboard

Ankündigungen, Galerie und Partnerschaften

Ankündigungen (4 Boosts)

Titel (140 Zeichen), Markdown-Inhalt (6.000), Titelbild, angeheftet, veröffentlicht oder Entwurf, auf der öffentlichen Seite sichtbar. Eine veröffentlichte Ankündigung geht an Discord, als Push-Benachrichtigung und in die Glocke der App. „Erneut benachrichtigen“ funktioniert nur bei einer veröffentlichten Ankündigung. Mitglieder ohne Staff-Status sehen nur veröffentlichte Ankündigungen.

Partnerschaften

Berechtigung „Partnerschaften verwalten“. Das Senden einer Anfrage erfordert 4 Boosts und richtet sich an eine öffentliche VTC (über ihre Kennung). Annehmen, Ablehnen oder Entfernen einer Partnerschaft geht ohne Boosts. Angenommene Partnerschaften erscheinen auf den öffentlichen Seiten und in der App.

VTC-Dashboard

Fuhrpark und Wirtschaft

Zwei Wirtschaftssysteme laufen parallel:

WährungGespeist durch
Gehälter und KasseEinnahmen im Spiel (€ / $)Jede Lieferung: Ein Anteil (standardmäßig 30 %, einstellbar von 0 bis 100 %) geht in die Geldbörse des Fahrers, der Rest in die VTC-Kasse.
FuhrparkHorizon-Credits (◈ CH)150.000 CH zum Start, dann pro Lieferung: km × 12 + 5 % der Einnahmen, gemindert durch Schäden und Geschwindigkeitsverstöße.

Fuhrpark

Für alle lesbar; Aktionen erfordern „Flotte verwalten“. Bis zu 50 Lkw und 50 Anhänger werden angezeigt.

  • Einen Fahrer zuweisen, einen Haupt-Lkw festlegen (er erhält die Lieferungen, wenn kein Lkw passt), umbenennen, das Kennzeichen eintragen (16 Zeichen).
  • Lkw-Wartungen: allgemein alle 45.000 km (2.500 CH), Motor alle 150.000 km (9.000 CH), Reifen alle 175.000 km (6.000 CH).
  • Austausch von Bauteilen: Motor 25.000, Getriebe 18.000, Reifen 8.000, Fahrgestell 12.000 CH. Ein Bauteil ist ab 20 % Verschleiß kritisch.
  • Anhänger: allgemein alle 60.000 km (1.800 CH), Reifen alle 150.000 km (4.200 CH); Austausch Reifen 6.000, Bremsen 7.000, Fahrgestell 9.000 CH.
  • Wiederverkauf: etwa 85 % des Preises, abzüglich Wertverlust durch km und Verschleiß.
  • Kritischer Verschleiß und überfällige Wartungen werden auf Discord gemeldet. Die App kann die echten Lkw aus deinem Spielstand importieren.

Autohaus

Katalog mit neuen Lkw und Anhängern für ETS2 und ATS (einschließlich generischer, mod-kompatibler Modelle) und ein Gebrauchtmarkt mit 6 Angeboten, die täglich erneuert werden. Der Kauf schlägt fehl, wenn das Credit-Guthaben zu niedrig ist.

Mechaniker

Bis zu 6 Mechaniker, jeder mit einem Tempo von 1 bis 5 und einer Spezialität (Universal, allgemein, Motor, Getriebe, Reifen, Fahrgestell, Bremsen). Ein Mechaniker mit passender Spezialität senkt die Kosten um 15 %, plus 3 % pro Stufe, bis maximal 50 %. Arbeiten halten den Lkw von der Straße fern (allgemein 30 Min., Motor 2 Std., Reifen 1 Std., Austausch 3 Std., verkürzt durch das Tempo des Mechanikers). Ohne Mechaniker sind Arbeiten sofort erledigt.

Jeder Mechaniker wird jede Woche bezahlt, aus den Fuhrpark-Credits (von 1.200 CH pro Woche bei Tempo 1 bis 4.800 CH bei Tempo 5, +35 % für einen Universal-Mechaniker). Reichen die Credits nicht, kündigt er, und das Protokoll der VTC vermerkt es.

VTC-Dashboard

VTC-Website

Nicht zu verwechseln mit der öffentlichen Seite /vtcs/deine-vtc (immer verfügbar): Die Webseite ist eine eigene, vollständige Website, veröffentlicht unter /vtcs/deine-vtc/site. Sie erfordert 5 Boosts und die Berechtigung Einstellungen, dann den Schalter „Seite veröffentlichen“.

  • Aussehen: 6 Themen (Horizon, Ozean, Wald, Neon-Violett, Karmesinrot, Reines Gold), 6 Schriftarten, Ecken, Abstand, Hero-Höhe, Hintergrund, Button-Stil, Akzentfarbe.
  • 18 Module zum Anordnen: Hero, Über uns, Statistiken, Mitglieder, Rangliste, Fuhrpark, Galerie, Video, FAQ, Aufruf-Banner, Rekrutierung, Events, Ankündigungen, Partner, Unterstützung, Kontakt, Netzwerke, freier Text.
  • Pro Abschnitt: Hintergrund, Hintergrundbild, Ausrichtung und Spalten.
  • Empfangene Nachrichten: die letzten 50 Nachrichten aus dem Kontakt-Modul, die auch in den Discord-Kanal „contact“ gesendet werden.

Die normale öffentliche Seite wird in den Einstellungen angepasst (Thema und Banner der Seite ab 2 Boosts).

VTC-Dashboard

VTC-Einstellungen

Berechtigung „Einstellungen verwalten“, sofern nicht anders angegeben.

TabEinstellungen
IdentitätName (40 Zeichen, ändert auch die Adresse), Beschreibung (2.000), Logo (URL oder Upload, 2 MB), Banner (2 Boosts, 5 MB), Thema der öffentlichen Seite (2 Boosts), Farbe, Spiel, Land.
Rekrutierung & SichtbarkeitRekrutierung offen, im Verzeichnis sichtbar, Standardrolle (mit „Auf Mitglieder ohne Rang anwenden“).
Tracker & DiscordTag (8 Zeichen), Geschwindigkeitsbegrenzung, Einnahmen öffentlich sichtbar, Lieferungen-Kanal, Lieferungs-Webhook (HTTPS), Fahrergehalt (%), Ankündigungen-Kanal, Galerie-Kanal.
PlattformenIDs für TruckersMP, Trucky und TrucksHub.
Links8 soziale Netzwerke.
TeamManager hinzufügen oder entfernen (Berechtigung Mitglieder).
Mitglieder-OnboardingOnboarding-Checkliste mit bis zu 20 Schritten, die neuen Mitgliedern angezeigt wird.
APIÖffentliche API und Widgets ein- oder ausschalten, Mitgliederliste freigeben (kostenlos). Öffentlicher API-v1-Schlüssel pk_… ab 5 Boosts (nur der Gründer kann ihn neu erzeugen). Siehe Entwickler.
GefahrenzoneNur für den Gründer: Eigentum übertragen (der bisherige Gründer wird Manager) oder die VTC löschen, indem du ihren Namen eintippst.
Der Lieferungen-Kanal erhält auch abgebrochene Fahrten, vom Anti-Cheat blockierte Lieferungen und Fuhrpark-Warnungen. Der Lieferungs-Webhook sendet jede Lieferung an eine HTTPS-URL deiner Wahl (im Discord-Format, wenn es ein Discord-Webhook ist).
VTC-Dashboard

Ökosystem

Die Seite Ecosystem der VTC, ohne Boost, offen für den Staff (beliebige Berechtigung):

  • Horizon Network: ein öffentliches oder privates Netzwerk von VTCs erstellen oder einem per Code beitreten.
  • Konvoi-Operationen mit Checkpoints und Status.
  • VTC-gegen-VTC-Challenges, kooperativ oder im direkten Duell.
  • Gemeinsame Verträge zwischen VTCs.
  • Verifizierte Fähigkeiten: Zertifizierungen und Auszeichnungen für Fahrer.
  • Event-Synchronisierung zwischen Plattformen (Discord verfügbar, weitere in Arbeit).
  • OAuth-App „Horizon Connect“ (das Secret wird nur einmal angezeigt) und Webhooks (HTTPS, nur an öffentliche Adressen). Siehe Entwickler.
  • Marktplatz: Jedes Mitglied kann eine Anzeige veröffentlichen, sichtbar auf /ecosystem/marketplace.
Discord-BotServer, Kanäle, Tickets, Befehle
Discord-Bot

Kanäle und Nachrichten der VTC

Zwei Seiten steuern, was der Bot für deine VTC postet (Berechtigung Einstellungen):

WoWas
Einstellungen → Tracker & DiscordLieferungen-Kanal, Ankündigungen-Kanal, Galerie-Kanal, Lieferungs-Webhook.
Deine VTC → DiscordServer-ID, 7 eigene Kanäle (Standard, Ankündigungen, Events, neue Bewerbungen, Entscheidungen zu Bewerbungen, Rang, Kontakt) und 8 Nachrichtentypen.

Für jeden Nachrichtentyp (Ankündigung, Event, Bewerbung erhalten, Bewerbung angenommen, abgelehnt, Beförderung, Degradierung, Kontakt über die Website): an oder aus, Farbe, Titel, Text mit Variablen, bis zu 10 zu erwähnende Rollen, „Die betroffene Person erwähnen“ und eine Schaltfläche Test senden. Ohne eigenen Kanal nutzt der Bot den Standardkanal, danach den Ankündigungen-Kanal.

Was der Lieferungen-Kanal postet

  • Jede Lieferung: Route, Firmen, km (und Umweg), Einnahmen, €/km, Lkw, Spiel, Markt (Standard oder World of Trucks), Schaden, Höchstgeschwindigkeit, Geschwindigkeitsverstöße, Parken, Fahrbewertung, Level-Fortschritt, Schaltfläche „Lieferung ansehen“.
  • „⛔ Unvollständige Fahrt“, wenn eine Lieferung nicht ab ihrem Start erfasst wurde (Statistiken blockiert).
  • „Lieferung blockiert“, wenn der Anti-Cheat sie zurückstellt.
  • Verschleiß- und Wartungswarnungen aus dem Fuhrpark.

Weitere automatische Nachrichten

  • Wochenbericht jeden Montag.
  • Der Level-Aufstieg eines Fahrers (plus eine DM an den Fahrer).
  • Rang (Rank up) im Kanal „rank“, mit aktualisierter Discord-Rolle.
  • Ankündigungen (4 Boosts) und Events (2 Boosts), die im Dashboard veröffentlicht werden.
  • Eine Verwarnung durch das Anti-Cheat-Team: DM an den Fahrer und eine Nachricht im Ankündigungen-Kanal.
Discord-Bot

Bot-Konfiguration: Server-Systeme

Bot-Konfiguration → wähle einen Server. Diese Einstellungen gelten für den Discord-Server, nicht für die VTC, und benötigen keinen Boost.

SystemFunktion
👋 WillkommensnachrichtWillkommenskarte im gewählten Kanal, optionales Bild und eine automatische Rolle (wird auch vergeben, wenn die Nachricht ausgeschaltet ist). Variablen: {user}, {username}, {server}, {count}.
🙋 AbschiedsnachrichtNachricht, wenn ein Mitglied den Server verlässt. Variablen: {username}, {server}, {count}.
🎭 ReaktionsrollenPanel mit Buttons, die eine Rolle geben oder entfernen: Titel, Beschreibung, bis zu 25 Rollen mit Emoji. Wird das Panel gelöscht, verschwindet auch die Discord-Nachricht.
📢 EmbedEine Bot-Nachricht posten oder bearbeiten: klassisches Embed oder Components V2, Titel, Text (4.000), Farbe, Bild, Fußzeile, bis zu 5 Link-Buttons.
🔔 Horizon-Dispatch-BenachrichtigungenKanäle, die die offiziellen Ankündigungen von Horizon Dispatch erhalten (Updates, Wartungsarbeiten).
📋 Server-Logs8 Kategorien zum Ankreuzen: Mitglieder, Nachrichten, Rollen, Kanäle, Sanktionen, Sprachkanäle, Server, VTC. Der Urheber einer Aktion wird über das Audit-Log des Servers ermittelt.
🟢 Live-KonvoistatusEine Nachricht, die alle 90 s mit den Fahrern der VTC auf der Straße aktualisiert wird (bis zu 25). Die VTC muss mit diesem Server verknüpft sein.
🔢 MitgliederzählerBenennt alle 10 Minuten Sprachkanäle in Zähler um (Mitglieder, online, Bots, Boosts).
🚛 TruckersMP-RelaisPostet alle 10 Minuten die News, Events und Partner deiner TruckersMP-VTC (ID einzutragen) erneut.
Befehle funktionieren nur auf einem Server (nicht in DMs). Du kannst jeden Befehl unter Servereinstellungen → Integrationen auf bestimmte Rollen oder Kanäle beschränken.
Discord-Bot

Tickets

Deine VTC → Tickets (Berechtigung „Tickets verwalten“, kein Boost). Erstelle so viele Panels, wie du möchtest (Support, Rekrutierung, Partnerschaften…).

  • Pro Panel: Name, Farbe, Panel-Kanal, Ticket-Kategorie, Support-Rolle, Namensformat (ticket-{user}), Titel und Text des Panels, Text, Emoji und Stil des Buttons, Willkommensnachricht, Beschriftung zum Schließen, Erwähnung der Support-Rolle.
  • Bereitstellen postet das Panel auf Discord (der Bot muss online sein).
  • Jedes Mitglied kann pro Panel ein offenes Ticket haben. Der private Kanal ist für das Mitglied, die Support-Rolle und den Bot sichtbar.
  • Jeder im Ticket kann es schließen; der Kanal wird dann nach ein paar Sekunden gelöscht, ohne Transkript.
Discord-Bot

Slash-Befehle

Übersetzte Befehle (/vtc, /truckersmp, /aide, Server und Moderation) antworten in der Sprache, die mit /langue für den Server festgelegt wurde, sonst in der Discord-Sprache des jeweiligen Mitglieds (Französisch, Englisch, Deutsch, Türkisch, Spanisch, Italienisch, Polnisch, Niederländisch). Die übrigen antworten auf Französisch. Eine Kurzliste gibt es auch unter /commands.

VTCs und Fahrer

BefehlZweck
/vtc register nom jeuDeine VTC erstellen und mit diesem Server verknüpfen.
/vtc info · /vtc membersKarte und Mitglieder deiner VTC.
/vtc public nomDie öffentliche Karte einer VTC.
/vtc setplatformDie TruckersMP-, Trucky- oder TrucksHub-ID festlegen (Gründer, Manager oder Server verwalten).
/driver join · leave · profileDer VTC des Servers beitreten (Rekrutierung offen), sie verlassen, ein Profil ansehen (Rang, Status, Statistiken, letzte 3 Lieferungen, TruckersMP).
/leaderboard critere periodeDie Top 10 der VTC nach Distanz, Lieferungen oder Einnahmen, für die Woche, den Monat oder insgesamt.
/live globalFahrer, die gerade unterwegs sind (deine VTC oder die ganze Plattform).
/statsStatistiken der VTC des Servers: live, Woche, gesamt, Mitglieder, Top der Woche, Lieblingsroute und -fracht.
/link truckersmp id · show · removeDein TruckersMP-Konto verknüpfen (ein TruckersMP-Konto kann nur mit einem einzigen Discord-Konto verknüpft werden).

TruckersMP

BefehlZweck
/joueur idDie Karte eines TruckersMP-Spielers.
/bans idDie letzten 5 Bans eines Spielers.
/serveursTabelle der TruckersMP-Server.
/truckersmp servers · player · companyTruckersMP-Server, -Spieler oder -VTC.
/events id salonEin TruckersMP-Event oder die nächsten 6; mit salon wird das Ergebnis dort gepostet.
/vtcinfos info · events · membres · partenariats · newsInformationen über eine TruckersMP-VTC (Mitglieder Seite für Seite).
/traffic jeu serveurVerkehrsbereiche auf den TruckersMP-Servern (Daten von Trucky).

Server und Moderation

BefehlZweck
/accueil bienvenue · aurevoirWillkommens- und Abschiedsnachrichten direkt in Discord einrichten (Server verwalten).
/roles-react panneau · ajouter · retirerPanels mit Rollen-Buttons (Rollen verwalten).
/role ajouter · retirerEine Rolle geben oder entfernen (Rollen verwalten).
/clear nombre membre1 bis 100 Nachrichten löschen, die jünger als 14 Tage sind (Nachrichten verwalten).
/say salonDen Bot sprechen lassen, als Text oder Embed (Nachrichten verwalten).
/sondageNative Discord-Umfrage: 2 bis 6 Optionen, von 1 Stunde bis 14 Tage, Mehrfachauswahl möglich.
/alertes configurer · supprimerKanäle für Horizon-Dispatch-Benachrichtigungen (Server verwalten).
/langueDie Sprache des Bots auf diesem Server oder „Automatisch“ für die Sprache jedes Mitglieds (Server verwalten). Gilt auch für Willkommens- und Abschiedsnachrichten.
/vtcs ajouter · infos · liste · vérifier · supprimerDie Links der VTC auf TruckersMP, Trucky, TruckersHub oder VTLog, spezifisch für diesen Server (Administrator).
/avatar · /userinfo · /serverinfoAvatar, Mitgliederkarte, Serverkarte.

Hilfe

BefehlZweck
/aideHilfemenü nach Kategorien.
/info bot · serveur · system · vtcInformationen über den Bot, den Server, den Dienststatus und die Plattform.
/rapport-bugEinen Fehler an das Team melden (Bereich, Schweregrad, Beschreibung). Du erhältst bei jeder Statusänderung eine DM.
Public websiteDirectory, map, community
Public website

Directory and VTC pages

The directory lists public VTCs (hidden and blacklisted VTCs are not shown). Search by name, tag or description; filter by game and "recruiting"; sort by members, kilometres, age, name or rating; 24 VTCs per page. VTCs with 10 boosts (or Premium granted by the team) are featured at the top.

A VTC's public page

/vtcs/your-vtc presents the VTC: certification badge, awards (Seasons, referral), boosts, Apply button, "Official site" link if the website is published.

  • The current month: km, deliveries, income and active drivers, compared with last month.
  • Drivers online, monthly goals, grades, 12-week activity chart.
  • Driver of the month (podium of the month's deliveries) and the VTC's records: longest delivery, best-paid delivery, top speed.
  • Announcements, galleries, events, partners, member list and reviews.
  • Each delivery has its own page (/vtcs/your-vtc/deliveries/…) with the route map; income only shows if the VTC makes it public.

Apply

Signed in with Discord, open Apply on the page of a VTC that is recruiting. The application is refused if you are already a member, already in 2 VTCs, left a VTC less than 12 hours ago, or already have a pending application. The VTC is notified on Discord and by push notification.

Reviews

Any signed-in user can leave a 1 to 5 star review with a comment (1,000 characters), one per VTC (sending it again edits it). The author, the VTC's managers and the team can delete it.

Public website

Live map

The live map shows drivers whose app sent a position within the last minute (500 at most). It refreshes every 4 seconds.

  • ETS2 / ATS switch, search (driver, VTC, city, server), "All" or "On a job" filter, sort (activity, server, VTC, name, speed).
  • Scope All members or VTC members (signed in and member of a VTC).
  • Server chips: All, TruckersMP, Solo, Not detected, then each official TruckersMP server with Horizon Dispatch and TruckersMP player counts.
  • Cities and ferries layer, "Show all" and "Center on me" buttons.
  • Driver card: game, VTC, tag and grade, TruckersMP server or solo, cities and companies, cargo, truck, trailer, speed and progress.

Useful addresses

  • /map?scope=vtc: your VTC only.
  • /map?server=tmp, solo, unknown or a TruckersMP server ID.
  • /map?game=ats: open on ATS.
  • /map?embed=1: without the sidebar, to embed in a site (see also the Mini live map widget).
The TruckersMP server is detected by the app automatically (see TruckersMP). Your position is only published while the app is open and the game connected.
Public website

Community

Driver leaderboard

/leaderboard: top 50 drivers and top 15 VTCs, in real km, job km or World of Trucks km, plus the best levels, salaries and treasuries. The VTC ranking by country and period is on /rankings.

Weekly challenge

/challenges: one challenge per week, in rotation: 2,500 km, 15 deliveries, 10 deliveries without damage, €250,000 income, 3 night deliveries (10 pm - 6 am) or 3 trips of at least 800 km. Top 10 and your progress.

Quarterly driver leagues

/season ranks drivers by their km in the quarter: Rookie, Bronze (500 km), Silver (4,000), Gold (12,000), Diamond (30,000), Legend (75,000). Not to be confused with HDispatch Seasons, the monthly competition between VTCs.

News, events and feed

  • /news: Horizon Dispatch news, with 6 reactions and comments (500 characters) for signed-in users.
  • /vtc-news: latest public announcements from VTCs.
  • /events: upcoming public events, filter by game and search; each event has its page with sign-up, convoy slots and a calendar file (.ics).
  • /feed: the community feed (new VTCs, arrivals, long trips, events, announcements, partnerships).

Other pages

  • /avis: reviews of Horizon Dispatch, posted from the Discord forum.
  • /servers: status of the TruckersMP, TruckLineMP and HaulMP servers.
  • /status: Horizon Dispatch service status (website, bot, database, API…).
  • /team, /features, /commands, /contact and the legal pages.
Public website

Public profiles

  • /drivers/<Discord ID>: rank (km among public VTCs), level, badges and achievements with their rarity, challenge and league, main and traction VTC, last 10 deliveries. Customisation (colour, banner, bio, socials) shows for active supporters. The main VTC must be public.
  • /passport/<Discord ID>: the Horizon Dispatch passport (validated deliveries, VTCs, public skill certifications).
  • Every profile, VTC and ranking has a preview image for shares on Discord and social networks.
Public website

Languages and notifications

  • The website is available in French, English, German, Turkish, Spanish, Italian, Polish and Dutch. The language follows your choice (language menu, remembered for 6 months), otherwise your Discord or browser language.
  • Push notifications: allow them in your browser to hear about applications (managers), new convoys and your VTCs' announcements. The site can also be installed as an app (PWA).
  • The session stays open for 7 days. Sign out from the account menu.
Growth & integrationsWidgets, API, rankings, Seasons
Growth & integrations

Widgets for your website

Show your VTC's activity on your own website, forum or Carrd page, with no server code. Widgets update on their own and use your VTC's colour. The ready-to-copy codes are in Dashboard → your VTC → Integrations ("Settings" permission).

WidgetTypeContent
Members onlineonlineWho is driving right now, with cargo and route. Refreshed every 30 s.
Latest tripsjobsThe latest deliveries, with a link to each trip.
Kilometres this monthkmMonth counter, deliveries, active drivers and progression.
Next eventeventThe next convoy with a countdown and a "Join" button.
RecruitmentrecruitRecruitment open or closed, with an "Apply" button.
Full cardcardAll in one: online, month km, members, next event, recruitment.
Mini live mapmapThe VTC's drivers on the map, live.

Embed a widget

Recommended: the script. The height adapts to the content automatically.

<div class="hd-widget" data-vtc="my-vtc" data-type="online"></div>
<script src="https://hdispatch.eu/widgets/embed.js" async></script>

Without a script (Carrd, Notion, forums): a plain iframe.

<iframe src="https://hdispatch.eu/widgets/vtc/my-vtc/card" width="100%" height="280" frameborder="0"></iframe>

Options (in the URL or as data-* attributes)

  • theme: dark (default), light or auto (follows the visitor's theme).
  • accent: hexadecimal colour, e.g. ff8800 (your VTC's colour by default).
  • lang: widget language (fr, en, de, es, it, nl, pl, tr…). Defaults to the visitor's browser language.
  • limit: number of rows shown, from 1 to 15 (5 by default).
  • header=0: hides the header with the VTC name.
Widgets only show what your public page already shows. If your VTC is private or the public API is turned off, they show a message instead.
Growth & integrations

Public API (no key)

Every public VTC exposes its statistics as JSON, with no key and no sign-up: ideal for a home-made Discord bot, a website or a dashboard. Responses are read-only, open to other sites (CORS) and cached for a few dozen seconds.

EndpointContent
GET /api/vtc/:slug or /statsOverview: name, tag, game, country, members, kilometres (total and month), deliveries, online, recruitment, certification.
GET /api/vtc/:slug/onlineDrivers online right now.
GET /api/vtc/:slug/jobs?limit=10Latest deliveries (1 to 50).
GET /api/vtc/:slug/events?limit=5Upcoming public events (1 to 20).
GET /api/vtc/:slug/members?limit=50Members ranked by kilometres (1 to 200), if the VTC makes its list public.
GET /api/vtc/:slug/certificationCertification level, date obtained and verification link.
  • GET /api/vtc returns the list of available endpoints.
  • Limit: 120 requests per minute per IP address.
  • Deliveries blocked by the anti-cheat are never counted.
  • The Settings → API → Allow API access setting (free, Settings permission) turns the API (and the widgets) off; "Expose the member list" only hides /members. Income follows the privacy setting of the Tracker tab.
Need more data (announcements, divisions, galleries, private events…)? Use the developer API with a key: see Developers.
Growth & integrations

Certification badge

A certified VTC can show its official badge on its website, Discord or TruckersMP page. The badge points to a public verification page: it cannot be copied to pass as a certified VTC.

  • Image: /badges/vtc/my-vtc.svg (or .png for Discord and forums).
  • Options: ?theme=light, ?lang=en, ?style=flat (compact shields.io-style pill).
  • Verification page: /verify/my-vtc shows the current level (Verified, Certified or Partner), since when, and the check date.
  • If the certification is withdrawn, the badge and the verification page update immediately.

Ready-to-copy HTML, Markdown and BBCode are in Dashboard → Integrations. Levels and their criteria are described in Certification.

Growth & integrations

Migrating from another platform

Coming from Trucky, VTLog, TruckersHub or a TruckersMP VTC? Import your members and their statistics (kilometres, deliveries, income) for free from Dashboard → your VTC → Import ("Members" permission). Public overview: /migration.

SourceWhat is importedWhat you need
TruckersMP (official VTC)Members, roles, join dates, Discord account when the player made it publicYour TruckersMP VTC ID or link
TruckersHubDrivers, kilometres, deliveries, incomeYour TruckersHub API token (read once, never stored)
CSV or JSON fileEverything in the export (Trucky, VTLog, spreadsheet)A file of 2 MB at most (CSV template)
  1. Pick the source and run the preview: each driver is matched to a Discord account when possible (Discord ID, connected Steam or TruckersMP). Nothing is written yet.
  2. Check the list, then confirm. You can choose to add recognised drivers as members right away, within your VTC's seat limit.
  3. Recognised members get their history immediately. The others stay pending: they get their history as soon as they join your VTC or connect their Steam. You can also match or dismiss them by hand.
  • Columns recognised in a file: name, discord_id, steam_id, truckersmp_id, km (or miles, converted), jobs, revenue, role, joined_at, plus French names and common variants.
  • Up to 500 rows per import.
  • Importing twice doubles nothing: the largest imported value is kept for each driver.
  • Imported statistics count in the totals and "all time" rankings, not in monthly rankings or Seasons.
Growth & integrations

VTC → VTC referral

Invite another VTC to Horizon Dispatch with your /r/<code> link, shown in Dashboard → Referral. When the referred VTC becomes active, both VTCs get free boosts.

RuleValue
AttachmentCreated through your link, or your code entered within 30 days of the referred VTC's creation
"Active" referred VTCWithin 45 days: at least 3 active members, 15 validated deliveries and 2 distinct drivers who are not members of the sponsor VTC
Reward2 boosts for 30 days for each of the two VTCs
CapA sponsor VTC holds no more than 4 referral boosts at once; beyond that, the last one is extended instead
Badges🤝 Sponsor (1 active referral), 🌟 Ambassador (3), 👑 Network legend (10); the referred VTC gets 🌱 Recommended by the network
No money involved, and self-referral is blocked (shared members, blacklisted VTCs).
Growth & integrations

International rankings

The /rankings page ranks every public VTC. Pick a category, a period and an area (world, a region such as Europe, or a country, based on the country set in the VTC's settings).

CategoryPeriods
KilometresThis month, last month, all time
DeliveriesThis month, last month, all time
EventsThis month, last month, all time
Best progressionThis month, last month
Active driversThis month, last month
  • Deliveries blocked by the anti-cheat, private VTCs and blacklisted VTCs are excluded.
  • Every row has a share link with a preview image (rank and VTC) for Discord and social networks.
  • The dashboard (Integrations) shows your VTC's position in each ranking.
Growth & integrations

HDispatch Seasons

Each calendar month is a season, with a theme that changes one rule. Season 1 starts on 1 November 2026; until then, the /seasons page shows a trial pre-season with no rewards. Every public VTC takes part automatically.

Base scoring

ActionPoints
100 km delivered1 pt
Validated delivery2 pts
Event organised and held during the season10 pts (20 events counted at most)
Participant signed up to one of your events3 pts
Active driver (at least 3 deliveries in the season)15 pts

Rotating themes

  • 🇪🇺 Europe Challenge: km on Euro Truck Simulator 2 are worth 50% more.
  • 🇺🇸 American Dream: km on American Truck Simulator are worth 50% more.
  • 🚛 Convoy Masters: events and participants count double.
  • 🛣️ Long Haul: +10 points per delivery over 1,000 km.
  • 🤝 Team Spirit: each active driver is worth 40 points.

End-of-season rewards

RankReward
🏆 1stPermanent badge, exclusive champion banner, 3 free boosts for 30 days
🥈 2ndPermanent badge and 2 free boosts for 30 days
🥉 3rdPermanent badge and 2 free boosts for 30 days
🎖️ 4th to 10thPermanent Top 10 badge
Deliveries blocked by the anti-cheat earn no points, and imported statistics (migration) do not count.
Growth & integrations

Comparisons

The /compare pages compare Horizon Dispatch with Trucky, VTLog and TruckersHub, feature by feature, with the date the information was checked. They point to the free migration.

Premium & boostsVTC boosts and support
Trust & safetyCertification, anti-cheat, blacklist
Trust & safety

Anti-cheat: Horizon Shield

Horizon Shield protects the rankings, Seasons and statistics. The principle: the app collects, the server decides. While you drive, the app sends signed telemetry (position, speed, odometer, game time); on arrival, the server replays the trip, compares it with the reported delivery and decides. Official kilometres are only credited after this validation.

Normal play goes through without trouble: ferries, trains, garages, loading screens, TruckersMP and mods are not cheating. The same security applies to everyone, with or without Premium.

What is checked

  • Speed: driving over 145 km/h for a sustained time puts the delivery in quarantine and sends an automatic warning by DM. The app's speed warner helps you avoid it.
  • Teleporting and distance jumps: moving without the odometer progressing, an odometer that jumps or goes back, outside ferries, trains and garages.
  • Time or simulation speed-up: odometer or game time running faster than the displayed speed (calibrated for each driver).
  • Fake or edited delivery: a delivery with no observed start, a trip that is too fast, a reported distance above the measured or in-game distance, cargo, cities or income different from those recorded at the start.
  • Duplicates, saves and farming: the same delivery sent twice, rolling back with a save to redo it, a save that skips a large part of the route, an unrealistic delivery rate, the same route repeated in a loop. Loading a save mid-route is still allowed: the delivery is validated, without the "verified" label.
  • Spoofed telemetry: frozen or inconsistent data, replayed requests, invalid signatures, a modified or debugged app, several sessions active at once.
A single signal is not enough: each anomaly has a weight, and only serious combinations lead to quarantine. Gaps caused by missing telemetry or a lost connection are tolerated.

Decisions and the "verified" label

DecisionEffect
VerifiedTrip fully covered by signed telemetry, with no anomaly. Counted, with the verified label and verified km.
ValidatedCounted normally (for example offline, older app or partial telemetry).
FlaggedCounted, but flagged to the team for a check.
QuarantineSet aside without any sanction: not counted until it is reviewed. Checked again automatically when the reason can resolve itself (telemetry arriving late).
BlockedSeveral serious anomalies: not counted, human review.

A delivery that is set aside does not count in statistics, rankings, certification or Seasons. It stays visible in Trips marked "Under review". If the team restores it, it is counted again.

"Verified" means the checks found nothing, not an absolute guarantee. An offline delivery (sent later) can be validated, but does not get this label.

App security

  • Secure session: each time it starts, the app opens a session; every upload is signed and numbered, and a replayed upload is refused.
  • Offline: without a connection, telemetry is signed and kept on the PC (up to 72 h), then sent when the network is back.
  • Integrity: the fingerprints of the app and the plugin are compared with those of the official version; a debugger or injected module is reported.
  • Updates: the downloaded installer is compared with the signed manifest of the version before anything is installed.
No kernel driver, no access to your other programs or files: only game telemetry is read. With the app's simulator, Horizon Shield is disabled.

Security Center (team)

The Horizon Dispatch anti-cheat team works in the Security Center (/dashboard/shield):

  • Review queue: deliveries in quarantine, blocked or flagged, with Route Replay (the trip replayed on a map, speed curve, timestamped anomalies) and the evidence kept in the Evidence Vault.
  • Restore a delivery (it is counted again), confirm the cheating or run the check again.
  • Alerts and live sessions: anomalies detected while driving, tampering, multiple sessions.
  • Sanctions: warning, restriction (no more verified label) or exclusion. A restriction or exclusion requires deliveries as evidence, and an exclusion must be approved by a second analyst.
  • Appeals and audit log: every decision and every evidence access is recorded.

VTC managers (permission "View activity log") have a security panel for their drivers and can report a delivery to the team.

For drivers

Drive normally and start the app before taking a delivery. The Horizon Shield page of your dashboard (/dashboard/shield/me) shows the decision for each delivery, the anomalies found, your trust score and your sanctions. You can appeal a decision there: an analyst replies. The app shows the same information on its dashboard.

The site can reserve rankings, Seasons or challenges for verified deliveries (competitive mode): in that case, only deliveries with the label count for those rankings.

Trust & safety

Blacklist and sanctions

The team can suspend a user or a VTC when a safety or moderation measure is needed. The reason and duration are always shown to the person concerned; the identity of the team member who applied the measure never is.

Blacklisted user

Access to the dashboard and to VTC page actions (apply, reviews, sign-ups) is blocked. The site's bell shows the reason and duration.

Blacklisted VTC

The VTC's dashboard is locked. Its public page shows "VTC blacklisted for: …" with the reason, date and duration. It disappears from the directory, rankings, Seasons, public API, widgets and referral.

Warnings

The team can send a warning (information, warning or severe) to a VTC or a driver. It shows in the dashboard and in the app. An active severe warning prevents certification.

SoftwareTracker, overlay, mobile
Software

Installation and plugin

  1. Download the installer from /software and run it: you choose the folder, it installs for your Windows account and creates a desktop shortcut.
  2. Open the app and sign in with Discord.
  3. The app finds ETS2 and ATS (Steam, Steam libraries, Epic Games, GOG or another folder) and installs the telemetry plugin on its own.
  4. Start the game: the app shows "game connected".

Telemetry plugin

The HorizonDispatch.dll plugin is copied into bin\win_x64\plugins of each game found. The app checks it at start-up, after sign-in, after an update and every 5 minutes, and reinstalls it when needed.

  • On first launch, the game shows a message about "advanced SDK features": click OK.
  • Game not found? Settings → Plugin: "Check again", "Search all drives" (up to 15 seconds) or "Manual folder…" (choose the game's plugins folder).
  • After an app update, restart the game to load the new plugin.

Start-up and system tray

  • "Start with Windows" and "Start minimised" options.
  • Closing the window sends the app to the system tray; its menu offers Open, Open the logs folder and Quit.
  • Only one copy of the app can run at a time.

Sign-in and solo mode

Sign-in happens in a built-in Discord window. The app finds your main VTC automatically. Without a VTC, it runs in solo mode: your deliveries are saved to your profile, without the VTC features (chat, quick commands, overlay options unlocked by boosts). "Sign out" in My account revokes this computer's access.

Software

Delivery tracking

A delivery is sent when the game reports it finished and paid. Cancelled deliveries are ignored. Recorded: game, cargo, origin and destination cities and companies, truck, km driven and planned, detour, income, cargo damage, market (standard or World of Trucks), top speed, speeding and the route trace.

Start the app before taking a delivery

A trip whose start the app did not see is sent as an "unfinished trip": it is not recorded, a "⛔ Unfinished trip, statistics blocked" message goes to the VTC's deliveries channel and the overlay warns you.

How kilometres are counted

  • Km come from the truck's odometer, frame by frame. An abnormal jump (truck change, save load, teleport) is ignored.
  • The route counts as changed if the gap with the planned distance is over 5 km and 5%.
  • If the app or the PC restarts mid-trip, the delivery is resumed: km already validated are restored and counting restarts from the current odometer. The state is saved every 2 km.
  • Going over the speed limit + 5 km/h counts as a speeding event.

Offline and duplicates

Without a connection, deliveries wait in a queue (200 at most) and are sent as soon as the website answers, at the latest every 60 seconds. The server ignores duplicates (the same delivery sent twice).

App counters

  • Session: reset each time the app starts; a summary shows when you leave the game.
  • Day: deliveries, km, income, speeding and driving time, reset at midnight.
  • Total: since installation.

Only deliveries accepted by the server count: a delivery blocked by the anti-cheat or a duplicate is not counted, and a delivery sent offline is counted when it goes out. In the Deliveries screen, a blocked delivery stays listed with "🚫 Under review".

Fleet import from your saves

For VTC members, the app reads your latest save (Documents\…\profiles folder) when tracking starts and sends your trucks, trailers (model, plate, odometer) and garages to the VTC fleet. Steam Cloud profiles are not read.

Software

In-game overlay

The overlay shows on top of the game when it is connected and in the foreground. It does not capture the mouse. Everything is set in the app's Overlay tab; "Preview" shows a demo trip without starting the game.

  • Placement: 6 preset positions, screen choice, or free move with "Move the overlay" or Ctrl+Alt+O. "Reset" goes back to the default corner.
  • Mode: standard or tachograph; card or bar layout; size (75 to 150%) and opacity.
  • Fuel shown as a percentage or as range (km).
  • Themes: sunset and glass are free; midnight, emerald, crimson and mono from 4 boosts.

The 19 widgets

WidgetContent
Speed, limit, cruise controlCurrent speed, the road's limit, cruise control.
Route, cargo, truck, trailerOrigin and destination, goods, vehicle.
ETA, progressReal time remaining and delivery progress.
OnlineYour VTC members who are driving (refreshed every 30 s).
Nearby convoyA teammate within 5 km on the same game, with an alert when they arrive.
Event radarThe VTC's next event within 3 hours.
StandingYour grade and the km left before the next one.
TruckersMP (beta)Players on the detected server or players nearby (off by default). See TruckersMP.
ClockTime (off by default).
Earnings, fuel, damageFrom 4 boosts.
VTCYour VTC badge, from 2 boosts.

Options unlocked by your VTC's boosts

  • 2 boosts: accent colour and VTC badge (without a chosen colour, the VTC's is used).
  • 4 boosts: earnings, fuel and damage widgets, and 4 extra themes.
  • 6 boosts: full customisation (background, opacity, border, corner radius, blur, logo size, advanced tachograph settings).

In solo mode, these options stay off.

Alerts and on-screen messages

  • Low fuel: at 15% or less while driving.
  • Damage: at 60% or more.
  • Each alert repeats at most every 5 minutes; turn them on in the Alerts tab.
  • Also shown: delivery sent or unfinished, VTC chat messages, website announcements and team warnings.
Software

RP tachograph

Tachograph mode replaces the standard overlay with a truck-style digital tachograph, for roleplay.

RuleDefaultAdjustable
Maximum continuous driving4 h 3030 min to 12 h
Required break45 min5 to 180 min
Split break15 + 30 minThe first part is one third of the break
Maximum daily driving9 h1 to 24 h, reset at midnight
Warning before the break30 min0 to 120 min
  • "Game paused = rest" (on by default) and sounds for warning, overrun and validated break.
  • Display: full, compact or minimal format, width, screen colour (green, cyan, amber, white or custom), text size, and which lines are shown (driving, break, time left, session km, daily driving, status, header).
  • "Reset session" button.
  • The tachograph with its default settings is available to everyone. Changing the format, width, colour, text size, rules or skin needs 6 boosts.
Software

Speed warner

The overlay warns you when you go over a chosen speed, regardless of the game's limits. On by default at 97 km/h, adjustable from 50 to 160 km/h.

  • Visual: the speed blinks yellow.
  • Sound: a beep, repeated at most every 4 seconds while you stay above (can be turned on separately).
  • Also works in tachograph mode.
Above 145 km/h for a sustained time, the anti-cheat puts the delivery in quarantine: the warner helps you stay well clear of that threshold.
Software

TruckersMP

  • Every 30 seconds, the app detects whether you play on TruckersMP or solo, and on which server. If detection fails, fill in the "TruckersMP server" field.
  • The server shows on the live map (server chips) and on your driver card.
  • TruckersMP widget (beta): "server" mode (players and queue on the detected server) or "nearby" mode (players within an adjustable radius, 1 km by default, through Trucky's traffic API).
Software

VTC chat and quick commands

For VTC members only.

In-game chat

Ctrl+Shift+C (changeable or off in Settings) opens a small VTC chat window over the game. Messages of 500 characters; Esc closes it and gives focus back to the game. "Main" and "Traction" tabs if you belong to two VTCs. An optional beep signals new messages.

Chat usage setting: "On ETS2/ATS" (the hotkey only opens the chat while the game is in the foreground) or "Anywhere" (outside the game too).

Quick commands

Ctrl+Shift+1 to 5 (only when the game is in the foreground) or the app's buttons: On my way, Break, Arrived, Need help, Refuelling. The message goes to the live convoy status channel of the VTC's Discord server and is deleted after 30 minutes. One command every 10 seconds at most.

Software

Discord Rich Presence

The app shows your activity in your Discord status. The VTC customises that status in your VTC → RPC ("Manage RPC" permission, 6 boosts): Discord application ID (required), two text lines, large and small image with their text, timer and up to 2 buttons (otherwise "My profile" and "My VTC").

  • Custom lines apply during a delivery. Off job, the status shows the activity and the truck.
  • Variables: {vtc}, {driver}, {truck}, {trailer}, {cargo}, {route}, {cityFrom}, {cityTo}, {distance}, {income}, {speed}, {speedText}, {game}, {activity}.
  • The status updates every 3 seconds. Discord must be open on the same PC.
Line 1: 🚚 {cityFrom} → {cityTo}
Line 2: {cargo} · {speedText}
Software

Mobile dashboard

Mobile dashboard tab: scan the QR code with your phone, connected to the same Wi-Fi network as the PC. No app to install.

  • Info: speed, limit, cruise control, speeding, cargo, route and progress, fuel, damage, ETA, income, top speed, range, trailer. Updated in real time.
  • Map: your truck turned to its heading, follow mode, an orange trail of the path actually driven, a 🏁 flag on the destination and the other Horizon Dispatch drivers on the same game.
  • The address changes each time the app starts; "New QR" makes a new one right away.
Driving data goes straight from the PC to the phone over your local network. The Map tab needs the Internet for map tiles and other drivers' positions.
Software

Screens, notifications and settings

Deliveries and reports

Deliveries shows your last 200 deliveries (trips, cargo, statistics). Reports sums up deliveries, km, income, average km and € per delivery, € per km and your top 6 cargos.

Notifications

  • New announcements and new events from your VTC (checked every 5 minutes).
  • Event reminders 30 minutes, 10 minutes and at departure time.
  • Do not disturb: mutes Windows notifications while you play.
  • The app's bell gathers the website's notifications.

Settings

  • Appearance: colours (accent, secondary, background, menu, cards), background style (ambient, gradient, solid or image) and the Horizon, Ocean, Violet night, Forest, Carbon presets.
  • Language: French, English, German, Turkish, Spanish, Italian, Polish, Dutch.
  • Start with Windows, start minimised, do not disturb, notifications, chat hotkey and beep.
Software

Updates and troubleshooting

The app checks for updates 15 seconds after start-up and then every 6 hours. When a version is available, a window offers Update now or Later; if you are playing, it waits until you leave the game. The update installs and the app restarts. Then restart the game to load the updated plugin.

Troubleshooting

ProblemFix
"Game not connected"Check the plugin in Settings → Plugin, restart the game and accept the advanced SDK features message.
Delivery missing from the websiteWas the app running when the delivery started? If not, it is an unfinished trip. Without Internet, it is sent later from the queue.
Delivery "under review"The anti-cheat set it aside; the team can restore it if it is a mistake.
The overlay does not showThe game must be connected and in the foreground. If it stays invisible in full screen, switch the game to borderless windowed mode.
The phone cannot connectSame Wi-Fi network as the PC, and allow the app through the Windows firewall (private network).

The logs (hd-tracker.log) open from the system tray menu: Open the logs folder. Attach them to your message on the support Discord or with /rapport-bug.

Developers & helpAPI, OAuth, FAQ
Developers & help

Developer API and integrations

The full reference (sample responses, error codes) is on the Developers page. In short:

ToolAccessUse
Public API /api/vtc/:slugNo key, any public VTCRead statistics for a website or a bot.
Widgets and badgeNo keyShow the VTC on a website.
API v1 /api/v1/*pk_… key, 5 boostsDetailed data about your VTC.
Horizon Connect (OAuth 2)App created in Ecosystem"Sign in with Horizon Dispatch" on your site.
WebhooksEcosystem, or the delivery webhook in SettingsReceive your VTC's events on your server.

API v1

Turn the API on in Settings → API (5 boosts) and copy your public key pk_…. Send it in the x-api-key header or as the ?key= parameter. Limit: 120 requests per minute per key.

curl -H "x-api-key: pk_xxxxxxxx" https://hdispatch.eu/api/v1/vtc

Endpoints: /vtc, /members, /events, /deliveries, /live, /news, /partners, /divisions, /gallery and /hd/events (Horizon Dispatch events). GET /api/v1 returns the list.

Do not mix up the public key pk_… (read-only, safe in a web page) with the VTC's tracker key, which is secret: never share it. Only the founder can regenerate the public key.

Horizon Connect (OAuth 2)

Create an app in your VTC → Ecosystem (the secret is shown only once), then:

  1. Send the user to /connect/authorize with client_id, redirect_uri, scope and state. PKCE (S256) is supported.
  2. Exchange the code you receive (valid 5 minutes, single use) for a token: POST /connect/token with your secret.
  3. Call GET /connect/userinfo with Authorization: Bearer <token>. The token is valid for 30 days.

Scopes: identity (ID), profile (profile), vtc (the user's VTC).

Developers & help

Frequently asked questions

QuestionAnswer
Is Horizon Dispatch free?Yes. Boosts (€0.99 per month each) only unlock extra features for a VTC.
Which systems does the app run on?Windows only. The website and dashboard work everywhere, mobile included.
Can I be in several VTCs?Two at most: a main and a traction VTC.
I left a VTC, why can't I join another one?A 12-hour wait applies after each departure.
My delivery does not show.The app must run from the start of the delivery. See Troubleshooting.
Does it work with TruckersMP?Yes. The app detects TruckersMP and your server automatically.
Is my position public?While the app runs and the game is connected, you show on the live map.
How do I change the founder?Settings → Danger zone → Transfer ownership.
I am switching platforms, will I lose my stats?No: the migration imports members and statistics for free.
Where do I report a bug?With /rapport-bug on Discord, or on the support Discord.

Bereit für die Straße?

Erstelle deine VTC, installiere den Tracker und tritt der Horizon-Dispatch-Community bei.