A BETTER START. AN EASIER FIX.

Let’s get you
back on the road.

Answers to the issues players report most, with checks for controls, maps, passenger seats and everyday gameplay.

TAB not opening?

Close the game. Try the installer’s keyboard repair. The correct device is sys.keyboard.

No shop icons?

Generate for the active profile and put one matching Huxxi compatibility pack at the top.

Empty taxi seats?

Use a supported car, enable Real Cab Passengers and purchase the TaxiConnect Seats fitting.

49 answers

TAB does not open the tablet. What should I check?

First load your actual driving profile and return to gameplay. TAB will not behave as the tablet shortcut while another menu owns input. Check the current plugin is installed in the selected game, activation is valid, and both required game settings are enabled.

  1. Close ATS and ETS2 before installing or repairing files.
  2. In the installer, select the correct game and use Install plugin. Avoid duplicate old Huxxi plugins.
  3. Under Settings → Game fixes, enable console/developer mode and run Fix tablet keyboard.
  4. Restart the game and load the intended profile. If TAB still fails, use the controls.sii check below.
Is the keyboard setting sys.keyboard or keyboard.sys in controls.sii?

The correct device name is sys.keyboard, not keyboard.sys. Some affected profiles use di8.keyboard, which can prevent the tablet keys from working. The installer’s Settings → Game fixes → Fix tablet keyboard changes that device entry and keeps a one-time backup.

  1. Close the game so it cannot overwrite the change.
  2. Prefer the installer repair. For a manual repair, back up the active profile’s controls.sii first.
  3. In a readable text controls.sii, replace the exact device text di8.keyboard with sys.keyboard. Keep the surrounding syntax and other bindings unchanged.
  4. Restart and load that profile. Do not try to edit an unreadable/binary file as text.
Which controls.sii belongs to my profile?

Look in the selected game’s actual home folder, under profiles or steam_profiles and then the profile’s folder. It is not the Steam installation folder. OneDrive, a moved Documents folder or a custom -homedir may change the location. Check the installer’s Game home directory and load the intended profile before diagnosing it.

Will Fix tablet keyboard remove my wheel or button bindings?

The repair targets the keyboard device name in readable profile controls files; it does not replace your complete control layout. The one-time backup is named controls.sii.huxxi-backup. Keep it before making further manual changes, and close the game during the repair.

Do I need g_console and g_developer enabled?

Yes. Set the existing config.cfg entries to uset g_console "1" and uset g_developer "1" in each game you use. The installer’s Game fixes section can enable them with the game closed. If editing manually, keep the .cfg extension, avoid duplicate entries and restart.

Why do F9, jump, view toggle or interaction use a different key?

Saved bindings take priority over defaults. Check Settings → Key bindings and the relevant movement, cabin or trailer/job group. Use the configured walk toggle for entry/exit; there is no second F-to-enter shortcut. Match any game Attach, lights, wipers and engine bindings to the active game profile.

The tablet opens, but the mouse or keys do nothing.

Click back into the game/tablet, close conflicting menus and check that you are using the current plugin. Try the keyboard repair if the problem is profile-specific. Mouse, controller and keyboard paths are supported, but a key held across focus changes may need to be released before trying again.

My wheel or button-box shortcut is not responding.

Confirm the device is connected and bind it in Huxxi Settings. Device identity and saved bindings matter if hardware was replaced or reconnected. Short presses are retained between game frames; avoid mapping the same button to conflicting actions. A configured game action still needs the corresponding in-game keyboard binding.

Shop icons are missing. What load order should I use?

Generate a compatibility pack before expecting Huxxi locations. In that profile’s Mod Manager, put exactly one matching Huxxi Roleplay Map Compatibility pack at the TOP, above its source maps. Disable older Huxxi icon packs and add-ons; keep the original maps and dependencies below it in their authors’ required order.

  1. Load the intended profile once, then close the game.
  2. Select the correct game/home in the installer and choose Find my maps.
  3. Review the sources, then Generate & install for that setup.
  4. Enable its matching pack at the top of that same profile. Do not enable several generated packs together.
I can see a shop icon, but cannot interact with it.

The map pack supplies locations; the activated gameplay plugin handles interactions. Check that both are installed and the matching generated data is available. Walk to the actual interaction area and use your saved shop key when prompted. A bus-stop icon is a discovery/pickup point, not a shop. Reviewed coordinates do not guarantee a measured doorway for every custom building.

ETS2 shops work differently from ATS, or no location details appear.

