PerseweratywneImponderabilia/LangPlus
Create multilanguage open.mp servers with ease
Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.
Installer avec sampctl
sampctl package install PerseweratywneImponderabilia/LangPlus
Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.
Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.
Dépend de 6 paquets
README.md
LangPlus
A lightweight multilanguage library for open.mp servers. Uses INI files for translations and provides an easy-to-use API for managing player languages.
Features
- Fallback system - Missing keys fall back to the default language; if that fails, the
keyitself is used - String replacements - Use
SetStringReplacement()for dynamic text substitution - Format specifiers - Full support for format specifiers, such as:
%d,%s,%.2f, etc. - Non-latin character support - Support for non-latin characters, such as cyrillic alphabet; use proper file encoding for the desired characters
Installation
sampctl install PerseweratywneImponderabilia/LangPlus
#include <LangPlus>
Note
Make sure these definitions are declared before you include PawnPlus, preferably at the very top of your main gamemode file:
#define PP_SYNTAX_FOR_POOL
#define PP_SYNTAX_FOR_MAP
Quick Start
gamemodes/main.pwn
#include <LangPlus>
new Language:g_English, Language:g_Ukrainian;
public OnGameModeInit() {
g_English = LoadLanguage("en", "English");
g_Ukrainian = LoadLanguage("uk", "Ukrainian");
return 1;
}
public OnPlayerConnect(playerid) {
SetPlayerLanguage(playerid, g_Ukrainian);
SendLanguageMessage(playerid, -1, "WELCOME_MESSAGE", playerid);
SendLanguageMessageToAll(-1, "PLAYER_JOINED", playerid);
return 1;
}
scriptfiles/languages/en.ini
WELCOME_MESSAGE=Welcome, player %d!
PLAYER_JOINED=Player %d joined
scriptfiles/languages/uk.ini
WELCOME_MESSAGE=Вітаємо, гравець %d!
PLAYER_JOINED=Гравець %d приєднався
API Reference
| Function | Description |
|---|---|
Language:LoadLanguage(code[], name[], fileName[]) | Load a language. Looks for the file in the DIRECTORY_LANGUAGES directory; file name is fileName, name.ini, code.ini respectively. |
SetPlayerLanguage(playerid, Language:id) | Set player's language |
Language:GetPlayerLanguage(playerid) | Get player's current language |
SendLanguageMessage(playerid, colour, key[], ...) | Send localized message to player (supports format specifiers) |
SendLanguageMessageToAll(colour, key[], ...) | Send localized message to all players in their language |
GetLanguageString(Language:id, key[], output[], len) | Get translated string for a language |
ReturnLanguageString(Language:id, key[]) | Return translated string |
String:ReturnLanguageString_s(Language:id, key[]) | Return translated PawnPlus string |
GetLanguageCount() | Get number of loaded languages |
bool:DoesLanguageCodeExist(code[]) | Check if language exists |
bool:DoesLanguageNameExist(code[]) | Check if language exists |
GetLanguageCodeList(string:codes[][], maxSize) | Get array of language codes |
GetLanguageNameList(string:names[][], maxSize) | Get array of language names |
SetStringReplacement(key[], value[]) | Define replacement for language loading (call before LoadLanguage) |
@L(playerid, key[]) | Macro for ReturnLanguageString(GetPlayerLanguage(playerid), key) |
@LS(playerid, key[]) | Macro for ReturnLanguageString_s(GetPlayerLanguage(playerid), key) |
Configuration
Define before including the library:
| Macro | Default | Description |
|---|---|---|
MAX_LANGUAGES | 4 | Maximum number of languages |
DELIMITER_CHAR | "=" | Key-value separator in INI files |
DIRECTORY_LANGUAGES | "languages/" | Language files directory |
MAX_LANGUAGE_KEY_LEN | 32 | Maximum key length |
MAX_LANGUAGE_ENTRY_LENGTH | 768 | Maximum translation length |
MAX_LANGUAGE_NAME | 32 | Maximum language name length |
MAX_LANGUAGE_CODE | 8 | Maximum language code length |
MAX_FILE_NAME | 64 | Maximum file name length |
MAX_REPLACEMENT_KEY_LEN | 16 | Maximum replacement key length |
MAX_REPLACEMENT_VALUE_LEN | 16 | Maximum replacement value length |
LANGPLUS_NO_MACROS | `` | Define to disable @L and @LS macros |
Example:
#define MAX_LANGUAGES 8
#define DIRECTORY_LANGUAGES "translations/"
#include <LangPlus>
Language File Syntax
Language files use INI format with the following rules:
- Key format: Keys must start with a letter (a-z, A-Z), digit (0-9), or a certain symbol (
!,@,$,&) - Delimiter: Keys and values are separated by
=(configurable viaDELIMITER_CHAR) - Comments: Lines starting with other characters are ignored by the parser (e.g.,
;,#,[) - Escape sequences: Supports
\n,\t, etc. in values - Format specifiers: Values can contain
%d,%s,%f, and other format specifiers
Example:
; This is a comment
WELCOME_MESSAGE=Welcome, player %d!
@ADMIN_COMMAND=Admin %s used command
$ERROR_MESSAGE=Error: %s
Testing
sampctl run
Credits
Inspired by ScavengeSurvive/language
omp-serverpawnpawn-packagesa-mpsa-mp-librarysampsampctl
Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche