Locales

🌐 Locales

Translation files are in the locales/ folder.

locales/
├── en.json   <- English
└── pl.json   <- Polish

To change the language, update fxmanifest.lua to point at the correct file, or duplicate a file and translate the values.

Never rename or remove keys (the left side of each JSON entry). Only edit the values on the right side. Changing a key will cause the script to fall back to the key name

---

Variable placeholders

Some values contain %s, %d, or %.1f. These are filled in automatically by the script.

Placeholder	Type	Example output
%s	text	stop name, route name
%d	whole number	EXP, $, passengers
%.1f	decimal	distance in km
%02d	zero-padded int	06, 09

Do not remove, reorder, or add extra % placeholders. Arguments are passed in a fixed order - mismatches cause a Lua error.

---

Key reference

Errors

"error_title":              "Error",
"error_no_vehicle_route":   "Select a vehicle and route first",
"error_already_has_bus":    "You already have a bus",
"error_no_bus":             "You have no bus",
"error_finish_route_first": "Finish your route before returning the bus",
"error_not_working_here":   "You don't work here",
"error_invalid_vehicle":    "Invalid vehicle",
"error_invalid_route":      "Invalid route",
"error_level_vehicle":      "Your level is too low for this vehicle",
"error_level_route":        "Your level is too low for this route",
"error_route_time":         "This route is not available right now",
"error_too_far":            "You are too far away",
"error_too_far_depot":      "You are too far from the depot",
"error_spot_taken":         "The spawn spot is occupied",
"error_wait":               "Please wait a moment"

Stops & Routes

"stop_timeout_title":    "Stop skipped!",
"stop_timeout_desc":     "You didn't reach stop: %s in time\nEXP: +%d (reduced)",
"stop_time_low_title":   "Hurry up!",
"stop_time_low_desc":    "Stop: %s\nTime remaining: %ds",
"stop_text":             "[E] Open doors – Stop: %s",
"stop_text_last":        "[E] Open doors – Final stop: %s",
"stop_exchanging":       "Passenger exchange in progress...",
"stop_desc":             "Boarded: %d  |  Exited: %d\nIn bus: %d passengers\nEarning: $%d  |  EXP: +%d\nDriving score: %d%%",
"stop_last_desc":        "Final stop\nPassengers exited: %d\nEarning: $%d  |  EXP: +%d\nDriving score: %d%%",
"route_complete_title":  "Route completed",
"route_complete_desc":   "Total earning: $%d  |  EXP: +%d\nDistance: %.1f km\nDriving score: %d%% %s\n\nReturn to the depot to collect your payment!",
"route_damage_line":     "\nDamage penalty: -%d%%  ($%d)",
"perfect_title":         "Perfect route!",
"perfect_desc":          "Bonus: $%d  |  EXP: +%d\nDriving score: %d%%",
"route_cancelled_title": "Route interrupted",
"route_cancelled_desc":  "Your route has been cancelled"

Level & Damage

"level_up_title":      "Level up to %d!",
"level_up_desc":       "Congratulations! New options unlocked.\nPayment bonus: +%d%%",
"damage_title":        "Vehicle damaged!",
"damage_desc":         "Body loss: %.0f  |  Engine: %.0f\nScore penalty: -%.0f%%\nTotal damage penalty: -%d%%",
"minor_damage_title":  "Minor damage",
"minor_damage_desc":   "Driving score: -%.0f%%",
"speed_title":         "Speeding",
"speed_desc":          "Penalty: $%d",
"achievement_title":   "🏆 Achievement!",
"achievement_desc":    "%s\n%s\nReward: $%d"

Menu

"menu_main_title":        "Work – Bus Driver",
"menu_configure":         "Configure route",
"menu_configure_desc":    "Select vehicle and bus line",
"menu_stats":             "Statistics",
"menu_stats_desc":        "Your achievements and work summary",
"menu_history":           "Route history",
"menu_history_desc":      "Last 10 completed routes",
"menu_return_bus":        "Return bus",
"menu_return_bus_desc":   "Return to depot and hand over the vehicle",
"menu_return_bus_active": "Finish your active route first",
"menu_start_work":        "Start work",
"menu_start_work_desc":   "Drive the bus out and head to the route",
"menu_vehicle_select":    "Select vehicle",
"menu_route_select":      "Select route",
"menu_clear":             "Clear selection",
"confirm_start":          "Start work",
"confirm_back":           "Go back"

Discord Webhooks

"wh_route_started_title":  "🚌  Route started",
"wh_route_complete_title": "✅  Route completed",
"wh_route_perfect_title":  "🌟  Perfect route!",
"wh_bus_returned_title":   "✅  Bus returned - payment",
"wh_bus_destroyed_title":  "💥  Bus destroyed!",
"wh_accident_title":       "⚠️  Accident!",
"wh_levelup_title":        "⭐  Level up!",
"wh_achievement_title":    "🏆  Achievement unlocked!",
"wh_disconnect_title":     "🔌  Player disconnected during route",

"wh_footer":               "🚌 Bus Driver  •  sleepycode  •  %s",
"wh_discord_link":         "🔗 [Join our Discord](%s)",

"wh_desc_route_started":   "Driver departed on route **%s**! 🚌",
"wh_desc_bus_returned":    "Driver returned the bus and collected **$%d**. ✅",
"wh_desc_levelup":         "Player levelled up to **%d**! New options unlocked. 🎉",
"wh_desc_accident":        "Driver caused an accident on route **%s**! ⚠️",
"wh_desc_route_complete":  "Route **%s** completed!",
"wh_desc_collect_payment": "*Payment is waiting at the depot.*",
"wh_desc_damage_penalty":  "> ⚠️ Damage penalty: **-%d%%**  ($%d)",
"wh_desc_bus_destroyed":   "Driver **%s**'s bus was completely destroyed! 💥",
"wh_desc_disconnect":      "Player **%s** left the server during an active route! 🔌",
"wh_desc_achievement":     "**%s**\n> %s"

wh_desc_* keys support Discord Markdown: **bold**, > blockquote, *italic*, and emoji.