AdminSuiteChat
PluginMIT

AdminSuiteChat

AdminSuiteChat is a lightweight, fast, and secure chat plugin designed for efficient server administration. It provides 10 pre-configured staff channels, a HelpMe system, advanced logging, and comprehensive security features.

18
Downloads
1
Followers
4 months ago
Updated
📦
1
Versions

📖About AdminSuiteChat

AdminSuiteChat

Staff Communication Plugin for Minecraft Servers


✨ What is AdminSuiteChat?

AdminSuiteChat is a feature-rich communication plugin designed for server staff teams. It provides dedicated chat channels for different roles, an anonymous help request system, and powerful logging with automatic rotation.

Perfect for: Large networks, roleplay servers, and any server with multiple staff members needing organized communication.

You can easily change the command or shortcut in the config and reload the plugin.


🎯 Key Features

📢 9 Pre-configured Channels

  • Admin (@a) - Red channel for administrators
  • Developer (@d) - Cyan channel for developers
  • Moderator (@m) - Blue channel for moderators
  • Helper (@h) - Green channel for helpers
  • Builder (@b) - Orange channel for builders
  • Staff (@s) - Yellow channel for all staff
  • VIP (@v) - Purple channel for VIP players
  • VIP+ (@vp) - Dark purple for VIP+ players
  • 3 Custom Channels - Create your own!

🆘 Smart HelpMe System

  • Anonymous help requests (no spam!)
  • Configurable cooldowns
  • Automatic logging
  • Staff-only visibility
  • Works even when no admins are online!

📦 Advanced Logging

  • Auto-rotation: Creates archives on server shutdown
  • TAR.GZ format: Industry-standard compression
  • Smart cleanup: Keeps only last 5 archives (configurable)
  • No lag: All operations run asynchronously
  • Easy extraction: Use any standard tool

🌍 30 Languages

Full multilingual support with automatic language detection:
English, Slovak, Czech, Polish, Russian, German, French, Spanish, Italian, Portuguese, Dutch, Danish, Swedish, Norwegian, Finnish, Hungarian, Romanian, Bulgarian, Croatian, Serbian, Ukrainian, Estonian, Latvian, Lithuanian, Greek, Turkish, Arabic, Chinese, Japanese, Korean

⚡ Performance

  • Async Operations: No TPS impact
  • Optimized I/O: Smart caching and buffering
  • Lightweight: Minimal memory footprint
  • Battle-tested: Used on production servers

🚀 Quick Start

Installation

  1. Download the latest .jar file
  2. Place it in your plugins/ folder
  3. Restart your server
  4. Configure in plugins/AdminSuiteChat/config.yml
  5. Reload with /asc reload

That's it! The plugin works out of the box with sensible defaults.


🎮 Usage

Sending Messages

Using Commands:

/admin Hello team!
/moderator Need help with this player
/vip Welcome to VIP chat!
/staff problem :D

Using Shortcuts (faster!):

@a Hello team!
@m Need help with this player
@v Welcome to VIP chat!
@s problem :F

HelpMe System

Players can request help:

/helpme I'm stuck at spawn!

Staff sees:

[HELPME] Player needs help: I'm stuck at spawn!

Player sees:

Your help request has been sent!

⚙️ Configuration

Basic Settings

settings:
  enabled: true
  debug: false
  language: en_US
  luckperms-sync: true

logging:
  enabled: true
  max-archives: 5

helpme:
  helpme1:
    enabled: true
    cooldown-seconds: 60

Channel Customization

channels:
  admin:
    enabled: true
    shortcut: "@a"
    format: "&4[ADMIN] &c{player}: &f{message}"
    log-to-file: false

🔐 Permissions

Channel Access

adminsuitechat.admin      - Access admin channel
adminsuitechat.moderator  - Access moderator channel
adminsuitechat.helper     - Access helper channel
adminsuitechat.vip        - Access VIP channel

HelpMe System

adminsuitechat.helpme         - Use /helpme command
adminsuitechat.helpme.see     - See helpme requests (staff)
adminsuitechat.helpme.bypass  - Bypass cooldown

Administration

adminsuitechat.reload  - Reload configuration
adminsuitechat.list  - Channel list /asc list or /adminsuitechat list

🔌 Integrations

LuckPerms (Optional)

Automatic permission sync with LuckPerms groups. The plugin works perfectly fine without it!

PlaceholderAPI (Optional)

Display player information in messages:

  • {player_name} - Player's display name
  • {player_rank} - Player's rank
  • And many more!

📊 Server Compatibility

Server Type Version Status
Spigot 1.21+ ✅ Supported
Paper 1.21+ ✅ Supported
Purpur 1.21+ ✅ Supported

Java: Requires Java 17 or higher


🎨 Features Showcase

Smart Archive Rotation

logs/archives/
├── logs1.tar.gz  (oldest)
├── logs2.tar.gz
├── logs3.tar.gz
├── logs4.tar.gz
└── logs5.tar.gz  (newest)

When the 6th shutdown happens, logs1.tar.gz is overwritten, and the cycle continues!

Multi-language Support

Plugin automatically detects player's language:

  • English player sees: "Your help request has been sent!"
  • Slovak player sees: "Tvoja žiadosť o pomoc bola odoslaná!"
  • German player sees: "Deine Hilfeanfrage wurde gesendet!"

💡 Why Choose AdminSuiteChat?

Easy to use - Works out of the box with smart defaults
Professional - Used by large networks and roleplay servers
Performant - Zero TPS impact with async operations
Flexible - Highly configurable to fit your needs
Reliable - Extensive testing and error handling
Supported - Active development and quick bug fixes


📸 Screenshots

adminsuitechat chat example


🆘 Support

Need help? Check these resources:

  1. Full Documentation - Complete guide
  2. GitHub Issues - Report bugs
  3. Website - Official website

⭐ Support the Project

If you like AdminSuiteChat, please:

  • ⭐ Star the project on GitHub
  • 📝 Leave a review on Modrinth
  • 💬 Share with other server owners
  • 🐛 Report bugs to help improve the plugin

🙏 Credits

Made with ❤️ by yamiru

Special thanks to the Minecraft community for feedback and testing!