HomeGuard

🏠 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

| Command | Description |
|———|————-|
| /sethome <name> | Set a home at your current location |
| /home | Open the homes GUI menu |
| /home <name> | Teleport to a specific home |
| /delhome <name> | Delete a home |
| /renhome <old> <new> | Rename a home |
| /publichome | Set a public Home (can be deactivated by config) |
| sharehome <player> <all> | share coordinates or invite a player to your Homepoint |
| /homeguard homes | homes, clear, stats, config, get, set, reload|

🛠️ 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
}