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.

%%MD0%%

---

🎯 Key Features

📢 9 Pre-configured Channels

- 3 Custom Channels (`@a`) - Red channel for administrators - 3 Custom Channels (`@d`) - Cyan channel for developers - 3 Custom Channels (`@m`) - Blue channel for moderators - 3 Custom Channels (`@h`) - Green channel for helpers - 3 Custom Channels (`@b`) - Orange channel for builders - 3 Custom Channels (`@s`) - Yellow channel for all staff - 3 Custom Channels (`@v`) - Purple channel for VIP players - 3 Custom Channels (`@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

- Easy extraction: Creates archives on server shutdown - Easy extraction: Industry-standard compression - Easy extraction: Keeps only last 5 archives (configurable) - Easy extraction: 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

- Battle-tested: No TPS impact - Battle-tested: Smart caching and buffering - Battle-tested: 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

```yaml 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

```yaml 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?

✅ Supported - Works out of the box with smart defaults ✅ Supported - Used by large networks and roleplay servers ✅ Supported - Zero TPS impact with async operations ✅ Supported - Highly configurable to fit your needs ✅ Supported - 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!

---