Horizon Dispatch Docs 0.7.4

Cała platforma.
Jedna dokumentacja.

Utwórz i prowadź swoją VTC, skonfiguruj bota Discord, zainstaluj tracker, poznaj certyfikację, anty-cheat i narzędzia rozwoju: cały Horizon Dispatch wyjaśniony krok po kroku.

VTC i Discord Tracker ETS2 / ATS Zaufanie i bezpieczeństwo API i integracje
Pierwsze krokiPierwsze kroki i konto
Pierwsze kroki

Twoje konto kierowcy

Panel → Mój profil zawiera wszystko o tobie jako kierowcy, niezależnie od VTC. Twój profil publiczny znajduje się pod adresem /drivers/<twoje ID Discord>.

Poziom, tytuły i osiągnięcia

Każda dostawa daje doświadczenie: 1 XP za km, 100 XP za dostawę i 500 XP za punkt osiągnięć. Następny poziom wymaga 4000 XP, a potem o 2000 XP więcej na każdy kolejny poziom.

Tytuły: 🔰 Uczeń (poz. 1), 🚚 Kierowca (5), 🛣️ Kierowca ciężarówki (10), 📦 Doświadczony kierowca (18), 🚛 Mistrz kierownicy (28), 🎖️ Weteran (40), 👑 Mistrz drogi (55), 🌟 Legenda (75). Odblokowane odznaki i osiągnięcia widać na twoim profilu, razem z kolejnym osiągnięciem do zdobycia.

Połączone konta: Discord, Steam, TruckersMP

  • Discord: twoje konto logowania.
  • Steam: przycisk Zaloguj się przez Steam. Logowanie odbywa się na oficjalnej stronie Steam: nikt nie może połączyć twojego Steama za ciebie. Konto Steam można połączyć tylko z jednym kontem Discord.
  • TruckersMP: łączone i oznaczane jako zweryfikowane automatycznie, gdy tylko połączysz Steam. W przeciwnym razie /link truckersmp na Discordzie tworzy zwykłe (niezweryfikowane) połączenie; połączenie zweryfikowane przez Steam zawsze ma pierwszeństwo.

W każdej chwili możesz ukryć Steam na profilu publicznym lub go odłączyć. Połączenie Steama przypisuje ci też historię zaimportowaną przez twoją VTC podczas migracji.

VTC główna i VTC ciągnąca

Jeśli należysz do dwóch VTC, wybierz w Moim profilu, która jest twoją VTC główną: otrzymuje 100% twoich dostaw. Druga, VTC ciągnąca, otrzymuje dodatkowo 75% kopii (km, przychód) każdej dostawy.

Wypłata i saldo

Każda dostawa przekazuje część przychodu do twojego portfela w głównej VTC (domyślnie 30%, ustala to VTC). Mój profil pokazuje twoje saldo, twój procent i 6 ostatnich transakcji. Premiami i wypłatami zajmuje się zespół VTC.

Nakładka do streamu (OBS)

Kliknij Wygeneruj mój link nakładki, aby otrzymać adres /overlay/<token> do dodania jako „Źródło przeglądarki” w OBS. Pokazuje twoją VTC, twój poziom, trasę, ładunek, prędkość i postęp, odświeżane co 3 sekundy, gdy aplikacja działa.

  • Opcje: ?theme=light i ?accent=ff8800.
  • Ponowne wygenerowanie linku wyłącza stary (przydatne, jeśli wyciekł).

Personalizacja i Supporter

  • Awatar (8 MB) i baner (16 MB) albo powrót do tych z Discorda.
  • Bio (400 znaków), kolor akcentu i media społecznościowe: YouTube, Twitch, X, TikTok, Instagram, Steam, Discord, strona internetowa.
  • Supporter Profile Studio (aktywne wsparcie miesięczne lub stała rola wspierającego): styl (klasyczny, szkło, zachód słońca, neon, minimalny), ramka, wzór, układ, przezroczystość, rozmycie, poświata, status z emoji, 4 wyróżnione statystyki i 3 wyróżnione odznaki. Zobacz Premium i boosty.

Opuść VTC

Przycisk Opuść VTC na banerze VTC (powód opcjonalny). Założyciel nie może odejść: najpierw musi przekazać własność (Ustawienia → Strefa niebezpieczna). Po odejściu musisz odczekać 12 godzin, zanim utworzysz VTC lub do niej dołączysz.

Panel VTCCodzienne prowadzenie VTC
Panel VTC

