# ShadowCrestModeration (SCM) **ShadowCrestModeration** is a modern, lightweight moderation plugin for **Paper & Spigot**. It focuses on **clarity**, **performance**, and **staff efficiency**, featuring a powerful **GUI-based ticket system**, private ticket chats, and integrated moderation tools. --- ## ✨ Features ### 🎫 Ticket System - Fully **GUI-based ticket creation** - Step-by-step ticket workflow: - Category → Target → Additional info - Ticket cooldown & maximum open tickets per player - Staff ticket overview with pagination - Ticket detail GUI with: - Claim / Unclaim - Teleport to ticket creator - Close ticket with predefined reasons - Ticket status system (`OPEN`, `CLAIMED`, `CLOSED`) - Automatic staff notifications --- ### 💬 Ticket Chat - Private chat between supporter and ticket creator - Reply using `/t ` - Optional toggle mode for ticket chat - Automatically disabled when ticket is closed - Safe session handling --- ### 🛠 Ticket Actions GUI - Moderate directly from the ticket: - Warn - Kick - Tempban (1h / 1d) - Permanent ban - Default punishment reason: `Ticket` - Fully language-driven (de_DE / en_US) - Clean separation between detail GUI and actions GUI --- ### 👥 Internal Team Chat - Built-in internal staff chat - Toggle mode or single-message usage - Separate chat format - Permission-based - Independent from ticket chat --- ### 🔔 Moderation System - Warn system with history - Automatic punishments (configurable) - Kick, Ban, Tempban - IP Ban / Unban - Clear warnings - Join logs for staff - Optional playtime display --- ## ⚙ Configuration - Fully configurable via `config.yml` - All messages configurable via language files: - `de_DE.yml` - `en_US.yml` - Prefix, cooldowns, limits, formats, actions --- ## 🔗 Ticket-linked Moderation Log Every punishment executed from a ticket is automatically: - Linked to the ticket ID - Stored internally - Sent to Discord with full context: - Staff - Target - Action - Reason - Duration - Ticket ID --- ## 🌐 Discord Integration SCM includes a built-in Discord Webhook system: - Ticket created / claimed / closed - Moderation actions (warn, kick, ban, mute, etc.) - Fully configurable via `config.yml` - Fully translatable via language files This allows staff to monitor moderation activity live without being in-game. --- ## 📦 Installation 1. Download the latest `.jar` from **Releases** 2. Place it in your `plugins/` folder 3. Start the server 4. Configure `config.yml` and language files 5. Optional: `/scm reload` --- ## 📜 Commands ### General | Command | Description | |------|------------| | `/ticket` | Open ticket creation GUI | | `/t ` | Reply to active ticket chat | | `/tc` | Toggle ticket chat mode | | `/teamchat` | Toggle staff team chat | | `/teamchat ` | Send a single team chat message | --- ### Moderation | Command | Description | |------|------------| | `/warn ` | Warn a player | | `/warns ` | Show warnings | | `/clearwarns ` | Clear warnings | | `/kick ` | Kick a player | | `/ban ` | Permanent ban | | `/tempban ` | Temporary ban | | `/unban ` | Unban player | | `/ipban ` | IP ban | | `/unipban ` | Remove IP ban | | `/playtime ` | Show playtime | --- ### SCM | Command | Description | |------|------------| | `/scm reload` | Reload configuration | | `/scm info` | Plugin info | | `/scm gui` | Open staff ticket GUI | | `/scm accept` | Accept next open ticket | | `/scm close [reason]` | Close ticket | | `/scm tpticket ` | Teleport to ticket creator | --- ## 🔐 Permissions - `shadowcrest.mod.warn` - `shadowcrest.mod.kick` - `shadowcrest.mod.ban` - `shadowcrest.mod.tempban` - `shadowcrest.mod.ipban` - `shadowcrest.mod.unban` - `shadowcrest.mod.unipban` - `shadowcrest.mod.clearwarns` - `shadowcrest.mod.warns` - `shadowcrest.mod.playtime` - `shadowcrest.mod.notify` - `shadowcrest.mod.ticket.staff` - `shadowcrest.mod.ticket.accept` - `shadowcrest.mod.ticket.close` - `shadowcrest.mod.ticket.tp` - `shadowcrest.mod.teamchat` - `shadowcrest.mod.reload` - `shadowcrest.mod.info` (Default: OP) --- ## 🔧 Compatibility - **Minecraft:** 1.20 – 1.21.x - **Server:** Paper / Spigot - **Java:** 21 --- ## 🛣 Roadmap Planned features and future improvements: ➡️ ROADMAP.md --- ## 📄 License This project is licensed under the **Apache License 2.0**. See the LICENSE file for details. --- ## ❤️ Support If you encounter bugs or have feature requests, please open an **Issue** on GitHub. --- ### 🌍 Community Translations If you have created a **language file (.yml)** for ShadowCrestModeration in a language that is not yet included, you are very welcome to share it with us! You can submit your translation via GitHub (Pull Request or Issue), and if it is added to the plugin, **you will be credited by name** in the project. Thank you for helping make ShadowCrestModeration accessible to players all over the world! ❤️

ShadowCrest

ShadowCrestModeration

Информация