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! 🚀