Horizon Dispatch Docs 0.7.4

Tutta la piattaforma.
Un'unica documentazione.

Crea e gestisci la tua VTC, configura il bot Discord, installa il tracker, scopri la certificazione, l'anti-cheat e gli strumenti di crescita: tutto Horizon Dispatch, spiegato passo dopo passo.

VTC e Discord Tracker ETS2 / ATS Fiducia e sicurezza API e integrazioni
Primi passiInizio e account
Primi passi

Il tuo account autista

Dashboard → Il mio profilo raccoglie tutto ciò che ti riguarda come autista, qualunque sia la tua VTC. Il tuo profilo pubblico si trova su /drivers/<il tuo ID Discord>.

Livello, titoli e obiettivi

Ogni consegna fa guadagnare esperienza: 1 XP per km, 100 XP per consegna e 500 XP per punto obiettivo. Il livello successivo richiede 4.000 XP, poi 2.000 XP in più per ogni livello.

Titoli: 🔰 Apprendista (liv. 1), 🚚 Autista (5), 🛣️ Camionista (10), 📦 Camionista esperto (18), 🚛 Grande camionista (28), 🎖️ Veterano (40), 👑 Maestro della strada (55), 🌟 Leggenda (75). Badge e obiettivi sbloccati compaiono sul tuo profilo, insieme al prossimo obiettivo da raggiungere.

Account collegati: Discord, Steam, TruckersMP

  • Discord: il tuo account di accesso.
  • Steam: pulsante Accedi tramite Steam. L'accesso passa dalla pagina ufficiale di Steam: nessuno può collegare il tuo Steam al posto tuo. Un account Steam può essere collegato a un solo account Discord.
  • TruckersMP: collegato e segnato come verificato automaticamente non appena il tuo Steam è connesso. Altrimenti, /link truckersmp su Discord crea un collegamento semplice (non verificato); un collegamento verificato tramite Steam ha sempre la precedenza.

Puoi nascondere Steam dal tuo profilo pubblico o scollegarlo in qualsiasi momento. Collegare Steam associa anche lo storico che la tua VTC ha importato durante una migrazione.

VTC principale e VTC di traino

Se fai parte di due VTC, scegli in Il mio profilo quale è la tua VTC principale: riceve il 100% delle tue consegne. La seconda, la VTC di traino, riceve in più una copia al 75% (km, ricavi) di ogni consegna.

Stipendio e saldo

Ogni consegna versa una parte dei suoi ricavi nel tuo portafoglio nella VTC principale (30% di default, deciso dalla VTC). Il mio profilo mostra il tuo saldo, la tua percentuale e le tue ultime 6 transazioni. Bonus e prelievi sono gestiti dal team della VTC.

Overlay stream (OBS)

Clicca su Genera il link per ottenere un indirizzo /overlay/<token> da aggiungere come "Sorgente browser" in OBS. Mostra la tua VTC, il tuo livello, il viaggio, il carico, la velocità e l'avanzamento, aggiornati ogni 3 secondi mentre l'app è in esecuzione.

  • Opzioni: ?theme=light e ?accent=ff8800.
  • Rigenerare il link disattiva quello vecchio (utile se è trapelato).

Personalizzazione e Supporter

  • Avatar (8 MB) e banner (16 MB), oppure ritorno a quelli di Discord.
  • Bio (400 caratteri), colore d'accento e social: YouTube, Twitch, X, TikTok, Instagram, Steam, Discord, sito web.
  • Supporter Profile Studio (supporto mensile attivo o ruolo supporter permanente): stile (classico, vetro, tramonto, neon, minimal), cornice, motivo, layout, opacità, sfocatura, bagliore, stato con emoji, 4 statistiche e 3 badge in evidenza. Vedi Premium e boost.

Lasciare una VTC

Pulsante Lascia la VTC nel banner della VTC (motivo facoltativo). Il fondatore non può uscire: deve prima trasferire la proprietà (Impostazioni → Zona sensibile). Dopo l'uscita, devi aspettare 12 ore prima di creare una VTC o di unirti a un'altra.

Dashboard della VTCGestire la tua VTC ogni giorno
Dashboard della VTC

Membri e reclutamento

