Settings+

Ly+ Settings - Changelog

Version 1.8.5 (Rebranding & Performance)

Date: March 10, 2026

Rebranding

- Renamed plugin from Settings+ to Ly+ Settings - Updated: Plugin name across all files - Updated: plugin.yml name field changed to LyPlus Settings

Performance

- Various performance optimizations under the hood

Affected Files

- plugin.yml - Plugin name updated --- All plugins that are gonna released from me now are gonna be Branded "Ly+" infront of it <3 _Thanks for the support you all_

SettingsPlus - Changelog

Version 1.8.4 (Bug-Fix)

Date: March 09, 2026

Bug Fixes

- [CRITICAL] Fixed: /tp command was overridden by /tpa - Removed: Aliases teleport and tp from /tpa command - Removed: Alias tphere from /tpahere command - Kept: Alias tph for /tpahere (safe, no conflicts) - Effect: Minecraft's native /tp command and TP commands from other plugins now work normally again

Technical Details

The issue was caused by command alias conflicts in plugin.yml. The aliases tp and teleport for /tpa caused all /tp inputs to be interpreted as /tpa, making the default teleport command non-functional.

Affected Files

- plugin.yml - Command aliases updated

Settings+ v1.8.3 Beta - Home System Update

Major New Feature: Home System

Home Teleportation Commands

- NEW: `/home` - Opens the interactive Home GUI - NEW: `/home <1-5>` - Teleport directly to a specific home - NEW: `/sethome <1-5>` - Set a home at your current location - NEW: `/delhome <1-5>` - Delete a saved home location

Interactive Home GUI

- Beautiful visual interface with red beds representing each home slot - Visual status indicators: - Blue dye under set homes - Gray dye under empty home slots - Intuitive controls: - Left-click empty bed: Set home at current location - Left-click set home: Teleport to that home - Right-click set home: Delete the home - 4-row layout (36 slots) for clean, centered design - World information displayed in home tooltips

Home Teleportation Features

- Action Bar Countdown: Countdown displays above hotbar (like TPA system) - Default: 3 seconds (configurable) - Visual countdown: ⏱ 3s | Don't move! | ⏱ - Success message: ✓ Welcome home! ✓ - Movement Detection: Optional cancellation if you move during countdown - Configurable in settings: Enable/disable in /settings GUI - Cancels if player moves >1 block in any direction - Config option: home_cancel_on_move: true/false - Full location storage: Saves world, coordinates, yaw, and pitch - Cross-world support: Teleport between Overworld, Nether, and End - Persistent data: All homes saved to settings.json

Configuration Options

features:
  home_system: true               # Enable/disable entire home system
  max_homes: 5                    # How many homes per player (1-9)
  home_countdown_seconds: 3       # Countdown duration (0 = instant teleport)
  home_cancel_on_move: true       # Cancel if player moves during countdown

Settings GUI Integration

- New setting slot: "Home Countdown" toggle (Slot 17) - Toggle countdown on/off before home teleports - Works exactly like TPA countdown system

Critical Bug Fixes

Friends System Synchronization Fix

- FIXED: Friends not syncing properly between players - Previously: Only the person who sent the request could see the friendship - Now: Both players correctly see each other in their friends list - Issue affected both /friends accept and viewing friend lists - Improved data persistence: Friends data now saves immediately after changes - Better offline player support: Friendships sync correctly even when one player is offline

Friends System Improvements

- Enhanced bidirectional friendship management - More reliable data saving for friend additions/removals - Fixed edge cases where friendships could become one-sided

Technical Improvements

Data Storage

New HomeLocation class stores complete position data:

{
  "homes": {
    "1": {
      "world": "world",
      "x": 100.5,
      "y": 64.0,
      "z": -200.5,
      "yaw": 90.0,
      "pitch": 0.0
    }
  }
}

Performance

- Efficient home data loading/saving - Memory-safe teleport countdown cleanup - Optimized GUI rendering for home slots

Translations

Complete Language Support

Both English and German translations added for: - All home system commands and messages - Home GUI tooltips and labels - Status indicators and action messages - Error messages and usage instructions

New Translation Keys

- home_set - Home set confirmation - home_deleted - Home deleted message - home_teleported - Successful teleport message - home_bed_name - Bed item display name - home_set_lore / home_not_set_lore - Status tooltips - home_left_tp / home_right_del / home_click_set - Action hints - And more...

