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

---

🆘 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!

---