Uploads Emojis Previews

Uploads, Emoji, and Media Previews

File uploads

The upload section controls whether users may attach files, which roles may upload, allowed extensions, maximum file size, total storage limit, rate limits, retention, and public URL generation.

For a public server, explicitly review:

• Per-file size
• Total stored size
• Uploads per minute
• Allowed extensions
• Retention period
• Filesystem permissions
• Reverse-proxy routing for the upload path

Clipboard upload

When allowed by the browser and server policy, images/files pasted into the web chat can be uploaded through the same upload subsystem.

Media previews

The preview section controls image/video/audio previews and external embeds. YouTube/Shorts can be embedded; TikTok and X/Twitter embeds are optional because they load third-party content in the user's browser.

For public servers, keep click-to-load enabled for third-party embeds unless you intentionally want them loaded automatically.

Custom emoji

BlueMapWebChat stores custom emoji below:

plugins/BlueMapWebChat/emojis/

Subdirectories are emoji packs, for example:

plugins/BlueMapWebChat/emojis/default/wave.png

Web chat can keep original GIF/JPG/JPEG/WEBP assets while generating PNG sidecars for game-side emoji plugins that require PNG.

Minecraft rendering

BlueMapWebChat preserves canonical emoji tokens in history and server-relay payloads. A compatible game-side plugin such as ImageEmojis-Bero can translate the token into the receiving server's current resource-pack glyph.

See ImageEmojis-Bero and ImageEmojis Client Picker.

Public URLs behind HTTPS

Normally leave upload.public-base-url and emoji.public-base-url empty so they follow the configured public BMChat API base. Explicit legacy paths are supported, but the simplest reverse-proxy setup is to configure the public API base once.