Command Reference

New Commands

| Command | Description | Permission | Aliases | |---------|-------------|------------|---------| | /home | Open home GUI | settings.home | /homes, /h | | /home <#> | Teleport to home | settings.home | - | | /sethome <#> | Set home location | settings.sethome | /createhome | | /delhome <#> | Delete home | settings.delhome | /deletehome, /removehome |

Tab Completion

- Auto-suggests home numbers (1-5) for all home commands - Smart completion based on max_homes config value

GUI Updates

Home GUI Layout (v1.8.3)

┌──────────────────────────────────────┐
│  Empty slot for metadata             │ Row 1
│      [🛏️] [🛏️] [🛏️] [🛏️] [🛏️]      │ Row 2 - Home Beds
│      [●] [●] [○] [○] [○]           │ Row 3 - Status (Blue/Gray)
│                                      │ Row 4
└──────────────────────────────────────┘

Legend:
🛏️ = Red Bed (Home Slot)
● = Status Indicator (Blue = Set, Gray = Empty)

Settings GUI Addition

- New home countdown toggle at slot 17 - Consistent with existing TPA/message settings layout

Configuration Schema Updates

New Config Sections

# New prefix for home messages
prefixes:
  homes: "§8[§aHomes§8] §f"

# New slot for home countdown setting
slots:
  home_countdown: 17

# New permissions
permissions:
  settings.home: true
  settings.sethome: true
  settings.delhome: true

Compatibility

- Minecraft: 1.21.1+ - Server: Paper / Purpur / Folia compatible - Dependencies: ProtocolLib (for chat filters) - Java: 17+

Statistics

- Lines of code added: ~300+ - New translation keys: 15+ per language - New config options: 4 - New commands: 3 (with aliases) - Bug fixes: 1 critical (friends sync)

Usage Examples

Setting Up Homes

/sethome 1          → Set home #1 at current location
/sethome 2          → Set home #2 at spawn
/home               → Open GUI to manage all homes

Teleporting Home

/home 1             → Teleport to home #1
/home 2             → Teleport to home #2

Managing Homes

/delhome 1          → Delete home #1
/home               → Click beds in GUI to set/teleport/delete

Coming in Future Updates

- Home naming system (custom names for homes) - Home sharing with friends - Home icons (different bed colors) - Home descriptions/notes - Max homes per permission group - Home teleport cooldowns - Economy integration for home slots --- Full Changelog: v1.8.2 → v1.8.3 Upgrade Notes: - Existing player data is fully compatible - New homes field will be automatically added to player data - No config migration needed - new options use safe defaults Download: Available on Modrinth & GitHub Releases Support: Report issues on GitHub or join our Discord!

Special Thanks

Thanks to all beta testers and community members who reported the friends sync bug and requested the home system feature! ---

What's Next?

We're working on v1.8.4 which will include: - Warp system for server-wide teleportation - Enhanced home management features - Performance optimizations - More customization options Stay tuned!

Settings+ v1.8.2 Beta - Major Feature Update

New Features

Private Messaging System

- NEW: `/msg <player> <message>` - Send private messages to other players - NEW: `/reply <message>` - Quickly reply to the last person who messaged you - Privacy Controls: Configure who can message you (Everyone, Friends Only, or Nobody) - Friend Integration: Restrict messages to friends only for enhanced privacy - Sound Notifications: Receive pleasant notification sounds when messages arrive - Operator Override: Server operators can always send messages regardless of settings

Redesigned Settings GUI

- Completely reorganized layout for better usability and clarity - Three-section design: - Left: Chat Filters (All Chat, Server Messages, Player Messages) - Middle: Private Message Reception Settings - Right: TPA System Controls - Removed visual clutter: Clean interface without unnecessary decorative elements - Improved item placement for more intuitive navigation

Enhanced TPA Countdown System

- Action Bar Display: Countdown now appears above your hotbar instead of cluttering chat - Visual Feedback: - Initial message: §a✈ Teleporting in 5s... Don't move! §a✈ - Countdown: §e⏱ 6s | Don't move! | ⏱ - Success: §a✓ Teleport successful! ✓ - Movement Detection: NEW optional feature that cancels teleport if you move - Configurable: Enable/disable movement detection in config (tpa_cancel_on_move) - Smart Detection: Only cancels if you move more than 1 block in any direction

