Configurable socials GUI: custom heads, slots, and per-link permissions. Players open links via the menu, /socials (id), or extra commands you define in gui.yml. MiniMessage everywhere; optional browser open plus styled multi-line chat with a clickable URL. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – safe for regionized servers
• Socials GUI – rows, title, filler panes, optional enchant glint, PLAYER_HEAD textures, close-on-click
• Per-entry rules – URL, optional extra permission, enable/disable, command aliases, multi-line chat layout (header + body lines; automatic blank lines above and below the header; optional blank-before-link before the yellow ▶ underlined URL ◀ row)
• Link delivery – OPEN_URL (client browser only), CHAT_ONLY (chat link), or BOTH (config)
• Click cooldown – rate limit between link actions (configurable ms)
• Click statistics – per-entry counts, autosave, admin view and reset
• Sounds – separate open and click sounds (config)
• PlaceholderAPI – link URLs, click counts, totals, entry existence (soft-depend)
Placeholders
%perfsocials_link_(id)% – HTTPS URL for the social entry (id) from gui.yml
%perfsocials_clicks_(id)% – recorded clicks for that entry
%perfsocials_total_clicks% – sum of all recorded clicks
%perfsocials_exists_(id)% – true/false if that entry key exists in the GUI config
Commands
/socials – Open the socials menu (perfsocials.use)
/socials (id) – Send the same link/chat as clicking that slot; (id) is the entry key or a command alias from gui.yml (perfsocials.use)
/social – Alias of /socials (perfsocials.use)
/links – Alias of /socials (perfsocials.use)
Per-entry commands – Defined under each social in gui/socials-gui.yml as commands (string or list), e.g. /discord or /youtube (perfsocials.use)
/perfsocials reload – Reload config, messages, and GUI; re-register dynamic commands (perfsocials.admin)
/perfsocials stats – Show click statistics (perfsocials.admin)
/perfsocials stats reset – Clear the statistics file (perfsocials.admin)
/perfsocials help – Admin help (perfsocials.admin)
