Skip to content

Guest Chat

KOKOTO-DEV edited this page Aug 26, 2026 · 2 revisions

Guest Chat

KOKOTO WebChat 5.0.0 · Minecraft 1.18–26.2 · Java 17 baseline

12. Guest Chat and Captcha

guest:
  enabled: true
  allow-custom-name: true
  name-prefix: "Guest-"
  cooldown-seconds: 6
  max-messages-per-minute: 50
  block-player-name-spoofing: true

allow-custom-name: true accepts Unicode letters and numbers, spaces, _, and -, so guest names can use Korean, Japanese, Chinese, Latin, and other writing systems. Leading/trailing spaces are removed, repeated Unicode space separators are normalized to one regular space, and tabs/newlines/control characters or other symbols are discarded. Custom guest names remain limited to 16 Unicode code points.

block-player-name-spoofing prevents guests from using real usernames or known display/custom names. The comparison always also checks the color/format-code-stripped form, even when player-display.strip-colors: false, so a colored player name cannot be copied by a guest using its plain visible text. Add protected administrative names to blocked-names.

Captcha:

captcha:
  mode: "math"
  expire-seconds: 120
  require-on-each-message: false
  pass-valid-minutes: 120

Guest/IP moderation commands:

/kchat guest mute guest <name> [minutes] [reason]
/kchat guest mute ip <address> [minutes] [reason]
/kchat guest unmute guest <name>
/kchat guest unmute ip <address>
/kchat guest list

Clone this wiki locally