Członkowie i rekrutacja

Strona Członkowie zawiera listę Twoich kierowców z wyszukiwarką i filtrami (rola, ranga, stopień). Każdy może ją przeglądać; działania wymagają uprawnienia „Zarządzaj członkami”.

  • Dodaj członka po ID Discord, jako Kierowcę lub Menedżera. Zostaje mu nadana rola domyślna. Dodanie się nie powiedzie, jeśli VTC jest pełna lub osoba jest już w 2 VTC.
  • Mianowanie kogoś Menedżerem daje wszystkie prawa: zostaw to dla zaufanych osób.
  • Przypisz do 5 ról na członka.
  • Usuń członka, z opcjonalnym powodem.
  • Sprawdź, której wersji aplikacji używa każdy kierowca.
Członek, który opuści serwer Discord VTC, staje się „nieaktywny”; nie jest usuwany.

Karta kierowcy

  • Statystyki kierowcy, postęp rangi i odznaki.
  • Wypłata i saldo: „Wypłać premię” (z skarbca VTC, kierowca dostaje wiadomość prywatną) oraz „Wypłata / płatność”.
  • Historia dyscyplinarna: notatka, ostrzeżenie lub sankcja, z powodem (500 znaków).

Centrum rekrutacji

Zgłoszenia wysłane z Twojej strony publicznej trafiają do Zgłoszeń (uprawnienie „Zarządzaj rekrutacją”), z plakietką w menu i powiadomieniem push dla menedżerów.

1 Nowe2 Krótka lista3 Rozmowa4 Okres próbny5 Przyjęte lub odrzucone
  • Liczniki: łącznie, w toku, rozmowy, okresy próbne, przyjęte, odrzucone.
  • Przypisz osobę odpowiedzialną (założyciel lub menedżer) i pisz notatki wewnętrzne (1200 znaków).
  • Zaakceptuj tworzy członka (jeśli w VTC jest miejsce, osoba nie jest w 2 VTC i nie trwa jej 12-godzinne oczekiwanie) i publikuje skonfigurowaną wiadomość na Discordzie.

Formularz zgłoszeniowy pyta o: doświadczenie, dostępność, motywację (wymagana), preferowaną grę, strefę czasową, poprzednią VTC, profil TruckersMP i doświadczenie w konwojach.

Panel VTC

Role, rangi i dywizje

Trzy osobne systemy, które działają razem:

SystemDo czego służyPrzydział
RoleNadawanie uprawnień w paneluRęcznie, do 5 na członka
Rank up (rangi)Nagradzanie przejechanych kilometrówAutomatycznie, na podstawie km dostaw
DywizjeSpecjalizacja kierowców (cysterny, transport ciężki…)Wybierane przez kierowcę w aplikacji

Role

Uprawnienie „Zarządzaj rolami”. Każda rola ma nazwę (40 znaków), kolor i wybór spośród 13 uprawnień. Przeciągaj role, aby ustalić ich kolejność. Roli domyślnej (nadawanej nowym członkom) nie można usunąć. Liczba ról zależy od boostów (od 5 do 30, zobacz Premium i boosty).

Rank up

Każda ranga ma nazwę, wymagane km, kolor i opcjonalną rolę Discord. Liczą się tylko km z dostaw. Po każdej dostawie (lub po kliknięciu Zsynchronizuj) kierowca dostaje rolę Discord swojej rangi, stare role są usuwane, a na kanał „rank” trafia wiadomość. Bot musi być na serwerze VTC.

Dywizje

  • Włącz „Włącz dywizje w aplikacji”, a potem wybierz tryb: jedna dywizja na kierowcę lub wiele łącznie.
  • Do 10 dywizji, każda z nazwą, opisem, obrazem, kolorem, listą ciężarówek i naczep oraz rolą Discord.
  • Kierowcy wybierają dywizję w aplikacji i dostają odpowiednią rolę Discord.
Panel VTC

Statystyki, trasy i dziennik

Każdy członek może przeglądać te strony.

Statystyki

  • Wyniki z bieżącego miesiąca w porównaniu z poprzednim, aktywność dzienna, najlepsi kierowcy miesiąca.
  • Dystans na kierowcę, podział według ról, trend z 12 tygodni, mapa cieplna aktywności, ulubione trasy i ładunki, dostawy według krajów, nieaktywni kierowcy (brak dostawy od 14 dni).
  • Cele miesięczne: jeden na wskaźnik na miesiąc (uprawnienie Ustawienia).
  • Ręczne wprowadzanie statystyk (uprawnienie „Edytuj statystyki”).

