Multi-lingua

What it does

Multi-lingua allows players within factions to speak in another language, so that when they chat, players that are not in their faction see only a garbled message and players in their faction see a normal message.

Features

• Enable/disable easily with a simple command
• Config options to degrade messages over distance
• Easily speak so that everyone can understand with a chat prefix
• Yell a message with a chat suffix so that players can hear you from a distance
• Config option to decrease hunger bar and give dizzy effect when yelling
• Created in response to this request: Multi-lingua

Installation

Add the Multi-lingua.jar file to your server's plugins directory and start up the server. A config file will be created automatically with the default values. Use the in-game or console commands to change config settings.

This plugin relies on Factions and will disable itself if Factions is not found.

Tested with Factions 1.6.9.4

How it works

1. When a player creates a faction they will be asked if they want to enable Multi-lingua for the faction, to do this they type: /ml add
2. Now when a player uses chat, their messages will appear garbled to non-faction members
3. To speak normally you can add a prefix (configurable) before your chat message - by default this is "[@] "
4. To make your message be heard over a distance, you add a suffix at the end of your chat message - by default this is " [!]"
5. To remove Multi-lingua from your faction, just type: /ml remove

Commands

• /ml add - turns on Multi-lingua for your faction
• /ml remove - turns off Multi-lingua for your faction
• /ml [config_option] [value] - sets the specified config option to the value given

Permissions

mulitlingua.admin - allows a player to edit the Multi-lingua config - default: OP

factions.create - needed to add Multi-lingua to your faction (you must also be the faction ADMIN to use the /ml add command)

Config

1. plain_text_key: <put text here> - sets the prefix to make speech normal i.e. if <put text here> = '@' when you type "[@] " before your message it will not scramble the text - note that there is a space after the last square bracket!
2. yell_key: <put text here> - sets the prefix to make you yell your message so that players can hear it beyond the chat_deaf_after distance (see 5) - requires a space before the first square bracket i.e. " [!]" when typed in chat
3. use_chat_radius: <true|false> - whether to make the chat message break up over distance
4. chat_degrade_after: <distance> - the distance (in blocks) after which chat starts breaking up i.e. players within <distance> can hear normally, players outside <distance> start to lose bits, the further away you are the more bits you lose
5. chat_deaf_after: <distance> - the distance (in blocks) after which players are deaf, if you put the yell suffix after your message deafness will be ignored
6. dizzy_after_yell: <true|false> - whether to make the yelling player dizzy (confusion effect) and reduce their hunger bar
7. dizzy_ticks: [amount] - how long the dizzy effect lasts
8. dizzy_hunger: [amount] - how much hunger to remove

Change log

v1.0-beta-3

• Fixed the chat listener ignoring the /ml remove command

v1.0-beta-2

• Fixed chat radius not applying to everyone when enabled, this also fixes only faction members needing to yell
• Fixed chat radius related bug where it seemed like it was using the faction creator as the measuring point to start from when degrading chat over distance

v1.0-beta

• Initial beta release

Source code

GitHub repository