Horizon Dispatch Docs 0.7.4

Toda la plataforma.
Una sola documentación.

Crea y gestiona tu VTC, configura el bot de Discord, instala el tracker, entiende la certificación, el antitrampas y las herramientas de crecimiento: todo Horizon Dispatch, explicado paso a paso.

VTC y Discord Tracker ETS2 / ATS Confianza y seguridad API e integraciones
Primeros pasosPuesta en marcha y cuenta
Primeros pasos

Tu cuenta de conductor

Panel → Mi perfil reúne todo lo que te concierne como conductor, sea cual sea tu VTC. Tu perfil público está en /drivers/<your Discord ID>.

Nivel, títulos y logros

Cada entrega te da experiencia: 1 XP por km, 100 XP por entrega y 500 XP por punto de logro. El siguiente nivel pide 4.000 XP y luego 2.000 XP más por cada nivel.

Títulos: 🔰 Aprendiz (niv. 1), 🚚 Conductor (5), 🛣️ Camionero (10), 📦 Camionero experto (18), 🚛 Gran camionero (28), 🎖️ Veterano (40), 👑 Maestro de la carretera (55), 🌟 Leyenda (75). Las insignias y los logros desbloqueados aparecen en tu perfil, junto con el próximo logro al que apuntar.

Cuentas vinculadas: Discord, Steam, TruckersMP

  • Discord: tu cuenta de inicio de sesión.
  • Steam: botón Iniciar sesión con Steam. La conexión pasa por la página oficial de Steam: nadie puede vincular tu Steam en tu lugar. Una cuenta de Steam solo se puede vincular a una cuenta de Discord.
  • TruckersMP: se vincula y se marca como verificada automáticamente en cuanto tu Steam está conectado. Si no, /link truckersmp en Discord crea un vínculo simple (no verificado); un vínculo verificado por Steam siempre tiene prioridad.

Puedes ocultar Steam de tu perfil público o desvincularlo en cualquier momento. Conectar Steam también te asigna el historial que tu VTC importó durante una migración.

VTC principal y VTC de tracción

Si perteneces a dos VTC, elige en Mi perfil cuál es tu VTC principal: recibe el 100 % de tus entregas. La segunda, la VTC de tracción, recibe además una copia al 75 % (km, ingresos) de cada entrega.

Salario y saldo

Cada entrega ingresa una parte de sus ingresos en tu cartera de la VTC principal (30 % por defecto, lo fija la VTC). Mi perfil muestra tu saldo, tu porcentaje y tus 6 últimas operaciones. Las primas y los retiros los gestiona el equipo de la VTC.

Overlay de stream (OBS)

Haz clic en Generar mi enlace de overlay para obtener una dirección /overlay/<token> que puedes añadir como «Fuente de navegador» en OBS. Muestra tu VTC, tu nivel, el viaje, la carga, la velocidad y el progreso, y se actualiza cada 3 segundos mientras la app está abierta.

  • Opciones: ?theme=light y ?accent=ff8800.
  • Regenerar el enlace desactiva el anterior (útil si se ha filtrado).

Personalización y Supporter

  • Avatar (8 MB) y banner (16 MB), o volver a los de Discord.
  • Biografía (400 caracteres), color de acento y redes: YouTube, Twitch, X, TikTok, Instagram, Steam, Discord, sitio web.
  • Supporter Profile Studio (apoyo mensual activo o rol de supporter permanente): estilo (classic, glass, sunset, neon, minimal), marco, motivo, disposición, opacidad, desenfoque, brillo, estado con emoji, 4 estadísticas y 3 insignias destacadas. Consulta Premium y boosts.

Salir de una VTC

Botón Salir de la VTC en el banner de la VTC (motivo opcional). El fundador no puede irse: primero debe transferir la propiedad (Ajustes → Zona sensible). Después de salir, debes esperar 12 horas antes de crear una VTC o unirte a otra.

Panel de la VTCGestionar tu VTC en el día a día
Panel de la VTC

Miembros y reclutamiento