Trasy

Ostatnie 120 dostaw z trasą zachowaną lub zmienioną, uszkodzeniami, prędkością maksymalną, przekroczeniami prędkości i parkowaniem. Dostawy odłożone przez anty-cheat pozostają widoczne, oznaczone „🚫 W trakcie weryfikacji”, „⚠️ Kierowca ostrzeżony” lub „Oszustwo potwierdzone”, z dopiskiem „Nieliczone w statystykach”.

Usuń duplikaty („Edytuj statystyki”) usuwa identyczne dostawy zapisane w odstępie krótszym niż 6 godzin.

Operacje

Centrum dowodzenia na żywo: kierowcy online, w trasie i offline, dzisiejsze km i dostawy, dzisiejszy przychód, mapa na żywo i strumień aktywności. Kierowca jest „online”, jeśli jego aplikacja zgłosiła się mniej niż 60 sekund temu; strona odświeża się co 5 sekund.

Dziennik aktywności

Uprawnienie „Zobacz dziennik aktywności”. Pokazuje 100 ostatnich działań w VTC: dołączenia i odejścia, zmiany ról, wydarzenia, ustawienia, polecenia… Nie ma eksportu.

Panel VTC

Wydarzenia i konwoje

Zakładka Wydarzenia (łącznie z przeglądaniem) odblokowuje się przy 2 boostach. Tworzenie i edycja wymagają uprawnienia „Zarządzaj wydarzeniami”.

  • Tytuł, opis w Markdown, kategoria (konwój, spotkanie, szkolenie, wyścig, oficjalne, inne), gra, serwer, język, baner, kolor.
  • Start i cel, do 20 punktów pośrednich, planowane km, DLC mapy, godziny zbiórki i wyjazdu.
  • Zasady, kanał głosowy, wymagane malowanie, maksymalna liczba uczestników (0 = bez limitu), do 200 miejsc w konwoju (domyślnie 20).
  • Importuj z TruckersMP: wklej link lub ID wydarzenia TruckersMP, aby wstępnie wypełnić formularz.
  • „Widoczne na stronie publicznej” pokazuje je na /vtcs/your-vtc i /events; w przeciwnym razie widzą je tylko członkowie.

Po utworzeniu: wiadomość na Discordzie na kanale „events” i powiadomienie push dla członków. Przycisk Powiadom ponownie wysyła je jeszcze raz. Kierowcy zapisują się („Biorę udział” lub „Może”) na stronie lub w aplikacji; aplikacja przypomina im 30 min i 10 min przed wyjazdem oraz w chwili wyjazdu. Każde wydarzenie publiczne można też pobrać jako plik kalendarza (.ics).

Panel VTC

Ogłoszenia, galeria i partnerstwa

Ogłoszenia (4 boosty)

Tytuł (140 znaków), treść w Markdown (6000), obraz okładki, przypięcie, opublikowane lub wersja robocza, widoczność na stronie publicznej. Opublikowane ogłoszenie trafia na Discord, jako powiadomienie push i do dzwonka w aplikacji. „Powiadom ponownie” działa tylko dla opublikowanego ogłoszenia. Członkowie spoza staffu widzą tylko opublikowane ogłoszenia.

Partnerstwa

Uprawnienie „Zarządzaj partnerstwami”. Wysłanie prośby wymaga 4 boostów i dotyczy publicznej VTC (po jej identyfikatorze). Akceptowanie, odrzucanie i usuwanie partnerstwa działa bez boostów. Zaakceptowane partnerstwa widać na stronach publicznych i w aplikacji.

Panel VTC

Flota i ekonomia

Dwie ekonomie działają równolegle:

WalutaŹródło
Wypłaty i skarbiecPrzychód w grze (€ / $)Każda dostawa: część (domyślnie 30%, regulowana od 0 do 100%) trafia do portfela kierowcy, reszta do skarbca VTC.
FlotaKredyty Horizon (◈ CH)150 000 CH na start, potem za każdą dostawę: km × 12 + 5% przychodu, pomniejszone o uszkodzenia i przekroczenia prędkości.

Flota

