⚙️ Settings+ v1.8.1 (Pro Build)

A comprehensive settings, friends, and teleport system for Paper 1.21.1+

✨ What's New in v1.8.1

🐛 Major Bug Fixes

Chat Filter System - Completely Rewritten

• Fixed: Chat filters were using inverted logic (backwards!)
• Fixed: Global Chat, Server Messages, and Player Messages filters now work correctly
• Improved: Filters now default to OFF (disabled) instead of ON
• Improved: Clean, readable filter logic with proper packet type detection

What Now Works:

• ✅ Global Chat Filter - Blocks ALL chat when enabled
• ✅ Server Messages Filter - Blocks only messages with server prefix
• ✅ Player Messages Filter - Blocks only player-to-player chat
• Each filter is now independent and works as intended

TPA Permission System - Fixed

• Fixed: "Nobody" setting was being ignored
• Fixed: "Friends Only" setting had backwards logic
• Changed: Now properly checks if sender is in receiver's friend list
• Improved: Clear permission hierarchy (Everyone → Friends Only → Disabled)

What Now Works:

• ✅ /tpa respects receiver's TPA settings
• ✅ /tpahere respects receiver's TPA-Here settings
• ✅ Friends-only restrictions work correctly
• ✅ Disabled setting blocks all requests

Friends System

• Fixed: Right-click friend removal wasn't working properly
• Improved: Better player name extraction from inventory items
• Fixed: Name parsing now handles color codes correctly

GUI Issues

• Fixed: Settings GUI wouldn't close immediately after accepting TPA
• Fixed: Warning GUI now closes properly when TPA is confirmed
• Improved: Both players' inventories are now properly closed

🎨 User Interface Improvements

Professional Configuration

• Added comprehensive config comments and sections
• Improved setting names for clarity
  • "TPA Empfang" → "Allow TPA Requests"
  • "Tpa-Here Empfang" → "Allow TPA-Here Requests"
• Better lore descriptions for all settings
• Added visual indicators (icons) in GUI titles
• Professional formatting with borders and organization

Better GUI Names

• Settings GUI: Now shows as "⚙ Settings+"
• TPA GUI: Now shows as "✈ Teleport Request"
• Friends GUI: Now shows as "★ Friend List"
• Requests GUI: Now shows as "📬 Friend Requests"

🔧 Code Quality

• Improved error handling throughout
• Added proper null-checks for safety
• Better code documentation
• Cleaner method organization
• More intuitive variable naming

📝 Documentation

Added comprehensive documentation:

• CHAT_FILTER_DOCUMENTATION.md - Complete chat filter guide
• CHAT_FILTER_QUICK_REFERENCE.md - Admin quick reference
• TPA_FIX_DOCUMENTATION.md - TPA permission system details
• GUI_CLOSE_FIX.md - GUI closing behavior
• QUICK_START.md - Installation and testing guide
• BUGFIX_CHANGELOG.md - Previous fixes overview

📊 Settings Overview

Chat Filters

Setting	Default	Effect
Global Chat	OFF	Mutes all chat
Server Messages	OFF	Mutes server notifications
Player Messages	OFF	Mutes player chat

TPA Settings

Setting	Default	Options
Allow TPA Requests	Everyone	Everyone / Friends Only / Disabled
Allow TPA-Here Requests	Everyone	Everyone / Friends Only / Disabled
Auto-Accept TPA	OFF	ON/OFF
TPA-Here Warning	ON	ON/OFF

🎮 Commands

Friends:

• /friends - Open friend list
• /friends add <player> - Send friend request
• /friends accept <player> - Accept request
• /friends deny <player> - Deny request
• /friends remove <player> - Remove friend

Teleport:

• /tpa <player> - Request to teleport to player
• /tpahere <player> - Request player to teleport to you
• /tpaccept - Accept teleport request
• /tpdeny - Deny teleport request

Admin:

• /settings - Open settings menu
• /settings reload - Reload configuration

🌍 Languages Supported

• 🇬🇧 English
• 🇩🇪 Deutsch (German)

Both languages fully translated with professional descriptions.

⚙️ Requirements

• Server: Paper 1.21.1+
• Dependencies: ProtocolLib (required for chat filters)
• Java: 17+

📦 Dependency

⚠️ This plugin requires ProtocolLib to be installed on your server for chat filtering features to work.

If ProtocolLib is not found:

• Chat filters will be disabled
• A warning will appear in console
• All other features will work normally

🐛 Known Issues

None reported! Please report any issues on GitHub or Modrinth.

🙏 Credits

Settings+ is a comprehensive plugin developed for Paper 1.21.1+ servers.

Built with:

• ✨ Adventure API - Text components
• 🔌 ProtocolLib - Packet manipulation
• 📚 Paper API - Server implementation

📄 License

This plugin is provided as-is for use on Minecraft servers.

---

How to Install

1. Download the latest JAR file
2. Place it in your plugins/ folder
3. Install ProtocolLib in plugins folder
4. Restart your server
5. Edit plugins/SettingsPlus/config.yml to customize
6. Run /settings reload to apply changes

First Steps

1. Open settings: /settings
2. Add friends: /friends add <player_name>
3. Configure TPA settings to your preference
4. Enjoy! ✨

---

Version: 1.8.1 (Pro Build)
Release Date: 2025
Minecraft Version: 1.21.1+
Status: ✅ Stable & Fully Tested

Visit the GitHub Repository for source code and issue tracking.

Made with ❤️ for Minecraft Servers