Horizon Dispatch Docs 0.7.4

Het hele platform.
Eén documentatie.

Je VTC aanmaken en runnen, de Discord-bot instellen, de tracker installeren, certificering, de anti-cheat en de groeitools begrijpen: heel Horizon Dispatch, stap voor stap uitgelegd.

VTC & Discord ETS2 / ATS-tracker Vertrouwen & veiligheid API & integraties
Aan de slagEerste stappen en account
Aan de slag

Je chauffeursaccount

Dashboard → Mijn profiel bevat alles over jou als chauffeur, ongeacht je VTC. Je openbare profiel staat op /drivers/<your Discord ID>.

Niveau, titels en prestaties

Elke levering levert ervaring op: 1 XP per km, 100 XP per levering en 500 XP per prestatiepunt. Voor het volgende niveau heb je 4.000 XP nodig, daarna telkens 2.000 XP meer per niveau.

Titels: 🔰 Leerling (niv. 1), 🚚 Chauffeur (5), 🛣️ Trucker (10), 📦 Ervaren trucker (18), 🚛 Meester-trucker (28), 🎖️ Veteraan (40), 👑 Meester van de weg (55), 🌟 Legende (75). Ontgrendelde badges en prestaties verschijnen op je profiel, samen met de volgende prestatie om op te mikken.

Gekoppelde accounts: Discord, Steam, TruckersMP

  • Discord: je inlogaccount.
  • Steam: knop Aanmelden via Steam. De aanmelding verloopt via de officiële pagina van Steam: niemand kan jouw Steam in jouw plaats koppelen. Een Steam-account kan maar aan één Discord-account worden gekoppeld.
  • TruckersMP: wordt automatisch gekoppeld en als geverifieerd gemarkeerd zodra je Steam is verbonden. Anders maakt /link truckersmp op Discord een eenvoudige (niet-geverifieerde) koppeling; een via Steam geverifieerde koppeling heeft altijd voorrang.

Je kunt Steam op elk moment verbergen op je openbare profiel of ontkoppelen. Door Steam te verbinden wordt ook de geschiedenis gekoppeld die je VTC tijdens een migratie heeft geïmporteerd.

Hoofd-VTC en trekkende VTC

Als je bij twee VTC's hoort, kies je in Mijn profiel welke je hoofd-VTC is: die krijgt 100% van je leveringen. De tweede, de trekkende VTC, krijgt daarnaast een kopie van 75% (km, inkomsten) van elke levering.

Salaris en saldo

Elke levering stort een deel van de inkomsten in je portemonnee bij je hoofd-VTC (standaard 30%, ingesteld door de VTC). Mijn profiel toont je saldo, je percentage en je laatste 6 transacties. Bonussen en opnames worden door het VTC-team beheerd.

Stream-overlay (OBS)

Klik op Mijn overlay-link genereren om een adres /overlay/<token> te krijgen dat je als "Browserbron" in OBS toevoegt. Het toont je VTC, je niveau, de rit, de vracht, de snelheid en de voortgang, elke 3 seconden ververst zolang de app draait.

  • Opties: ?theme=light en ?accent=ff8800.
  • Als je de link opnieuw genereert, werkt de oude niet meer (handig als hij is uitgelekt).

Personalisatie en Supporter

  • Avatar (8 MB) en banner (16 MB), of terug naar die van Discord.
  • Bio (400 tekens), accentkleur en socials: YouTube, Twitch, X, TikTok, Instagram, Steam, Discord, website.
  • Supporter Profile Studio (actieve maandelijkse steun of permanente supporter-rol): stijl (classic, glass, sunset, neon, minimal), kader, patroon, indeling, dekking, vervaging, gloed, status met emoji, 4 uitgelichte statistieken en 3 uitgelichte badges. Zie Premium & boosts.

Een VTC verlaten

Knop VTC verlaten in de VTC-banner (reden optioneel). De oprichter kan niet vertrekken: die moet eerst het eigendom overdragen (Instellingen → Gevarenzone). Nadat je bent vertrokken, moet je 12 uur wachten voordat je een VTC kunt aanmaken of er lid van kunt worden.