La página Miembros lista a tus conductores con búsqueda y filtros (rol, rango, grado). Todos pueden verla; las acciones requieren el permiso «Gestionar miembros».

  • Añade un miembro por su ID de Discord, como Conductor o Gerente. Se le aplica el rol predeterminado. El alta falla si la VTC está llena o si la persona ya está en 2 VTC.
  • Nombrar a alguien Gerente le da todos los derechos: resérvalo para personas de confianza.
  • Asigna hasta 5 roles por miembro.
  • Quita a un miembro, con un motivo opcional.
  • Consulta qué versión de la app usa cada conductor.
Un miembro que abandona el servidor de Discord de la VTC pasa a estar «inactivo»; no se le elimina.

Ficha de conductor

  • Las estadísticas del conductor, su progreso de rango y sus insignias.
  • Salario y saldo: «Pagar una prima» (pagada desde la tesorería de la VTC; el conductor recibe un MD) y «Retiro / pago».
  • Historial disciplinario: nota, advertencia o sanción, con un motivo (500 caracteres).

Centro de reclutamiento

Las candidaturas enviadas desde tu página pública llegan a Candidaturas (permiso «Gestionar el reclutamiento»), con un distintivo en el menú y una notificación push a los gerentes.

1 Nueva2 Preselección3 Entrevista4 Periodo de prueba5 Aceptada o rechazada
  • Contadores: total, en curso, entrevistas, pruebas, aceptadas, rechazadas.
  • Asigna un responsable (fundador o gerente) y escribe notas internas (1.200 caracteres).
  • Aceptar crea el miembro (si la VTC tiene sitio, la persona no está en 2 VTC y no está dentro de su espera de 12 horas) y publica el mensaje de Discord configurado.

El formulario de candidatura pide: experiencia, disponibilidad, motivación (obligatorias), juego preferido, zona horaria, VTC anterior, perfil de TruckersMP y experiencia en convoyes.

Panel de la VTC

Roles, rangos y divisiones

Tres sistemas distintos que funcionan juntos:

SistemaSirve paraAsignación
RolesConceder permisos en el panelA mano, hasta 5 por miembro
Rank up (rangos)Recompensar los kilómetros recorridosAutomática, según los km entregados
DivisionesEspecializar a los conductores (cisterna, convoy excepcional…)La elige el conductor en la app

Roles

Permiso «Gestionar roles». Cada rol tiene un nombre (40 caracteres), un color y una selección entre los 13 permisos. Arrastra los roles para ordenarlos. El rol predeterminado (asignado a los nuevos miembros) no se puede eliminar. El número de roles depende de los boosts (de 5 a 30, consulta Premium y boosts).

Rank up

Cada rango tiene un nombre, los km requeridos, un color y un rol de Discord opcional. Solo cuentan los km entregados. Tras cada entrega (o con Resincronizar), el conductor recibe el rol de Discord de su rango, se le quitan los anteriores y se envía un mensaje al canal «rank». El bot debe estar en el servidor de la VTC.

Divisiones

  • Activa «Divisiones en la app» y elige el modo: una sola división por conductor o varias acumulables.
  • Hasta 10 divisiones, cada una con nombre, descripción, imagen, color, lista de camiones y remolques, y un rol de Discord.
  • Los conductores eligen su división en la app y reciben el rol de Discord correspondiente.
Panel de la VTC

Estadísticas, viajes y registro

Todos los miembros pueden ver estas páginas.

Estadísticas

  • El rendimiento de este mes comparado con el mes anterior, la actividad diaria y los mejores conductores del mes.
  • Distancia por conductor, reparto por rol, tendencia de 12 semanas, mapa de calor de actividad, rutas y cargas favoritas, entregas por país, conductores inactivos (sin entregas en 14 días).
  • Objetivos mensuales: uno por métrica y por mes (permiso Ajustes).
  • Introducción manual de estadísticas (permiso «Editar estadísticas»).

Viajes

Las 120 últimas entregas, con ruta respetada o modificada, daños, velocidad máxima, excesos de velocidad y aparcamiento. Las entregas apartadas por el antitrampas siguen visibles, marcadas como «🚫 En revisión», «⚠️ Conductor advertido» o «Trampa confirmada», con la nota «No cuenta en las estadísticas».

Limpiar duplicados («Editar estadísticas») elimina las entregas idénticas registradas con menos de 6 horas de diferencia.

Operaciones

El centro de control en directo: conductores en línea, en un trabajo y desconectados, km y entregas del día, ingresos del día, mapa en directo y feed de actividad. Un conductor está «en línea» si su app se ha comunicado hace menos de 60 segundos; la página se actualiza cada 5 segundos.

