Horizon Dispatch Tutorials 0.7.4

Configúralo todo,
paso a paso.

Guías breves para configurar tu VTC, Discord y la aplicación.

27 guías De 2 a 15 minutos Comprobación final Enlaces a la documentación
Primeros pasosThe first three guides
Primeros pasos

Unirse a una VTC

5 min Driver Free

Want to drive with an existing VTC? Find it, apply, then get your account ready.

Step 1 · Find a VTC

Open the directory, filter by game and tick "recruiting". On each VTC page, look at the month's activity, events, reviews and certification badge.

Step 2 · Apply

Click Apply and fill in the form (motivation is required). The VTC is notified on Discord; you can follow the answer on the same page.

On the VTC's Discord server, /driver join does the same in one command if recruitment is open.

You can be in 2 VTCs at most, and you must wait 12 hours after leaving a VTC.

Step 3 · Get your account ready

  • My profile → Linked accounts: connect your Steam, and your TruckersMP account gets linked and verified (guide).
  • If you are in two VTCs, pick your main VTC: it gets 100% of your deliveries, the second one 75%.
  • Customise your bio and socials: they show on your public profile.

Check

  • The VTC shows in your My VTC menu.
  • Your public profile /drivers/<your Discord ID> shows the VTC.

Last step: install the app so your deliveries count.

Primeros pasos

Instalar la aplicación y completar tu primera entrega

10 min Driver Windows

The app records your deliveries automatically. You only need to install it once.

Step 1 · Install

Download the installer from the Software page and run it. Choose the install folder; a desktop shortcut is created.

Step 2 · Sign in

Open the app and click Sign in with Discord. Your main VTC is found on its own; without a VTC, the app switches to solo mode.

Step 3 · Let the plugin install

The app finds ETS2 and ATS and installs the telemetry plugin. Start the game: on first launch, a message mentions "advanced SDK features"; click OK. The app then shows "game connected".

Game not found? Settings → Plugin → Search all drives, or Manual folder… to choose the game's plugins folder.

Step 4 · Your first delivery

  1. With the app open, accept a delivery in the game.
  2. Drive normally and stay under 145 km/h: above that, the anti-cheat blocks the delivery.
  3. Deliver the cargo: the app shows "✅ Trip sent to the dashboard".
A delivery started before opening the app cannot be validated ("unfinished trip"). Always open it before accepting a job.

Check

  • The delivery shows in your VTC → Trips on the website.
  • It is announced in the deliveries channel of the VTC's Discord (if set up).
  • While you drive, you show on the live map.

A problem? See troubleshooting. To go further: set up the overlay.

DiscordBot, channels, tickets
Discord

Configurar canales y mensajes automáticos

10 min Settings permission Free

Decide where deliveries, announcements, events and applications go, and what the messages look like.

Step 1 · The deliveries channel

your VTC → Settings → Tracker & Discord: pick the deliveries channel, the announcements channel and the gallery channel. Also set the driver salary (30% by default) and income visibility.

The deliveries channel will also get unfinished trips, deliveries blocked by the anti-cheat and fleet alerts.

Step 2 · Dedicated channels

your VTC → Discord: give each use a channel (default, announcements, events, new applications, decisions, rank, contact). An empty channel falls back to the default one.

Step 3 · Customise the messages

For each of the 8 message types: turn it on, pick the colour, title and text, the roles to mention (10 max) and whether the person concerned is mentioned. Click Send a test to see the result.

Check

  • Each message test arrives in the right channel.
  • A driver's delivery shows in the deliveries channel.
  • The following Monday, the weekly report is posted.

Message details: documentation.

Discord

Dar la bienvenida a los miembros del servidor

10 min Server admin Free

Welcome message, auto role and role buttons: a welcoming server in a few minutes.

Step 1 · Welcome message and auto role

Bot config → your server → Welcome message: turn it on, pick the channel, write the message (variables {user}, {username}, {server}, {count}), add an image if you like, and choose the auto role.

Do the same with the Leave message. On Discord, /accueil bienvenue and /accueil aurevoir give access to the same settings.

