Moderation-tools.md

   1 ## How can I block/ignore people personally?
   2
   3 **As a player**, use `ignore #player_id`, this player will be blocked and entirely hidden from your personal chat logs. \
   4 Keep in mind that this can result in confusing situations as the blocked player(s) can continue talking to others in the server while you've blocked them. \
   5 To unblock a single player, use `unignore #player_id`. \
   6 To unblock all currently ignored players, use `clear_ignores`.
   7
   8 _Note: you can't ignore more than 16 players._
   9
  10 ## How can I disallow people from chatting in my server?
  11
  12 **As a server admin**, if there's someone spamming in the chat all time or being hostile, use `chatban #player_id` to prevent them from being able to send any messages to anyone, this includes private messages, team chat and spectator chat. \
  13 To unban the chatbanned player, use `unchatban #player_id`. \
  14 To see the list of chatbanned players, use `chatbans`.
  15
  16 _Note 1: there's another aliased version: `mute`. It has been used for many years while it wasn't improved, only temporarily muting for the duration of the match._ \
  17 _Note 2: `muteban` is an alias to `chatban` as it was this feature's previous name and has been used for many years by a few admins while it was implemented via_ [_SMB modpack_](https://github.com/MarioSMB/modpack) _before its merge to Xonotic's official repositories._
  18
  19 Set `g_chat_allowed` to 0, if you think there is a good reason to not anyone use any chats. \
  20 Remember, you can disable private, spectator and team chat as you wish.
  21
  22 - `g_chat_private_allowed 0` disables private chat, players can't use `tell #player_id` to send a private message to someone.
  23 - `g_chat_spectator_allowed 0` players can't chat while spectating.
  24 - `g_chat_team_allowed 0` disables team chat, preventing players from talking privately in their own teams.
  25
  26 These cvars are set to 1 by default. Set any of them to 0 if you wish to disallow that chat.
  27
  28 ## How can I disallow people from voting in my server?
  29
  30 **As a server admin**, use `voteban #player_id` to disallow a player from voting, they can't start a vote nor vote Yes or No for votes called by other players. \
  31 To allow the votebanned player vote again, use `unvoteban #player_id`.\
  32 To see the list of disallowed players from voting, use `votebans`.
  33
  34 ## How can I disallow people from playing in my server?
  35
  36 **As a server admin**, use `playban #player_id` to disallow a player from playing in the server, this player will be forced to spectate. \
  37 To allow a player to play again instead of being forced to spectate, use `unplayban #player_id`.\
  38 To see the list of players forced to spectate, use `playbans`.
  39
  40 _Note: `g_playban_minigames 1` also prevents the playbanned players from participating in minigames. (This is disabled by default)._
  41
  42 ## How can I ban people from my server?
  43
  44 **As a server admin**, doing that can be pretty harsh. Use this last resource if you decided definitely that it is what you want to do. \
  45 `ban <player_IP_address/key_hash> <bantime in seconds> <reason>` stores a ban in the server, it isn't a quick ban. The player can stay in the server unless if disconnects and tries to go back. \
  46 `kickban #player_id` stores a ban and kicks the player from the server. \
  47 To unban the player, use `unban <player_IP_address/key_hash>`. \
  48 To see the ban list, use `bans`.
  49
  50 ## TL;DR:
  51
  52 #### Personally as a player
  53
  54 - block in chat
  55   * `ignore #player_id`
  56 - unblock in chat
  57   * `unignore #player_id`
  58 - List blocks
  59   * Can't in-game.
  60
  61 #### In a server as an admin or a moderator
  62
  63 - Ban
  64   * `chatban #player_id`
  65   * `voteban #player_id`
  66   * `playban #player_id`
  67 - Unban
  68   * `unchatban #player_id`
  69   * `unvoteban #player_id`
  70   * `unplayban #player_id`
  71 - List bans
  72   * `chatbans`
  73   * `votebans`
  74   * `playbans`
  75
  76 #### From the whole server
  77
  78 - Kick and/or ban from the server
  79   * `kick #player_id`
  80   * `ban <player_IP_address/key_hash> <bantime in seconds> <reason>`
  81   * `kickban #player_id`
  82 - Unban from the server
  83   * `unban <player_IP_address/key_hash>`
  84 - List bans from the server
  85   * `bans`