Home

KOKOTO WebChat Wiki

/kchat reload validates the edited YAML before stopping live services. Invalid YAML is rejected while the previous running configuration, UI language, and services remain active; YAML indentation must use normal ASCII spaces, not tabs or full-width spaces.

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

KOKOTO WebChat is a multi-platform server-side web chat for Bukkit/Paper/Spigot, Fabric, NeoForge, and exact-target Forge servers. It can run as a standalone web chat and can also embed into supported map frontends.

Project/download transition

BlueMapWebChat was renamed to KOKOTO WebChat in 5.0.0. The 5.0.0 bridge release should remain discoverable from the existing bluemapwebchat project listing before the old page is renamed or retired. KWC 5.0.0 checks the planned kokoto-webchat Modrinth project first and falls back to bluemapwebchat during the transition.

• Legacy Modrinth entry: https://modrinth.com/plugin/bluemapwebchat
• Legacy CurseForge entry: https://www.curseforge.com/minecraft/bukkit-plugins/bluemapwebchat
• Legacy GitHub repository: https://github.com/KOKOTO-DEV/BlueMapWebChat
• Target canonical names after activation: https://modrinth.com/plugin/kokoto-webchat, https://www.curseforge.com/minecraft/bukkit-plugins/kokoto-webchat, https://github.com/KOKOTO-DEV/KOKOTO-WebChat

If a platform cannot keep BMWC and KWC as the same project listing, leave the BMWC page as a retirement/migration notice pointing to the new KWC page.

5.0.0 highlights

• Multi-platform architecture: kwc-core, kwc-standalone-frontend, kwc-adapter-bluemap, and kwc-platform-bukkit.
• Platform-neutral models/token/security/session helpers moved to core with an initial PlatformAdapter boundary.
• Signed server relay and public-chat SQLite history now run from core through platform-neutral relay/logging callbacks.
• DM/group persistence, HTTP/SSE transport, and the JDK-only Web Push engine now run from core behind loader-neutral host contracts.
• PlatformAdapter now owns player/permission/thread/console-command/native game delivery; WebChatServer no longer imports Bukkit/Bungee APIs directly.
• Safe config reload validation rejects malformed YAML before stopping live services, preserving the previous running config and UI language.
• 5.0.0 completes the BlueMapWebChat → KOKOTO WebChat identity migration; /kchat (/kc), kwc.*, KWC data directories and dev.kokoto.webchat are canonical.

4.7 feature baseline retained

• Conservative Minecraft support baseline expanded to 1.18 through 26.2 with Java 17 bytecode and api-version: '1.18'.
• Administrator custom-emoji picker supports multi-file selection with immediate sequential upload, following the same hidden-input handoff as normal chat file upload.
• New configurable message-tokens processor. English aliases are supplied by default, while administrators can add or replace aliases in any language.
• :enter: / :newline: / :nextline: / :linebreak: / :br: insert a new line.
• :blankline: / :emptyline: / :paragraphbreak: insert an empty line; :tab: / :indent: insert configured spaces.
• Printable custom substitutions such as :separator: can be defined by administrators. Unknown tokens are preserved for custom emoji compatibility.
• Existing config values are preserved by rebuilding active migrations from the current bundled config.yml and overlaying those values; old comments/layout are discarded. A fixed older-version config is backed up before upgrade. 5.0.0_auto_migration keeps this rebuild enabled, exact 5.0.0 leaves the same-version config untouched, and config-reference-5.0.0.yml remains only the administrator-readable exact default copy.

Core features

• Bidirectional Minecraft ↔ web public chat
• Persistent direct messages and group rooms
• Multi-server signed relay
• Replies, pins, search, uploads, rich previews, custom emoji
• DiscordSRV integration
• Browser notifications / Web Push
• Guest chat and linked Minecraft accounts
• Administrator/moderator tools, optional read-only private-chat audit

Use the sidebar for the complete operating and configuration reference.