Players, chat and mail

modules/players.yml and modules/chat.yml

Private messages#

/reply answers whoever you last spoke to, in either direction.

/rtoggle chooses which end of a conversation /reply answers. It only matters when one is interrupted: you write to Anna, Ben writes to you, and /r has to pick.

Message text reaches chat as plain text, so a player cannot smuggle colour codes or formatting into somebody else's screen.

Turning messages off#

/msgtoggle turns private messages off entirely. /ignore <player> turns off one person and remembers it between sessions; /ignore list shows who.

Either way the sender is told the same thing — that the player is not taking messages — so being ignored is never announced.

chorus.chat.ignore.bypass reaches anybody regardless.

Social spy#

chat:
  spy-enabled: true

/socialspy shows staff a copy of everybody else's private messages. spy-enabled: false stops it working for everyone, permission or not.

Mail#

Letters for players who were not online to hear it said. Whoever they are for is told how much is waiting the next time they log in, and reading marks the whole inbox as seen.

/mail read <player> needs chorus.mail.read.others and leaves the inbox unread, because staff looking into a complaint should not change what the player is about to see.

mail:
  keep-days: 60
  inbox-size: 50
  page-size: 8
  max-length: 256

There is a [Mail] service sign too — see Utility, signs and powertools.

Players#

Away#

players:
  auto-afk-minutes: 5
  kick-after-minutes: 0
  broadcast: true

Nicknames#

players:
  max-nick-length: 16

Counted in letters rather than colour codes.

/nick <name> renames yourself, /nick off puts it back. /nick <player> <name> needs chorus.players.nick.others, and colour codes need chorus.players.nick.colour.

/realname <nickname> finds the username behind one.

Looking players up#

/seen shows when a player was last online. chorus.players.seen.address adds the address and any accounts sharing it.

/whois shows everything known about a player. chorus.players.whois.ip adds the address.

/playtime on somebody else needs chorus.players.playtime.others.

GeoIP#

players:
  geoip:
    enabled: false
    endpoint: 'https://ipapi.co/%address%/country_name/'

Adds the country to /whois, for whoever holds chorus.players.whois.country.

There is no country in a player's connection. The only way to know is to ask a service outside this server, which means sending that player's address to it. That is a real decision, so it is off until you turn it on. Answers are kept until the next restart.

Personal time and weather#

/ptime and /pweather change what one player alone sees. On somebody else they need .others.

Config reference#

# modules/players.yml
enabled: true

players:
  auto-afk-minutes: 5
  kick-after-minutes: 0
  broadcast: true
  max-nick-length: 16
  geoip:
    enabled: false
    endpoint: 'https://ipapi.co/%address%/country_name/'

commands:
  defaults: ...
  afk: ...
  seen: ...
  playtime: ...
  whois: ...
  list: ...
  nick: ...
  realname: ...
  ptime: ...
  pweather: ...

# modules/chat.yml
enabled: true

chat:
  spy-enabled: true

mail:
  keep-days: 60
  inbox-size: 50
  page-size: 8
  max-length: 256

commands:
  defaults: ...
  msg: ...
  reply: ...
  socialspy: ...
  msgtoggle: ...
  ignore: ...
  mail: ...
  rtoggle: ...

Permissions#