🗺️localization

Overview

The script supports multiple languages. Translation files are located in:

data/
└── language/
    ├── en.json
    └── pl.json

---

Changing Language

Open shared/config.lua and change the locale:

Config.Locale = 'en' -- 'pl' or 'en'

---

Available Languages

Code	Language
en	English
pl	Polish

---

Translation Structure

DUI Showroom

{
    "dui": {
        "header_title": "Check out your dream vehicle now",
        "category_all": "All",
        "category_select": "Select Vehicle Category",
        "stock_available": "In Stock",
        "stock_count": "In Stock: {0}",
        "stock_unavailable": "Out of Stock"
    }
}

Key	Description
header_title	Main title on DUI showroom
category_all	"All categories" filter option
category_select	Category dropdown placeholder
stock_available	Badge text when in stock
stock_count	Stock count with number placeholder
stock_unavailable	Badge text when out of stock

---

Target Interactions

{
    "target": {
        "enter_showroom": "Check Offer Vehicles",
        "exit_showroom": "Exit Showroom",
        "set_random_tuning": "Set Random Tuning",
        "open_catalog": "Open Vehicle Catalog"
    }
}

Key	Description
enter_showroom	Target label for entering showroom
exit_showroom	Target label for exit interaction
set_random_tuning	Target label for random tuning
open_catalog	Target label for NUI catalog

---

Tuning Menu

{
    "tuning": {
        "bone_bonnet": "Hood",
        "bone_boot": "Trunk",
        "bone_door_driver_front": "Driver Door",
        "bone_door_passenger_front": "Passenger Door",
        "bone_door_driver_rear": "Rear Door (L)",
        "bone_door_passenger_rear": "Rear Door (R)",
        "bone_wheels": "Wheels and Tires",
        "bone_exhaust": "Exhaust",
        "bone_bumper_front": "Front Bumper",
        "bone_bumper_rear": "Rear Bumper",
        "no_mods_available": "No modifications available for this part",
        "stock": "Stock (Original)",
        "currently_applied": "Currently applied",
        "click_to_apply": "Click to apply",
        "restore_original": "Restore original",
        "reset_to_stock": "Reset to stock",
        "applied": "Applied: {0}",
        "random_colors_applied": "Random colors applied",
        "color": "Color: {0}",
        "window_tint": "Window Tint: {0}",
        "toggle_on": "Turn On {0}",
        "toggle_off": "Turn Off {0}",
        "is_installed": "{0} is installed",
        "install": "Install {0}",
        "turned_on": "{0} turned on",
        "turned_off": "{0} turned off",
        "level": "{0} Level {1}",
        "primary_color": "Primary Color",
        "secondary_color": "Secondary Color",
        "pearlescent_color": "Pearlescent Color",
        "random_colors": "Random Colors"
    }
}

---

NUI Interface

{
    "ui": {
        "search_placeholder": "Search vehicle...",
        "selected": "Selected",
        "category": "Category",
        "price": "Price",
        "max_speed": "Max. Speed",
        "production_year": "Production Year",
        "speed": "Speed",
        "acceleration": "Acceleration",
        "handling": "Handling",
        "braking": "Braking",
        "in_stock": "In Stock",
        "out_of_stock": "Out of Stock",
        "no_return": "Purchased vehicle is non-refundable",
        "random_tuning": "Apply Random Tuning",
        "buy_vehicle": "Buy Vehicle",
        "test_drive": "Test Drive"
    }
}

---

Vehicle Categories

{
    "categories": {
        "All": "All",
        "Compacts": "Compacts",
        "Sedans": "Sedans",
        "SUVs": "SUVs",
        "Coupes": "Coupes",
        "Muscles": "Muscles",
        "Sports Classics": "Sports Classics",
        "Sports": "Sports",
        "Super": "Super",
        "Motorcycles": "Motorcycles",
        "Off-Road": "Off-Road",
        "Vans": "Vans",
        "Cycles": "Cycles",
        "Boats": "Boats"
    }
}

---

Test Drive

{
    "testdrive": {
        "time_remaining": "TIME REMAINING",
        "started": "Test Drive Started",
        "started_desc": "Return the vehicle to the marked zone before time runs out",
        "return_zone": "Return Zone",
        "return_zone_desc": "Press E to return the vehicle",
        "returned": "Vehicle Returned",
        "returned_desc": "Thank you for returning the vehicle",
        "expired": "Test Drive Expired",
        "expired_desc": "You did not return the vehicle in time",
        "penalty": "Penalty Applied",
        "penalty_desc": "You have been charged for not returning the vehicle"
    }
}

---

Notifications

{
    "notifications": {
        "purchase_success": "Vehicle Purchased",
        "purchase_success_desc": "Your new vehicle is waiting for you",
        "purchase_failed": "Purchase Failed",
        "not_enough_money": "You don't have enough money",
        "vehicle_added": "Vehicle Added",
        "vehicle_added_desc": "Vehicle has been added to your garage"
    }
}

---

Adding New Language

1

Create the file

Create a new JSON file in data/language/ (e.g., de.json for German).

2

Copy structure

Copy the structure from en.json.

3

Translate

Translate all values in the new JSON file.

4

Enable language

Update Config.Locale to your language code in shared/config.lua.

Example (German):

{
    "dui": {
        "header_title": "Entdecken Sie jetzt Ihr Traumfahrzeug",
        "category_all": "Alle",
        "category_select": "Fahrzeugkategorie auswählen",
        "stock_available": "Auf Lager",
        "stock_count": "Auf Lager: {0}",
        "stock_unavailable": "Nicht verfügbar"
    }
}

---

Placeholders

Some translations use placeholders:

Placeholder	Description
{0}	First dynamic value
{1}	Second dynamic value

Example: "level": "{0} Level {1}" becomes "Engine Level 4"