PlatformChat is a simple Minecraft Bukkit/Spigot plugin that provides enhanced chat formatting with support for Bedrock players (via Floodgate) and PlaceholderAPI integration. It allows configurable chat prefixes and color-coded messages for both Java and Bedrock editions.
- Different chat formats for Java and Bedrock players
- PlaceholderAPI support for dynamic placeholders
- Configurable prefixes and color codes via
config.yml - Supports Floodgate API to detect Bedrock players
- Uses color codes with
&symbols translated into Minecraft colors
I wanted to use the FloodgatePlaceholder plugin for a Paper server, but I didn’t want to rely on large, feature-heavy plugins like EssentialsX just to handle placeholders. My goal was to have a minimal plugin focused solely on interacting with placeholders in a simple and efficient way. PlatformChat is designed specifically to detect the platform and device each player joins with and customize how player information is displayed in chat messages to keep things lightweight and focused.
This plugin was tested with Geyser + Floodgate.
- Java 17+ (matches your server's Java version)
- Bukkit/Spigot/Paper Minecraft server (1.16+ recommended)
- Floodgate plugin (for Bedrock player detection)
- PlaceholderAPI plugin (optional, for placeholder support)
- FloodgatePlaceholders (recommended to get Floodgate placeholders working)
- Download or build the
PlatformChat.jar. - Place the JAR file into your server's
pluginsfolder. - Start the server once to generate the default config file.
- Modify
plugins/PlatformChat/config.ymlto your liking (see Configuration section). - Restart or reload your server.
use-placeholderapi: true
prefix: '&6[PlatformChat] '
bedrock-format: '&b[Bedrock] &a%player_name% &e%floodgate_device%&f: %message%'
java-format: '&7[Java] &a%player_name%&f: %message%'use-placeholderapi: Enable or disable PlaceholderAPI support.prefix: A string prefix prepended to all messages.bedrock-format: Chat format for Bedrock players. Use%player_name%,%message%, and Floodgate placeholders like%floodgate_device%.java-format: Chat format for Java players. Use%player_name%and%message%.
- JDK 17+
- Maven or Gradle (example below uses Maven)
- Place the source code in
src/main/java/com/aspaulding/platformchat/PlatformChat.java. - Create a
pom.xmlincluding dependencies for Bukkit API, Floodgate API, and PlaceholderAPI. - Run:
mvn clean package- The compiled JAR will be in
target/PlatformChat.jar.
- Chat messages from Java and Bedrock players will be formatted differently based on your configuration.
- Placeholders from PlaceholderAPI and FloodgatePlaceholders will be parsed if enabled.
- Messages are color-coded according to the config and Minecraft’s color codes.
- GeyserMC (Bedrock Proxy)
- PaperMC (Server software)
- Floodgate (Bedrock auth plugin)
- PlaceholderAPI (Placeholder plugin)
- FloodgatePlaceholders (Floodgate placeholders)
Found a bug or want to request a feature? Please open an issue on the GitHub repository.
This project is licensed under the MIT License. See the LICENSE file for details.