SIR

<div align="center"> (https://i.imgur.com/AUjlLnA.png)](https://www.spigotmc.org/resources/131149/) (https://i.imgur.com/A5RvHK4.png)](https://wiki.bitaspire.com/en/docs) (https://i.imgur.com/4JRPRWB.png)](https://www.spigotmc.org/resources/131149/) (https://i.imgur.com/YveUMZy.png)](https://discord.gg/DC4Gqj3y5V) !(https://i.imgur.com/iIJJetg.png) (https://i.imgur.com/ZRjB2Qg.png)](https://discord.gg/DC4Gqj3y5V) !(https://i.imgur.com/mHpjbKV.png) !(https://i.imgur.com/FE9WdZ9.png) (https://bstats.org/signatures/bukkit/sir.svg)](https://bstats.org/plugin/bukkit/SIR/25264) </div> <details> <summary><strong>Text Description</strong></summary> # SIR – Simple In-game Receptionist A modular Minecraft assistant that centralizes chat management, announcements, onboarding, and cross-platform communication. SIR ships with a rich configuration toolkit so you can tailor every interaction players see without touching Java code. --- ## Feature Highlights - **Modular architecture** – Toggle self-contained modules for chat, join/quit experiences, announcements, MOTDs, advancements, and third-party hooks. - **Deep chat customization** – Build channel hierarchies, apply gradient colours, emojis, hover/click actions, tags, and mention effects directly from YAML. - **Player journey controls** – Craft first-join flows, spawn teleport rules, welcome/farewell messages, and timed invulnerability windows. - **Automated outreach** – Schedule announcements that mix chat, action bar, title, boss bar, sounds, and console commands. - **Discord-ready** – Mirror activity with DiscordSRV or EssentialsDiscord using embed templates, per-event routing, and cross-server relays. - **Login & vanish awareness** – Coordinate with major authentication and vanish plugins so muted, hidden, or unauthenticated players follow your rules. - **Takion-powered runtime** – The Takion framework is bundled, providing the scheduler, text processors, gradients, and boss bars you rely on—no extra download needed. - **Live updates & metrics** – Automatic update checks, optional coloured console logging, and bStats analytics keep administrators informed. --- ## Compatibility Matrix | Area | Details | | --- | --- | | **Minecraft server** | Spigot/Paper/Folia API 1.13+ (Folia flag enabled in `plugin.yml`). | | **Java runtime** | Compiled for Java 8 targets while building with Maven (Java 21 toolchain supported). | | **Permissions** | Vault-driven chat adapter with automatic fallback when Vault is absent. | | **Placeholder support** | PlaceholderAPI expansion included; formats across messages, announcements, and Discord bridge respect PAPI placeholders. | | **Text effects** | Takion gradient & rainbow tags, hover/click actions, and InventoryFramework-powered GUIs for chat colour menus. | | **Analytics** | bStats (ID 25264) with drill-down charts for detected integrations. | --- ## Built-in & Optional Integrations | Category | Supported Plugins / Libraries | Notes | | --- | --- | --- | | **Bundled libraries** | Takion 1.3, GlobalScheduler, LangUtils | Shaded inside SIR—no external jars needed. | | **Metrics** | bStats | Relocated package (`me.croabeast.metrics`) to avoid conflicts. | | **Chat & permissions** | Vault, InteractiveChat | Automatically detected; permissions exposed through `commands.yml` and channel configs. | | **Placeholder system** | PlaceholderAPI | Optional but fully supported; registers a dedicated expansion. | | **Discord bridge** | DiscordSRV, EssentialsDiscord | Route join/quit/advancement/chat events with per-channel embed templates. | | **Authentication** | AuthMe, UserLogin, NexAuth, nLogin, OpeNLogin | Shared spawn handling via `modules/hook/login.yml`. | | **Vanish handling** | CMI, EssentialsX, SuperVanish, PremiumVanish | Optional vanish chat key rules to block message leaks. | | **Moderation synergy** | AdvancedBan and other punishment suites | Use cooldowns, mute commands, and violation actions to complement third-party moderation. | --- ## Modular Platform Overview | Module | Purpose | Key Configuration Files | | --- | --- | --- | | **Join/Quit** | Welcomes players, controls vanilla join/quit spam, and manages spawn & invulnerability. | `modules/join_quit/config.yml`, `modules/join_quit/messages.yml` | | **Announcements** | Time-based broadcasts mixing chat, titles, action bars, sounds, and commands. | `modules/announcements/config.yml`, `modules/announcements/announces.yml` | | **MOTD** | Rotates server list MOTDs and icons with custom counters. | `modules/motd/config.yml`, `modules/motd/motds.yml` | | **Advancements** | Broadcasts achievements with rewards and per-world/mode filters. | `modules/advancements/config.yml`, `modules/advancements/messages.yml` | | **Chat – Channels** | Hierarchical global/local channels with inheritance and colour governance. | `modules/chat/channels.yml` (see wiki guide) | | **Chat – Cooldowns** | Anti-spam timers and scripted