{"id":17575068,"url":"https://github.com/myth-mc/social","last_synced_at":"2026-02-18T02:35:49.779Z","repository":{"id":258886878,"uuid":"861794302","full_name":"myth-MC/social","owner":"myth-MC","description":"Enhance your server's communication with social. Modular, customizable and feature-packed.","archived":false,"fork":false,"pushed_at":"2025-07-14T20:53:35.000Z","size":1135,"stargazers_count":8,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-15T01:03:58.118Z","etag":null,"topics":["bukkit","chat","chat-plugin","minecraft","minecraft-plugin","paper","spigot"],"latest_commit_sha":null,"homepage":"https://discord.gg/bpkwdzREcR","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/myth-MC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"mythMC","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-09-23T14:22:24.000Z","updated_at":"2025-07-14T20:40:27.000Z","dependencies_parsed_at":"2024-10-26T00:20:14.323Z","dependency_job_id":"6f660f7d-bcf1-4cfe-9c0b-c8d1052fd63e","html_url":"https://github.com/myth-MC/social","commit_stats":null,"previous_names":["myth-mc/social"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/myth-MC/social","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myth-MC%2Fsocial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myth-MC%2Fsocial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myth-MC%2Fsocial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myth-MC%2Fsocial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/myth-MC","download_url":"https://codeload.github.com/myth-MC/social/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myth-MC%2Fsocial/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268723073,"owners_count":24296544,"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","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","chat","chat-plugin","minecraft","minecraft-plugin","paper","spigot"],"created_at":"2024-10-21T22:06:15.701Z","updated_at":"2025-10-06T23:17:25.276Z","avatar_url":"https://github.com/myth-MC.png","language":"Java","funding_links":["https://ko-fi.com/mythMC"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cimg src=\"https://assets.mythmc.ovh/social/logo-small.png\"\u003e\n    \u003ch1\u003esocial\u003c/h1\u003e\n    \u003ca href=\"https://github.com/myth-MC/social/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/myth-MC/social\" alt=\"Latest release\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/myth-MC/social/pulls\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-pr/myth-MC/social\" alt=\"Pull requests\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/myth-MC/social/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/myth-MC/social\" alt=\"Issues\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/myth-MC/social/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-GPL--3.0-blue.svg\" alt=\"License\" /\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    Enhance your server's communication.\n    \u003cbr\u003e\n    Modular, customizable and feature-packed.\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdetails open=\"open\"\u003e\n  \u003csummary\u003e🧲 Quick navigation\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#information\"\u003e📚 Information\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#installation\"\u003e📥 Installation\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#usage\"\u003e🖊️ Usage\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#credits\"\u003e⭐️ Credits\u003c/a\u003e\n    \u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003cdiv id=\"information\"\u003e\u003c/div\u003e\n\n# 📚 Information\n\n**social 🦜** is a fully modular plug-in focused on **enhancing your server's communication** without affecting the gameplay experience. \nIt is developed using modern APIs, providing a **simple but powerful tool** for server owners and developers. \n**Everything can be configured**, including messages.\n\n## 🤔 Features\n\n* ✨ Fully compatible with [MiniMessage](https://docs.advntr.dev/minimessage/index.html) and [PlaceholderAPI](https://wiki.placeholderapi.com) to have great-looking messages\n* 🗣️ **Channel-based chat provider**. You can add or remove channels according to your server's needs. For example, you could have a global and a staff channel\n* 😲 **Reactions** that appear above a player's head with nice animations\n* 🧵 **Chat replies and threads**. Players can click on a message to reply to it.\n* 🛡️ **Group chat channels**. Players can create their own group channel with `/group`. Server owners can see group messages with Social Spy.\n* 😎 **Emoji support** in a very similar way as Discord: `:emoji_name:`\n* ‼️ **Mentions** that work with usernames and nicknames.\n* 🔗 **Server links**. Available since Minecraft 1.21, server links are a great way of sharing external resources with your players in the pause menu\n* 📢 **Built-in announcements** with a configurable interval. Can broadcast messages through the action bar\n* 🤫 **Private messages** with social spy for staff members\n* 🖌️ **Advanced text formatting** with **bold**, _italics_, \u003cins\u003eunderline\u003c/ins\u003e and more options\n* 🤬 **Chat filters** that block IPs, URLs or words. Even in private messages\n* 🌊 **Flood/spam prevention**\n* ☕️ **Developer-friendly API** with countless possibilities. Developers can add custom channels, reactions, emojis, filters, keywords, formatters...\n* 👀 **No dependencies**\n\n## ⚠️ Compatibility chart\n\n|                                                         | Compatible? | Version | Notes                                        |\n|---------------------------------------------------------|-------------|---------|----------------------------------------------|\n| [PaperMC](https://papermc.io/)                          | ✅          | 1.19+   | *1                                           |\n| [PurpurMC](https://purpurmc.org/)                       | ✅          | 1.19+   | *1                                           |\n| [Spigot](https://www.spigotmc.org)                      | ✅          | 1.19+   | *1                                           |\n| [Bukkit](https://bukkit.org)                            | ✅          | 1.19+   | *1                                           |\n| [Folia](https://papermc.io/software/folia)              | ✅          | 1.19+   | *1                                           |\n\n*1: _Some features require the latest version_\n\n## 🔌 Integrations\n\n### 🏷️ [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI)\n- Compatible with every placeholder added by PlaceholderAPI.\n\n### 💬 [DiscordSRV](https://github.com/DiscordSRV/DiscordSRV)\n- Compatible with chat channels.\n\n### 🐷 [banco](https://github.com/myth-MC/banco)\n- Adds keyword `[balance]` to show balance amount in chat.\n\n## ➕ Official add-ons\n\n### 👤 [social-chatheadfont](https://github.com/myth-MC/social-chatheadfont-addon)\n- Provides compatibility with [ChatHeadFont](https://github.com/OGminso/ChatHeadFont).\n\n\u003cdiv id=\"installation\"\u003e\u003c/div\u003e\n\n# 📥 Installation\n\n1. **Download the social jar file for your platform**. You can find the latest version on [our releases page](https://github.com/myth-MC/social/releases).\n2. **Add the social jar file to your server's plugin folder**. Make sure to delete any older versions of social.\n3. **Fully restart your server**. Type `/stop` and start the server again [instead of using `/reload`](https://madelinemiller.dev/blog/problem-with-reload/).\n\n\u003cdiv id=\"usage\"\u003e\u003c/div\u003e\n\n# 🖊️ Usage\n\nWe have a simple guide on using **social** in our docs website: https://social.mythmc.ovh/docs\n\n## ✏️ Key concepts\n### 💬 Parsers\n**social** provides a set of powerful built-in tools in the form of **parsers**. Parsers are rules that modify text accordingly. Here's a list of parser types:\n\n|              | Description                                     | Format         | Triggerable by players? | Example                 |\n|--------------|-------------------------------------------------|----------------|-------------------------|-------------------------|\n| Filter       | Replaces a literal with '***'                   | _configurable_ | ✅                      | `192.168.1.1 ➡️ ***`    |\n| Formatter    | Gives a special format to a literal             | _configurable_ | ✅                      | `**hi**      ➡️ `**hi** |\n| Emoji        | Replaces a literal with a unicode input (emoji) | :emoji:        | ✅                      | `:smile:     ➡️ 😄`     |\n| Keyword      | Replaces a literal with a specific component    | [keyword]      | ✅                      | `[balance]   ➡️ 10.4$`  |\n| Placeholder  | Replaces a literal with a specific component    | $placeholder   | ❌                      | `$channel    ➡️ global` |\n\n\u003cdiv id=\"credits\"\u003e\u003c/div\u003e\n\n# ⭐️ Credits\n\n## 🫶 Special thanks _(in alphabetical order)_\n\n| Username                                           | Contribution                              |\n|----------------------------------------------------|-------------------------------------------|\n| [@deltartz_](https://www.instagram.com/deltartz_/) | For her great work on the logo and assets |\n| Jekyll                                             | For his bug reports and financial support |\n\n## ☕️ The myth-MC Team _(in alphabetical order)_\n| Username                           | Real name       | Role                 |\n|------------------------------------|-----------------|----------------------|\n| [@U8092](https://github.com/U8092) |                 | Lead developer       |\n\n\u003chr\u003e\n\n\u003ca href=\"https://sponsor.mythmc.ovh/\"\u003e\n  \u003cimg src=\"https://assets.mythmc.ovh/banner_godlike.png\" /\u003e\n\u003c/a\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eWe're sponsored by \u003ca href=\"https://sponsor.mythmc.ovh/\"\u003eGodlike\u003c/a\u003e, a high performance game server hosting. Check them out!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyth-mc%2Fsocial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmyth-mc%2Fsocial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyth-mc%2Fsocial/lists"}