social
Enhance your server's communication.
Modular, customizable and feature-packed.
๐ 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...
- ๐ No dependencies
โ ๏ธ Compatibility chart
| Compatible? | Version | Notes |
|---|
| PaperMC | โ
| 1.16+ | Reactions are available from 1.20 onwards |
| PurpurMC | โ
| 1.16+ | Reactions are available from 1.20 onwards |
| Spigot | โ
| 1.16+ | Reactions are available from 1.20 onwards |
| Bukkit | โ
| 1.16+ | Reactions are available from 1.20 onwards |
| Folia | โ | | |
๐ Integrations
- Compatible with every placeholder added by PlaceholderAPI.
- Compatible with chat channels
- Adds keyword
[balance] to show balance amount in chat.
โ Official add-ons
๐๏ธ Usage
๐ง First run
When you run social for the very first time it will automatically generate two files:
- 'settings.yml' contains general settings
- 'messages.yml' contains configurable messages
You can disable any feature by modifying settings.yml
โ๏ธ 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 | Replace expressions or words with '***' | configurable | โ
| 192.168.1.1 โก๏ธ *** |
| Emoji | Replaces a word with a unicode input (emoji) | :emoji: | โ
| :smile: โก๏ธ ๐ |
| Keyword | Replaces a word with a specific component | ย [keyword] | โ
| [balance] โก๏ธ 10.4$ |
| Placeholder | Replaces a word with a specific component | $placeholder | โ | $channel โก๏ธ global |