ktoxktox docs

Localization

How to add or modify language translations for ktx_garages.

Localization

Supported Languages

  • English
  • French
  • German

Setting the Language

In shared/config.lua:

Config.GarageSystem = {
    language = "english",   -- "english" | "french" | "german"
}

Adding a New Language

  1. Copy languages/english.lua to languages/yourlanguage.lua
  2. Translate all strings in the new file
  3. Set the config:
Config.GarageSystem = {
    language = "yourlanguage",
}

File Structure

Each language file sets Config.GarageSystem.Translation with three sections:

guis - React UI Strings

Strings displayed in the browser-based UI panels:

  • replaceVehicles - vehicle replacement overlay (title, hints, vehicle stats)
  • availableGarages - garage browser cards (purchase flow, pricing)
  • invitePopup - guest invite accept/decline popup
  • garageSelect - garage selection when multiple garages overlap
  • manageGarage - management panel (invite, sell, co-owners, activity log)
  • activityLog - activity log event labels

messages - In-Game Notifications

Notification text and action prompts shown during gameplay. Includes:

  • Entry/exit messages
  • Error messages (vehicle restrictions, ownership, money)
  • Interaction prompts (press E to enter, manage, etc.)
  • Discord webhook log descriptions

builder - Builder UI

Labels, dialogs, menus, and notifications for the garage builder. Includes:

  • Stage labels and field names
  • Capture mode button text
  • Validation messages
  • Dialog titles and input labels
  • Notification messages (success, errors, warnings)

Note: All language files are in escrow_ignore and can always be edited, even in encrypted releases.