diff --git a/.idea/ButtonChat.iml b/.idea/ButtonChat.iml index c640e48..dec5138 100644 --- a/.idea/ButtonChat.iml +++ b/.idea/ButtonChat.iml @@ -19,7 +19,7 @@ - + diff --git a/README.md b/README.md index 32b9c62..b00ded7 100644 --- a/README.md +++ b/README.md @@ -1,133 +1,28 @@ -# The Button Minecraft server chat plugin +# Chroma-Chat plugin +A plugin that provides markdown formatting, name mentioning and other chat features. -## How to use -### Players -#### Obtaining the flair (/u accept) -At first, you need to connect your Reddit account with your Minecraft account. This is done by writing your Minecraft name to [this thread](https://www.reddit.com/r/Chromagamers/comments/51ys94/flair_thread_for_the_mc_server/), following the instructions in the post. +## Components -When you're done, connect to the server, if you aren't already on. You should see a message after a while (max. 10 seconds) asking if you're the correct Reddit user. Type /u accept to confirm it and accept your flair. +### Announcer +This component simply sends messages globally based on a configurable list in a given interval. -__Note__: You can comment your ingame name from multiple Reddit accounts. In this case, you'll need to specify the exact username you want to pair with your Minecraft account. For example: +### Append text +This component allows the players to put tableflips and other texts after their messages using /tableflip and other commands. - /u accept NorbiPeti +### Chat-only +This component lets a player become invincible at the cost of not being able to move. It was made for chat clients. -#### Hiding the message (/u ignore) -You can use this command to hide the notice showing up after you log in if you don't have a flair accepted. +### Flair +This component downloads /r/TheButton flairs from Reddit for users who comment in a specific thread. This was the original function of the plugin. -#### Flair not showing up -Please note that in some cases your flair cannot be obtained (specifically, if it's not stored by karmadecay.com, in which case possibly Karmancer can't show it as well). In this case, there are two possibilities. +### Formatter +This component provides the Markdown and other formatting and name mentioning. -If you're a non-presser or a can't press and only your time is recorded, it will automatically decide based on your account creation date. +### Fun +This component has some random things I added for fun, including "Press F to pay respects" and rainbow chat. -If nothing is known about your flair, you need to ask an admin to set the flair for you. Please prepare a link to a comment you made on /r/thebutton, if possible. +### Town colors +This component allows mayors and kings to set a color for their town/nation, which sets each resident's name colors and also shows on Dynmap. -#### Getting someone's Reddit username (/u name) -You can see a player's username if they have a flair shown. - -#### Name mentioning -If you simply say any online player's full playername or nickname, it'll highlight it and play a sound for the target player. - -If you say a nickname, it'll show it's original colors, if you say a username, then it will choose based on flair color if known, otherwise it'll use the aqua color. - -You can also use @console to ping the console. If someone is there, they'll receive an audible bell signal. - -#### RP/OOC mode (/nrp or /ooc) -You can use /ooc to say something Out-of-Character. Otherwise everything you speak should be treated as said in RP, except when it is obvious it's not in RP (like talking about the server). - -#### Greentext support (>message) -Start your message with '>' to make it green. - -#### Hashtags (#hashtag) -If you say a hashtag in global chat, it'll highlight it and makes it clickable, linking to the hashtag page on Twitter. - -#### Paying respects (F) -If a player dies, sometimes the plugin will tell everyone "Press F to pay respects.". After a few seconds, a message will tell everyone how many people paid their respects. - -If you hover over a player's name in chat, you can see how much respect they gained this way, divided by the number of eligible deaths. - -#### Copy messages -To copy a message from chat, click the channel identifier (for example: [g] or [TC]) at the beginning of the message. - -#### Tableflipping (/tableflip and /unflip) and shrug (/shrug) -The idea of this command came from Discord. - -Examples: - - /tableflip - (╯°□°)╯︵ ┻━┻ - /tableflip test - test(╯°□°)╯︵ ┻━┻ - /unflip - ┬─┬ ノ( ゜-゜ノ) - /unflip test - test┬─┬ ノ( ゜-゜ノ) - -#### Chat only (/chatonly) -You can use this mode to protect yourself if you connect from a chat-only client. This will make you invincible, but unable to move, teleport or interact with the world in any way. - -#### Rainbow chat (/u c) -Chat in rainbow/Presser colors. - -### Admins -Type /u admin for a list of the commands. -#### Seeing player information (/u admin playerinfo) -You can check someone's flair status and other infos in case something goes wrong. - -It outputs the player name (useful if something goes *really* wrong), the player's current ingame flair, the Reddit username, and their flair status: - -* Accepted: The user has a flair shown after their name. -* Ignored: The user chose to hide their flair, but they have one. -* Recognised: The user has recognised flair(s) but haven't accepted any. -* Commented: The user commented, but their flair isn't known. -* NoComment: The user haven't commented in the thread. - -#### Reloading the plugin (/u admin reload) -This is useful if you want to change a file related to the plugin. - -Be careful and make sure you do /u admin save before you reload the plugin. You need to confirm your action (/u admin confirm) to make sure no setting is lost. - -If you want to edit a file, you need to do /u admin save, then edit the file you want, then do /u admin reload. - -#### Setting the flair by hand (/u admin setflair) -This allows you to set any flair you want to any player. This will override the automatic flairs, though it's not recommended to do so. However, the player can reset the automatic flair at any time (see /u accept). - -* To remove a user's flair: - - /u admin setflair none false - -* To set a non-presser or can't press flair: - - /u admin setflair non-presser/cant-press false - -* To set a cheater flair: - - /u admin setflair