Registro de actividad

Permiso «Ver el registro de actividad». Muestra las 100 últimas acciones de la VTC: llegadas y salidas, cambios de rol, eventos, ajustes, apadrinamiento… No hay exportación.

Panel de la VTC

Eventos y convoyes

La pestaña Eventos (incluida su consulta) se desbloquea con 2 boosts. Crear o editar requiere el permiso «Gestionar eventos».

  • Título, descripción en Markdown, categoría (convoy, reunión, formación, carrera, oficial, otra), juego, servidor, idioma, banner, color.
  • Salida y llegada, hasta 20 puntos de paso, km previstos, DLC de mapa, horas de encuentro y de salida.
  • Reglas, canal de voz, skin obligatoria, máximo de participantes (0 = ilimitado), hasta 200 posiciones de convoy (20 por defecto).
  • Importar desde TruckersMP: pega un enlace o un ID de evento de TruckersMP para rellenar el formulario.
  • «Visible en la página pública» lo muestra en /vtcs/your-vtc y en /events; si no, queda reservado a los miembros.

Al crearlo: un mensaje de Discord en el canal «events» y una notificación push a los miembros. El botón Volver a notificar los reenvía. Los conductores se apuntan («Voy a asistir» o «Quizás») desde el sitio web o la app; la app se lo recuerda 30 min y 10 min antes y a la hora de salida. Cada evento público también se puede descargar como archivo de calendario (.ics).

Panel de la VTC

Anuncios, galería y colaboraciones

Anuncios (4 boosts)

Título (140 caracteres), contenido en Markdown (6.000), imagen de portada, fijado, publicado o borrador, visible en la página pública. Un anuncio publicado se envía a Discord, como notificación push y a la campana de la app. «Volver a notificar» solo funciona con un anuncio publicado. Los miembros que no son staff solo ven los anuncios publicados.

Colaboraciones

Permiso «Gestionar colaboraciones». Enviar una solicitud requiere 4 boosts y se dirige a una VTC pública (por su identificador). Aceptar, rechazar o eliminar una colaboración funciona sin boosts. Las colaboraciones aceptadas aparecen en las páginas públicas y en la app.

Panel de la VTC

Flota y economía

Dos economías funcionan en paralelo:

MonedaSe alimenta de
Salarios y tesoreríaIngresos del juego (€ / $)Cada entrega: una parte (30 % por defecto, ajustable de 0 a 100 %) va a la cartera del conductor y el resto a la tesorería de la VTC.
FlotaCréditos Horizon (◈ CH)150.000 CH para empezar y luego, por cada entrega: km × 12 + 5 % de los ingresos, reducido por los daños y los excesos de velocidad.

Flota

Visible para todos; las acciones requieren «Gestionar la flota». Se muestran hasta 50 camiones y 50 remolques.

  • Asigna un conductor, define un camión principal (recibe las entregas cuando ningún camión coincide), cambia el nombre, introduce la matrícula (16 caracteres).
  • Mantenimiento de camiones: general cada 45.000 km (2.500 CH), motor cada 150.000 km (9.000 CH), neumáticos cada 175.000 km (6.000 CH).
  • Sustitución de componentes: motor 25.000, caja de cambios 18.000, neumáticos 8.000, chasis 12.000 CH. Un componente está en estado crítico a partir del 20 % de desgaste.
  • Remolques: general cada 60.000 km (1.800 CH), neumáticos cada 150.000 km (4.200 CH); sustitución de neumáticos 6.000, frenos 7.000, chasis 9.000 CH.
  • Reventa: alrededor del 85 % del precio, menos la depreciación por km y desgaste.
  • El desgaste crítico y los mantenimientos atrasados se notifican en Discord. La app puede importar los camiones reales de tu partida guardada.

Concesionario

Catálogo de camiones y remolques nuevos para ETS2 y ATS (incluidos modelos genéricos, compatibles con mods) y un mercado de ocasión con 6 ofertas que se renuevan cada día. La compra falla si el saldo de créditos es insuficiente.

Mecánicos