Step 2 · Reaction roles

Reaction roles → create a panel (channel, title, description), then add up to 25 buttons, each with a role and an emoji. Members click to take or remove a role (game, region, notifications…).

Step 3 · Bot language

On Discord, /langue sets the bot's language on the server (8 languages), or "Automatic" to answer in each member's language. It also applies to welcome and leave messages.

Check

  • A test account joining the server gets the message and the auto role.
  • A click on a panel button gives the role, a second click removes it.
Discord

Configurar los tickets

10 min Tickets permission Free

A panel with a button: each member opens a private channel with your team (support, recruitment, partnerships…).

Step 1 · Prepare Discord

Create a category for tickets (e.g. "Tickets") and a support role. Make sure the bot can manage channels in that category.

Step 2 · Create the panel

your VTC → Tickets → new panel: name, colour, channel to post the panel in, category, support role, name format (ticket-{user}), panel and button texts, welcome message, support mention.

Step 3 · Deploy

Click Deploy: the panel appears in the chosen channel. Create one panel per use if you want to separate support and recruitment.

Each member can have one open ticket per panel. On close, the channel is deleted with no transcript: copy anything worth keeping.

Check

  • The button creates a channel visible to you, the support role and the bot.
  • The close button deletes the channel.
Discord

Registros, contadores, estado del convoy y retransmisión de TruckersMP

10 min Server admin Free

The server tools in Bot config, to turn on as needed.

Server logs

Pick a private channel and tick the categories to follow (members, messages, roles, channels, sanctions, voice, server, VTC). Give the bot the view audit log permission to know who did what.

Member counters

Create (locked) voice channels and link them to the counters: members, online, bots, boosts. They are renamed every 10 minutes.

Live convoy status

Pick a channel: a single message, updated every 90 seconds, lists the VTC's drivers on the road. It is also where the app's quick commands arrive.

TruckersMP relay and notifications

  • TruckersMP relay: enter your TruckersMP VTC ID and the news, events and partners channels.
  • Horizon Dispatch notifications: a channel for official announcements (updates, maintenance).
Gestionar tu VTCTeam, recruitment, convoys, fleet
Gestionar tu VTC

Roles del equipo y permisos

10 min Roles permission Free

Roles give precise rights in the dashboard, without making everyone a manager.

Step 1 · Plan the organisation

An example that works well:

RolePermissions
Driver (default)None: views the VTC's pages.
RecruiterManage recruitment, Manage members.
OrganiserManage events, Manage announcements, Manage gallery.
Fleet managerManage fleet.
ModeratorManage tickets, View activity log.

Step 2 · Create the roles

your VTC → Roles: create each role (name, colour, permissions) and drag them into order of importance. The number of roles depends on your boosts (5 without boosts).

Step 3 · Assign them

  • In Settings → Recruitment & visibility, pick the default role (and "Apply to members without a rank").
  • In Members, give up to 5 roles per member.
These roles live in the dashboard only: they do not create Discord roles. For automatic Discord roles, use ranks and divisions.
Gestionar tu VTC

Rangos automáticos con roles de Discord

10 min Roles permission Free

Drivers rank up with their kilometres, and the bot gives them the matching Discord role.

Step 1 · Create the Discord roles

On your server, create one role per rank (e.g. Trainee, Trucker, Long hauler, Legend) and put the bot's role above them.

Step 2 · Create the ranks

your VTC → Rank up: for each rank, enter the name, the required km, the colour and pick the Discord role. Example: 0, 5,000, 25,000, 100,000 km.

Step 3 · Sync

Click Resync to apply the ranks to existing members. After that, everything is automatic after each delivery, with an announcement in the "rank" channel.

Check

  • Members have the Discord role of their rank.
  • The "Rank" column of the Members page is filled in.
Gestionar tu VTC

Crear divisiones

5 min Settings permission Free

Specialities (reefer, tanker, oversize load…) that drivers pick in the app.

Step 1 · Turn it on

your VTC → Divisions: turn on "Enable divisions in the app" and pick the mode: one division per driver, or several at once.

Step 2 · Create the divisions

Up to 10 divisions: name, description, image, colour, recommended trucks and trailers, and the Discord role given to those who pick it.

Step 3 · On the drivers' side

In the app, Divisions menu: each driver picks their division(s) and gets the Discord role.

Gestionar tu VTC

Organizar la contratación

10 min Recruitment permission Free

From the application to the new driver's first convoy.

Step 1 · Attract applicants

  • Recruitment open and VTC visible in the directory (Settings).
  • A clear description: game, servers, schedule, rules, atmosphere.
  • On your website or Discord, the Recruitment widget with its "Apply" button.

Step 2 · Get notified

Each application arrives in Applications, in the "new applications" Discord channel and as a push notification (allow the website's notifications in your browser).

Step 3 · Follow each application

1 New2 Shortlist3 Interview4 Trial period5 Decision

Move the application from stage to stage, assign someone in charge and write down your impressions (internal notes). Accept creates the member and sends the decision message on Discord.

Step 4 · Welcome them well

  • The onboarding checklist (Settings → Member onboarding) guides the newcomer: install the app, read the rules, join a convoy…
  • The default role and, after their first delivery, their rank are given automatically.
Gestionar tu VTC

Organizar un convoy

10 min Events permission 2 boosts

Create the event, fill the slots, then run the convoy live.

Step 1 · Create the event

your VTC → Events (2 boosts): title, description, "convoy" category, game, server, start, destination, stops, meetup and departure times, convoy slots, rules and voice channel.

Your convoy already exists on TruckersMP? Paste its link in Import from TruckersMP.

Step 2 · Announce it

Tick "Visible on the public page" to open it to everyone. On creation, the bot announces it in the "events" channel and members get a notification. Re-notify sends the announcement again the day before.

Step 3 · Sign-ups

Drivers sign up from the website or the app and pick their slot. The app reminds them of the departure 30 minutes before, 10 minutes before and on time.

Step 4 · On the day

  • The live convoy status shows who is driving.
  • Drivers use the app's quick commands (Ctrl+Shift+1 to 5: On my way, Break, Arrived, Need help, Refuelling).
  • The overlay's "Nearby convoy" widget flags a teammate less than 5 km away.
  • The dashboard's Operations page follows everyone on the map.
Gestionar tu VTC

Gestionar la flota y la economía

10 min Fleet permission Free

A virtual fleet funded by deliveries, with maintenance and mechanics.

Step 1 · Understand the two currencies

  • Salaries: a share of each delivery's income (30% by default, set in Settings → Tracker & Discord) goes to the driver, the rest to the treasury.
  • Fleet credits (CH): 150,000 CH to start, then earned with each delivery. They pay for buying and maintaining vehicles.

Step 2 · Buy or import

Buy trucks and trailers at the Dealership (new or used). Drivers can also bring their real trucks: the app reads their save when tracking starts.

Step 3 · Assign and maintain

In Fleet, assign each truck to a driver and pick a main truck. Service them on time (alerts on Discord): a part worn down to 20% becomes critical.

Step 4 · Hire mechanics

Up to 6 mechanics lower the cost of repairs according to their speciality. They are paid every week from the credits: keep a reserve, or they resign.

Gestionar tu VTC

Definir objetivos y seguir la actividad

5 min Settings permission Free
  • VTC home → Goals: a km, deliveries or income goal, with a deadline. It shows on the public page and in the app.
  • Statistics → Monthly goals: one goal per metric per month.
  • Weekly report: posted every Monday on Discord, or right away with "Send now".
  • Statistics: spot inactive drivers (nothing for 14 days) and favourite routes.
AplicaciónOverlay, tachograph, mobile, RPC
Aplicación

Configurar la superposición y el aviso de velocidad

10 min Driver Windows

A readable in-game display, placed where you want, with the right alerts.

Step 1 · Preview

App → Overlay tab → Preview: a demo trip shows without starting the game.

Step 2 · Place and size it

  • Pick one of the 6 positions and the screen, or move it freely with Move the overlay (Ctrl+Alt+O).
  • Set the size (75 to 150%), opacity, layout (card or bar) and theme.

Step 3 · Pick the widgets

Turn on the ones you use: speed and limit, trip, ETA, progress, members online, nearby convoy, event radar, ranking, clock, TruckersMP… Fuel can show as % or as range (km). Income, fuel and damage need 4 boosts on your VTC.

Step 4 · Speed warner and alerts

  • Speed warner: 97 km/h threshold by default (50 to 160), flashing and an optional beep.
  • Alerts: low fuel (15%) and damage (60%), to turn on in the Alerts tab.

Check

  • In game, the overlay shows when the game is in the foreground.
  • If it stays hidden in full screen, switch the game to borderless window.
Aplicación

Conducir en modo RP con el tacógrafo

5 min Driver Windows

The tachograph counts your driving time and breaks like in a real truck.

Step 1 · Turn on the mode

Overlay tab → Tachograph mode. Default rules: 4 h 30 of driving, 45 min break (or 15 + 30), 9 h per day.

Step 2 · Adjust (6 boosts)

With 6 boosts on your VTC: durations, format (full, compact, minimal), width, screen colour, text size and skin. "Game paused = rest" stays on by default.

Step 3 · Take your breaks

A warning comes 30 minutes before the mandatory break. Stop (or pause the game): the break is confirmed with a sound. "Reset session" starts from zero.

Aplicación

Panel móvil y superposición de OBS para streaming

5 min Driver or streamer Free

Phone as a dashboard

  1. Connect your phone to the same Wi-Fi as the PC.
  2. App → Mobile dashboard → scan the QR code.
  3. Info tab for driving, Map tab to follow your truck. If nothing shows, allow the app in the Windows firewall.

Overlay for OBS

  1. Website → My profile → Generate my overlay link for the stream overlay.
  2. In OBS: add a Browser source with that link (add ?theme=light or ?accent=ff8800 if you like).
  3. Start the app and drive: the overlay updates every 3 seconds. Generate the link again if it was shared by mistake.
Aplicación

Personalizar la presencia enriquecida de la VTC

5 min RPC permission 6 boosts

Your drivers' Discord status shows your VTC while they drive.

Step 1 · Create the Discord application

On the Discord developer portal, create an application named after your VTC (it is the title shown) and add your images in Rich Presence → Art Assets. Copy the Application ID.

Step 2 · Write the lines

your VTC → RPC: paste the Application ID, then write the two lines with variables, pick the images, the timer and up to 2 buttons.

Line 1: 🚚 {cityFrom} → {cityTo}
Line 2: {cargo} · {speedText}

Check

  • Discord open on the same PC, app running: during a delivery, your Discord profile shows the lines.
  • Outside a delivery, the status shows your activity and your truck.
Hacer crecer tu VTCWebsite, widgets, certification
Hacer crecer tu VTC

Crear el sitio web de tu VTC

15 min Settings permission 5 boosts

A real website for your VTC, published at /vtcs/your-vtc/site, with no hosting or code.

Step 1 · Pick the style

your VTC → Website (5 boosts): theme (Horizon, Ocean, Forest, Violet neon, Crimson, Pure gold), font, corner radius, spacing, button style and accent colour.

Step 2 · Build the sections

Add and order the modules: hero, about, statistics, members, ranking, fleet, gallery, video, FAQ, recruitment, events, announcements, partners, contact, socials, free text… Each section has its own background, alignment and columns.

Step 3 · Turn on contact and publish

Add the Contact module: messages arrive in Received messages and in the "contact" Discord channel. Turn on Publish the site: an "Official website" link appears on your public page.

Hacer crecer tu VTC

Mostrar tu VTC en tu web (widgets e insignias)

5 min Settings permission Free

Step 1 · Copy the code

your VTC → Integrations: pick a widget (members online, latest trips, km this month, next event, recruitment, full card, live mini map), the theme, the language and the number of rows, then copy the code.

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

Step 2 · Paste it on your website

Paste the code where the widget should appear (HTML block in WordPress, Wix, Carrd, Google Sites…). If JavaScript is not allowed, use the iframe version.

Step 3 · The certification badge

Once certified, copy the badge (HTML, Markdown or BBCode) from the same page: it links to your VTC's official verification page.

Hacer crecer tu VTC

Migrar desde otra plataforma

10 min Members permission Free

Bring your members and their statistics over from Trucky, VTLog, TruckersHub or TruckersMP.

Step 1 · Prepare the source

  • TruckersMP VTC: its ID or link.
  • TruckersHub: your API token (truckershub.in → Integrations → API).
  • Trucky, VTLog, spreadsheet: a CSV or JSON export (2 MB max), built from the CSV template if needed.

Step 2 · Preview

your VTC → Import: pick the source and run the preview. Each driver is matched to their Discord account when possible. Nothing is saved yet.

Step 3 · Confirm

Confirm, adding the recognised drivers straight away if you like. The others stay "pending": they get their history back by joining the VTC or connecting their Steam. You can also match them by hand.

Importing twice doubles nothing: the highest value is kept for each driver.
Hacer crecer tu VTC

Obtener la certificación

Founder or manager Free

Three levels (Verified, Certified, Partner) reward active VTCs. The criteria are in the documentation.

Step 1 · Cover the basics

  • Public VTC, with a logo and a description of at least 80 characters.
  • Discord server linked and public invite link filled in (Settings → Links → Discord).
  • TruckersMP ID filled in (Settings → Platforms), required from the Certified level.

Step 2 · Reach the thresholds

your VTC → Certification shows your score and what is missing: members, age, deliveries, active drivers and kilometres over 30 days. Run convoys and motivate the team to reach 100%.

Step 3 · Apply

At 100%, send the application. The team reviews it; a question? Contact the Certification team. After a refusal, wait 7 days before applying again.

Hacer crecer tu VTC

Recomendar otra VTC

5 min Settings permission Free
  1. Copy your link in your VTC → Referral.
  2. Send it to a VTC that is not on Horizon Dispatch yet: it creates its VTC with it, or enters your code within 30 days.
  3. When it becomes active (3 members, 15 deliveries and 2 of its own drivers within 45 days), you each get 2 boosts for 30 days.
Hacer crecer tu VTC

Vincular Steam y TruckersMP

2 min Driver Free
  1. Website → My profile → Linked accounts → Sign in through Steam.
  2. Sign in on Steam's official page: you come back to your profile automatically.
  3. The TruckersMP account tied to that Steam is linked and marked verified; the history imported by your VTC is attached to you.

You can hide Steam from your public profile or unlink it at any time.

DesarrolladoresAPI and OAuth
Desarrolladores

Mostrar estadísticas mediante la API

10 min Developer Free

With no key, every public VTC exposes its statistics as JSON. Example for a website:

fetch('https://hdispatch.eu/api/vtc/my-vtc/stats')
  .then((r) => r.json())
  .then((d) => {
    document.querySelector('#km').textContent = d.month.km + ' km this month';
    document.querySelector('#online').textContent = d.members.online + ' online';
  });
  • Other endpoints: /online, /jobs, /events, /members, /certification.
  • Limit: 120 requests per minute per IP. Cache the responses on your side.
  • Need more (announcements, divisions, galleries, private events)? The v1 API with the pk_… key (5 boosts): full reference.
Desarrolladores

Añadir «Iniciar sesión con Horizon Dispatch»

15 min Developer Free

Step 1 · Create the application

your VTC → Ecosystem → Create an OAuth application: name, description and redirect URIs (one per line). Note the client_id and the secret (shown only once).

Step 2 · The sign-in flow

  1. Redirect the user to /connect/authorize?client_id=…&redirect_uri=…&scope=identity profile vtc&state=….
  2. On return, exchange the code (valid 5 minutes): POST /connect/token with client_id, client_secret, code and redirect_uri.
  3. Read the profile with GET /connect/userinfo and the Authorization: Bearer <token> header (token valid 30 days).

Details and responses: Developers page.

¿Todo listo?

Encuentra cada ajuste en la documentación o pide ayuda en Discord.