Readme
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 playersMessageIconUrl
- URL of the icon shown in messagesDefaultHomeCooldown
- Seconds players must wait between using home teleportDefaultHomeDelay
- Seconds players must wait before teleportation happensDefaultMaxHomes
- Maximum number of homes a player can haveTeleportHeight
- Height offset when teleporting to a bedCancelOnMove
- Whether teleportation should cancel if player movesMoveMaxDistance
- How far a player can move before teleport cancelsBlockUnderground
- 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 playersVIPDelays
- Custom delay times for VIP playersVIPMaxHomes
- Custom maximum home limits for VIP players
Each VIP setting contains:
PermissionTag
- The permission node that players need to haveValue
- 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>