feat(locale): add locale management functionality

[lu-value]

Pull request template

Important

Please complete all fields. PRs will not be merged if any fields are incomplete. Be respectful, and keep in mind that it may take some time for your PR to be reviewed.

Bear in mind refactors are up to the developers and not it's contributors after all we are the ones giving support when needed. if they are big changes I suggest you to release it under your name instead.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Motive for This Pull Request

This PR contributes to script and server creators by allowing VORP creators to use this module so their resources can support multiple languages with a simple import.

Provide a brief explanation of why these changes are being proposed and what they aim to achieve.

It simply aims to make the life of VORP creators easier.

Explain the necessity of these changes and how they will impact the framework or its users.

This is not required; it is only a "dev" feature and has no impact on users.

Please describe the tests you have conducted to verify your changes. Provide instructions so we can reproduce these tests. Client-side and server-side tests work perfectly.

• Tested with latest vorp scripts
• Tested with latest artifacts

Notes if any

explanation field

[lu-value]

If this PR is accepted, I will update the documentation

[outsider31000]

not sure I understand what is this for
you can already import any file using Import function ,
why do we need a module to import more files?

each script has its own translation and those files can be imported using Import function.
see for example vorp_police , it has translation.lua file and its imported to the client and server no need to import a module to import a translation file

[lu-value]

You're right that Import() can load translation files. But this module does more than just importing:

1. Runtime language switching - Users can change language without restarting (SetLang('fr'))
2. Automatic fallback - If a key is missing in French, it falls back to English
3. Variable interpolation - T('welcome', {name = 'John'}) → "Welcome John"
4. Standardized API - All VORP scripts would use the same translation pattern

Currently each script implements its own translation logic. This module provides a consistent, feature-rich solution.

If you think this isn't needed for vorp_lib, I understand.

[outsider31000]

Yeah sorry I just dont see the need of switching language in runtime
for example, what would be the point in changing inventory to english at run time if the other 200 scripts are in spanish and do not support this module? rhetorical question
specially when people use escrow scripts where they cannot support this feature.

Even though you explained I cannot see a reason to add a module to load files when we have Import function that does the "same"

I appreciate the effort though, thank you for making a pr. lets leave it open for now.

[lu-value]

Yeah sorry I just dont see the need of switching language in runtime for example, what would be the point in changing inventory to english at run time if the other 200 scripts are in spanish and do not support this module? rhetorical question specially when people use escrow scripts where they cannot support this feature.

Even though you explained I cannot see a reason to add a module to load files when we have Import function that does the "same"

I appreciate the effort though, thank you for making a pr. lets leave it open for now.

Yeah, for the escrow scripts, I didn’t really consider that point
I was mainly trying to make the library more powerful
But yes, feel free to make the call, and actually, when we look at it from this perspective, this feature isn’t really necessary
I really appreciate the time you took to review this!

[outsider31000]

no worries thank you for understanding.