Hasta 6 mecánicos, cada uno con una velocidad de 1 a 5 y una especialidad (polivalente, general, motor, caja de cambios, neumáticos, chasis, frenos). Un mecánico con la especialidad adecuada reduce el coste un 15 %, más un 3 % por nivel, hasta un 50 %. Los trabajos inmovilizan el camión (general 30 min, motor 2 h, neumáticos 1 h, sustitución 3 h, acortados según la velocidad del mecánico). Sin mecánicos, los trabajos son instantáneos.

Cada mecánico cobra cada semana de los créditos de la flota (desde 1.200 CH por semana con velocidad 1 hasta 4.800 CH con velocidad 5, +35 % para un polivalente). Si se acaban los créditos, dimite y el registro de la VTC lo indica.

Panel de la VTC

Sitio web de la VTC

No hay que confundirlo con la página pública /vtcs/your-vtc (siempre disponible): el sitio web es un sitio completo e independiente, publicado en /vtcs/your-vtc/site. Requiere 5 boosts y el permiso Ajustes, y después activar el interruptor «Publicar el sitio».

  • Aspecto: 6 temas (Horizon, Océano, Bosque, Violeta neón, Carmesí, Oro puro), 6 fuentes, esquinas, espaciado, altura del hero, fondo, estilo de botones, color de acento.
  • 18 módulos que ordenar: hero, acerca de, estadísticas, miembros, clasificación, flota, galería, vídeo, FAQ, llamada a la acción, reclutamiento, eventos, anuncios, socios, apoyo, contacto, redes, texto libre.
  • Por sección: fondo, imagen de fondo, alineación y columnas.
  • Mensajes recibidos: los 50 últimos mensajes del módulo Contacto, que también se envían al canal de Discord «contact».

La página pública normal se personaliza en Ajustes (tema de la página y banner desde 2 boosts).

Panel de la VTC

Ajustes de la VTC

Permiso «Gestionar los ajustes», salvo que se indique lo contrario.

PestañaAjustes
IdentidadNombre (40 caracteres; también cambia la dirección), descripción (2.000), logo (URL o subida, 2 MB), banner (2 boosts, 5 MB), tema de la página pública (2 boosts), color, juego, país.
Reclutamiento y visibilidadReclutamiento abierto, visible en el directorio, rol predeterminado (con «Aplicar a los miembros sin rango»).
Tracker y DiscordEtiqueta (8 caracteres), límite de velocidad, ingresos visibles públicamente, canal de entregas, webhook de entrega (HTTPS), salario del conductor (%), canal de anuncios, canal de galería.
PlataformasID de TruckersMP, Trucky y TrucksHub.
Enlaces y redes8 redes sociales.
EquipoAñadir o quitar gerentes (permiso Miembros).
Bienvenida de miembrosChecklist de bienvenida de hasta 20 pasos, que se muestra a los nuevos miembros.
APIActivar o desactivar la API pública y los widgets, exponer la lista de miembros (gratis). Clave pública de la API v1 pk_… desde 5 boosts (solo el fundador puede regenerarla). Consulta Desarrolladores.
Zona sensibleSolo el fundador: transferir la propiedad (el antiguo fundador pasa a ser gerente) o eliminar la VTC, escribiendo su nombre.
El canal de entregas también recibe los viajes sin terminar, las entregas bloqueadas por el antitrampas y las alertas de la flota. El webhook de entrega envía cada entrega a una URL HTTPS de tu elección (en formato Discord si es un webhook de Discord).
Panel de la VTC

Ecosistema

La página Ecosistema de la VTC, sin boosts, abierta al staff (cualquier permiso):

  • Horizon Network: crea una red de VTC pública o privada, o únete a una con un código.
  • Operaciones de convoy con puntos de control y estado.
  • Retos entre VTC, cooperativos o cara a cara.
  • Contratos compartidos entre VTC.
  • Competencias verificadas: certificaciones y distinciones de los conductores.
  • Sincronización de eventos entre plataformas (Discord disponible, las demás en desarrollo).
  • App OAuth «Horizon Connect» (el secreto solo se muestra una vez) y webhooks (HTTPS solo hacia direcciones públicas). Consulta Desarrolladores.
  • Marketplace: cualquier miembro puede publicar un anuncio, que se muestra en /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.

¿Listo para salir a la carretera?

Crea tu VTC, instala el tracker y únete a la comunidad de Horizon Dispatch.