WebChatAPI

A lightweight Paper plugin that exposes Minecraft server chat through a simple HTTP JSON API.

WebChatAPI is API-only. It does not include a web interface. You control the frontend and can integrate Minecraft chat into React, Next.js, Vue, plain HTML, Node.js applications, or mobile apps.

Minecraft chat → WebChatAPI → Your backend → Your website

Features

• Lightweight and easy to deploy
• Pure HTTP JSON API
• Real-time updates with long polling
• Configurable in-memory chat history
• Online player list endpoint
• Read-only mode enabled by default
• Optional web-to-Minecraft messaging
• Token protection for two-way messaging
• Configurable CORS
• Easy integration with custom frontends

Architecture

Minecraft Server │ │ Player sends a chat message ▼ WebChatAPI │ │ HTTP JSON API ▼ Your Backend │ │ Proxied API ▼ Your Website

Production Setup

For production, keep the WebChatAPI port private and let your backend communicate with the plugin.

Minecraft Server └── WebChatAPI (127.0.0.1:8765) ▲ │ Your Backend │ ▼ Public Website

Using 127.0.0.1 prevents direct access to the plugin from the public internet.

Requirements

Component	Version
Server	Paper 1.21+
Java	JDK 17+
Build tool	Maven

Internet access is required during the build process to resolve the Paper API dependency.