Widoczna dla wszystkich; działania wymagają uprawnienia „Zarządzaj flotą”. Wyświetla się do 50 ciężarówek i 50 naczep.

  • Przypisz kierowcę, ustaw ciężarówkę główną (otrzymuje dostawy, gdy żadna ciężarówka nie pasuje), zmień nazwę, wpisz tablicę rejestracyjną (16 znaków).
  • Przeglądy ciężarówek: ogólny co 45 000 km (2500 CH), silnik co 150 000 km (9000 CH), opony co 175 000 km (6000 CH).
  • Wymiana podzespołów: silnik 25 000, skrzynia biegów 18 000, opony 8000, podwozie 12 000 CH. Podzespół jest krytyczny od 20% zużycia.
  • Naczepy: przegląd ogólny co 60 000 km (1800 CH), opony co 150 000 km (4200 CH); wymiana opon 6000, hamulców 7000, podwozia 9000 CH.
  • Odsprzedaż: około 85% ceny, minus utrata wartości z powodu km i zużycia.
  • Krytyczne zużycie i zaległe przeglądy są zgłaszane na Discordzie. Aplikacja może zaimportować prawdziwe ciężarówki z Twojego zapisu gry.

Salon

Katalog nowych ciężarówek i naczep do ETS2 i ATS (w tym modele ogólne, przyjazne modom) oraz rynek używanych z 6 ofertami odnawianymi codziennie. Zakup się nie powiedzie, jeśli saldo kredytów jest za niskie.

Mechanicy

Do 6 mechaników, każdy z szybkością od 1 do 5 i specjalizacją (wszechstronny, ogólna, silnik, skrzynia biegów, opony, podwozie, hamulce). Mechanik z właściwą specjalizacją obniża koszt o 15% plus 3% za poziom, maksymalnie o 50%. Prace wyłączają ciężarówkę z ruchu (ogólny przegląd 30 min, silnik 2 h, opony 1 h, wymiana 3 h, skracane przez szybkość mechanika). Bez mechaników prace są natychmiastowe.

Każdy mechanik jest opłacany co tydzień z kredytów floty (od 1200 CH tygodniowo przy szybkości 1 do 4800 CH przy szybkości 5, +35% dla wszechstronnego). Jeśli kredyty się skończą, mechanik odchodzi, a dziennik VTC to odnotowuje.

Panel VTC

Strona VTC

Nie myl jej ze stroną publiczną /vtcs/your-vtc (zawsze dostępną): strona VTC to osobna, pełna witryna, publikowana pod adresem /vtcs/your-vtc/site. Wymaga 5 boostów i uprawnienia Ustawienia, a następnie włączenia przełącznika „Opublikuj stronę”.

  • Wygląd: 6 motywów (Horizon, Ocean, Las, Neonowy fiolet, Karmazyn, Czyste złoto), 6 czcionek, rogi, odstępy, wysokość hero, tło, styl przycisków, kolor akcentu.
  • 18 modułów do uporządkowania: hero, o nas, statystyki, członkowie, ranking, flota, galeria, wideo, FAQ, wezwanie do działania, rekrutacja, wydarzenia, ogłoszenia, partnerzy, wsparcie, kontakt, media społecznościowe, dowolny tekst.
  • Dla każdej sekcji: tło, obraz tła, wyrównanie i kolumny.
  • Otrzymane wiadomości: 50 ostatnich wiadomości z modułu Kontakt, wysyłanych też na kanał Discord „contact”.

Zwykłą stronę publiczną dostosowujesz w Ustawieniach (motyw strony i baner od 2 boostów).

Panel VTC

Ustawienia VTC

Uprawnienie „Zarządzaj ustawieniami”, chyba że zaznaczono inaczej.

ZakładkaUstawienia
TożsamośćNazwa (40 znaków, zmienia też adres), opis (2000), logo (URL lub przesłanie, 2 MB), baner (2 boosty, 5 MB), motyw strony publicznej (2 boosty), kolor, gra, kraj.
Rekrutacja i widocznośćRekrutacja otwarta, widoczność w katalogu, rola domyślna (z opcją „Zastosuj do członków bez rangi”).
Tracker i DiscordTag (8 znaków), limit prędkości, publiczna widoczność przychodów, kanał dostaw, webhook dostawy (HTTPS), wypłata kierowcy (%), kanał ogłoszeń, kanał galerii.
PlatformyID TruckersMP, Trucky i TrucksHub.
Linki i media8 sieci społecznościowych.
ZespółDodawanie lub usuwanie menedżerów (uprawnienie Członkowie).
Wdrażanie członkówLista powitalna do 20 kroków, pokazywana nowym członkom.
APIWłączanie lub wyłączanie publicznego API i widżetów, udostępnianie listy członków (za darmo). Klucz publiczny API v1 pk_… od 5 boostów (tylko założyciel może go wygenerować ponownie). Zobacz Deweloperzy.
Strefa niebezpiecznaTylko założyciel: przeniesienie własności (dotychczasowy założyciel zostaje menedżerem) lub usunięcie VTC, po wpisaniu jej nazwy.
Kanał dostaw otrzymuje też niedokończone trasy, dostawy zablokowane przez anty-cheat i alerty floty. Webhook dostawy wysyła każdą dostawę na wybrany przez Ciebie adres HTTPS (w formacie Discord, jeśli to webhook Discord).
Panel VTC

