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

🏷️ 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

πŸ“₯ 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 and assets
Jekyll For his bug reports and financial support

β˜•οΈ The myth-MC Team (in alphabetical order)

Username Real name Role
@U8092 Lead developer

We're sponsored by Godlike, a high performance game server hosting. Check them out!

About

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

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors 2

  •  
  •  

Languages