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
• 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

Integrations

PlaceholderAPI

• Compatible with every placeholder added by PlaceholderAPI.

DiscordSRV

• Compatible with chat channels.

banco

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

Official add-ons

social-chatheadfont

• Provides compatibility with ChatHeadFont.

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

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:

Credits

Special thanks (in alphabetical order)

The myth-MC Team (in alphabetical order)