ChatPerms

A comprehensive chat and permissions management plugin for PocketMine-MP servers with advanced moderation tools, analytics, and faction support.

Features

Custom chat formats for different groups
Customizable nametags with health display and faction tags
Dynamic permission management with group inheritance
Faction integration (supports FactionsPro, PiggyFactions, SimpleFaction, and Factions)
Automatic detection of compatible faction plugins
Real-time nametag updates reflecting health changes
Mute system with temporary and permanent muting
Chat cooldowns per group
Chat statistics and analytics
Temporary group assignments
Permission debugging tools
Easy-to-use commands for group and permission management

Commands

Group Management

/cp setgroup - Assign a player to a group

/cp creategroup <chat_format> <nametag_format> [permissions...] - Create a new group

/cp removegroup - Delete a group

/cp listgroups - List all groups with details

Permission Management

/cp addgroupperm - Add a permission to a group

/cp removegroupperm - Remove a permission from a group

/cp checkplayer - Check player permissions and group info

Moderation

/cp mute [duration] [reason] - Mute a player

/cp unmute - Unmute a player

/cp mutelist - List all muted players

Temporary Groups

/cp tempgroup [reason] - Assign temporary group

/cp tempgroupcheck - Check temporary group status

Statistics

/cp stats - Show server chat statistics

/cp stats - Show player chat statistics

Utility

/cp help - Display all available commands

Placeholders

Chat Format

{PLAYER} - Player's username

{MESSAGE} - Chat message

{WORLD} - Current world name

{FACTION} - Player's faction (if detected)

Nametag Format

{PLAYER} - Player's username

{HEALTH} - Color-coded health display

{WORLD} - Current world name

{FACTION} - Player's faction (if detected)

Duration Formats

s = seconds (30s = 30 seconds)

m = minutes (15m = 15 minutes)

h = hours (2h = 2 hours)

d = days (1d = 1 day)

w = weeks (1w = 1 week)

permanent = never expires

Group Inheritance

Groups can inherit permissions from parent groups using the inherits property in config.yml:

groups: default: permissions:

chatperms.basic vip: inherits: default permissions:
chatperms.vip admin: inherits: vip permissions:
chatperms.admin

Installation

Download the plugin from Poggit
Place the plugin file in your server's plugins folder
Restart your server
Configure the plugin in plugins/ChatPerms/config.yml

Configuration Files

config.yml - Main configuration

players.yml - Player group assignments

mutes.yml - Mute data

chat_stats.yml - Chat statistics

temp_groups.yml - Temporary group assignments

Permissions

chatperms.command.* - All command access

chatperms.command.setgroup - Set player groups

chatperms.command.creategroup - Create groups

chatperms.command.removegroup - Remove groups

chatperms.command.addgroupperm - Add group permissions

chatperms.command.removegroupperm - Remove group permissions

chatperms.command.listgroups - List groups

chatperms.command.checkplayer - Check player info

chatperms.command.mute - Mute players

chatperms.command.unmute - Unmute players

chatperms.command.mutelist - List muted players

chatperms.command.stats - View statistics

chatperms.command.tempgroup - Assign temporary groups

chatperms.command.tempgroupcheck - Check temp group status

Supported Faction Plugins

FactionsPro
PiggyFactions
SimpleFaction
Factions

Support

For issues, feature requests, or contributions, please visit the GitHub repository.