SetHomes

A simple homes plugin with the ability to create, delete, and teleport to many different homes. Have the ability to control a blacklist of worlds in which players will be restricted from setting homes. Using the config you can control setting such as a maximum number of homes, teleport cooldown, teleport delay, and their respective messages that get displayed to the user.

Installation

Simply place the downloaded jar into your server plugins folder. As of plugin version 1.2.6 you will also need to download the Vault plugin since it is a dependency. It may be found here: https://dev.bukkit.org/projects/vault. This dependency is necessary for the maximum homes functionality to work, as vault hooks into various permission plugins. 

Commands

• /sethome [HomeName] [HomeDescription] - This command will allow the issuer to set a home with a given name and description of their choosing at your standing location. If no name and description are given then you will set a default home at your standing location.
• /home [HomeName] - This command will teleport the user to the given "HomeName". If no home name is given then the user is teleported to their default home that was set by /sethome
• /home-of [PlayerName] [HomeName] - This command will allow players with the "homes.home-of" permission to teleport to any players set home. If no home name is provided it will assume the default home as the desired destination.
• /delhome [HomeName] - This command will delete the home at the given home name. If no home name is given then it will attempt to remove the default home.
• /delhome-of [PlayerName] [HomeName] - This command will allow players with the "homes.delhome-of" permission to delete any players set home. If no home name is given it will assume the default home as the home desired for deletion.
• /uhome <HomeName> <HomeDescription> - This command will allow players with the "homes.uhome" permission to update any of there already set homes. If no description is given, and there was one previously set before it will reuse the old one.
• /uhome-of <PlayerName> <HomeName> - This command will allow players with the "homes.uhome-of" permission to update a home for any player. If no home name is supplied then it will update the supplied players default home.
• /homes [PlayerName] - This command will list all of the players currently set homes if there are any. Players with the "home.gethomes" permission can use the extra PlayerName parameter to list the homes of a specific player.
• /blacklist [Add/Remove] [WorldName] - This command is used to both add and remove worlds to/from the blacklist. If passed no other arguments it will list all worlds currently blacklisted.
• /setmax <GroupName> <Amount> - This command will allow players with the "homes.setmax" permission to set a maximum number of allowed homes for a specific permission group. For example if you wanted to only allow the default permission group 4 homes you execute the command, "/setmax default 4".
• /strike - Have fun admins.

Permissions

• homes.* - A player given this permission will be allowed all commands under the Set Homes plugin
• homes.home - A player with this permission is allowed to teleport to named homes
• homes.sethome - A player with this permission is allowed to set named homes
• homes.strike - Give the power to others!
• homes.blacklist_list - A player given this permission will be able to list worlds in the blacklist
• homes.blacklist_add - A player given this permission will be able to add worlds to the blacklist
• homes.blacklist_remove - A player given this permission will be able to remove worlds from the blacklist
• homes.config_bypass - A player given this permission can set homes in blacklisted worlds, and doesn't have to wait for cooldown or teleport delays. They will also be able to exceed the max home limit.
• homes.gethomes - Give the ability to list any players active homes
• homes.home-of - Give the ability to teleport to one of any players active homes
• homes.delhome-of - Give the ability to delete one of any players active homes
• homes.uhome - Give the ability to update homes
• homes.uhome-of - Give the ability to update other players homes
• homes.setmax - Give the ability to set a maximum number of homes for a permission group

Default Config

# --------------------------
# 	SetHomes Config	
# --------------------------
# Messages: 
# 	You can use chat colors in messages with this symbol §.
# 	I.E: §b will change any text after it to an aqua blue color.
# 	Color codes may be found here https://www.digminecraft.com/lists/color_list_pc.php
# Time: 
# 	Any time value is based in seconds.
# Things to Note: 
# 	Set any integer option to 0 for it to be ignored.
# 	The max-homes does not include the default un-named home.
# 	Use %s as the seconds variable in the cooldown message.

max-homes:
  default: 0
max-homes-msg: §4You have reached the maximum amount of saved homes!
tp-delay: 3
tp-cooldown: 0
tp-cancelOnMove: false
tp-cancelOnMove-msg: §4Movement detected! Teleporting has been cancelled!
tp-cooldown-msg: §4You must wait another %s second(s) before teleporting!
auto-update: true

F.A.Q

• Q: How can I give players permission to set named homes?
  A: Install a permissions plugin and apply the permission homes.sethome to the player/group you want to allow usage of multiple homes. The permissions plugin I use to test is PermissionsEX. The command for it is as follows, /pex user <PlayerName> add homes.sethome.
• Q: I am having trouble with max homes and I am using a permissions plugin (V1.2.6)?
  A: Please check to make sure that you have installed  the "Vault" plugin as it is used to determine which groups you have created using a permissions plugin. This also means that you need to be using a permissions plugin that is compatible with "Vault". A list those specific plugins may be found here: https://dev.bukkit.org/projects/vault

Donations

I work on this plugin with the little amount of free time that I have. Please feel free to donate any amount you desire by using the link just below the download button to show your support, and help me stay motivated to keep this project going. Thank You!