Ekosystem

Strona Ekosystem VTC, bez boostów, dostępna dla staffu (dowolne uprawnienie):

  • Horizon Network: utwórz publiczną lub prywatną sieć VTC albo dołącz do istniejącej za pomocą kodu.
  • Operacje konwojowe z punktami kontrolnymi i statusem.
  • Wyzwania VTC kontra VTC, kooperacyjne lub bezpośrednie.
  • Wspólne kontrakty między VTC.
  • Zweryfikowane umiejętności: certyfikaty i wyróżnienia kierowców.
  • Synchronizacja wydarzeń między platformami (Discord dostępny, pozostałe w przygotowaniu).
  • Aplikacja OAuth „Horizon Connect” (sekret jest pokazywany tylko raz) i webhooki (HTTPS, tylko na adresy publiczne). Zobacz Deweloperzy.
  • Marketplace: każdy członek może dodać ogłoszenie, wyświetlane na /ecosystem/marketplace.
Bot DiscordSerwer, kanały, tickety, komendy
Bot Discord

Kanały i wiadomości VTC

Dwie strony decydują o tym, co bot publikuje dla Twojej VTC (uprawnienie Ustawienia):

GdzieCo
Ustawienia → Tracker i DiscordKanał dostaw, kanał ogłoszeń, kanał galerii, webhook dostawy.
Twoja VTC → DiscordID serwera, 7 dedykowanych kanałów (domyślny, ogłoszenia, wydarzenia, nowe zgłoszenia, decyzje w sprawie zgłoszeń, ranga, kontakt) i 8 typów wiadomości.

Dla każdego typu wiadomości (ogłoszenie, wydarzenie, otrzymane zgłoszenie, zgłoszenie zaakceptowane, odrzucone, awans, degradacja, kontakt ze strony): włączenie lub wyłączenie, kolor, tytuł, tekst ze zmiennymi, do 10 ról do wspomnienia, „Wspomnij osobę, której dotyczy” oraz przycisk Wyślij test. Bez dedykowanego kanału bot używa kanału domyślnego, a potem kanału ogłoszeń.

Co publikuje kanał dostaw

  • Każdą dostawę: trasa, firmy, km (i objazd), przychód, €/km, ciężarówka, gra, rynek (standardowy lub World of Trucks), uszkodzenia, prędkość maksymalna, przekroczenia prędkości, parkowanie, ocena jazdy, postęp poziomu, przycisk „Zobacz dostawę”.
  • „⛔ Niedokończona trasa”, gdy dostawa nie była śledzona od początku (statystyki zablokowane).
  • „Dostawa zablokowana”, gdy anty-cheat ją odłoży.
  • Alerty zużycia i przeglądów z floty.

Inne automatyczne wiadomości

  • Raport tygodniowy w każdy poniedziałek.
  • Awans na wyższy poziom kierowcy (plus wiadomość prywatna do kierowcy).
  • Ranga (rank up) na kanale „rank”, z aktualizacją roli Discord.
  • Ogłoszenia (4 boosty) i wydarzenia (2 boosty) opublikowane z panelu.
  • Ostrzeżenie od zespołu anty-cheat: wiadomość prywatna do kierowcy i wiadomość na kanale ogłoszeń.
Bot Discord

Konfiguracja bota: systemy serwera

Konfiguracja bota → wybierz serwer. Te ustawienia dotyczą serwera Discord, a nie VTC, i nie wymagają żadnego boosta.