Configuration Updates

New Config Options

features:
  private_messages: true          # Enable/disable private messaging system
  tpa_cancel_on_move: true        # Cancel TPA if player moves during countdown

New Slot Configuration

- Reorganized GUI slots for better layout (slots 10-16, 28-29) - IMPORTANT: Config reload (/settings reload) now properly updates slot positions

New Translation Keys

Added complete translation support for: - Private message system (sent, received, disabled messages) - Message reception settings - All new GUI elements and tooltips

Bug Fixes

Critical Fixes

- FIXED: Config Reload Issue - Slot positions now update correctly after /settings reload - Implemented slot caching system for instant config updates - Previously, slot changes required server restart - FIXED: Private Messages GUI - Message settings now display correctly with single cycle button - Removed duplicate buttons that caused configuration issues - Clean Everyone → Friends Only → Nobody cycle

Improvements

- Better error handling for offline players in messaging system - Improved permission checks for message reception settings - Enhanced null safety for player data management - Optimized countdown task cleanup to prevent memory leaks

Command Reference

New Commands

| Command | Description | Permission | |---------|-------------|------------| | /msg <player> <message> | Send a private message | settings.msg | | /reply <message> | Reply to last message | settings.msg |

Existing Commands

- /settings [reload] - Open settings GUI or reload config - /friends [add\|remove\|accept\|deny] - Manage friends - /tpa <player> - Request teleport to player - /tpahere <player> - Request player teleport to you - /tpaccept - Accept TPA request - /tpdeny - Deny TPA request

Language Support

- English - Fully supported - German - Fully supported - All new features include complete translations

Performance

- Optimized countdown system using BukkitScheduler - Efficient slot caching reduces config reads by ~80% - Memory-safe cleanup of teleport tasks - Concurrent-safe movement tracking

Dependencies

- Paper 1.21.1+ (or compatible fork) - ProtocolLib (for chat filtering features) - Java 17+

Coming Soon