VTC-dashboardJe VTC dagelijks runnen
VTC-dashboard

Leden en werving

De pagina Leden toont je chauffeurs, met zoeken en filters (rol, rang, niveau). Iedereen kan hem lezen; voor acties heb je het recht "Leden beheren" nodig.

  • Voeg een lid toe via Discord-ID, als Chauffeur of Manager. De standaardrol wordt toegekend. Toevoegen mislukt als de VTC vol is of de persoon al in 2 VTC's zit.
  • Iemand Manager maken geeft alle rechten: bewaar dat voor mensen die je vertrouwt.
  • Ken maximaal 5 rollen per lid toe.
  • Verwijder een lid, met een optionele reden.
  • Bekijk welke app-versie elke chauffeur gebruikt.
Een lid dat de Discord-server van de VTC verlaat, wordt "inactief"; het wordt niet verwijderd.

Chauffeurskaart

  • De statistieken van de chauffeur, de voortgang naar de volgende rang en de badges.
  • Salaris en saldo: "Bonus uitkeren" (betaald uit de VTC-kas, de chauffeur krijgt een DM) en "Opname / uitbetaling".
  • Disciplinair dossier: notitie, waarschuwing of sanctie, met een reden (500 tekens).

Wervingscentrum

Sollicitaties die via je openbare pagina worden verstuurd, komen terecht in Sollicitaties (recht "Werving beheren"), met een badge in het menu en een pushmelding naar de managers.

