{"id":141880,"date":"2026-06-08T13:26:12","date_gmt":"2026-06-08T10:26:12","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/"},"modified":"2026-06-08T13:26:12","modified_gmt":"2026-06-08T10:26:12","slug":"sir","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/","title":{"rendered":"SIR"},"content":{"rendered":"
\n

![Spigot](https:\/\/www.spigotmc.org\/resources\/131149\/)
\n![Wiki](https:\/\/wiki.bitaspire.com\/en\/docs)
\n![Spigot Resource](https:\/\/www.spigotmc.org\/resources\/131149\/)
\n![Discord](https:\/\/discord.gg\/DC4Gqj3y5V)<\/p>\n

![](https:\/\/i.imgur.com\/iIJJetg.png)
\n![](https:\/\/discord.gg\/DC4Gqj3y5V)
\n![](https:\/\/i.imgur.com\/mHpjbKV.png)
\n![](https:\/\/bstats.org\/plugin\/bukkit\/SIR\/25264)
\n![](https:\/\/bstats.org\/signatures\/bukkit\/sir.svg)<\/p>\n<\/div>\n

\nText Description<\/strong><\/summary>\n

# SIR \u2013 Simple In-game Receptionist<\/p>\n

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.<\/p>\n

—<\/p>\n

## Feature Highlights<\/p>\n

– **Modular architecture** \u2013 Toggle self-contained modules for chat, join\/quit experiences, announcements, MOTDs, advancements, and third-party hooks.
\n– **Deep chat customization** \u2013 Build channel hierarchies, apply gradient colours, emojis, hover\/click actions, tags, and mention effects directly from YAML.
\n– **Player journey controls** \u2013 Craft first-join flows, spawn teleport rules, welcome\/farewell messages, and timed invulnerability windows.
\n– **Automated outreach** \u2013 Schedule announcements that mix chat, action bar, title, boss bar, sounds, and console commands.
\n– **Discord-ready** \u2013 Mirror activity with DiscordSRV or EssentialsDiscord using embed templates, per-event routing, and cross-server relays.
\n– **Login & vanish awareness** \u2013 Coordinate with major authentication and vanish plugins so muted, hidden, or unauthenticated players follow your rules.
\n– **Takion-powered runtime** \u2013 The Takion framework is bundled, providing the scheduler, text processors, gradients, and boss bars you rely on\u2014no extra download needed.
\n– **Live updates & metrics** \u2013 Automatic update checks, optional coloured console logging, and bStats analytics keep administrators informed.<\/p>\n

—<\/p>\n

## Compatibility Matrix<\/p>\n

| Area | Details |
\n| — | — |
\n| **Minecraft server** | Spigot\/Paper\/Folia API 1.13+ (Folia flag enabled in `plugin.yml`). |
\n| **Java runtime** | Compiled for Java 8 targets while building with Maven (Java 21 toolchain supported). |
\n| **Permissions** | Vault-driven chat adapter with automatic fallback when Vault is absent. |
\n| **Placeholder support** | PlaceholderAPI expansion included; formats across messages, announcements, and Discord bridge respect PAPI placeholders. |
\n| **Text effects** | Takion gradient & rainbow tags, hover\/click actions, and InventoryFramework-powered GUIs for chat colour menus. |
\n| **Analytics** | bStats (ID 25264) with drill-down charts for detected integrations. |<\/p>\n

—<\/p>\n

## Built-in & Optional Integrations<\/p>\n

| Category | Supported Plugins \/ Libraries | Notes |
\n| — | — | — |
\n| **Bundled libraries** | Takion 1.3, GlobalScheduler, LangUtils | Shaded inside SIR\u2014no external jars needed. |
\n| **Metrics** | bStats | Relocated package (`me.croabeast.metrics`) to avoid conflicts. |
\n| **Chat & permissions** | Vault, InteractiveChat | Automatically detected; permissions exposed through `commands.yml` and channel configs. |
\n| **Placeholder system** | PlaceholderAPI | Optional but fully supported; registers a dedicated expansion. |
\n| **Discord bridge** | DiscordSRV, EssentialsDiscord | Route join\/quit\/advancement\/chat events with per-channel embed templates. |
\n| **Authentication** | AuthMe, UserLogin, NexAuth, nLogin, OpeNLogin | Shared spawn handling via `modules\/hook\/login.yml`. |
\n| **Vanish handling** | CMI, EssentialsX, SuperVanish, PremiumVanish | Optional vanish chat key rules to block message leaks. |
\n| **Moderation synergy** | AdvancedBan and other punishment suites | Use cooldowns, mute commands, and violation actions to complement third-party moderation. |<\/p>\n

—<\/p>\n

## Modular Platform Overview<\/p>\n

| Module | Purpose | Key Configuration Files |
\n| — | — | — |
\n| **Join\/Quit** | Welcomes players, controls vanilla join\/quit spam, and manages spawn & invulnerability. | `modules\/join_quit\/config.yml`, `modules\/join_quit\/messages.yml` |
\n| **Announcements** | Time-based broadcasts mixing chat, titles, action bars, sounds, and commands. | `modules\/announcements\/config.yml`, `modules\/announcements\/announces.yml` |
\n| **MOTD** | Rotates server list MOTDs and icons with custom counters. | `modules\/motd\/config.yml`, `modules\/motd\/motds.yml` |
\n| **Advancements** | Broadcasts achievements with rewards and per-world\/mode filters. | `modules\/advancements\/config.yml`, `modules\/advancements\/messages.yml` |
\n| **Chat \u2013 Channels** | Hierarchical global\/local channels with inheritance and colour governance. | `modules\/chat\/channels.yml` (see wiki guide) |
\n| **Chat \u2013 Cooldowns** | Anti-spam timers and scripted punishments. | `modules\/chat\/cooldowns.yml` |
\n| **Chat \u2013 Emojis & Tags** | Replace shortcuts with formatted text and manage permission-based tags. | `modules\/chat\/emojis.yml`, `modules\/chat\/tags.yml` |
\n| **Chat \u2013 Mentions** | Highlight recipients with sounds, hover\/click actions, and custom outputs. | `modules\/chat\/mentions.yml` |
\n| **Chat \u2013 Moderation** | Filter swears, caps, links, and enforce format standards. | `modules\/chat\/moderation.yml` |
\n| **Hooks \u2013 Discord** | DiscordSRV channel routing and embed templates. | `modules\/hook\/discord.yml`, `webhooks.yml` |
\n| **Hooks \u2013 Login\/Vanish** | Sync behaviour with authentication and vanish plugins. | `modules\/hook\/login.yml`, `modules\/hook\/vanish.yml` |<\/p>\n

All modules are toggled from `modules\/modules.yml`, which also manages update tracking for shipped configs.<\/p>\n

—<\/p>\n

## Command Suite<\/p>\n

| Command | Summary | Highlights |
\n| — | — | — |
\n| `\/sir` | Administrative hub | About, reload, module status, help, support links. |
\n| `\/print` | Raw formatted broadcaster | Targeted chat, titles, action bars, Discord webhooks. |
\n| `\/announcer` | Manage automated announcements | Preview, start\/stop, reboot sequences. |
\n| `\/chatview` | Channel visibility | Players opt in\/out of channel subscriptions. |
\n| `\/chatcolor` | GUI colour selector | Unlockable colours, gradients, rainbow styles. |
\n| `\/ignore` | Personal mute list | Persistent ignore data per player. |
\n| `\/clearchat` | Clear local\/global chat | Instant moderation tool. |
\n| `\/msg`, `\/reply` | Private messaging | Sound & action feedback for mentions. |
\n| `\/mute`, `\/tempmute`, `\/unmute`, `\/checkmute` | Moderation controls | Permanent or timed mutes powered by configurable lang\/data files. |<\/p>\n

Command behaviour, aliases, and language strings live under `resources\/commands\/` for complete customization.<\/p>\n

—<\/p>\n

## Formatting & Player Experience Toolkit<\/p>\n

– **Message prefixing:** Define the main plugin prefix, centred text tag, and line separators in `config.yml`.
\n– **Gradient & rainbow tags:** Use `` or `` syntax anywhere the plugin parses text.
\n– **Interactive components:** Attach hover lists and click actions across messages, announcements, and mentions.
\n– **Sound design:** Assign unique join\/quit, mention, and announcement sounds using vanilla sound keys.
\n– **Spawn logic:** Per-message group spawn teleporters align with login plugins when enabled.
\n– **Boss bars & titles:** Tap into Takion\u2019s animated boss bars for announcement or module-specific effects.<\/p>\n

—<\/p>\n

## Getting Started<\/p>\n

1. **Drop SIR into `plugins\/`** \u2013 No external dependencies are required; Takion is already shaded inside the jar.
\n2. **Start your server once** \u2013 Configuration files populate under `plugins\/SIR\/resources\/`.
\n3. **Review `config.yml` and `modules\/modules.yml`** \u2013 Toggle features and adjust update checks.
\n4. **Tailor modules** \u2013 Edit the YAML files under each module directory to match your server\u2019s tone and rules.
\n5. **Grant permissions** \u2013 Use your permission manager (Vault-compatible) to assign command and channel access.
\n6. **Reload or restart** \u2013 `\/sir reload` applies configuration changes without a full reboot.<\/p>\n

Need more detail? The wiki pages below dive into each subsystem with copy-paste-ready examples.<\/p>\n

—<\/p>\n

## Documentation & Support<\/p>\n

– **Wiki:** https:\/\/github.com\/CroaBeast\/SIR\/wiki
\n– **Community Discord:** https:\/\/discord.gg\/s9YFGMrjyF
\n– **Issue tracker:** https:\/\/github.com\/CroaBeast\/SIR\/issues<\/p>\n

—<\/p>\n

## Telemetry & Privacy<\/p>\n

SIR reports anonymous usage data to bStats (metrics ID `25264`) to help the developer understand which integrations are active. Disable metrics globally in `plugins\/bStats\/config.yml` or use your firewall if you prefer to opt out.<\/p>\n

—<\/p>\n

## Contributing & Feedback<\/p>\n

Found a bug or have a feature request? Open an issue on GitHub or reach out through the Discord community. Contributions are welcome\u2014fork the repository, make your improvements, and submit a pull request.<\/p>\n

With SIR, you control every step of the conversation players see. Configure once, delight forever.<\/p>\n<\/details>\n

\n

![](https:\/\/market.bitaspire.com\/spigot\/sir\/slot\/1)
\n![](https:\/\/market.bitaspire.com\/spigot\/sir\/slot\/2)
\n![](https:\/\/market.bitaspire.com\/spigot\/sir\/slot\/3)
\n![](https:\/\/market.bitaspire.com\/spigot\/sir\/slot\/4)
\n![](https:\/\/market.bitaspire.com\/spigot\/sir\/slot\/5)<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

A simple chat plugin that have a lot of functions to customize your server.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"sir","_minecraft_project_id":"N9Rx2kEL","_minecraft_author":"my5","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":484,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sir.zip","_minecraft_size_bytes":18521197,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T10:37:17.288297Z","_minecraft_date_created":"2025-05-12T02:00:41.059084Z","_minecraft_date_modified":"2026-05-15T14:07:13.482123Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sir","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T10:26:13+00:00","_minecraft_import_hash":"096a884e1fb92a64361eeaf5b114e8d3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,873,126,90,127,128,867,129,91,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-141880","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-folia","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nSIR - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/sir\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SIR - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A simple chat plugin that have a lot of functions to customize your server.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/sir\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sir\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sir\\\/\",\"name\":\"SIR - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"datePublished\":\"2026-06-08T10:26:12+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sir\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sir\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sir\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SIR\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SIR - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/","og_locale":"en_US","og_type":"article","og_title":"SIR - Minecraft","og_description":"A simple chat plugin that have a lot of functions to customize your server.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/","name":"SIR - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"datePublished":"2026-06-08T10:26:12+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/sir\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/sir\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"SIR"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/141880","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=141880"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=141880"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=141880"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=141880"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}