A simple chat plugin that have a lot of functions to customize your server.
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.
| 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. |
| 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. |
| 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 punishments. | modules/chat/cooldowns.yml |
| Chat – Emojis & Tags | Replace shortcuts with formatted text and manage permission-based tags. | modules/chat/emojis.yml, modules/chat/tags.yml |
| Chat – Mentions | Highlight recipients with sounds, hover/click actions, and custom outputs. | modules/chat/mentions.yml |
| Chat – Moderation | Filter swears, caps, links, and enforce format standards. | modules/chat/moderation.yml |
| Hooks – Discord | DiscordSRV channel routing and embed templates. | modules/hook/discord.yml, webhooks.yml |
| Hooks – Login/Vanish | Sync behaviour with authentication and vanish plugins. | modules/hook/login.yml, modules/hook/vanish.yml |
All modules are toggled from modules/modules.yml, which also manages update tracking for shipped configs.
| Command | Summary | Highlights |
|---|---|---|
/sir |
Administrative hub | About, reload, module status, help, support links. |
/print |
Raw formatted broadcaster | Targeted chat, titles, action bars, Discord webhooks. |
/announcer |
Manage automated announcements | Preview, start/stop, reboot sequences. |
/chatview |
Channel visibility | Players opt in/out of channel subscriptions. |
/chatcolor |
GUI colour selector | Unlockable colours, gradients, rainbow styles. |
/ignore |
Personal mute list | Persistent ignore data per player. |
/clearchat |
Clear local/global chat | Instant moderation tool. |
/msg, /reply |
Private messaging | Sound & action feedback for mentions. |
/mute, /tempmute, /unmute, /checkmute |
Moderation controls | Permanent or timed mutes powered by configurable lang/data files. |
Command behaviour, aliases, and language strings live under resources/commands/ for complete customization.
config.yml.<G:#RRGGBB:#RRGGBB> or <R:n> syntax anywhere the plugin parses text.plugins/ – No external dependencies are required; Takion is already shaded inside the jar.plugins/SIR/resources/.config.yml and modules/modules.yml – Toggle features and adjust update checks./sir reload applies configuration changes without a full reboot.Need more detail? The wiki pages below dive into each subsystem with copy-paste-ready examples.
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.
Found a bug or have a feature request? Open an issue on GitHub or reach out through the Discord community. Contributions are welcome—fork the repository, make your improvements, and submit a pull request.
With SIR, you control every step of the conversation players see. Configure once, delight forever.