SystemCo robi
👋 Wiadomość powitalnaKarta powitalna na wybranym kanale, opcjonalny obraz i rola automatyczna (nadawana nawet wtedy, gdy wiadomość jest wyłączona). Zmienne: {user}, {username}, {server}, {count}.
🙋 Wiadomość pożegnalnaWiadomość, gdy członek opuszcza serwer. Zmienne: {username}, {server}, {count}.
🎭 Role reakcjiPanel przycisków, które nadają lub zabierają rolę: tytuł, opis, do 25 ról z emoji. Usunięcie panelu usuwa wiadomość na Discordzie.
📢 EmbedOpublikuj lub edytuj wiadomość bota: klasyczny embed lub Components V2, tytuł, tekst (4000 znaków), kolor, obraz, stopka, do 5 przycisków-linków.
🔔 Powiadomienia Horizon DispatchKanały, które otrzymują oficjalne ogłoszenia Horizon Dispatch (aktualizacje, prace konserwacyjne).
📋 Logi serwera8 kategorii do zaznaczenia: członkowie, wiadomości, role, kanały, kary, kanały głosowe, serwer, VTC. Autor działania jest ustalany na podstawie dziennika zdarzeń serwera.
🟢 Status konwoju na żywoWiadomość aktualizowana co 90 s z kierowcami VTC, którzy są w trasie (do 25). VTC musi być powiązana z tym serwerem.
🔢 Liczniki członkówCo 10 minut zmienia nazwy kanałów głosowych na liczniki (członkowie, online, boty, boosty).
🚛 Przekaźnik TruckersMPCo 10 minut publikuje ponownie newsy, wydarzenia i partnerów Twojej VTC z TruckersMP (trzeba podać ID).
Komendy działają tylko na serwerze (nie w wiadomościach prywatnych). Każdą komendę możesz ograniczyć do wybranych ról lub kanałów w Ustawienia serwera → Integracje.
Bot Discord

Tickety

Twoja VTC → Zgłoszenia (system ticketów, uprawnienie „Zarządzaj ticketami”, bez boostów). Utwórz tyle paneli, ile chcesz (wsparcie, rekrutacja, partnerstwa…).

  • Dla każdego panelu: nazwa, kolor, kanał panelu, kategoria ticketów, rola wsparcia, format nazwy (ticket-{user}), tytuł i tekst panelu, tekst, emoji i styl przycisku, wiadomość powitalna, etykieta zamknięcia, wspomnienie roli wsparcia.
  • Wdróż publikuje panel na Discordzie (bot musi być online).
  • Każdy członek może mieć jeden otwarty ticket na panel. Prywatny kanał widzą: członek, rola wsparcia i bot.
  • Każdy, kto jest w tickecie, może go zamknąć; kanał jest wtedy usuwany po kilku sekundach, bez zapisu rozmowy.
Bot Discord

Komendy slash

Przetłumaczone komendy (/vtc, /truckersmp, /aide, serwer i moderacja) odpowiadają w języku ustawionym dla serwera komendą /langue, a w przeciwnym razie w języku Discorda każdego członka (francuski, angielski, niemiecki, turecki, hiszpański, włoski, polski, niderlandzki). Pozostałe odpowiadają po francusku. Skrócona lista jest też na /commands.

VTC i kierowcy

KomendaDo czego służy
/vtc register nom jeuUtwórz swoją VTC i powiąż ją z tym serwerem.
/vtc info · /vtc membersKarta i członkowie Twojej VTC.
/vtc public nomPubliczna karta VTC.
/vtc setplatformUstaw ID TruckersMP, Trucky lub TrucksHub (założyciel, menedżer lub Zarządzanie serwerem).
/driver join · leave · profileDołącz do VTC serwera (rekrutacja otwarta), opuść ją, zobacz profil (ranga, status, statystyki, 3 ostatnie dostawy, TruckersMP).
/leaderboard critere periodeTop 10 VTC według dystansu, dostaw lub przychodu, z tygodnia, miesiąca lub z całego okresu.
/live globalKierowcy, którzy są teraz w trasie (Twoja VTC lub cała platforma).
/statsStatystyki VTC serwera: na żywo, tydzień, łącznie, członkowie, najlepsi tygodnia, ulubiona trasa i ładunek.
/link truckersmp id · show · removePołącz swoje konto TruckersMP (konto TruckersMP można połączyć tylko z jednym kontem Discord).

TruckersMP

KomendaDo czego służy
/joueur idKarta gracza TruckersMP.
/bans id5 ostatnich banów gracza.
/serveursTabela serwerów TruckersMP.
/truckersmp servers · player · companySerwery, gracz lub VTC w TruckersMP.
/events id salonJedno wydarzenie TruckersMP lub 6 najbliższych; z opcją salon wynik jest publikowany na tym kanale.
/vtcinfos info · events · membres · partenariats · newsInformacje o VTC w TruckersMP (członkowie strona po stronie).
/traffic jeu serveurStrefy ruchu na serwerach TruckersMP (dane Trucky).