Each game has its own installation, home and generated data. Generate for the correct ETS2 profile rather than copying ATS data. Confirm the matching pack is enabled, and do not diagnose an empty location catalogue before generating the map. Wrong-game, missing or stale data is rejected instead of borrowing another profile’s locations.

Where does the matching shop data go?

The installer installs the generated SCS in the game home’s mod folder and its matching data at bin\win_x64\plugins\hxdata\<setup>\data.hxdb inside that game’s installation. The base setup uses base. Keep the generated names unchanged. Old root-level plugins\data.hxdb is no longer loaded.

Can I keep base, ProMods and other map profiles installed?

Yes. Leave the setup identifier blank for the base game and official DLCs; choose a different short identifier for each modded combination. Keep multiple setups installed, but enable only the matching generated pack in each profile. ETS2 and ATS store their data separately.

Find my maps shows the wrong profile or no mods.

Open the intended profile, enter gameplay, then close the game before scanning. The installer reads that session’s game.log.txt. Check the selected game home contains that log, profiles and mod. A stale log or another game’s home can describe a different setup; game.crash.txt is not the map-source list.

When do I need to regenerate my map pack?

Regenerate after a game version, map source, active mod list or load-order change. Moving from an older generated data format also needs a one-time regeneration. A plugin-only, audio or artwork update normally does not require rebuilding an otherwise matching pack.

Why do some custom shops have no Huxxi icon?

The scanner recognises reviewed service models. An unfamiliar custom building can remain unclassified even when its archive is readable. Report the map name, location and a screenshot through support. Generating markers does not add universal building recognition or navigation coverage.

Map generation stops, including around 77%. What should I do?

Use the current installer and read the Activity error rather than the percentage alone. A reported missing-source-sector failure near unavailable DLC areas has a specific filtering fix. Other failures can involve unsupported sectors, unreadable archives, missing dependencies, permissions or space.

  1. Use Activity → Open diagnostic log or Open logs folder.
  2. Check the highlighted source/member and confirm the map combination works in the game.
  3. If removing a bad source, disable it and its required dependants in Mod Manager, load the working profile, close the game, and scan again.
  4. Send the scan log and exact error to support if it still fails.
Does excluding a map in Review remove that map from my game?

No. It only excludes Huxxi icons from that source. Active geometry and model definitions still resolve in the profile’s load order. Disable an unwanted map in the game and capture the revised profile before generating again.

Is an unreadable SCS always encrypted?

No. The reader supports known game-readable ZIP and HashFS variations, but damage, unsupported compression and unsupported sector formats are different problems. A genuine encrypted payload still needs an authorised readable version. Do not change sector headers or generate from an older hidden source to bypass an error.

My taxi passenger is talking, but the seat is empty.

TaxiConnect conversation alone does not fit a visible rider into every car. On a supported ATS Road Trip car, you also need the optional Real Cab Passengers companion and the TaxiConnect Seats accessory.

  1. Enable Real Cab Passengers above the supported car/accessory packages in the active profile.
  2. Use a supported Road Trip Bronco, F150, Mustang or Crown Victoria.
  3. Visit the interior upgrade shop, add TaxiConnect Seats to the car and CONFIRM the purchase.
  4. Start an eligible TaxiConnect ride and wait until boarding finishes. A passenger is not permanently shown between rides.
Does the ETS2 passenger pack add riders to every car?

No. The prepared ETS2 appearance library does not provide universal car fittings. A compatible vehicle/seat fitting is still required; enabling a model library alone cannot place a rider in a car. Third-person player characters and visible taxi occupants are separate features.

A rider is missing textures or the appearance changed.

Use the matching current passenger companion, car package and seat fitting. The plugin retries a missing appearance before selecting a recognised compatible appearance of the same gender. This cannot mount a missing companion or make an unsupported car compatible. Include the current game log when reporting it.

The passenger will not board or leave.

Park inside the indicated 100-metre arrival area, stop, turn the engine off, apply the parking brake and stay inside. Wait for the pickup/drop-off countdown. Moving or breaking the parking conditions can reset it. A direction pin is not permission to drive through a barrier.

TaxiConnect cannot go online or offers are empty.

Load and activate the game, finish the current delivery job, and check phone battery and mobile credit. Offers also need reachable sites and supported routing data for the setup. A shop marker catalogue does not automatically supply every custom map’s road network.

Can two passengers appear, and why is a friend pickup not on every ride?

