Home

BlueMapWebChat

BlueMapWebChat is a web chat plugin for Bukkit/Paper/Spigot-compatible Minecraft servers. It can run inside BlueMap as an addon, as a standalone web chat served by the plugin, or in both modes at the same time.

This Wiki documents BlueMapWebChat 4.6.1. If you use cross-server DMs, every participating BlueMapWebChat server must run version 4.6.1.

Downloads

• Modrinth
• CurseForge
• GitHub

Main features

• Two-way Minecraft game ↔ web public chat
• BlueMap embedded addon and standalone web chat
• Account linking, password login, guest chat, captcha, and moderation
• Search, replies, pinned messages, previews, and uploads
• Persistent 1:1 DMs and group chat
• Server-to-server public chat and exact cross-server DM routing
• Integration with game /w, /msg, /tell, and compatible whisper aliases
• Optional read-only administrator DM audit for incident handling
• Custom emoji and ImageEmojis-Bero integration
• Optional ImageEmojis client-side emoji picker for Fabric/Quilt, NeoForge, and Forge
• DiscordSRV integration
• Browser notifications, Web Push, and a compact Modrinth update checker
• Built-in UI languages: en-US, ko-KR, ja-JP, zh-CN

Start here

1. Read Installation.
2. Choose a deployment pattern in Quick Start.
3. Review plugins/BlueMapWebChat/config.yml, then set enabled: true.
4. For an Internet-facing server, use HTTPS as described in Web Hosting and HTTPS.
5. See Web Chat Usage and Commands and Permissions for normal operation.
6. If something fails, check Troubleshooting.

Default locations

Item	Default
HTTP port	8899
API path	/api
Standalone page	/chat
Main config	plugins/BlueMapWebChat/config.yml
Public history DB	plugins/BlueMapWebChat/history.db
Direct-message DB	plugins/BlueMapWebChat/direct-messages.db
Group-chat DB	plugins/BlueMapWebChat/group-messages.db

The complete commented default configuration is available at Default Config.