🏠 HomeGuard - Advanced Home & Teleportation System

HomeGuard is a powerful server-side mod that brings a comprehensive home management and teleportation system to your Minecraft world. Set multiple homes, teleport safely with warmup timers, and expand your home slots through crafting!

✨ Core Features

🎯 Smart Home Management

• Multiple Homes: Set up to 27 different home points across your world
• Per-World Storage: Homes are saved per world, keeping your saves independent
• Beautiful GUI: Intuitive chest-like interface with color-coded bed icons
• Easy Commands: Simple /sethome, /home, /delhome, and /renhome commands

⏱️ Safe Teleportation

• Warmup System: 3-second countdown before teleporting (configurable)
• Movement Detection: Teleport cancels if you move during warmup
• Cooldown Protection: 5-second cooldown between teleports (configurable)
• Safety Checks: Prevents teleporting into lava, water, or unsafe locations
• Cross-Dimension Protection: Blocks dangerous Overworld ↔ Nether teleports
• Visual Feedback: Particle effects, sounds, and progress bars during teleportation

🎨 Visual Polish

• 16 Bed Colors: Each home gets a unique colored bed icon based on its name
• Animated Token: Craftable Home Slot Token with smooth animation
• Progress Indicators: Real-time countdown with visual progress bar
• Particle Effects: Beautiful particle effects for successful teleports and slot unlocks

🔓 Expandable System

• Default Slots: Start with 3 home slots
• Craftable Upgrades: Create Home Slot Tokens to unlock more slots
• Premium Crafting: Requires 8 Ender Pearls + 1 Nether Star per token
• Maximum Capacity: Expand up to 27 total home slots
• Admin Controll: Edit costs, probabilities, Player, Spawnrate and more
• Tokens can be found: In End Ships and Ancient Citys

🎮 Commands

🛠️ Configuration

The mod is fully configurable via config/homeguard/config.json:

{
  "defaultLimit": 3,
  "cooldownMs": 5000,
  "warmupSeconds": 3,
  "maxLimit": 27,
  "allowPublicHomes": true,
  "publicHomesOpOnly": true,
  "publicHomeLimit": 1,
  "dimensionLimits": {
    "minecraft:overworld": -1,
    "minecraft:the_nether": 3,
    "minecraft:the_end": 1
  },
  "teleportHungerCost": 0,
  "teleportXpLevelsCost": 0,
  "dimensionRules": {
    "minecraft:overworld": {
      "limit": -1
    },
    "minecraft:the_nether": {
      "limit": 3
    },
    "minecraft:the_end": {
      "limit": 1
    }
  },
  "warmupCancelOnDamage": true,
  "endShipTokenChance": 0.12,
  "ancientCityTokenChance": 0.5
}