1 Nieuw2 Voorselectie3 Gesprek4 Proefperiode5 Geaccepteerd of afgewezen
  • Tellers: totaal, lopend, gesprekken, proefperiodes, geaccepteerd, afgewezen.
  • Wijs een verantwoordelijke toe (oprichter of manager) en schrijf interne notities (1.200 tekens).
  • Accepteren maakt het lid aan (als er plaats is in de VTC, de persoon niet al in 2 VTC's zit en niet in zijn wachttijd van 12 uur) en plaatst het ingestelde Discord-bericht.

Het sollicitatieformulier vraagt naar: ervaring, beschikbaarheid, motivatie (verplicht), favoriete game, tijdzone, vorige VTC, TruckersMP-profiel en konvooi-ervaring.

VTC-dashboard

Rollen, rangen en divisies

Drie aparte systemen die samenwerken:

SysteemWaarvoorToegekend
RollenRechten geven in het dashboardHandmatig, maximaal 5 per lid
Rank up (rangen)De gereden kilometers belonenAutomatisch, op basis van geleverde km
DivisiesChauffeurs specialiseren (tankwagen, zwaar transport…)Gekozen door de chauffeur in de app

Rollen

Recht "Rollen beheren". Elke rol heeft een naam (40 tekens), een kleur en een keuze uit de 13 rechten. Sleep de rollen om ze te ordenen. De standaardrol (die nieuwe leden krijgen) kan niet worden verwijderd. Het aantal rollen hangt af van de boosts (5 tot 30, zie Premium & boosts).

Rank up

Elke rang heeft een naam, de vereiste km, een kleur en een optionele Discord-rol. Alleen geleverde km tellen mee. Na elke levering (of met Opnieuw synchroniseren) krijgt de chauffeur de Discord-rol van zijn rang, worden oude rollen verwijderd en gaat er een bericht naar het kanaal "rang". De bot moet op de server van de VTC staan.

Divisies

  • Schakel "Divisies in de app" in en kies daarna de modus: één divisie per chauffeur of meerdere gecombineerd.
  • Maximaal 10 divisies, elk met een naam, beschrijving, afbeelding, kleur, lijst van trucks en opleggers en een Discord-rol.
  • Chauffeurs kiezen hun divisie in de app en krijgen de bijbehorende Discord-rol.
VTC-dashboard

Statistieken, ritten en logboek

Elk lid kan deze pagina's lezen.

Statistieken

  • De prestaties van deze maand vergeleken met vorige maand, dagelijkse activiteit, topchauffeurs van de maand.
  • Afstand per chauffeur, verdeling per rol, trend over 12 weken, activiteits-heatmap, favoriete routes en vrachten, leveringen per land, inactieve chauffeurs (14 dagen geen levering).
  • Maanddoelen: één per meetwaarde per maand (recht Instellingen).
  • Handmatige invoer van statistieken (recht "Statistieken bewerken").

Ritten

De laatste 120 leveringen, met gevolgde of gewijzigde route, schade, topsnelheid, snelheidsovertredingen en parkeren. Leveringen die door de anti-cheat apart zijn gezet, blijven zichtbaar, gemarkeerd met "🚫 In beoordeling", "⚠️ Chauffeur gewaarschuwd" of "Valsspelen bevestigd", met de vermelding "Telt niet mee in de statistieken".

Duplicaten opschonen ("Statistieken bewerken") verwijdert identieke leveringen die minder dan 6 uur na elkaar zijn geregistreerd.

Operaties

Het live controlecentrum: chauffeurs online, onderweg met een rit en offline, km en leveringen van vandaag, inkomsten van vandaag, live kaart en activiteitenfeed. Een chauffeur is "online" als zijn app zich minder dan 60 seconden geleden heeft gemeld; de pagina ververst elke 5 seconden.

Activiteitenlogboek

Recht "Activiteitenlogboek bekijken". Toont de laatste 100 acties van de VTC: komen en gaan van leden, rolwijzigingen, evenementen, instellingen, doorverwijzingen… Er is geen export.

VTC-dashboard

Evenementen en konvooien

Het tabblad Evenementen (ook alleen bekijken) wordt ontgrendeld bij 2 boosts. Voor aanmaken of bewerken heb je het recht "Evenementen beheren" nodig.

  • Titel, beschrijving in Markdown, categorie (konvooi, bijeenkomst, training, race, officieel, overig), game, server, taal, banner, kleur.
  • Vertrek en aankomst, maximaal 20 tussenstops, geplande km, kaart-DLC, verzameltijd en vertrektijd.
  • Regels, spraakkanaal, verplichte livery, maximumaantal deelnemers (0 = onbeperkt), maximaal 200 konvooiposities (standaard 20).
  • Importeren uit TruckersMP: plak een link of ID van een TruckersMP-evenement om het formulier vooraf in te vullen.
  • "Zichtbaar op de openbare pagina" toont het op /vtcs/your-vtc en /events; anders blijft het alleen voor leden.

Bij het aanmaken: een Discord-bericht in het kanaal "evenementen" en een pushmelding naar de leden. De knop Opnieuw melden verstuurt ze opnieuw. Chauffeurs schrijven zich in ("Ik doe mee" of "Misschien") via de website of de app; de app herinnert ze 30 min en 10 min van tevoren en op het vertrekmoment. Elk openbaar evenement kan ook als agendabestand (.ics) worden gedownload.

VTC-dashboard

Aankondigingen, galerij en samenwerkingen

Aankondigingen (4 boosts)

Titel (140 tekens), inhoud in Markdown (6.000), omslagafbeelding, vastgezet, gepubliceerd of concept, zichtbaar op de openbare pagina. Een gepubliceerde aankondiging gaat naar Discord, als pushmelding en naar de bel in de app. "Opnieuw melden" werkt alleen voor een gepubliceerde aankondiging. Leden die geen staff zijn, zien alleen gepubliceerde aankondigingen.

Samenwerkingen

Recht "Samenwerkingen beheren". Een verzoek versturen vereist 4 boosts en is gericht aan een openbare VTC (via zijn identificatie). Een samenwerking accepteren, weigeren of verwijderen kan zonder boosts. Geaccepteerde samenwerkingen verschijnen op de openbare pagina's en in de app.

VTC-dashboard

Wagenpark en economie

Twee economieën draaien naast elkaar:

ValutaGevoed door
Salarissen en kasInkomsten in de game (€ / $)Elke levering: een deel (standaard 30%, instelbaar van 0 tot 100%) gaat naar de portemonnee van de chauffeur, de rest naar de VTC-kas.
WagenparkHorizon Credits (◈ CH)150.000 CH om te beginnen, daarna per levering: km × 12 + 5% van de inkomsten, verminderd bij schade en snelheidsovertredingen.

Wagenpark

Leesbaar voor iedereen; voor acties heb je "Wagenpark beheren" nodig. Maximaal 50 trucks en 50 opleggers worden getoond.

  • Wijs een chauffeur toe, stel een hoofdtruck in (die krijgt de leveringen als geen enkele truck overeenkomt), hernoem, vul het kenteken in (16 tekens).
  • Onderhoud van trucks: algemeen elke 45.000 km (2.500 CH), motor elke 150.000 km (9.000 CH), banden elke 175.000 km (6.000 CH).
  • Vervanging van onderdelen: motor 25.000, versnellingsbak 18.000, banden 8.000, chassis 12.000 CH. Een onderdeel is kritiek vanaf 20% slijtage.
  • Opleggers: algemeen elke 60.000 km (1.800 CH), banden elke 150.000 km (4.200 CH); vervanging banden 6.000, remmen 7.000, chassis 9.000 CH.
  • Doorverkoop: ongeveer 85% van de prijs, min afschrijving door km en slijtage.
  • Kritieke slijtage en achterstallig onderhoud worden op Discord gemeld. De app kan de echte trucks uit je savegame importeren.

Dealer

Catalogus met nieuwe trucks en opleggers voor ETS2 en ATS (inclusief generieke, mod-compatibele modellen) en een tweedehandsmarkt met 6 aanbiedingen die elke dag worden vernieuwd. Kopen mislukt als het creditsaldo te laag is.

Monteurs

Maximaal 6 monteurs, elk met een snelheid van 1 tot 5 en een specialiteit (allround, algemeen, motor, versnellingsbak, banden, chassis, remmen). Een monteur met de juiste specialiteit verlaagt de kosten met 15%, plus 3% per niveau, tot maximaal 50%. Tijdens werkzaamheden staat de truck stil (algemeen 30 min, motor 2 u, banden 1 u, vervanging 3 u, korter naarmate de monteur sneller is). Zonder monteurs zijn werkzaamheden direct klaar.

Elke monteur wordt elke week betaald uit de credits van het wagenpark (van 1.200 CH per week bij snelheid 1 tot 4.800 CH bij snelheid 5, +35% voor een allrounder). Als de credits op zijn, neemt hij ontslag en meldt het logboek van de VTC dat.

VTC-dashboard

VTC-website

Niet te verwarren met de openbare pagina /vtcs/your-vtc (altijd beschikbaar): de website is een aparte, volledige site, gepubliceerd op /vtcs/your-vtc/site. Daarvoor heb je 5 boosts en het recht Instellingen nodig, en daarna de schakelaar "Site publiceren".

  • Uiterlijk: 6 thema's (Horizon, Oceaan, Bos, Neonviolet, Karmozijn, Puur goud), 6 lettertypen, hoeken, ruimte, hero-hoogte, achtergrond, knopstijl, accentkleur.
  • 18 modules om te ordenen: hero, over ons, statistieken, leden, klassement, wagenpark, galerij, video, FAQ, oproep tot actie, werving, evenementen, aankondigingen, partners, steun, contact, socials, vrije tekst.
  • Per sectie: achtergrond, achtergrondafbeelding, uitlijning en kolommen.
  • Ontvangen berichten: de laatste 50 berichten uit de Contact-module, ook verstuurd naar het Discord-kanaal "contact".

De gewone openbare pagina pas je aan in Instellingen (thema en banner van de pagina vanaf 2 boosts).

VTC-dashboard

VTC-instellingen

Recht "Instellingen beheren", tenzij anders vermeld.

TabbladInstellingen
IdentiteitNaam (40 tekens, wijzigt ook het adres), beschrijving (2.000), logo (URL of upload, 2 MB), banner (2 boosts, 5 MB), thema van de openbare pagina (2 boosts), kleur, game, land.
Werving & zichtbaarheidWerving open, zichtbaar in het overzicht, standaardrol (met "Toepassen op leden zonder rang").
Tracker & DiscordTag (8 tekens), snelheidslimiet, inkomsten publiek zichtbaar, leveringenkanaal, levering-webhook (HTTPS), chauffeurssalaris (%), aankondigingenkanaal, galerijkanaal.
PlatformsID's van TruckersMP, Trucky en TrucksHub.
Links8 sociale netwerken.
TeamManagers toevoegen of verwijderen (recht Leden).
LedenonboardingOnboarding-checklist van maximaal 20 stappen, getoond aan nieuwe leden.
APIDe openbare API en de widgets in- of uitschakelen, de ledenlijst openbaar maken (gratis). Openbare sleutel pk_… voor API v1 vanaf 5 boosts (alleen de oprichter kan hem opnieuw genereren). Zie Ontwikkelaars.
GevarenzoneAlleen de oprichter: eigendom overdragen (de vorige oprichter wordt manager) of de VTC verwijderen, door de naam ervan te typen.
Het leveringenkanaal ontvangt ook niet-voltooide ritten, door de anti-cheat geblokkeerde leveringen en waarschuwingen over het wagenpark. De levering-webhook stuurt elke levering naar een HTTPS-URL naar keuze (in Discord-formaat als het een Discord-webhook is).
VTC-dashboard

Ecosysteem

De pagina Ecosysteem van de VTC, zonder boost, toegankelijk voor staff (elk recht):

  • Horizon Network: maak een openbaar of privénetwerk van VTC's aan, of sluit je aan bij een netwerk met een code.
  • Konvooioperaties met checkpoints en status.
  • Uitdagingen tussen VTC's, samen of tegen elkaar.
  • Gedeelde contracten tussen VTC's.
  • Geverifieerde vaardigheden: certificeringen en onderscheidingen van chauffeurs.
  • Synchronisatie van evenementen tussen platforms (Discord beschikbaar, andere in ontwikkeling).
  • OAuth-app "Horizon Connect" (het geheim wordt maar één keer getoond) en webhooks (HTTPS, alleen naar openbare adressen). Zie Ontwikkelaars.
  • Marktplaats: elk lid kan een advertentie plaatsen, die verschijnt op /ecosystem/marketplace.
Discord botServer, channels, tickets, commands
Discord bot

VTC channels and messages

Two pages control what the bot posts for your VTC (Settings permission):

WhereWhat
Settings → Tracker & DiscordDeliveries channel, announcements channel, gallery channel, delivery webhook.
Your VTC → DiscordServer ID, 7 dedicated channels (default, announcements, events, new applications, application decisions, rank, contact) and 8 message types.

For each message type (announcement, event, application received, application accepted, refused, promotion, demotion, website contact): on or off, colour, title, text with variables, up to 10 roles to mention, "Mention the person concerned" and a Send a test button. Without a dedicated channel, the bot uses the default channel, then the announcements channel.

What the deliveries channel posts

  • Every delivery: route, companies, km (and detour), income, €/km, truck, game, market (standard or World of Trucks), damage, top speed, speeding, parking, driving score, level progress, "View the delivery" button.
  • "⛔ Unfinished trip" when a delivery was not tracked from its start (statistics blocked).
  • "Delivery blocked" when the anti-cheat sets it aside.
  • Wear and service alerts from the fleet.

Other automatic messages

  • Weekly report every Monday.
  • A driver's level up (plus a DM to the driver).
  • Grade (rank up) in the "rank" channel, with the Discord role updated.
  • Announcements (4 boosts) and events (2 boosts) published from the dashboard.
  • A warning from the anti-cheat team: DM to the driver and a message in the announcements channel.
Discord bot

Bot config: server systems

Bot config → pick a server. These settings apply to the Discord server, not the VTC, and need no boost.

SystemWhat it does
👋 Welcome messageWelcome card in the chosen channel, optional image, and an auto role (given even when the message is off). Variables: {user}, {username}, {server}, {count}.
🙋 Leave messageMessage when a member leaves the server. Variables: {username}, {server}, {count}.
🎭 Reaction rolesPanel of buttons that give or remove a role: title, description, up to 25 roles with emoji. Deleting the panel deletes the Discord message.
📢 EmbedPost or edit a bot message: classic embed or Components V2, title, text (4,000), colour, image, footer, up to 5 link buttons.
🔔 Horizon Dispatch notificationsChannels that receive official Horizon Dispatch announcements (updates, maintenance).
📋 Server logs8 categories to tick: members, messages, roles, channels, sanctions, voice, server, VTC. The author of an action is found through the server audit log.
🟢 Live convoy statusA message updated every 90 s with the VTC's drivers on the road (up to 25). The VTC must be linked to this server.
🔢 Member countersRenames voice channels into counters (members, online, bots, boosts) every 10 minutes.
🚛 TruckersMP relayReposts the news, events and partners of your TruckersMP VTC (ID to enter), every 10 minutes.
Commands only work on a server (not in DMs). You can restrict each command by role or channel in Server settings → Integrations.
Discord bot

Tickets

Your VTC → Tickets ("Manage tickets" permission, no boost). Create as many panels as you like (support, recruitment, partnerships…).

  • Per panel: name, colour, panel channel, ticket category, support role, name format (ticket-{user}), panel title and text, button text, emoji and style, welcome message, close label, support role mention.
  • Deploy posts the panel on Discord (the bot must be online).
  • Each member can have one open ticket per panel. The private channel is visible to the member, the support role and the bot.
  • Anyone in the ticket can close it; the channel is then deleted after a few seconds, with no transcript.
Discord bot

Slash commands

Translated commands (/vtc, /truckersmp, /aide, server and moderation) answer in the language set for the server with /langue, otherwise in each member's Discord language (French, English, German, Turkish, Spanish, Italian, Polish, Dutch). The others answer in French. A short list is also on /commands.

VTCs and drivers

CommandPurpose
/vtc register nom jeuCreate your VTC and link it to this server.
/vtc info · /vtc membersYour VTC's card and members.
/vtc public nomA VTC's public card.
/vtc setplatformSet the TruckersMP, Trucky or TrucksHub ID (founder, manager or Manage Server).
/driver join · leave · profileJoin the server's VTC (recruitment open), leave it, view a profile (grade, status, stats, last 3 deliveries, TruckersMP).
/leaderboard critere periodeThe VTC's top 10 by distance, deliveries or income, over the week, the month or all time.
/live globalDrivers on the road right now (your VTC, or the whole platform).
/statsStatistics of the server's VTC: live, week, total, members, top of the week, favourite route and cargo.
/link truckersmp id · show · removeLink your TruckersMP account (a TruckersMP account can be linked to one Discord only).

TruckersMP

CommandPurpose
/joueur idA TruckersMP player's card.
/bans idA player's last 5 bans.
/serveursTruckersMP servers table.
/truckersmp servers · player · companyTruckersMP servers, player or VTC.
/events id salonOne TruckersMP event or the next 6; with salon, the result is posted there.
/vtcinfos info · events · membres · partenariats · newsInformation about a TruckersMP VTC (members page by page).
/traffic jeu serveurTraffic areas on TruckersMP servers (Trucky data).

Server and moderation

CommandPurpose
/accueil bienvenue · aurevoirSet up welcome and leave messages from Discord (Manage Server).
/roles-react panneau · ajouter · retirerRole button panels (Manage Roles).
/role ajouter · retirerGive or remove a role (Manage Roles).
/clear nombre membreDelete 1 to 100 messages less than 14 days old (Manage Messages).
/say salonMake the bot speak, as text or embed (Manage Messages).
/sondageNative Discord poll: 2 to 6 options, from 1 hour to 14 days, multiple choice possible.
/alertes configurer · supprimerHorizon Dispatch notification channels (Manage Server).
/langueThe bot's language on this server, or "Automatic" for each member's language (Manage Server). Also applies to welcome and leave messages.
/vtcs ajouter · infos · liste · vérifier · supprimerThe VTC's links on TruckersMP, Trucky, TruckersHub or VTLog, specific to this server (Administrator).
/avatar · /userinfo · /serverinfoAvatar, member card, server card.

Help

CommandPurpose
/aideHelp menu by category.
/info bot · serveur · system · vtcInformation about the bot, the server, service status and the platform.
/rapport-bugReport a bug to the team (area, severity, description). You get a DM on each status change.
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.

Klaar om de weg op te gaan?

Maak je VTC aan, installeer de tracker en word lid van de Horizon Dispatch-community.