- Teleport request timeout system - Block/unblock specific players - Message history/log - Custom sound configuration - More GUI customization options - More Support for different Languages --- Full Changelog: v1.8.1 → v1.8.2 Installation: Drop the JAR into your plugins folder and restart your server. Config will generate automatically. Support: Report issues on our GitHub or join our Discord for help!

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](https://dev.bukkit.org/projects/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](https://docs.adventure.kyori.net/) - Text components - [ProtocolLib](https://dev.bukkit.org/projects/protocollib) - Packet manipulation - [Paper API](https://docs.papermc.io/) - 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](https://dev.bukkit.org/projects/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](https://github.com/Lyvt-Dev/SettingsPlus) for source code and issue tracking. Made with for Minecraft Servers

Changelog - Settings+ & Friends v1.8.0 (BETA)

(add me on dc: _.lyvt if you have problems or find bugs <3)

Global & Localization

Full Translation System:* The entire plugin is now 100% translatable via config.yml. Language Support:* Added English (en) and German (de) by default, including automatic color code support. Code Cleanup:* Removed all hardcoded strings from the Java source code. Every message and GUI title is now pulled dynamically from the configuration.

Friends System (Rebuilt)

Duplicate Prevention:* Switched internal data handling to LinkedHashSet. Friends can no longer appear twice in the list, even after server restarts. Interactive GUI Menu:* Left-Click:* Instantly sends a teleport request to that friend. Right-Click:* Removes the player from your friends list immediately. Live Status Tracking: Player heads in the menu now display a live Online or Offline* status. Region Tracker: For online friends, their current dimension (Overworld, Nether, or The End*) is displayed directly in the item lore. Request Management:* Added a dedicated sub-menu to manage incoming friend requests with one-click Accept/Deny functions.

TPA & TPA-HERE System

Dimensional Indicator: The TPA GUI now features a Physical Block* representing the sender's current location: 🌿 Grass Block* = Overworld 🔥 Netherrack* = Nether 🌑 End Stone* = The End GUI Logic Fixes:* Player heads in TPA requests now use a "Clean Lore" mode. They no longer show friend-specific instructions, preventing confusion during teleportation. Security Warning: When receiving a TPA-HERE* request, a special warning screen (TNT icon) appears to prevent players from being lured into traps. Chat Integration:* Clickable chat buttons ([ACCEPT], [DENY]) are now fully localized and formatted.

Settings (Main GUI)

Modular Chat Filters:* Global Chat:* Mutes everything for the user. Server Messages:* Filters out automated system notifications (filter prefix is customizable). Player Messages:* Filters out only the standard player chat. TPA Privacy:* Three-tier toggle for receiving requests (Everyone, Friends Only, or Nobody). Auto-Accept:* Toggleable feature to automatically accept TPA requests from friends.

Technical Fixes & Performance

Data Persistence:* Optimized settings.json saving with GSON. Settings and friendships are saved instantly upon any change. Smart Tab-Completion:* Updated the /friends command to only suggest relevant player names for remove, accept, or deny sub-commands. Audio Feedback:* Added immersive Minecraft sound effects to all GUI interactions, successes, and errors. Admin Tools:* Added /settings reload to allow admins to update translations and config settings without restarting the server.

Settings+ | Hotfix v1.7.3

Fixes & Patches

Fixed GUI Titles:* Resolved a bug where color codes were stripped incorrectly, causing titles to display as "8Settings" instead of the formatted name. Improved Color Support:* The plugin now correctly handles legacy color symbols (§) in all configuration strings using the Adventure API. Permission Logic Patch:* Fixed a minor issue where certain custom permission nodes from the config.yml were not being recognized after a plugin reload. Internal Cleanup:* Removed redundant code blocks to reduce the JAR file size and improve loading times.

Minor Changes

* Updated the default config.yml template to be more user-friendly. * Added a console warning if the plugin is loaded without its required dependencies.

Settings+ | Update v1.7.2

New Features

Full Customization:* All prefixes (TPA, Settings, Server) are now fully editable in the config.yml. Dynamic Permissions:* You can now rename every permission node (e.g., settings.use) to your own custom string in the configuration. Live Reload:* Added /settings reload command to apply config changes instantly without restarting the server. Server-Message Filter:* You can now define a specific keyword (like [Server]) in the config to control exactly which messages are blocked by the "Server Messages" toggle. GUI Slot Control:* All menu items can now be moved to any slot you prefer via the config.yml.

Improvements & Bugfixes

GUI Title Fix:* Resolved an issue where color codes in the menu title were displayed as plain text (e.g., "8Settings"). Enhanced Stability: Added a robust startup check for ProtocolLib* to prevent crashes if dependencies are missing. Rebranding: The plugin has been officially renamed to Settings+*. Performance Boost:* Optimized packet handling for the chat-filtering system to ensure zero lag on high-population servers.

Configuration Notes

* The plugin now generates a config.yml for administrative settings and a settings.json for player data. Important:* Please delete your old plugin folder before installing v1.7.2 to ensure all new config options are generated correctly.

SettingsPlugin - Ultimate Player Experience

SettingsPlugin is a lightweight yet powerful utility for Minecraft servers that gives players full control over their social experience. It features a highly intuitive GUI, a robust TPA system, and a deep configuration system for server admins.

Key Features

Customizable Settings GUI:* A clean, 54-slot inventory interface where players can toggle their preferences with a single click. Advanced Chat Filters:* Players can independently toggle "All Chat", "Server Messages" (system notifications), and "Player Messages". Integrated TPA System: Includes `/tpa`, `/tpahere`, and `/tpaccept`. It also features an Auto-Accept* toggle for faster gameplay. TPA-Here Warning System:* Protect your players! If enabled, a special warning GUI with sound effects pops up when someone tries to teleport a player to them, preventing "TP-Trapping". Multi-Language Support: Easily switch between English and German* (or add your own!) via the configuration file. Fully Configurable:* Admins can customize every single GUI slot and every text message in the config.yml.

:tools: Commands

* /settings - Opens the main settings menu. * /tpa <player> - Send a teleport request to a player. * /tpahere <player> - Request a player to teleport to your location. * /tpaccept - Review and accept pending requests. * /info - Quickly view your current toggle states in the chat.

Requirements

Spigot/Paper 1.21.x* ProtocolLib* (Required for advanced chat filtering) ---

Installation

1. Drop the SettingsPlugin.jar into your plugins folder. 2. Install ProtocolLib. 3. Restart your server. 4. (Optional) Edit the config.yml to change the language or GUI layout.