Serwer i moderacja

KomendaDo czego służy
/accueil bienvenue · aurevoirSkonfiguruj wiadomości powitalne i pożegnalne z poziomu Discorda (Zarządzanie serwerem).
/roles-react panneau · ajouter · retirerPanele przycisków ról (Zarządzanie rolami).
/role ajouter · retirerNadaj lub zabierz rolę (Zarządzanie rolami).
/clear nombre membreUsuń od 1 do 100 wiadomości młodszych niż 14 dni (Zarządzanie wiadomościami).
/say salonNiech bot przemówi, jako tekst lub embed (Zarządzanie wiadomościami).
/sondageNatywna ankieta Discorda: od 2 do 6 opcji, od 1 godziny do 14 dni, możliwy wielokrotny wybór.
/alertes configurer · supprimerKanały powiadomień Horizon Dispatch (Zarządzanie serwerem).
/langueJęzyk bota na tym serwerze lub „Automatyczny”, czyli język każdego członka (Zarządzanie serwerem). Dotyczy też wiadomości powitalnych i pożegnalnych.
/vtcs ajouter · infos · liste · vérifier · supprimerLinki VTC w TruckersMP, Trucky, TruckersHub lub VTLog, przypisane do tego serwera (Administrator).
/avatar · /userinfo · /serverinfoAwatar, karta członka, karta serwera.

Pomoc

KomendaDo czego służy
/aideMenu pomocy według kategorii.
/info bot · serveur · system · vtcInformacje o bocie, serwerze, stanie usług i platformie.
/rapport-bugZgłoś błąd zespołowi (obszar, waga, opis). Przy każdej zmianie statusu dostajesz wiadomość prywatną.
Strona publicznaKatalog, mapa, społeczność
Strona publiczna

Katalog i strony VTC

Katalog zawiera listę publicznych VTC (VTC ukryte i z czarnej listy nie są pokazywane). Szukaj po nazwie, tagu lub opisie; filtruj według gry i „Rekrutuje”; sortuj według liczby członków, kilometrów, wieku, nazwy lub oceny; 24 VTC na stronę. VTC z 10 boostami (lub z Premium przyznanym przez zespół) są wyróżnione na górze.

Strona publiczna VTC

/vtcs/your-vtc przedstawia VTC: odznaka certyfikacji, wyróżnienia (Sezony, polecenia), boosty, przycisk Aplikuj, link „Oficjalna strona”, jeśli strona VTC jest opublikowana.

  • Bieżący miesiąc: km, dostawy, przychód i aktywni kierowcy, w porównaniu z poprzednim miesiącem.
  • Kierowcy online, cele miesięczne, rangi, wykres aktywności z 12 tygodni.
  • Kierowca miesiąca (podium dostaw z miesiąca) i rekordy VTC: najdłuższa dostawa, najlepiej płatna dostawa, prędkość maksymalna.
  • Ogłoszenia, galerie, wydarzenia, partnerzy, lista członków i opinie.
  • Każda dostawa ma własną stronę (/vtcs/your-vtc/deliveries/…) z mapą trasy; przychód jest widoczny tylko wtedy, gdy VTC go upublicznia.

Aplikuj

Po zalogowaniu przez Discord otwórz Aplikuj na stronie VTC, która rekrutuje. Zgłoszenie zostanie odrzucone, jeśli już jesteś członkiem, należysz już do 2 VTC, opuściłeś VTC mniej niż 12 godzin temu albo masz już oczekujące zgłoszenie. VTC dostaje powiadomienie na Discordzie i powiadomienie push.

Opinie

Każdy zalogowany użytkownik może wystawić ocenę od 1 do 5 gwiazdek z komentarzem (1000 znaków), jedną na VTC (ponowne wysłanie ją edytuje). Może ją usunąć autor, menedżerowie VTC i zespół.

Strona publiczna

Mapa na żywo

Mapa na żywo pokazuje kierowców, których aplikacja wysłała pozycję w ciągu ostatniej minuty (maksymalnie 500). Odświeża się co 4 sekundy.

  • Przełącznik ETS2 / ATS, wyszukiwarka (kierowca, VTC, miasto, serwer), filtr „Wszyscy” lub „W dostawie”, sortowanie (aktywność, serwer, VTC, nazwa, prędkość).
  • Zakres Wszyscy członkowie lub Członkowie VTC (po zalogowaniu, dla członków VTC).
  • Etykiety serwerów: Wszystkie, TruckersMP, Solo, Nie wykryto, a dalej każdy oficjalny serwer TruckersMP z liczbą graczy Horizon Dispatch i TruckersMP.
  • Warstwa miast i promów, przyciski „Pokaż wszystkich” i „Wyśrodkuj na mnie”.
  • Karta kierowcy: gra, VTC, tag i ranga, serwer TruckersMP lub solo, miasta i firmy, ładunek, ciężarówka, naczepa, prędkość i postęp.

Przydatne adresy

  • /map?scope=vtc: tylko Twoja VTC.
  • /map?server=tmp, solo, unknown lub ID serwera TruckersMP.
  • /map?game=ats: otwiera mapę ATS.
  • /map?embed=1: bez paska bocznego, do osadzenia na stronie (zobacz też widżet Mini mapa na żywo).
Serwer TruckersMP jest wykrywany przez aplikację automatycznie (zobacz TruckersMP). Twoja pozycja jest publikowana tylko wtedy, gdy aplikacja jest otwarta, a gra połączona.
Strona publiczna

Społeczność

Ranking kierowców

/leaderboard: top 50 kierowców i top 15 VTC, w km rzeczywistych, km zleceń lub km World of Trucks, a do tego najwyższe poziomy, wypłaty i skarbce. Ranking VTC według kraju i okresu znajdziesz na /rankings.

Wyzwanie tygodnia

/challenges: jedno wyzwanie na tydzień, rotacyjnie: 2500 km, 15 dostaw, 10 dostaw bez uszkodzeń, 250 000 € przychodu, 3 dostawy nocne (22:00–6:00) lub 3 trasy po co najmniej 800 km. Top 10 i Twój postęp.

Kwartalne ligi kierowców

/season klasyfikuje kierowców według km przejechanych w kwartale: Rekrut, Brąz (500 km), Srebro (4000), Złoto (12 000), Diament (30 000), Legenda (75 000). Nie myl tego z HDispatch Seasons, comiesięczną rywalizacją między VTC.

Aktualności, wydarzenia i kanał aktywności

  • /news: aktualności Horizon Dispatch, z 6 reakcjami i komentarzami (500 znaków) dla zalogowanych użytkowników.
  • /vtc-news: najnowsze publiczne ogłoszenia VTC.
  • /events: nadchodzące wydarzenia publiczne, filtr według gry i wyszukiwarka; każde wydarzenie ma swoją stronę z zapisami, miejscami w konwoju i plikiem kalendarza (.ics).
  • /feed: kanał aktywności społeczności (nowe VTC, dołączenia, długie trasy, wydarzenia, ogłoszenia, partnerstwa).

Inne strony

Strona publiczna

Profile publiczne

  • /drivers/<ID Discord>: miejsce w rankingu (km wśród publicznych VTC), poziom, odznaki i osiągnięcia wraz z ich rzadkością, wyzwanie i liga, VTC główna i ciągnąca, 10 ostatnich dostaw. Personalizacja (kolor, baner, bio, media społecznościowe) jest widoczna u aktywnych wspierających. Główna VTC musi być publiczna.
  • /passport/<ID Discord>: paszport Horizon Dispatch (zatwierdzone dostawy, VTC, publiczne certyfikaty umiejętności).
  • Każdy profil, VTC i ranking ma obraz podglądu przy udostępnianiu na Discordzie i w mediach społecznościowych.
Strona publiczna

Języki i powiadomienia

  • Strona jest dostępna po francusku, angielsku, niemiecku, turecku, hiszpańsku, włosku, polsku i niderlandzku. Język zależy od Twojego wyboru (menu języka, zapamiętywany przez 6 miesięcy), a w przeciwnym razie od języka Discorda lub przeglądarki.
  • Powiadomienia push: zezwól na nie w przeglądarce, aby dowiadywać się o zgłoszeniach (menedżerowie), nowych konwojach i ogłoszeniach Twoich VTC. Stronę można też zainstalować jako aplikację (PWA).
  • Sesja pozostaje otwarta przez 7 dni. Wylogujesz się w menu konta.
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.

Gotowy, by ruszyć w trasę?

Utwórz swoją VTC, zainstaluj tracker i dołącz do społeczności Horizon Dispatch.