🌏Advanced Language Managment

Default Language

You can set default language at config.yml file.

config-files:
  language: en_US
  # Premium version only.
  per-player-language: true

The input here is the name of the language file (without the suffix). All language files are stored in the "languages" folder. You can also create a new language file by simply copying the "en_US.yml" file and renaming it to the corresponding language code. For example, zh_CN.yml.

Content below was added in plugin version 3.0.4.

Per Player Language - Premium

You can enable per-player-language at config.yml file. After being enabled, the plugin will determine which language file to display to the player based on their client language. The server must have the relevant language files preloaded; otherwise, it will display content using the default language file.

Let us watch this video to understand it!

Lang Placeholder

You can use {lang:<langKey>} placeholder in plugin message to enable players from all over the world to display language settings that match their client.

You can add your desired custom language text under the "override-lang" section of each language file, in the format of "ID: text content". For example:

// ... The content originally present in the language file

# Added content
override-lang:
  # This means shop-title it's language key.
  shop-title: 'Item Shop'

// ... The content originally present in the language file

# Added content
override-lang:
  # This means shop-title it's language key.
  shop-title: '物品商店'

Then use {lang:shop-title} in the place you want to use.

In config.yml, you can directly use {lang} to represent the custom language from the language file to be used. The language ID should be synchronized with the configuration file structure in the config.yml file, for example:

In config.yml file:

placeholder:
  # Premium version only
  compare:
    up: '{lang}'
    down: '{lang}'
    same: '{lang}'

In each language file:

// ... The content originally present in the language file

override-lang:
  placeholder:
    compare:
      up: '↑'
      down: '↓'
      same: '-'

Similarly, if we cannot find this custom language in the corresponding language file, we will search for it in the default language file. If it is still not found, then the plugin will not parse this placeholder.

Advanced Message Format - Premium

The default language text is directly filled into the text content that needs to be output, along with color codes. However, you can also utilize this feature to enable the plugin to display not only regular chat box messages, but also actionbars, titles, bossbars, sounds, and more!

You can still use color codes (including MiniMessage) while using our advanced message format.

Common Usage

welcome: 'Welcome to the server!'

Chat Message

welcome: '[message]&aWelcome![/message]'

Title

welcome: '[title=20,60,20]&6Welcome;;&eThis is sub title[/title]'
# Format: [title=fadeIn,Stay,fadeOut]title;;subTitle[/title]

Both Chat Message and Title will be sent

You can mix and match these different message types, just like this.

welcome: '[message]&aGood day![/message][title=20,60,20]&6Welcome;;&eThis is sub title[/title]'

Action Bar

welcome: '[actionbar]&7Please wait...[/actionbar]'

Boss Bar - Early Alpha

welcome: '[bossbar=GREEN,SOLID,1.0]&aHappy Today[/bossbar]'

Sound

welcome: '[sound=ENTITY_EXPERIENCE_ORB_PICKUP,1,1][/sound][sound=ENTITY_PLAYER_LEVELUP,1,1][/sound]'