La pagina Membri elenca i tuoi autisti con ricerca e filtri (ruolo, grado, rank). Tutti possono leggerla; le azioni richiedono l'autorizzazione "Gestire i membri".

  • Aggiungi un membro tramite ID Discord, come Autista o Manager. Viene applicato il ruolo predefinito. L'aggiunta non riesce se la VTC è piena o se la persona è già in 2 VTC.
  • Nominare qualcuno Manager gli dà tutti i diritti: riservalo a persone di fiducia.
  • Assegna fino a 5 ruoli per membro.
  • Rimuovi un membro, con un motivo facoltativo.
  • Vedi quale versione dell'app usa ogni autista.
Un membro che lascia il server Discord della VTC diventa "inattivo"; non viene rimosso.

Scheda autista

  • Le statistiche dell'autista, l'avanzamento di grado e i badge.
  • Stipendio e saldo: "Versa un premio" (pagato dalla tesoreria della VTC, l'autista riceve un DM) e "Prelievo / pagamento".
  • Storico disciplinare: nota, avvertimento o sanzione, con un motivo (500 caratteri).

Centro reclutamento

Le candidature inviate dalla tua pagina pubblica arrivano in Candidature (autorizzazione "Gestire il reclutamento"), con un badge nel menu e una notifica push ai manager.

1 Nuova2 Preselezione3 Colloquio4 Periodo di prova5 Accettata o rifiutata
  • Contatori: totale, in corso, colloqui, prove, accettate, rifiutate.
  • Assegna un responsabile (fondatore o manager) e scrivi note interne (1.200 caratteri).
  • Accetta crea il membro (se la VTC ha posto, la persona non è in 2 VTC e non è nelle sue 12 ore di attesa) e pubblica il messaggio Discord configurato.

Il modulo di candidatura chiede: esperienza, disponibilità, motivazione (obbligatoria), gioco preferito, fuso orario, VTC precedente, profilo TruckersMP ed esperienza nei convogli.

Dashboard della VTC

Ruoli, gradi e divisioni

Tre sistemi distinti che funzionano insieme:

SistemaServe aAssegnazione
RuoliConcedere autorizzazioni nella dashboardA mano, fino a 5 per membro
Rank up (gradi)Premiare i chilometri percorsiAutomatica, dai km consegnati
DivisioniSpecializzare gli autisti (cisterna, trasporto eccezionale…)Scelta dall'autista nell'app

Ruoli

Autorizzazione "Gestire i ruoli". Ogni ruolo ha un nome (40 caratteri), un colore e una scelta tra le 13 autorizzazioni. Trascina i ruoli per ordinarli. Il ruolo predefinito (dato ai nuovi membri) non può essere eliminato. Il numero di ruoli dipende dai boost (da 5 a 30, vedi Premium e boost).

Rank up

Ogni grado ha un nome, i km richiesti, un colore e un ruolo Discord facoltativo. Contano solo i km consegnati. Dopo ogni consegna (o con Risincronizza), l'autista riceve il ruolo Discord del suo grado, quelli vecchi vengono rimossi e un messaggio arriva nel canale "rank". Il bot deve essere sul server della VTC.

Divisioni

  • Attiva "Divisioni nell'app", poi scegli la modalità: una sola divisione per autista o più divisioni cumulabili.
  • Fino a 10 divisioni, ciascuna con nome, descrizione, immagine, colore, elenco di camion e rimorchi e un ruolo Discord.
  • Gli autisti scelgono la loro divisione nell'app e ricevono il ruolo Discord corrispondente.
Dashboard della VTC

Statistiche, viaggi e registro

Tutti i membri possono leggere queste pagine.

Statistiche

  • Le prestazioni del mese confrontate con il mese scorso, l'attività giornaliera, i migliori autisti del mese.
  • Distanza per autista, distribuzione per ruolo, andamento su 12 settimane, heatmap di attività, percorsi e carichi preferiti, consegne per paese, autisti inattivi (nessuna consegna da 14 giorni).
  • Obiettivi mensili: uno per metrica al mese (autorizzazione Impostazioni).
  • Inserimento manuale delle statistiche (autorizzazione "Modificare le statistiche").

Viaggi

Le ultime 120 consegne con percorso rispettato o modificato, danni, velocità massima, eccessi di velocità e parcheggio. Le consegne messe da parte dall'anti-cheat restano visibili, contrassegnate da "🚫 In verifica", "⚠️ Autista avvertito" o "Imbroglio confermato", con la nota "Non conteggiata nelle statistiche".

Pulisci duplicati ("Modificare le statistiche") rimuove le consegne identiche registrate a meno di 6 ore di distanza.

Operazioni

Il centro di controllo in diretta: autisti online, in consegna e offline, km e consegne di oggi, ricavi di oggi, mappa in diretta e flusso di attività. Un autista è "online" se la sua app ha dato segni di vita meno di 60 secondi fa; la pagina si aggiorna ogni 5 secondi.

Registro attività

Autorizzazione "Vedere il registro attività". Mostra le ultime 100 azioni della VTC: arrivi e partenze, cambi di ruolo, eventi, impostazioni, referral… Non c'è esportazione.

Dashboard della VTC

Eventi e convogli

La scheda Eventi (consultazione compresa) si sblocca a 2 boost. Per creare o modificare serve l'autorizzazione "Gestire gli eventi".

  • Titolo, descrizione in Markdown, categoria (convoglio, incontro, formazione, gara, ufficiale, altro), gioco, server, lingua, banner, colore.
  • Partenza e arrivo, fino a 20 tappe, km previsti, DLC della mappa, orari di ritrovo e di partenza.
  • Regole, canale vocale, livrea richiesta, partecipanti massimi (0 = illimitati), fino a 200 posizioni nel convoglio (20 di default).
  • Importa da TruckersMP: incolla il link o l'ID di un evento TruckersMP per precompilare il modulo.
  • "Visibile sulla pagina pubblica" lo mostra su /vtcs/your-vtc e su /events; altrimenti resta riservato ai membri.

Alla creazione: un messaggio Discord nel canale "events" e una notifica push ai membri. Il pulsante Notifica di nuovo li reinvia. Gli autisti si iscrivono ("Partecipo" o "Forse") dal sito o dall'app; l'app glielo ricorda 30 min e 10 min prima e all'ora di partenza. Ogni evento pubblico si può anche scaricare come file calendario (.ics).

Dashboard della VTC

Annunci, galleria e partnership

Annunci (4 boost)

Titolo (140 caratteri), contenuto in Markdown (6.000), immagine di copertina, fissato in alto, pubblicato o bozza, visibile sulla pagina pubblica. Un annuncio pubblicato arriva su Discord, come notifica push e nella campanella dell'app. "Notifica di nuovo" funziona solo per un annuncio pubblicato. I membri che non sono staff vedono solo gli annunci pubblicati.

Partnership

Autorizzazione "Gestire le partnership". Inviare una richiesta richiede 4 boost e si rivolge a una VTC pubblica (tramite il suo identificativo). Accettare, rifiutare o rimuovere una partnership funziona senza boost. Le partnership accettate compaiono sulle pagine pubbliche e nell'app.

Dashboard della VTC

Flotta ed economia

Due economie convivono:

ValutaAlimentata da
Stipendi e tesoreriaRicavi in gioco (€ / $)Ogni consegna: una quota (30% di default, regolabile da 0 a 100%) va nel portafoglio dell'autista, il resto nella tesoreria della VTC.
FlottaCrediti Horizon (◈ CH)150.000 CH per iniziare, poi per ogni consegna: km × 12 + 5% dei ricavi, ridotti da danni ed eccessi di velocità.

Flotta

Leggibile da tutti; le azioni richiedono "Gestire la flotta". Vengono mostrati fino a 50 camion e 50 rimorchi.

  • Assegna un autista, imposta un camion principale (riceve le consegne quando nessun camion corrisponde), rinomina, inserisci la targa (16 caratteri).
  • Manutenzioni del camion: generale ogni 45.000 km (2.500 CH), motore ogni 150.000 km (9.000 CH), pneumatici ogni 175.000 km (6.000 CH).
  • Sostituzione dei componenti: motore 25.000, cambio 18.000, pneumatici 8.000, telaio 12.000 CH. Un componente è critico dal 20% di usura.
  • Rimorchi: generale ogni 60.000 km (1.800 CH), pneumatici ogni 150.000 km (4.200 CH); sostituzione pneumatici 6.000, freni 7.000, telaio 9.000 CH.
  • Rivendita: circa l'85% del prezzo, meno la svalutazione dovuta a km e usura.
  • L'usura critica e le manutenzioni scadute vengono segnalate su Discord. L'app può importare i camion reali dal tuo salvataggio.

Concessionaria

Catalogo di camion e rimorchi nuovi per ETS2 e ATS (compresi modelli generici compatibili con le mod) e un mercato dell'usato di 6 offerte rinnovate ogni giorno. L'acquisto non riesce se il saldo di crediti è troppo basso.

Meccanici

Fino a 6 meccanici, ciascuno con una velocità da 1 a 5 e una specialità (polivalente, generale, motore, cambio, pneumatici, telaio, freni). Un meccanico con la specialità giusta riduce il costo del 15%, più il 3% per livello, fino al 50%. I lavori tengono il camion fermo (generale 30 min, motore 2 h, pneumatici 1 h, sostituzione 3 h, ridotti dalla velocità del meccanico). Senza meccanici, i lavori sono immediati.

Ogni meccanico viene pagato ogni settimana con i crediti della flotta (da 1.200 CH a settimana a velocità 1 fino a 4.800 CH a velocità 5, +35% per un polivalente). Se i crediti finiscono, si dimette e il registro della VTC lo segnala.

Dashboard della VTC

Sito web della VTC

Da non confondere con la pagina pubblica /vtcs/your-vtc (sempre disponibile): il sito web è un sito completo a parte, pubblicato su /vtcs/your-vtc/site. Richiede 5 boost e l'autorizzazione Impostazioni, poi l'interruttore "Pubblica il sito".

  • Aspetto: 6 temi (Horizon, Oceano, Foresta, Viola neon, Cremisi, Oro puro), 6 caratteri, angoli, spaziatura, altezza hero, sfondo, stile pulsanti, colore d'accento.
  • 18 moduli da ordinare: hero, chi siamo, statistiche, membri, classifica, flotta, galleria, video, FAQ, invito all'azione, reclutamento, eventi, annunci, partner, supporto, contatto, social, testo libero.
  • Per sezione: sfondo, immagine di sfondo, allineamento e colonne.
  • Messaggi ricevuti: gli ultimi 50 messaggi del modulo Contatto, inviati anche al canale Discord "contact".

La normale pagina pubblica si personalizza in Impostazioni (tema della pagina e banner da 2 boost).

Dashboard della VTC

Impostazioni della VTC

Autorizzazione "Gestire le impostazioni", salvo indicazione contraria.

SchedaImpostazioni
IdentitàNome (40 caratteri, cambia anche l'indirizzo), descrizione (2.000), logo (URL o caricamento, 2 MB), banner (2 boost, 5 MB), tema della pagina pubblica (2 boost), colore, gioco, paese.
Reclutamento e visibilitàReclutamento aperto, visibile nell'elenco, ruolo predefinito (con "Applica ai membri senza grado").
Tracker e DiscordTag (8 caratteri), limite di velocità, ricavi visibili pubblicamente, canale consegne, webhook di consegna (HTTPS), stipendio autista (%), canale annunci, canale galleria.
PiattaformeID TruckersMP, Trucky e TrucksHub.
Link8 social network.
TeamAggiungi o rimuovi manager (autorizzazione Membri).
Accoglienza membriChecklist di avvio fino a 20 passi, mostrata ai nuovi membri.
APIAttiva o disattiva l'API pubblica e i widget, esponi l'elenco dei membri (gratis). Chiave pubblica API v1 pk_… da 5 boost (solo il fondatore può rigenerarla). Vedi Sviluppatori.
Zona sensibileSolo il fondatore: trasferire la proprietà (l'ex fondatore diventa manager) o eliminare la VTC, digitandone il nome.
Il canale consegne riceve anche i viaggi non conclusi, le consegne bloccate dall'anti-cheat e gli avvisi della flotta. Il webhook di consegna invia ogni consegna a un URL HTTPS a tua scelta (formato Discord se è un webhook Discord).
Dashboard della VTC

Ecosistema

La pagina Ecosistema della VTC, senza boost, aperta allo staff (qualsiasi autorizzazione):

  • Horizon Network: crea una rete di VTC pubblica o privata, oppure unisciti a una con un codice.
  • Operazioni di convoglio con checkpoint e stato.
  • Sfide VTC contro VTC, cooperative o testa a testa.
  • Contratti condivisi tra VTC.
  • Competenze verificate: certificazioni e riconoscimenti degli autisti.
  • Sincronizzazione degli eventi tra piattaforme (Discord disponibile, altre in arrivo).
  • App OAuth "Horizon Connect" (il segreto viene mostrato una sola volta) e webhook (HTTPS solo verso indirizzi pubblici). Vedi Sviluppatori.
  • Marketplace: qualsiasi membro può pubblicare un annuncio, visibile su /ecosystem/marketplace.
Bot DiscordServer, canali, ticket, comandi
Bot Discord

Canali e messaggi della VTC

Due pagine controllano ciò che il bot pubblica per la tua VTC (autorizzazione Impostazioni):

DoveCosa
Impostazioni → Tracker e DiscordCanale consegne, canale annunci, canale galleria, webhook di consegna.
La tua VTC → DiscordID del server, 7 canali dedicati (predefinito, annunci, eventi, nuove candidature, decisioni sulle candidature, rank, contatto) e 8 tipi di messaggio.

Per ogni tipo di messaggio (annuncio, evento, candidatura ricevuta, candidatura accettata, rifiutata, promozione, retrocessione, contatto dal sito): attivo o disattivo, colore, titolo, testo con variabili, fino a 10 ruoli da menzionare, "Menzionare la persona interessata" e un pulsante Invia un test. Senza un canale dedicato, il bot usa il canale predefinito, poi il canale annunci.

Cosa pubblica il canale consegne

  • Ogni consegna: percorso, aziende, km (e deviazione), ricavi, €/km, camion, gioco, mercato (standard o World of Trucks), danni, velocità massima, eccessi di velocità, parcheggio, punteggio di guida, avanzamento di livello, pulsante "Vedi la consegna".
  • "⛔ Viaggio incompleto" quando una consegna non è stata tracciata dall'inizio (statistiche bloccate).
  • "Consegna bloccata" quando l'anti-cheat la mette da parte.
  • Avvisi di usura e di manutenzione della flotta.

Altri messaggi automatici

  • Report settimanale ogni lunedì.
  • Il passaggio di livello di un autista (più un DM all'autista).
  • Grado (rank up) nel canale "rank", con il ruolo Discord aggiornato.
  • Annunci (4 boost) ed eventi (2 boost) pubblicati dalla dashboard.
  • Un avvertimento del team anti-cheat: DM all'autista e un messaggio nel canale annunci.
Bot Discord

Configurazione bot: sistemi del server

Configurazione bot → scegli un server. Queste impostazioni valgono per il server Discord, non per la VTC, e non richiedono boost.

SistemaCosa fa
👋 Messaggio di benvenutoScheda di benvenuto nel canale scelto, immagine facoltativa e un ruolo automatico (assegnato anche quando il messaggio è disattivato). Variabili: {user}, {username}, {server}, {count}.
🙋 Messaggio di addioMessaggio quando un membro lascia il server. Variabili: {username}, {server}, {count}.
🎭 Ruoli a reazionePannello di pulsanti che danno o tolgono un ruolo: titolo, descrizione, fino a 25 ruoli con emoji. Eliminare il pannello elimina il messaggio Discord.
📢 EmbedPubblica o modifica un messaggio del bot: embed classico o Components V2, titolo, testo (4.000), colore, immagine, piè di pagina, fino a 5 pulsanti link.
🔔 Notifiche Horizon DispatchCanali che ricevono gli annunci ufficiali di Horizon Dispatch (aggiornamenti, manutenzione).
📋 Log del server8 categorie da spuntare: membri, messaggi, ruoli, canali, sanzioni, vocale, server, VTC. L'autore di un'azione viene ricavato dal registro attività del server.
🟢 Stato del convoglio in direttaUn messaggio aggiornato ogni 90 s con gli autisti della VTC in strada (fino a 25). La VTC deve essere collegata a questo server.
🔢 Contatori di membriRinomina dei canali vocali in contatori (membri, online, bot, boost) ogni 10 minuti.
🚛 Relay TruckersMPRipubblica le novità, gli eventi e i partner della tua VTC TruckersMP (ID da inserire), ogni 10 minuti.
I comandi funzionano solo su un server (non nei DM). Puoi limitare ogni comando per ruolo o canale in Impostazioni server → Integrazioni.
Bot Discord

Ticket

La tua VTC → Ticket (autorizzazione "Gestire i ticket", nessun boost). Crea tutti i pannelli che vuoi (supporto, reclutamento, partnership…).

  • Per pannello: nome, colore, canale del pannello, categoria dei ticket, ruolo di supporto, formato del nome (ticket-{user}), titolo e testo del pannello, testo, emoji e stile del pulsante, messaggio di benvenuto, etichetta di chiusura, menzione del ruolo di supporto.
  • Pubblica invia il pannello su Discord (il bot deve essere online).
  • Ogni membro può avere un solo ticket aperto per pannello. Il canale privato è visibile al membro, al ruolo di supporto e al bot.
  • Chiunque sia nel ticket può chiuderlo; il canale viene poi eliminato dopo qualche secondo, senza trascrizione.
Bot Discord

Comandi slash

I comandi tradotti (/vtc, /truckersmp, /aide, server e moderazione) rispondono nella lingua impostata per il server con /langue, altrimenti nella lingua Discord di ogni membro (francese, inglese, tedesco, turco, spagnolo, italiano, polacco, olandese). Gli altri rispondono in francese. Un elenco breve si trova anche su /commands.

VTC e autisti

ComandoA cosa serve
/vtc register nom jeuCrea la tua VTC e la collega a questo server.
/vtc info · /vtc membersLa scheda e i membri della tua VTC.
/vtc public nomLa scheda pubblica di una VTC.
/vtc setplatformImposta l'ID TruckersMP, Trucky o TrucksHub (fondatore, manager o Gestire il server).
/driver join · leave · profileUnirsi alla VTC del server (reclutamento aperto), lasciarla, vedere un profilo (grado, stato, statistiche, ultime 3 consegne, TruckersMP).
/leaderboard critere periodeLa top 10 della VTC per distanza, consegne o ricavi, sulla settimana, sul mese o da sempre.
/live globalGli autisti in strada in questo momento (la tua VTC o tutta la piattaforma).
/statsStatistiche della VTC del server: in diretta, settimana, totale, membri, top della settimana, percorso e carico preferiti.
/link truckersmp id · show · removeCollega il tuo account TruckersMP (un account TruckersMP può essere collegato a un solo Discord).

TruckersMP

ComandoA cosa serve
/joueur idLa scheda di un giocatore TruckersMP.
/bans idGli ultimi 5 ban di un giocatore.
/serveursTabella dei server TruckersMP.
/truckersmp servers · player · companyServer, giocatore o VTC TruckersMP.
/events id salonUn evento TruckersMP o i prossimi 6; con salon, il risultato viene pubblicato lì.
/vtcinfos info · events · membres · partenariats · newsInformazioni su una VTC TruckersMP (membri pagina per pagina).
/traffic jeu serveurZone di traffico sui server TruckersMP (dati Trucky).

Server e moderazione

ComandoA cosa serve
/accueil bienvenue · aurevoirConfigura i messaggi di benvenuto e di addio da Discord (Gestire il server).
/roles-react panneau · ajouter · retirerPannelli di pulsanti ruolo (Gestire i ruoli).
/role ajouter · retirerDare o togliere un ruolo (Gestire i ruoli).
/clear nombre membreElimina da 1 a 100 messaggi con meno di 14 giorni (Gestire i messaggi).
/say salonFai parlare il bot, come testo o embed (Gestire i messaggi).
/sondageSondaggio nativo di Discord: da 2 a 6 opzioni, da 1 ora a 14 giorni, scelta multipla possibile.
/alertes configurer · supprimerCanali delle notifiche Horizon Dispatch (Gestire il server).
/langueLa lingua del bot su questo server, oppure "Automatico" per la lingua di ogni membro (Gestire il server). Vale anche per i messaggi di benvenuto e di addio.
/vtcs ajouter · infos · liste · vérifier · supprimerI link della VTC su TruckersMP, Trucky, TruckersHub o VTLog, specifici di questo server (Amministratore).
/avatar · /userinfo · /serverinfoAvatar, scheda membro, scheda server.

Aiuto

ComandoA cosa serve
/aideMenu di aiuto per categoria.
/info bot · serveur · system · vtcInformazioni sul bot, sul server, sullo stato del servizio e sulla piattaforma.
/rapport-bugSegnala un bug al team (area, gravità, descrizione). Ricevi un DM a ogni cambio di stato.
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.

Pronto a partire?

Crea la tua VTC, installa il tracker e unisciti alla community Horizon Dispatch.