ModsJava
ImperialChatFormat
Java mod listed for Minecraft 1.20–1.21. Downloads from the MC Java Mods app on Android.
⬇ Download on Spigot
ImperialChatFormat
Advanced Chat Format Plugin for Paper 1.21+
![[IMG]](//proxy.spigotmc.org/5c76cf43e89c72cc18cb1fcf3c19d09c238770f9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d312e312e322d627269676874677265656e)
![[IMG]](//proxy.spigotmc.org/553866d87f4441facfc1b3b67af7d0a7f0849a32/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d696e6563726166742d312e32302d2d312e32312d626c7565)
![[IMG]](//proxy.spigotmc.org/396496b638569dd87257abf6c086f8d4bf96ec5f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5365727665722d50617065722d6f72616e6765)
Advanced Chat Format Plugin for Paper 1.21+
Overview
ImperialChatFormat is a powerful, highly customizable chat format plugin for Paper servers (1.20 - 1.21+). It offers dynamic permissions, LuckPerms integration, and placeholder support for professional chat formatting on your server.
Key Features
- Dynamic Permission System: Automatically creates permissions for each chat format
- Priority-Based Ranking: Players with multiple permissions automatically use the highest ranking
- LuckPerms Integration: Full support for LuckPerms groups, prefixes and suffixes
- PlaceholderAPI Compatibility: Use any placeholder in your format definitions
- Tab-List Formatting: Automatic formatting of player names in the tab list
- Custom Permissions: Define custom permission names that point to specific formats
- Easy Configuration: YAML-based, easy-to-understand configuration
- Complete Documentation: Full English documentation and support
- Plugin Language: The plugin is primarily written in German. Upon request, an English configuration file and corrected messages can be provided.
Installation
Requirements:
- Paper Server (Version 1.20 - 1.21+)
- PlaceholderAPI (required)
- LuckPerms (optional, but recommended)
- Java 21 or higher
Installation Steps:
1. Download the ImperialChatformat-1.1.2.jar file
2. Place the JAR file in the plugins/ folder of your server
3. Restart your server
4. The plugin will automatically create the configuration file plugins/ImperialChatFormat/chatformat.yml
5. Customize the chatformat.yml to your preferences
6. Reload the configuration with /chatformat reload
Configuration
Basic Settings (chatformat.yml):
Code (YAML):
settings :
# Enable or disable the plugin
enabled : true
# Enable PlaceholderAPI placeholders
enable-placeholders : true
# LuckPerms integration for prefixes/suffixes
enable-luckperms : true
# Debug mode (shows detailed logs)
debug : false
# Automatically register permissions
auto-register-permissions : true
# Enable tab-list formatting
enable-tablist : true
Each format requires 2 fields:
- priority: Priority value (lower number = higher priority)
- format: The format string with placeholders
Example:
Code (YAML):
formats:
default:
priority : 9999
format : "%prefix% &f%player_name%&7: &7%message%"
admin:
priority : 0
format : "&c[ADMIN] &f%player_name%&7: &e%message%"
moderator:
priority : 10
format : "&e[MOD] &f%player_name%&7: &f%message%"
vip:
priority : 20
format : "&b[VIP] &f%player_name%&7: &e%message%"
Standard Placeholders:
- %player_name% - Player name
- %message% - The chat message
- %world% - Name of the world
- %player_ping% - Player's ping
- %player_health% - Player's health
- %player_level% - Player's level
LuckPerms Placeholders (when enabled):
- %prefix% - Player's prefix (from LuckPerms)
- %suffix% - Player's suffix (from LuckPerms)
PlaceholderAPI Placeholders:
- All standard PlaceholderAPI placeholders (e.g. %player_uuid%, %player_item_in_hand%, etc.)
- Additional placeholders from installed expansions
Color Codes:
Use standard Minecraft color codes:
- &0 - Black
- &c - Red
- &a - Green
- &e - Yellow
- &b - Cyan
- &d - Magenta
- &f - White
- &7 - Gray
- And more...
Permissions
Standard Permissions:
- chatformat.admin - Access to admin commands (e.g. /chatformat reload)
- chatformat.use - Basic chat permission (default: true for all)
Format Permissions:
A permission is automatically created for each format:
- icf.admin - Admin chat format
- icf.moderator - Moderator chat format
- icf.vip - VIP chat format
- icf.<your_format> - Your custom format
Setting Permissions with LuckPerms:
Code (Text):
/lp user <player> permission set icf.admin true
/lp group admin permission set icf.admin true
/lp user <player> permission unset icf.admin
Define alternative permission names that point to specific formats:
Code (YAML):
custom_permissions:
enabled : true
permissions:
"server.owner" : "admin"
"custom.premium" : "vip"
Main Command: /chatformat (Aliases: /cf, /chatfmt, /icf, /imperialcf)
Available Commands:
- /chatformat reload - Reload the configuration (Permission: chatformat.admin)
- /chatformat info - Show plugin information
- /chatformat list - List all available formats
Priority System
How does it work?
When a player has multiple format permissions, the plugin automatically selects the format with the highest priority:
| Format | Priority | Example Calculation |
| admin | 0 | Always used first |
| moderator | 10 | Used after admin |
| vip | 20 | Used after moderator |
| default | 9999 | Fallback for all others |
Example Scenario:
Player "Imperial42" has permissions for:
- icf.admin (priority: 0)
- icf.vip (priority: 20)
Result: The admin format will be used (priority 0 is higher than 20)
Configuration Tips
1. Simple Admin Setup:
Code (YAML):
formats:
default:
priority : 100
format : "%prefix% %player_name%&7: %message%"
admin:
priority : 0
format : "&c[ADMIN]&r %prefix% %player_name%&7: &c%message%"
Code (YAML):
formats:
clanmember:
priority : 50
format : "[%player_clan_tag%] %prefix% %player_name%&7: %message%"
Code (YAML):
formats:
creative:
priority : 50
format : "&d[CREATIVE]&r %player_name%&7: %message%"
survival:
priority : 50
format : "&a[SURVIVAL]&r %player_name%&7: %message%"
Q: The plugin doesn't load, what should I do?
A: Make sure that:
- PlaceholderAPI is installed
- Your server uses Java 21 or higher
- You restarted the server after uploading the JAR
Q: Why doesn't my format work?
A: Check:
- That the chatformat.yml is correctly formatted (YAML syntax)
- That each format has priority and format fields
- That the player has the correct permission (/lp user <player> info)
Q: Can I assign permissions without LuckPerms?
A: Yes, but LuckPerms is recommended. Without LuckPerms you can assign permissions via OP status or other permission plugins.
Q: How do I disable the plugin?
A: Set in the chatformat.yml: enabled: false
Q: Can I add custom formats?
A: Yes! Simply add new entries under formats:, and the plugin will automatically create the permission.
Q: Tab-list shows too long names?
A: Minecraft limits tab-list names to 16 characters without color codes. The plugin automatically truncates long names.
Support & Links
Bug Reports & Feature Requests:
Please report bugs or requests on this Spigot page.
Compatibility:
- Paper 1.20 - 1.21+
- PlaceholderAPI 2.11.6+
- LuckPerms 5.4+
- Java 21+
Have fun with ImperialChatFormat!
Developed by ImperialTeam
Developed by ImperialTeam
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- 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 Spigot — 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.
ImperialChatFormat is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 37 times (via Spigot). Download it and open it directly in the game.