{"id":28633746,"url":"https://github.com/staticpast/slackminecraft","last_synced_at":"2026-03-06T18:48:16.673Z","repository":{"id":36666925,"uuid":"229074386","full_name":"Staticpast/SlackMinecraft","owner":"Staticpast","description":"A lightweight Spigot plugin that bridges your Minecraft server with Slack, enabling real-time communication and event notifications between both platforms.","archived":false,"fork":false,"pushed_at":"2025-05-13T08:06:36.000Z","size":64,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-05-16T07:45:49.710Z","etag":null,"topics":["bukkit","java","minecraft","paperspigot","plugin","slack","spigot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Staticpast.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-12-19T14:43:42.000Z","updated_at":"2025-05-13T08:06:39.000Z","dependencies_parsed_at":"2025-05-13T09:25:16.550Z","dependency_job_id":"0ffaa370-fac6-4916-9733-73fbd813f948","html_url":"https://github.com/Staticpast/SlackMinecraft","commit_stats":null,"previous_names":["staticpast/slackminecraft","mckenziejdan/slackminecraft"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Staticpast/SlackMinecraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Staticpast%2FSlackMinecraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Staticpast%2FSlackMinecraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Staticpast%2FSlackMinecraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Staticpast%2FSlackMinecraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Staticpast","download_url":"https://codeload.github.com/Staticpast/SlackMinecraft/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Staticpast%2FSlackMinecraft/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259493740,"owners_count":22866383,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","java","minecraft","paperspigot","plugin","slack","spigot"],"created_at":"2025-06-12T15:32:12.423Z","updated_at":"2026-03-06T18:48:16.606Z","avatar_url":"https://github.com/Staticpast.png","language":"Java","funding_links":["https://www.paypal.com/paypalme/mckenzio"],"categories":[],"sub_categories":[],"readme":"# SlackMinecraft\n\nA Minecraft Spigot plugin that relays chat messages, player events (join, quit, death, advancements), and optionally commands between a Minecraft server and a Slack channel using Socket Mode.\n\n[![Java](https://img.shields.io/badge/Java-17-red.svg)](https://adoptium.net/temurin/releases/?version=17)\n[![Minecraft](https://img.shields.io/badge/Minecraft-1.21.5-green.svg)](https://www.minecraft.net/)\n[![SpigotMC](https://img.shields.io/badge/SpigotMC-SlackMinecraft-orange)](https://www.spigotmc.org/resources/slackminecraft.117207/)\n[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://www.paypal.com/paypalme/mckenzio)\n\n## Features\n\n*   💬 Bidirectional chat relay between Minecraft \u0026 Slack (with @mention support)\n*   📢 Relay game events (join, quit, death, advancements) to Slack\n*   ⚙️ Configurable message formats \u0026 bot appearance\n*   ⚡ Efficient \u0026 performant (Socket Mode, user caching)\n*   🖥️ Optional command echoing to Slack\n\n## Installation\n\n1.  Download the latest release from [Spigot](https://www.spigotmc.org/resources/slackminecraft.117207/) or [GitHub Releases](https://github.com/McKenzieJDan/SlackMinecraft/releases).\n2.  Place the JAR file in your server's `plugins` folder.\n3.  Restart your server.\n4.  Configure the plugin in `plugins/SlackMinecraft/config.yml`:\n    *   Create a [Slack App](https://api.slack.com/apps).\n    *   Enable **Socket Mode** under \"Features\". Generate an **App-Level Token** (starting with `xapp-`) with the `connections:write` scope and add it to `slack.app-token`.\n    *   Go to \"OAuth \u0026 Permissions\". Add the following **Bot Token Scopes**: `chat:write`, `users:read`, `channels:read`.\n    *   Install the app to your workspace and copy the **Bot User OAuth Token** (starting with `xoxb-`) into `slack.token`.\n    *   Set the `slack.channel` to the name of the channel you want the bot to use (without the `#`).\n    *   Review other settings like `i18n` messages and `options`.\n\n## Usage\n\nOnce configured correctly, the plugin automatically connects to Slack and relays messages and events between the configured channel and the Minecraft server. No specific player commands are required for basic operation.\n\n### Commands\n\nThis plugin does not currently add any commands.\n\n### Permissions\n\nThis plugin does not currently add any permissions. All players can chat and trigger events that are relayed.\n\n## Configuration\n\nThe plugin's configuration file (`config.yml`) allows customization:\n\n```yaml\n# Slack integration configuration\nslack:\n  # Set to true to enable Slack integration, false to disable\n  enabled: true\n  # Your Slack Bot Token (starts with xoxb-)\n  token: \"\"\n  # Your Slack App-Level Token for Socket Mode (starts with xapp-)\n  app-token: \"\"\n  # The Slack channel name (without #) to connect to and relay messages\n  channel: \"general\"\n  # URL for the bot's profile picture in Slack (leave empty for default)\n  icon: \"\"\n  # Set to true for extra diagnostic logging in the server console\n  debug: false\n  # How often (in minutes) to refresh the Slack user list cache (for @mentions)\n  cacheRefreshMinutes: 60\n\n# Internationalization / Message Customization\ni18n:\n  # Name used by the bot when posting messages (e.g., server status)\n  botName: \"Minecraft\"\n  # Message sent to Slack when the bot connects\n  connected: \":white_check_mark: Online\"\n  # Message sent to Slack when the bot disconnects\n  disconnected: \":x: Offline\"\n  # Message format for player joins\n  joinedGame: \"_Joined the game_\"\n  # Message format for player quits\n  leftGame: \"_Left the game_\"\n  # Prefix for advancement messages\n  advancementDone: \":trophy: Has made the advancement \"\n  # Prefix for player death messages (followed by Minecraft's death message)\n  death: \":skull: \"\n  # Prefix for command messages (if options.echoCommands is true)\n  commandExecuted: \":warning: Executed command: \"\n  # Format for messages coming FROM Slack TO Minecraft (%s = username, %s = message)\n  slackToMinecraftFormat: \"[Slack] \u003c%s\u003e %s\"\n\n# Other plugin options\noptions:\n  # Set to true to send messages to Slack when players use commands\n  echoCommands: true\n```\n\n## Requirements\n\n*   Spigot/Paper 1.21.5+\n*   Java 17+\n\n## Used By\n\n[SuegoFaults](https://suegofaults.com) - A curated adult Minecraft community where this plugin powers Slack chat and events integration.\n\n## Support\n\nIf you find this plugin helpful, consider [buying me a coffee](https://www.paypal.com/paypalme/mckenzio) ☕\n\n## License\n\n[MIT License](LICENSE)\n\nMade with ❤️ by [McKenzieJDan](https://github.com/McKenzieJDan)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstaticpast%2Fslackminecraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstaticpast%2Fslackminecraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstaticpast%2Fslackminecraft/lists"}