Multi-Language System
Welcome to the Multi-Language System! This is a project that allows you to add 3 languages, but you can implement more languages by adding base functions. In this example, the available languages are Portuguese, English, and Spanish. This system was developed with the assistance of (LBR)Diego^.
Installation
Follow the steps below to set up the Multi-Language System on your server:
- Download the files from the repository (https://github.com/Yuriitwo/VC-MP-Language-System).
- After downloading the repository, you will find two files. Copy the "LanguageSystem.nut" file to the scripts folder of your server. In the "Essential.nut" file, you will find everything you need to install the system.
- Add the following code in the onScriptLoad() to load the functions from the "LanguageSystem.nut" file:
function onScriptLoad() {
dofile("scripts/LanguageSystem.nut");
}
- Also, add the following line in the onScriptLoad() to create an array "Language" with the maximum number of players, so it's possible to switch between languages:
function onScriptLoad() {
dofile("scripts/LanguageSystem.nut");
Language <- array(GetMaxPlayers(), 1);
}
- Add the "idioma" command in the onPlayerCommand() function to allow players to change the language:
function onPlayerCommand( player, cmd, text ) {
if ( cmd == "idioma" || cmd == "language" || cmd == "linguagem" ) {
if (!text) {
MessagePlayer( "/> [#08c5ff]" + cmd + " <pt/en/es>", player);
}
else if (text == "pt") {
if (Language[ player.ID ] == 0 ) {
MessagePlayer("> [#fc3932]O idioma ja esta definido como Portugues.", player);
}
else {
Language[ player.ID ] = 0;
MessagePlayer("> [#08c5ff]Idioma definido como Portugues.", player);
}
}
else if (text == "en") {
if (Language[ player.ID ] == 1 ) {
MessagePlayer("> [#fc3932]The language is already set to English.", player);
}
else {
Language[ player.ID ] = 1;
MessagePlayer("> [#08c5ff]Language set to English.", player);
}
}
else if (text == "es") {
if (Language[ player.ID ] == 2 ) {
MessagePlayer("> [#fc3932]El idioma ya esta configurado en espanol.", player);
}
else {
Language[ player.ID ] = 2;
MessagePlayer("> [#08c5ff]Idioma configurado en espanol.", player);
}
}
else MessagePlayer(getMsgByLanguage("> [#fc3932]Esse idioma nao esta na lista.", "> [#08c5ff]This language is not on the list.", "> [#08c5ff]Este idioma no esta en la lista.", player), player);
}
}
About the system
This is a multi-language system designed to handle different messages for players in their preferred language. The system uses an array called
Language to keep track of the language chosen by each player.
- getMsgByLanguage(ptMsg, enMsg, esMsg, player)
This function takes four parameters: ptMsg, enMsg, esMsg, and player. It determines the message to be returned based on the player's chosen language. It first checks the Language array for the player's language preference and returns the corresponding message in that language. If the player's language is not 0 (Portuguese), 1 (English), or 2 (Spanish), it will return the ptMsg as a default fallback.
- getMsgByLanguageAllPlayers(ptMsg, enMsg, esMsg)
This function takes three parameters: ptMsg, enMsg, and esMsg. It iterates through all the players on the server and sends the appropriate message to each player based on their chosen language. It uses the MessagePlayer function to send the messages.
- getMsgByLanguageAllExcept(ptMsg, enMsg, esMsg, player)
This function is similar to the previous one, but it excludes sending the message to a specific player passed as the player parameter. It iterates through all players on the server except the specified player and sends the appropriate messages to each player based on their chosen language.
Overall, this system allows you to manage and deliver messages in different languages based on each player's preferences. By calling the appropriate functions, you can send messages to individual players, all players, or all players except a specific one, in their chosen language.
Thanks for the language system yuriitwo, I was about to ask you about this on DC. :DD
Quote from: Ridwan Rz on Aug 04, 2023, 03:08 AMThanks for the language system yuriitwo, I was about to ask you about this on DC. :DD
You're welcome, my friend. I just want to contribute in some way.
Good system.
You could replace the original msg function also this way:
MessagePlayer("Bem-vindo", "Welcome", "Bienvenido", player );
local msgplayer = MessagePlayer
rawset("MessagePlayer", function (...){
switch(vargv.len())
{
case 2: return msgplayer(vargv[0], vargv[1] );break;
case 4: return msgplayer(getMsgByLanguage(vargv[0], vargv[1], vargv[2], vargv[3]), vargv[3] );
default: throw("Invalid no:of parameters");
}
});
Quote from: habi on Aug 04, 2023, 06:55 AMGood system.
You could replace the original msg function also this way:
MessagePlayer("Bem-vindo", "Welcome", "Bienvenido", player );
local msgplayer = MessagePlayer
rawset("MessagePlayer", function (...){
switch(vargv.len())
{
case 2: return msgplayer(vargv[0], vargv[1] );break;
case 4: return msgplayer(getMsgByLanguage(vargv[0], vargv[1], vargv[2], vargv[3]), vargv[3] );
default: throw("Invalid no:of parameters");
}
});
Thanks for the tip, I didn't think of that at the time lol
Amazing work brother :)
but, why use the nut code made it? u can try custom file. belike:
en-us.lang:
hello-world=hello world
zh-cn.lang:
hello-world=你好，世界
Quote from: 2b2ttianxiu on Aug 11, 2023, 01:24 AMbut, why use the nut code made it? u can try custom file. belike:
en-us.lang:
hello-world=hello world
zh-cn.lang:
hello-world=你好，世界
I found this way more interesting, because it is easier to implement other languages, and it is also easier to understand.