HUXXI ROLEPLAY INSTALLER

Set up.
Then hit the road.

One installer for both games. Install the plugin, generate a pack for your map setup, and start your next journey.

For the standard game and official DLCs, leave the map setup identifier blank.

01

Download the installer.

Get Huxxi Roleplay Installer.exe from the latest Patreon release. Your licence arrives separately at your checkout email address.

Put the installer on a drive with enough free space. Its runtime prepares beside the EXE; temporary scan files are cleaned up after each run.

Downloads on Patreon
02

Enable the required game settings.

Close the game. Open config.cfg in its home folder with Notepad. Find these existing lines and set both values to 1:

uset g_developer "1"
uset g_console "1"

Save it as config.cfg, not config.cfg.txt, and restart the game after editing. Repeat for each game you use.

Documents\Euro Truck Simulator 2\config.cfg

Documents may be redirected to OneDrive. Use the actual game home folder if you have a custom setup.

03

Install the plugin.

With both games closed, open the installer and select Euro Truck Simulator 2 under Install plugin. Steam installations are detected automatically.

In Settings, check Game installation and Game home directory. The installation contains bin\win_x64; the home contains game.log.txt, profiles and mod.

Click Install plugin. The installer creates the plugins folder if needed. Your saves and preferences stay in place. Settings and plugin installation are available without a licence.

04

Activate and capture your map setup.

Activate your purchase key once in the installer’s Licence section or in-game under TAB → Settings → Licence. One key works in both games on this computer. Saved activation is reused when available.

Set up a working map combo with its required dependencies and load order. Disable old Huxxi icon packs and add-ons. Open your intended profile once, then close the game so its current map list is available to the installer.

Every map generation validates your licence online. Generation is unavailable offline.
05

Generate your matching map pack.

In Generate map, select Euro Truck Simulator 2 and click Find my maps. Review the detected map packages in their loaded priority order: lowest first, highest last.

Include or exclude maps to choose where Huxxi markers are added. Active sectors and required model definitions still resolve in the profile’s actual load order. Base game and installed official DLCs are included automatically.

Leave Map setup identifier blank for the standard game and official DLCs. Click Generate & install and follow the progress.

Your generated pack

Huxxi_Roleplay_Map_Compatibility-ETS2.scs

The installer places this pack in your game home’s mod folder and its matching protected data in:

bin\win_x64\plugins\hxdata\base\data.hxdb

Generation installs the map/data pair. Use Install plugin separately to update the plugin.

06

Enable one matching pack.

Start the game and place one matching Huxxi Roleplay Map Compatibility pack at the very top of Mod Manager. Disable older Huxxi Standard, ProMods and other icon packs.

Highest priority first

  1. One matching Huxxi Roleplay Map Compatibility pack
  2. Your original map mods and connectors in their required order

Keep the original maps, connectors and dependencies installed in their authors’ required order. The installer builds from your setup; it does not arrange load order, repair an incompatible combo or activate mods for you.

07

Keep a setup for each profile.

Generate a base setup with a blank identifier and give each modded combo a different name. Keep all of them installed, but enable only the matching generated pack in each profile. The plugin loads its matching data automatically.

Keep generated filenames and folders unchanged. Reusing an identifier updates that setup; a new identifier keeps a separate setup. ETS2 and ATS keep their data independently.

Regenerate once if you are moving from an older generated data format. Regenerate again after changing maps, active mods, load order or game version. Plugin-only, audio or artwork updates do not normally require another map generation. A pack built with ProMods still needs its source ProMods files.

08

Set up TruckMate and start playing.

Open TAB → Settings to choose your controls, driving side and ATM Card PIN. Under AI Settings → TruckMate, add your own Gemini key, load models, then choose an available Live model, voice, language, microphone and hold-to-talk key.

Load the supported voice-capable Live models available to your key. Availability can change: reload the list if a model becomes unavailable, then select another supported Live model.

For free-tier use, add valid fallback connections from separate authorized Google Cloud projects, which may belong to different accounts you control. Keys from the same project share quota, even across accounts. Choose sequential fallback or rotating keys; rotation needs at least two distinct keys.

AI needs internet, phone battery above 0% and at least 1.00 in mobile credit. Google’s model access, limits and charges still apply.

Google model information · Quota guidance

MAKE THE SETUP YOURS

Characters, cabin life and manual jobs.

Choose your character and view.

Open Character in the tablet. Use your configured view-toggle key for first or third person, and check the movement/jump bindings in Settings. Reachable surfaces need usable collision; not every roof or boundary can be climbed.

Missing or broken character pieces? Confirm the current matching generated pack is enabled above its source maps. A plugin update alone cannot mount missing model assets.

Prepare the cabin.

Park safely before cabin walking or rest. Bring a usable pillow, blanket and fan, settle on the bunk, then choose rest. Cabin settings control lamp position, colour, brightness and side/window fill.

Use Shift+R for driver-seat recovery. Add your own photo, name and company under Driver licence. Your portrait stays local.

Follow the trailer step.

Check Trailer & job papers in Settings for job markers and the interaction binding. Follow the active coupling/uncoupling stage rather than repeatedly pressing the game Attach key.

The tug check uses forward gear, engine on and parking brake released. Hold forward throttle against the trailer for the check; resolve a blocked native action or deliberately retry.

Find the right setting.

TaxiConnect and TruckMate remain separate sidebar apps. Their preferences are grouped under Settings → AI Settings. Match lights, wipers and engine keys to your game bindings before asking for an action.

For TAB, controls.sii, missing shop icons, empty seats and update problems, open FAQs & troubleshooting.