Skip to content
/ social Public

Enhance your server's communication with social. Modular, customizable and feature-packed.

License

Notifications You must be signed in to change notification settings

myth-MC/social

Repository files navigation

social

Latest release Pull requests Issues License
Enhance your server's communication.
Modular, customizable and feature-packed.

🧲 Quick navigation
  1. 📚 Information
  2. 📥 Installation
  3. 🖊️ Usage
  4. ⭐️ Credits

📚 Information

social 🦜 is a fully modular plug-in focused on enhancing your server's communication without affecting the gameplay experience. It is developed using modern APIs, providing a simple but powerful tool for server owners and developers. Everything can be configured, including messages.

🤔 Features

  • ✨ Fully compatible with MiniMessage and PlaceholderAPI to have great-looking messages
  • 🗣️ 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
  • 😲 Reactions that appear above a player's head with nice animations
  • 🧵 Chat replies and threads. Players can click on a message to reply to it.
  • 🛡️ Group chat channels. Players can create their own group channel with /group. Server owners can see group messages with Social Spy.
  • 😎 Emoji support in a very similar way as Discord: :emoji_name:
  • ‼️ Mentions that work with usernames and nicknames.
  • 🔗 Server links. Available since Minecraft 1.21, server links are a great way of sharing external resources with your players in the pause menu
  • 📢 Built-in announcements with a configurable interval. Can broadcast messages through the action bar
  • 🤫 Private messages with social spy for staff members
  • 🖌️ Advanced text formatting with bold, italics, underline and more options
  • 🤬 Chat filters that block IPs, URLs or words. Even in private messages
  • 🌊 Flood/spam prevention
  • ☕️ Developer-friendly API with countless possibilities. Developers can add custom channels, reactions, emojis, filters, keywords, formatters...
  • 👀 No dependencies

⚠️ Compatibility chart

Compatible? Version Notes
PaperMC 1.19+ *1
PurpurMC 1.19+ *1
Spigot 1.19+ *1
Bukkit 1.19+ *1
Folia 1.19+ *1

*1: Some features require the latest version

🔌 Integrations

  • Compatible with every placeholder added by PlaceholderAPI.
  • Compatible with chat channels.

🐷 banco

  • Adds keyword [balance] to show balance amount in chat.

➕ Official add-ons

📥 Installation

  1. Download the social jar file for your platform. You can find the latest version on our releases page.
  2. Add the social jar file to your server's plugin folder. Make sure to delete any older versions of social.
  3. Fully restart your server. Type /stop and start the server again instead of using /reload.

🖊️ Usage

We have a simple guide on using social in our docs website: https://social.mythmc.ovh/docs

✏️ Key concepts

💬 Parsers

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:

Description Format Triggerable by players? Example
Filter Replaces a literal with '***' configurable 192.168.1.1 ➡️ ***
Formatter Gives a special format to a literal configurable **hi** ➡️ hi
Emoji Replaces a literal with a unicode input (emoji) :emoji: :smile: ➡️ 😄
Keyword Replaces a literal with a specific component  [keyword] [balance] ➡️ 10.4$
Placeholder Replaces a literal with a specific component $placeholder $channel ➡️ global

⭐️ Credits

🫶 Special thanks (in alphabetical order)

Username Contribution
@deltartz_ For her great work on the logo
Jekyll For his bug reports and financial support

☕️ The myth-MC Team (in alphabetical order)

Username Real name Role
@U8092 Lead developer