You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
AnhyLingo is a plugin for Minecraft servers designed to create a multilingual interface. It allows players to receive system messages, messages from other plugins, as well as see names and descriptions of items in their chosen language. Tested on servers with Spigot, Paper, Purpur cores version 1.20.2. The latest version of the <span style="box-sizing: border-box; font-weight: bolder;">ProtocolLib</span> plugin is required for operation.
Functionality of the plugin
Multilingualism:
(all players):
Ability to select desired languages using the command.
Automatically use Minecraft client language settings if the player has not set their preferred languages.
Display of text in the game chat and on the action bar in different languages.
Automatic translation of custom items into the selected language during interaction.
Working with game items:
(players with admin permissions):
Ability to create multilingual items.
Working with NBT tags:
(players with admin permissions):
View available NBT item tags.
Installing, changing and deleting NBT tags in items.
Work with files:
(players with admin permissions):
Uploading language files to the plugin folder.
Uploading any files to allowed folderss.
Deleting files from allowed folderss.
Language Personalization with Commands for All Players:
Players have the option to select languages for system messages, plugin notifications, and the display of game items that support multiple languages. If the language chosen by the player has been added by the administrators, all relevant informational messages will be displayed in that language. In cases where the player has not selected any specific language, the system will use the language settings of the Minecraft client. If the chosen language is not supported in the localization, the player will receive messages in the default language set in the plugin.
Set the desired languages
(no permission is required)
/lingo set <langs>
- can be one or more languages, for example en or en it es. Plugin will search for the translation in order.
Resetting the set language
(no permission is required)
/lingo reset
Clears the list of selected languages, the plugin will receive the language from the minecraft client.
Get languages
(no permission is required)
/lingo get
View selected languages for translation.
Administrator Commands
(with permission anhylingo.*)
The AnhyLingo plugin for Minecraft servers is equipped with administrative commands to manage multilingualism on the server. These commands are only accessible to players with extended administrative rights and allow for customization and control over the plugin's language options. The administrators can use these tools to set the available languages on the server, modify translations of game elements and the interface, and adjust language settings as per the players' needs. This approach promotes inclusivity and accessibility of the game for players from different countries and ensures a more flexible approach to cultural and linguistic diversity on Minecraft
Reloading and information commands:
Reloading the plugin
(with permission anhylingo.reload)
Reloads the general configuration and language files configurations
/lingo reload
Information about available item localizations
(with permission anhylingo.items.info)
Displays a list of "keys" for all items that have a translation in the specified language.
/lingo items list <lang>
Show localization for key
(with permission anhylingo.items.info)
Shows the name and lore in the specified language for the given key.
/lingo item <lang> <key>
Working with NBT tags:
(with permission anhylingo.nbt.*)
Adding an NBT tag or changing its value
(with permission , "anhylingo.nbt.set")
/lingo nbt set <nbt_key> <params...>
Setting the NBT tag nbt_key with parameters params, specifying the data type (e.g., string:value, int:10).
Examples of value types: int, double, intarray, string.
View NBT tags
(with permission , "anhylingo.nbt.list")
/lingo nbt list
Displays a list of NBT tags for the item currently in the player's hand
Examples of value types: int, double, intarray, string.
Viewing the value of NBT tags
(with permission , "anhylingo.nbt.info")
/lingo nbt info <nbt_key>
Shows the value of a specific NBT tag for the item in the player's hand.
Important: Deleting is only possible in the directories defined as allowed in the plugin configuration file (allowed_del_directories).
directory: File path.
file_name: File name
File view
View folder contents
(with permission anhylingo.file.view)
<span style="box-sizing: border-box; font-weight: bolder;">/lingo dir [directory]</span>
Displays the contents of the directory folder located in the server plugins directory.
If [directory] is set to 0, it will show the contents of the ./plugins/ folder.
Automatic Item Renaming:
Renaming the name and lore of custom items to the player's language during the player's interaction with the item in the inventory.
Automatic setting of the NBT tag with the language during renaming to prevent unnecessary renamings.
The item is not modified in cases where the language of the item matches the language of the player, or when more than one player is looking at the inventory simultaneously.
For the AnhyLingo plugin to track and rename certain items, it is necessary to add a special NBT tag AnhyLingo. This tag should contain a string value that corresponds to the key in the language file.
Adding an NBT Tag to an Item
Command for Adding Tag, example:
/lingo nbt set AnhyLingo string:magic_wand
This command adds the NBT tag AnhyLingo with the string value magic_wand to the item in the player's hand.
The value magic_wand corresponds to the key that must be in the language file.
Using Other Plugins:
Administrators can also use the functionality of other plugins to add this NBT tag to items.
It is important that the NBT tag has the name AnhyLingo and a string value that corresponds to the key from the language file.
This feature provides the ability to rename certain items on the server according to the player's chosen language, making the gameplay more interactive and convenient for players who use different languages.
Configuration (config.yml)
language: The default language for system messages.
allowed_directories: Allowed directories for command interaction.
Directory Structure
items: Files with translations of names and lore of custom items.
magic_wand:
name: "&bMagic Wand"
lore:
- "&7This is a magic wand."
- "&7It can perform magical feats."
- "&7Use it wisely."
# A copy of the main item with the first line of lore changed
magic_wand_1:
copy: magic_wand
lines:
1: "&cEnhanced Magic Wand"
eternal_sword:
name: "&cEternal Sword"
lore:
- "&7A legendary sword that never dulls."
- "&7Said to be forged from a fallen star."
- "&7Its blade cuts through darkness."
system: Files with translations of system messages and messages from plugins.
#
# ░█████╗░███╗░░██╗██╗░░██╗██╗░░░██╗██╗░░░░░██╗███╗░░██╗░██████╗░░█████╗░
# ██╔══██╗████╗░██║██║░░██║╚██╗░██╔╝██║░░░░░██║████╗░██║██╔════╝░██╔══██╗
# ███████║██╔██╗██║███████║░╚████╔╝░██║░░░░░██║██╔██╗██║██║░░██╗░██║░░██║
# ██╔══██║██║╚████║██╔══██║░░╚██╔╝░░██║░░░░░██║██║╚████║██║░░╚██╗██║░░██║
# ██║░░██║██║░╚███║██║░░██║░░░██║░░░███████╗██║██║░╚███║╚██████╔╝╚█████╔╝
# ╚═╝░░╚═╝╚═╝░░╚══╝╚═╝░░╚═╝░░░╚═╝░░░╚══════╝╚═╝╚═╝░░╚══╝░╚═════╝░░╚════╝░
#
# Internal system messages of the ItemLingo plugin
#
# 1 General
lingo_err_not_have_permission: "You do not have permission to use this command."
lingo_err_command_format: "Command format: "
#
# 2 Loading configurations
lingo_err_folder_is_empty: "The folder is empty or an error occurred while reading it."
lingo_err_folder_is_notexist: "The folder does not exist or it is not a folder."
lingo_err_reloading_configuration: "Error reloading configuration."
lingo_created_default_configuration: "Default configuration created."
lingo_configuration_reloaded: "Configuration reloaded."
lingo_language_reloaded: "Language files and configuration reloaded."
Files must have the name format: "xxx_[language_code].yml", for example, "lingo_en.yml", files that do not meet the standard are not read.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
AnhyLingo
AnhyLingo is a plugin for Minecraft servers designed to create a multilingual interface. It allows players to receive system messages, messages from other plugins, as well as see names and descriptions of items in their chosen language. Tested on servers with
Spigot
,Paper
,Purpur
cores version1.20.2
. The latest version of the<span style="box-sizing: border-box; font-weight: bolder;">ProtocolLib</span>
plugin is required for operation.Functionality of the plugin
Multilingualism:
(all players):
Working with game items:
(players with admin permissions):
Working with NBT tags:
(players with admin permissions):
Work with files:
(players with admin permissions):
Language Personalization with Commands for All Players:
Set the desired languages
/lingo set <langs>
en
oren it es
. Plugin will search for the translation in order.Resetting the set language
/lingo reset
Get languages
/lingo get
Administrator Commands
(with permission anhylingo.*)
Reloading and information commands:
Reloading the plugin
/lingo reload
Information about available item localizations
/lingo items list <lang>
Show localization for key
/lingo item <lang> <key>
Working with NBT tags:
(with permission anhylingo.nbt.*)
Adding an NBT tag or changing its value
/lingo nbt set <nbt_key> <params...>
string:value, int:10
).int, double, intarray, string
.View NBT tags
/lingo nbt list
int, double, intarray, string
.Viewing the value of NBT tags
/lingo nbt info <nbt_key>
Working with files
(with permission anhylingo.file.*)
File Uploading
File YAML AnhyLingo uploading
(with permission anhylingo.file.lingo)
<span style="box-sizing: border-box; font-weight: bolder;">/lingo fl (flingo) link_to_file folder true|false</span>
Uploading language files to subfolders of the AnhyLingo plugin directory.
link_to_file
: Direct link to the file.folder
: Folder where the file is uploadeditems|system
.true|false
: Parameter to determine the possibility of overwriting the file.File requirements: valid yml format, file name corresponds to the pattern
xxx_[language_code].yml
.File uploading
(with permission anhylingo.file.other)
<span style="box-sizing: border-box; font-weight: bolder;">/lingo fo (fother) link_to_file directory true|false</span>
directory
within the server plugins folder.allowed_directories
).link_to_file
: Direct link to the file for download.directory
: Target directory for the file within the server plugins directories.true|false
: Parameter that determines whether overwriting existing files is allowed.Deleting files
Deleting a file
(with permission anhylingo.file.other)
<span style="box-sizing: border-box; font-weight: bolder;">/lingo fd (fdel) directory file_name</span>
allowed_del_directories
).directory
: File path.file_name
: File nameFile view
View folder contents
(with permission anhylingo.file.view)
<span style="box-sizing: border-box; font-weight: bolder;">/lingo dir [directory]</span>
directory
folder located in the server plugins directory.[directory]
is set to 0, it will show the contents of the./plugins/
folder.Automatic Item Renaming:
Configuration (config.yml)
language
: The default language for system messages.allowed_directories
: Allowed directories for command interaction.Directory Structure
items
: Files with translations of names and lore of custom items.system
: Files with translations of system messages and messages from plugins.xxx_[language_code].yml
", for example, "lingo_en.yml
", files that do not meet the standard are not read.Beta Was this translation helpful? Give feedback.
All reactions