An occasional eligible longer ride can request a named friend pickup. It uses another supported seat and appearance; the friend adds half the normal rate after joining. It is a random situation, not a permanent second passenger. The vehicle and companion still need the appropriate fittings.

Why did I lose stars, tips or money after a ride?

Open TaxiConnect → Job history for the rating factors and payment breakdown. Collisions, confirmed fines, missed requested stops and poor hygiene can affect the score. Repeated driving habits have grace allowances. Tips vary with rating and personality and need collision-free eligibility. Cleanliness or laundry below 10% can trigger a 100 USD/EUR drop-off deduction.

The passenger repeats themselves or talks too often.

Choose Quiet, Normal or Chatty under Settings → AI Settings → TaxiConnect. New pacing spreads optional events through the trip and reduces repeated starters. Generated wording can still recur. If reporting a duplicate, say whether it was pickup, boarding, driving or drop-off, and whether two copies of the plugin were installed.

How do forgotten-item returns work?

A rare completed ride can produce a return opportunity after a delay while you remain online and take no other job. Follow the return pin and park as instructed for a separate reward and thank-you. Accepting another ride/job or the return timeout ends the opportunity.

Where did TaxiConnect and TruckMate settings move?

Their sidebar apps remain separate. Open Settings → AI Settings, then choose TaxiConnect or TruckMate. Configure passenger chattiness/language in TaxiConnect, and your key, voice, microphone and companion preferences in TruckMate.

A Gemini model is missing or no voice model can be selected.

Load models using your own key. Only supported voice-capable Live models available to that key are selectable. Availability changes; reload and choose another supported Live entry if one disappears. Text-only models are not a substitute for live voice.

Why is AI silent or showing quota, credit or connection errors?

Check internet, a valid key, supported Live access, phone battery above zero and mobile credit of at least 1.00. Google quota and billing are separate from game money and phone credit. Keys in the same Google Cloud project share quota; extra keys do not automatically add capacity.

The microphone hears nothing or is busy.

Select the intended input under AI Settings → TruckMate and use Test microphone. Check Windows microphone privacy permission for desktop apps, the device mute and whether another app opened it exclusively. Hold the configured talk key in gameplay and release to send.

The AI says it will turn on lights or wipers, but nothing happens.

Set Huxxi’s lights, wipers and engine keys to match the active game profile. Sit in the driver’s seat, make an explicit ON request and close the tablet so the game can receive the action. Starting the engine first requires safe parking and a valid engine binding. Already-on controls are not toggled off.

Does the orange second pin replace my game GPS destination?

No. It adds Huxxi guidance to a suitable stop ahead while keeping the main destination. It does not write a native game GPS waypoint. Places and road coverage must exist in the supported datasets; a pin does not establish barrier-free access.

Why is a collision reaction not instantaneous every time?

Confirmed collisions and extremely close traffic take priority over casual speech, but a Live response still needs model access and network processing. Queues, cooldowns, phone state or unavailable service can prevent a line. The assistant cannot confirm a distant unseen accident.

Why is cabin Rest unavailable?

Park safely, move to the bunk and settle into the lying position. You need a usable pillow, blanket and fan; a missing or worn-out item blocks a cabin nap. The old free-standing cabin F-to-sleep shortcut is not the rest flow.

I am stuck at the back of the cab or the lying position is wrong.

Use Shift+R for driver-seat recovery and check the current plugin. It cancels a nap and restores the saved driver camera. Cab-specific geometry, camera/head-tracking mods and clearance can affect the view. Report the truck/cabin and camera setup if the position remains wrong.

My first-person body or third-person character is missing.

Check the character selection and body/view bindings in Settings. Install current matching generated character assets above the maps. First-person head hiding and restricted body visibility while looking toward the windows/back are intentional to limit clipping. A missing model asset needs the matching pack, not just another camera toggle.

Why can I jump on a car but cannot climb every truck or wall?

Low vehicle surfaces use a physical jump; reachable higher edges can use a climb or vault. Detection requires usable collision, clearance and a supported landing. Decorative meshes, excessive height, blocked landings and world boundaries can remain unavailable.

Coupling gets stuck at hoses, pin or landing gear.

Follow the active checklist step and its marker. Check Trailer & job papers settings, move within the prompt’s range, and use the configured interaction key once. A native failure should leave a reason and allow deliberate retry; audio alone is not confirmation. Confirm the game’s Attach binding is correct and avoid repeatedly toggling it.

The tug test is stuck unless the trailer moves.

Update to the current plugin. The repaired check accepts the required forward-throttle hold as well as short forward travel: engine on, forward gear, parking brake off and continuous throttle. Reverse, neutral, walking or the brake being on cannot pass it. Follow the displayed tug-test prompt.

Hose, wheel-pin or landing-gear markers are not visible.

Enable job markers in Trailer & job papers settings and check the active stage. Points are derived from the trailer hook/wheel placement, with guidance when off screen. A modded trailer can need further validation; share its name, stage and screenshots rather than forcing game actions.

Landing gear or hoses play sound but do not move.

Use the current plugin and a compatible game/trailer setup. These steps depend on checked native actions and cable graphics; an unsupported hook or disabled cable rendering cannot be fixed by replaying audio. Read the step’s reason, retry deliberately when safe and include the game log if it repeats.

Should car delivery jobs make me carry a parcel?

The revised flow uses bill-of-lading/CMR papers and delivery confirmation instead of parcel loading into the car. Follow the foreman/paperwork marker. If an older parcel flow remains, confirm you are running the current installation rather than a duplicate older plugin.

The shop card tap or PIN stage looks frozen.

Use the current plugin and wait for the reader to appear before the tap/PIN stage. Check focus and close conflicting menus; keyboard, numpad and the displayed keypad use the same payment controller. A cancelled or failed purchase must not be treated as approved. Report the exact stage and game log if it stalls.

The tablet causes stutter. Which graphics option should I try?

Close and reopen the tablet after changing its Graphics profile. Compare the private hardware and software options on your setup; neither is universally faster. Current changes reduce redraws, transfers and routine saves while retaining full-resolution payment art. Share the game log, GPU and graphics-mod list if degradation continues.

How do I update without losing settings or saves?

Close both games and use Install plugin for the intended installation. Normal installation preserves saves, activation and preferences. Keep your own profile backup. Generate again only for a changed game/map/load order or an older incompatible data format; enable the matching pack afterwards.

Will characters, passengers and money actions survive future game updates?

Compatibility checks reduce unsafe assumptions, but no mod can promise every future native game layout. Models, generated map sectors and memory-dependent actions have different update requirements. Use the current release notes; unsupported native actions can stop until a compatible patch is available.

What should I send support for an unresolved bug?

Include game and plugin release, the active map/profile setup, vehicle/cabin or trailer, exact action/step, error and screenshots. Use the latest game.log.txt and game.crash.txt for a crash, plus the installer diagnostic log for map failures. Check local paths before sharing. Never send licence/API keys, payment PINs or unrelated personal files.

PURCHASES & PRIVACY

Before you start.

Does one licence work in both games?

Yes. One Huxxi Roleplay licence activates the shared plugin in Euro Truck Simulator 2 and American Truck Simulator on the same computer.

What happens after I buy?

After a successful Stripe payment, your licence key is emailed to your checkout address. Download Huxxi Roleplay Installer from Patreon, install the plugin and generate your matching map pack. Activate once in the installer or TAB → Settings → Licence. Check spam or junk if your key is missing, or contact website support using your purchase email.

Are my Gemini keys stored on your server?

No. Your Gemini keys are protected locally with Windows encryption and connect directly to Google. Licensing stores hashed device identifiers and purchase and licence records, not your raw MAC address. Read the privacy page for the full explanation.

Can I use it in multiplayer?

The mod packages are marked optional, but that does not guarantee Convoy compatibility. Check your server’s rules and map requirements before joining.

Full installation guide

RECENT FIXES & IMPROVEMENTS

Small details. Better journeys.

These changes address known failure paths. A particular vehicle, profile or mod combination can still need its own check.

Tablet and keyboard

Keyboard-device repair with profile backups, clearer mouse focus, and better short controller-button handling.

Maps and profile data

Correct-game home/profile selection, matching generated data checks, clearer archive diagnostics and unavailable-DLC filtering.

Passenger appearances

Missing-companion notice, bounded texture retries and a recognised same-gender appearance fallback on supported fittings.

Cabin and trailer steps

Driver-seat recovery, sleep-body visibility, stationary tug checks and native hose/gear actions with deliberate retries.

Payments and UI

POS timing begins on a visible frame; fewer blocking transfers, unnecessary redraws and routine ride-save stalls.

Conversation and feedback

More varied trip pacing, severity-aware collision reactions, decimal ratings and the last five ride reports.

Still need a hand?

Send the exact step, game/profile setup and relevant logs through website support. Keep keys and personal details private.

Open support chat Installation guide