Перейти к содержимому
Mineforgian

social

Enhance your server's communication. Modular, modern and customizable.

Загрузки
874
Подписчики
25
Обновлён
13 апреля 2026 г.
Лицензия
GPL-3.0-or-later

Опубликован 1 октября 2024 г.

Исходный кодСообщить об ошибке

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

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

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

Ченджлог

0.7.0Релиз26.1, 26.1.1, 26.1.2 · 13 апреля 2026 г.
  • Added compatibility with Minecraft 26.1
  • Fixed a NullPointerException when sending a message to an empty Audience
  • Java 21 is now required to run the Paper version
  • The build pipeline no longer uses Lombok
0.7.0Релиз26.1, 26.1.1, 26.1.2 · 13 апреля 2026 г.
  • Added compatibility with Minecraft 26.1
  • Fixed a NullPointerException when sending a message to an empty Audience
  • Java 21 is now required to run the Paper version
  • The build pipeline no longer uses Lombok
0.6.1Релиз1.21.9, 1.21.10, 1.21.11 · 10 марта 2026 г.
  • Fixed a NullPointerException when trying to access the console's UUID
  • Improved the performance of the text processor by modifying its pipeline
  • The text processor will now print useful information about its performance when debug mode is active
0.6.1Релиз1.21.9, 1.21.10, 1.21.11 · 10 марта 2026 г.
  • Fixed a NullPointerException when trying to access the console's UUID
  • Improved the performance of the text processor by modifying its pipeline
  • The text processor will now print useful information about its performance when debug mode is active
0.6.0Релиз1.21.10, 1.21.11 · 9 марта 2026 г.
  • Adds compatibility with Minecraft 1.21.9+
  • Adds command /social help
  • Replaces the database with PDC-based storage, reducing overhead and code complexity
  • Rewrote the reaction display logic to enable smoother animations by using interpolation
  • Reworked the plugin's text processing pipeline with more efficient techniques, resulting in performance improvements
  • Replaced internal UUID resolvers with a faster and more suitable identity resolver
  • Improved support for asynchronous code by resolving several rare race conditions
  • Added automatic parsing timeouts (maximum of 5 seconds per process) to the text processor
  • Added detailed descriptions for command arguments and flags
  • Updated gestalt-api and gestalt-loader to v0.3.2, which improves the library loading process
  • Fixed a NullPointerException when opening an anvil GUI
  • Fixed an issue where users could sent private messages to themselves
  • Fixed an issue affecting Minecraft 1.21.11 where reactions would not display correctly
  • Fixed an issue where in-game commands could be executed by the console
0.6.0Релиз1.21.9, 1.21.10, 1.21.11 · 9 марта 2026 г.
  • Adds compatibility with Minecraft 1.21.9+
  • Adds command /social help
  • Replaces the database with PDC-based storage, reducing overhead and code complexity
  • Rewrote the reaction display logic to enable smoother animations by using interpolation
  • Reworked the plugin's text processing pipeline with more efficient techniques, resulting in performance improvements
  • Replaced internal UUID resolvers with a faster and more suitable identity resolver
  • Improved support for asynchronous code by resolving several rare race conditions
  • Added automatic parsing timeouts (maximum of 5 seconds per process) to the text processor
  • Added detailed descriptions for command arguments and flags
  • Updated gestalt-api and gestalt-loader to v0.3.2, which improves the library loading process
  • Fixed a NullPointerException when opening an anvil GUI
  • Fixed an issue where users could sent private messages to themselves
  • Fixed an issue affecting Minecraft 1.21.11 where reactions would not display correctly
  • Fixed an issue where in-game commands could be executed by the console
0.5.0Релиз1.21.6, 1.21.7, 1.21.8 · 14 июля 2025 г.
  • The API is now fully multi-platform
  • Commands have been totally reworked with better readability
  • Introduces various performance enhancements
  • Adds private channels, which can be enabled with /pm <username>
  • Adds command /reply which replies to the latest message sent or received
  • Adds configurable channel commands (for example, /global switches to the global channel)
  • Adds configurable particles to reactions
  • Adds color formatting for players via MiniMessage strings
  • Adds channel alias which will be used wherever possible
  • Adds clickable URLs (opt-in via the text formatting feature)
  • Main channel is now cached between sessions
  • Enables database query time logs in debug mode
  • Fixes a warning that appears while the server is booting
  • Fixes an issue where floodFilter wouldn't depend on its parent filter
  • Fixes various issues with chat event cancellations
  • Fixes an issue with DiscordSRV where the event cancellation state was not passed to DiscordSRV's chat manager
  • Fixes a typo in the update checker which pointed to the wrong download URL
  • Temporarily disables /social history and /social info
0.5.0Релиз1.21.6, 1.21.7, 1.21.8 · 14 июля 2025 г.
  • The API is now fully multi-platform
  • Commands have been totally reworked with better readability
  • Introduces various performance enhancements
  • Adds private channels, which can be enabled with /pm <username>
  • Adds command /reply which replies to the latest message sent or received
  • Adds configurable channel commands (for example, /global switches to the global channel)
  • Adds configurable particles to reactions
  • Adds color formatting for players via MiniMessage strings
  • Adds channel alias which will be used wherever possible
  • Adds clickable URLs (opt-in via the text formatting feature)
  • Main channel is now cached between sessions
  • Enables database query time logs in debug mode
  • Fixes a warning that appears while the server is booting
  • Fixes an issue where floodFilter wouldn't depend on its parent filter
  • Fixes various issues with chat event cancellations
  • Fixes an issue with DiscordSRV where the event cancellation state was not passed to DiscordSRV's chat manager
  • Fixes a typo in the update checker which pointed to the wrong download URL
  • Temporarily disables /social history and /social info

Комментарии

Загружаем…