Ly+ Settings

The central hub for the Ly+ plugin suite. A clean, GUI-based settings system that gives every player full control over their personal experience — and provides the addon API that powers the entire Ly+ ecosystem.

💬 Support & Community: Join our Discord

---

🧩 What is Ly+ Settings?

Ly+ Settings is the core plugin of the Ly+ suite. On its own it handles the /settings GUI and a built-in chat filter system. Its real power comes from the LyPlusAddon API — every Ly+ addon registers itself here, injects its own settings items into the GUI, and shares player data through the core. One command, all your preferences, zero clutter.

---

✨ Features

⚙️ Settings GUI

• Clean 54-slot GUI opened with /settings
• Addons inject their own items into dedicated slots automatically
• Bottom navigator row shows a shortcut icon for each installed addon
• Instant visual feedback — color-coded toggle states

💬 Chat Filters (requires ProtocolLib)

• Global Chat — mute all chat at once
• Server Messages — hide server broadcasts and notifications
• Player Messages — hide player-to-player chat only
• Powered by deep ProtocolLib packet interception for perfect accuracy
• All filters default to OFF for a normal experience

🔌 Addon API

• LyPlusAddon interface for clean addon integration
• Thread-safe AddonRegistry
• Shared persistent PlayerData across all addons
• Utility methods exposed to addons: createItem, addBoolItem, addCycleItem, playSound, updateBool, updateInt, and more

---

🎮 Commands

Command	Description	Permission
/settings	Open the settings GUI	settings.use
/settings reload	Reload all configs	settings.admin
/settings addons	List all loaded Ly+ addons	settings.use

Aliases: /s · /prefs · /preferences

---

🧱 Ly+ Addon Suite

Ly+ Settings is the core — install any of these addons alongside it:

Addon	Description
Ly+ TPA	GUI-based teleport requests with dimension awareness
Ly+ Friends (coming soon)	Full friend system with live status tracking
Ly+ Messages (coming soon)	Private messaging system
Ly+ Homes (coming soon)	Home and warp management

---

📋 Requirements

• Paper or Purpur 1.21+
• Java 21+
• ProtocolLib 5.4.0+

⚠️ If ProtocolLib is not installed, chat filters will be disabled — all other features work normally.

---

🚀 Installation

1. Download LyPlusSettings-2.0.0.jar and place it in /plugins
2. Install ProtocolLib in /plugins
3. Start the server — config.yml generates automatically
4. Install any Ly+ addon jars alongside it
5. Run /settings reload to apply any config changes

---

Made with ❤️ by Lyvt · Discord Support