WebChatAPI
Lightweight Paper plugin that exposes Minecraft server chat through a simple HTTP JSON API for custom websites and applications.
⬇ Download on ModrinthWebChatAPI
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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as webchatapi-1.0.1.jar — drop this file into the mods folder
- Download size: 163 KB
- Download link checked 1 Oct 2026 — working
These come from our own check of the pack file, not from the source page.