# BlueMap Web Chat

BlueMap Web Chat adds a real-time chat panel directly to your BlueMap web map, allowing players and web users to chat without leaving the map page.

It works as a server-side Bukkit/Spigot/Paper plugin and can run as a BlueMap web addon or as a standalone web chat page. No client-side Minecraft mod is required.

## Features

* Real-time web chat using Server-Sent Events
* BlueMap web addon integration
* Standalone web chat page
* Minecraft ↔ web chat relay
* Optional guest chat
* Web authentication with in-game auth codes
* Reply support with original-message previews
* Game-side and Discord-side reply previews
* Custom emoji packs and admin emoji management
* GIF support on the web with PNG compatibility for game-side ImageEmojis output
* Image, video, YouTube, YouTube Shorts, TikTok, and X/Twitter preview support
* Optional DiscordSRV integration
* Upload support with configurable limits
* Pinned messages
* Web command panel for admins
* Light/dark themes and UI customization
* Reverse proxy friendly configuration

## Compatibility

BlueMap Web Chat is built against the Spigot API and is intended for Bukkit-compatible server platforms.

Supported server software:

* Paper
* Spigot
* Bukkit / CraftBukkit
* Purpur
* Bukkit-compatible hybrid servers, depending on their plugin compatibility

Fabric or Forge-only servers are not supported unless they provide a Bukkit/Spigot compatibility layer.

## Optional integrations

BlueMap Web Chat can work together with:

* BlueMap
* DiscordSRV
* ImageEmojis-compatible emoji output
* Reverse proxies such as Caddy or Nginx

Most features are optional and can be enabled or disabled in the configuration.

## Notes

This plugin is designed for server owners who want a lightweight web chat experience connected to BlueMap without requiring players to install a client mod.

HTTP-only mode is supported for private/testing use. Passwords are stored hashed on the server, but HTTP login traffic is not encrypted. Use HTTPS for public servers.

Font note: Installed fonts must be typed by their CSS font-family name. Chat settings include a Test button that estimates whether the typed name is available in the current browser without requesting local-font permissions.

BlueMapWebChat