MoreHomes

A plugin for Unturned that allows players to claim and teleport to multiple beds.

Features

• Claim multiple beds as homes
• Teleport to your homes with simple commands
• Configurable cooldown and delay system
• Teleportation cancels if player moves
• Works with Teleportation plugin to check combat and raid status
• VIP system for special cooldowns, delays, and home limits

Commands

Player Commands

• /home - Teleport to your first home
• /home <name> - Teleport to a specific home
• /homes - List all your homes
• /destroyhome <name> - Delete a home
• /renamehome <name> <new_name> - Rename a home

Admin Commands

• /restorehomes - Rebuild homes database from all beds on the map (console only)

Configuration

<?xml version="1.0" encoding="utf-8"?>
<MoreHomesConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <MessageColor>yellow</MessageColor>
  <MessageIconUrl>https://i.imgur.com/9TF5aB1.png</MessageIconUrl>
  <DefaultHomeCooldown>20</DefaultHomeCooldown>
  <DefaultHomeDelay>10</DefaultHomeDelay>
  <DefaultMaxHomes>2</DefaultMaxHomes>
  <TeleportHeight>0.5</TeleportHeight>
  <CancelOnMove>true</CancelOnMove>
  <MoveMaxDistance>0.5</MoveMaxDistance>
  <BlockUnderground>false</BlockUnderground>
  <VIPCooldowns>
    <VIPPermission PermissionTag="morehomes.vip" Value="10" />
    <VIPPermission PermissionTag="morehomes.star" Value="5" />
  </VIPCooldowns>
  <VIPDelays>
    <VIPPermission PermissionTag="morehomes.vip" Value="5" />
    <VIPPermission PermissionTag="morehomes.star" Value="3" />
  </VIPDelays>
  <VIPMaxHomes>
    <VIPPermission PermissionTag="morehomes.vip" Value="3" />
    <VIPPermission PermissionTag="morehomes.star" Value="4" />
  </VIPMaxHomes>
</MoreHomesConfiguration>

Configuration Options

• MessageColor - Color of plugin messages to players
• MessageIconUrl - URL of the icon shown in messages
• DefaultHomeCooldown - Seconds players must wait between using home teleport
• DefaultHomeDelay - Seconds players must wait before teleportation happens
• DefaultMaxHomes - Maximum number of homes a player can have
• TeleportHeight - Height offset when teleporting to a bed
• CancelOnMove - Whether teleportation should cancel if player moves
• MoveMaxDistance - How far a player can move before teleport cancels
• BlockUnderground - Prevent teleporting to beds located underground

VIP System

The VIP system uses permission tags to give players special benefits:

• VIPCooldowns - Custom cooldown times for VIP players
• VIPDelays - Custom delay times for VIP players
• VIPMaxHomes - Custom maximum home limits for VIP players

Each VIP setting contains:

• PermissionTag - The permission node that players need to have
• Value - The numeric value for that permission

For example:

• <VIPPermission PermissionTag="morehomes.vip" Value="3" /> in VIPMaxHomes means players with "morehomes.vip" permission can have 3 homes
• <VIPPermission PermissionTag="morehomes.star" Value="5" /> in VIPCooldowns means players with "morehomes.star" permission have a 5 second cooldown

The plugin always uses the best value for the player:

• For cooldowns and delays: the lowest value from applicable permissions
• For max homes: the highest value from applicable permissions

Player Permissions

<Permission Cooldown="0">home</Permission>
<Permission Cooldown="0">homes</Permission>
<Permission Cooldown="0">destroyhome</Permission>
<Permission Cooldown="0">renamehome</Permission>