Add custom AFK reason support for ChatControl private messages

[RapidGravy]

Summary

Add custom AFK reason support for ChatControl private messages. The essentials plugin has this feature for their AFK implementation and its allowing the player to run /afk <message> which toggles their AFK status but also changes the auto reply to the input message.

For example:

/afk eating dinner

When someone then messages this person, instead of getting the standard chatcontrol afk message they get a smaller message such as:

PlayerName is AFK: eating dinner

I did try working around this with PlaceholderAPI/ParseOther and the Essentials AFK reason placeholder but it was not reliable inside the ChatControl PM warning format.

[kangobot]

Thanks, good idea. I've added this - when the person you message has set an AFK reason via /afk <reason> in Essentials (or CMI), the warning now shows it:

[Warn] PlayerName is currently AFK: eating dinner

If no reason is set, you get the normal AFK warning as before. You can customize the new message under the command-tell-afk-warning-reason key in your lang file, and the {reason} text is inserted as plain text so players can't sneak colors or clickable tags into it. It also works when the AFK player is on another server behind your proxy, with the same ~2 second refresh the AFK status itself has.

Two notes:

• Essentials only lets players set a reason if they have the essentials.afk.message permission from Essentials.
• Your PAPI workaround could never work reliably because the warning is rendered against the message sender, not the receiver, and cross-server players have no local data for PAPI to read. So this needed to be built in.

Will be in the next version once the PR is reviewed.

I proposed a fix here: https://github.com/kangarko/ChatControl-Src/pull/17
🔧 Foundation draft fix: kangarko/Foundation#451