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. 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. \
   4 If you want to unblock a single player, use `unignore #player_id`. If you want to unblock all currently ignored players, use `clear_ignores`.
   5
   6 _Note: you can't ignore more than 16 players._
   7
   8 ## How can I disallow people from chatting in my server?
   9
  10 **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. \
  11 To unban the chatbanned player, use `unchatban #player_id`. \
  12 To see the list of chatbanned players, use `chatbans`.
  13
  14 _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._ _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._
  15
  16 Set `g_chat_allowed` to 0, if you think there is a good reason to not anyone use any chats. \
  17 Remember, you can disable private, spectator and team chat as you wish.
  18
  19 - `g_chat_private_allowed 0` disables private chat, players can't use `tell #player_id` to send a private message to someone.
  20 - `g_chat_spectator_allowed 0` players can't chat while spectating.
  21 - `g_chat_team_allowed 0` disables team chat, preventing players from talking privately in their own teams.
  22
  23 These cvars are set to 1 by default. Set 0 if you wish to disallow some chats.
  24
  25 ## How can I disallow people from voting in my server?
  26
  27 **As a server admin**, use `voteban #player_id` to disallow a player from voting. The player can't start a vote nor vote Yes or No for votes called by other players. \
  28 To allow the votebanned player vote again, use `unvoteban #player_id`.\
  29 To see the list of disallowed players from voting, use `votebans`.
  30
  31 ## How can I disallow people from playing in my server?
  32
  33 **As a server admin**, use `playban #player_id` to disallow a player from playing in the server, this player will be forced to spectate. \
  34 To allow a player to play again instead of being forced to spectate, use `unplayban #player_id`.\
  35 To see the list of players forced to spectate, use `playbans`.
  36
  37 _Note: `g_playban_minigames 1` also prevents the playbanned players from participating in minigames. (This is disabled by default)._
  38
  39 ## How can I ban people from my server?
  40
  41 **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. \
  42 `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. \
  43 `kickban #player_id` stores a ban and kicks the player from the server. \
  44 To unban the player, use `unban <player_IP_address/key_hash>`. \
  45 To see the ban list, use `bans`.
  46
  47 ## TL;DR:
  48
  49 - Personally block in chat
  50   * `ignore #player_id`
  51 - Personally unblock in chat
  52   * `unignore #player_id`
  53 - List personal blocks
  54   * Can't in-game.
  55
  56 - Ban in server
  57   * `chatban #player_id`
  58   * `voteban #player_id`
  59   * `playban #player_id`
  60 - Unban in server
  61   * `unchatban #player_id`
  62   * `unvoteban #player_id`
  63   * `unplayban #player_id`
  64 - List bans in server
  65   * `chatbans`
  66   * `votebans`
  67   * `playbans`
  68
  69 - Kick and/or ban from server
  70   * `kick #player_id`
  71   * `ban <player_IP_address/key_hash> <bantime in seconds> <reason>`
  72   * `kickban #player_id`
  73 - Unban from server
  74   * `unban <player_IP_address/key_hash>`
  75 - List bans from server
  76   * `bans`