Skip to content

Localization

Matej Pacan edited this page Nov 9, 2021 · 12 revisions

Want to change messages like "Wait (x) seconds before chatting again" in antispam, in" /chc announce" and many, many more? Welcome to localization.

ChatControl speaks your language! We offer plenty of world's languages that will translate the vast majority of plugin's messages to your language, or to what you choose yourself.

Video tutorial below, click the image to watch:

Video tutorial

Important: Some messages cannot be reloaded, you have to do a clean restart.

Available Localizations

For up-to-date information about what languages we support, please see the Locale key in settings.yml.

Changing A Localization

By default, the localization is set to English (en). To change this, edit the Locale key in settings.yml file to one of the available localizations described in the comments above the key.

Localization file

Making Your Own Localization

Customizing any message is as simple as opening the localization/ folder and then editing the messages_X.yml file, where X represents the Locale key from settings.yml, such as messages_en.yml. Simply make direct changes to that file and you're good!

Before you edit your localization, check the Encoding article to prevent losing your messages.

Customizing /channel or /chc

To customize /channel, edit the Channels section in your locale file. You can also set Use_Alternative_Header to true in the same section and then edit the "Header_Alternative" and "Header_Alternative_Channel" keys.

To customize /chc, edit Commands section in your locale file. You can also set Use_Alternative_Header to true in the same section at the bottom and then edit the "Alternative_Header" key to completely change your /chc command output.

Removing prefixes such as [X] or [!]

You can either remove them completely in the Prefix section of your localization file, or prepend messages that should not have them added with "@noprefix" such as this example.