✦ PerWorldHomes ➢ Unique Features ✦
This plugin saves homes data into a each player <uuid>.yml file in a folder "userdata" inside the directory plugin folder.
PerWorldHomes plugin came up because there is not any plugin that support homes by worlds groups. This plugin its perfect for a server that prettends to be/act like a network or have different modalities
● Import your homes from Essentials
● Allows players to set, delete, see, and teleport to their homes
● Allows admins to set, delete, see, and teleport to other players homes
○ Can set global homes
● You can convert your global homes to shareds across worlds later with /pwh convert
● Can set homes shareds across worlds (Groups related worlds together)
○ If a world is not listed on config and per-world-homes is on true, then will have their own homes data
● Set max homes per worlds and per player groups
○ On first time enabled the plugin automatically setup all your server player groups on config with 1 max home by default if you have Vault
● Economy support NEW! 2.1
○ A economy plugin depending on Vault is needed.
● Before teleport to homes checks if your homes location is safe NEW! 2.1
○ When a home location is unsafe will block teleport to avoid players diying or will teleport anyways if teleport-unsafe-locations is enabled.
● Configurable /home and /homes GUI NEW! 2.0
● Customizable max length home name
● Customizable command cooldown
● Customizable delay before being teleported
● Customizable messages
● Tab completer for /home NEW! 1.8
● Full UUID Support
● Download PerWorldHomes.
● Shut down your server.
● Move PerWorldHomes.jar to your server plugins folder.
● Start the server and let the plugins generate config files.
● Shut down again the server.
● Change settings, messages and values from config files.
● Start your server again
● Done
CommandsUser commands
● /sethome <home>
● /delhome <home>
● /home (opens GUI if is enabled)
● /home <home>
● /homes
Admin Commands
● /sethome <player> <home>
● /delhome <player> <home>
● /home <player> (opens GUI if is enabled and if player is online)
● /home <player> <home>
● /homes <player>
● /pwh help
● /pwh version
● /pwh reload
● /pwh convert (Only console command)
○ Convert all players global homes to per world groups
● /pwh import (Only console command)
○ Import all homes from Essentials.
Permissions
● pwh.users
○ pwh.sethome
■ Allow acces to command /sethome <home>
○ pwh.delhome
■ Allow acces to command /delhome <home>
○ pwh.home
■ Allow acces to command /home <home>
○ pwh.homes
■ Allow acces to command /homes
● pwh.admin
○ pwh.sethome.others
■ Allow acces to command /sethome <player> <home>
○ pwh.delhome.others
■ Allow acces to command /delhome <player> <home>
○ pwh.home.others
■ Allow acces to command /home <player> <home>
○ pwh.homes.others
■ Allow acces to command /homes <player>
○ pwh.main
■ Allow acces to command /pwh help
■ Allow acces to command /pwh version
■ Allow acces to command /pwh reload
● pwh.teleport.delay.bypass
○ Allow bypass the teleport delay.
● pwh.teleport.move.bypass
○ Allows to move while you are being telported.
● pwh.command.cooldown.bypass
○ Allows to bypass the command cooldown.
● pwh.*
○ Allow access to all PerWorldHomes commands and permissions.
config.yml
# +----------------------------------------------------+ # < PerWorldHomes > # < By KechuFonzo > # +----------------------------------------------------+ # Allows op players to set unlimited homes. op-unlimited-homes: true # Set the max length for the home names. max-home-name-length: 16 # Economy will not affects admin commands. # delhome-refound means if on /delhome command # the player should returns his money back. economy: enabled: false sethome: 0.0 home: 0.0 delhome-refound: false delhome-giveback: 0.0 # Affects /home command, Time on seconds 0 = no delay. teleport-delay: 3 # Affects /sethome, /home and /delhome # Time its on seconds, 0 = no cooldown. cmd-cooldown: 3 # Unsafe location is a location that is dangerous # for players because lava or could soffocate. # This affects /sethome and /home allow-unsafe-locations: false # Open a menu with your homes when /home. home-gui: false # Max homes per player group for each world group. # The max homes are managed by your worlds groups # and your own server player groups. max-homes: global: default: 1 # If true then homes data will be saved by worlds groups. # If false then homes will be saved as global. per-world-homes: false # Groups of worlds that will share the homes data. # All worlds not listed will have their own data if # per-world-homes is on true. groups: group1: worlds: - world1 - world2 group2: worlds: - world3 - world4 # Checks if there is a new version available. version-checker: true # Auto-update config/messages/gui.yml files files-auto-update: true # Your config version. Do not touch this! config-version: 1.0
messages.yml
main:
help:
- '&6-----PerWorldHomes-----'
- '&f/pwh help'
- '&f/pwh version'
- '&f/pwh reload'
- '&f/pwh convert'
- '&f/pwh import'
version: '&aYou are using PerWorldHomes %version%.'
reload: '&aPlugin files have been reloaded.'
no-permission: '&4You dont have permission to execute this command!'
only-players: '&cOnly players may execute this command.'
only-console: '&cOnly console may execute this command.'
cmd-cooldown: '&cYou need to wait %sec-left% seconds before using this command!'
teleport-delay: '&cYou will be teleported on %sec-left% seconds! Please dont move.'
teleport-cancel: '&cYou moved! Teletransportation canceled!'
sethome:
already-exist: '&cYou already have a home with that name!'
reach-max: '&aYou have reached the max homes allowed for your rank!'
exceed-length: '&cThe max length for name is %max-length%!'
no-money: '&cYou dont have enough money! Price: %cost%'
payed-money: '&c$%cost% have been removed from your balance'
not-safe: '&cYou cant set a home in unsafe locations!'
success: '&aYour home has been successfully set!'
usage: '&cUsage: /sethome <home>'
other-player:
not-online: '&c%player% is not online!'
already-exist: '&c%player% already have a home with that name!'
success: '&a%player% home has been successfully set!'
reach-max: '&a%player% have reached the max homes allowed for his rank!'
delhome:
not-exist: '&cYou dont have a home with that name!'
success: '&aYour home has been deleted!'
refound-money: '&c$%refound% have been added to your balance'
usage: '&cUsage: /delhome <home>'
other-player:
not-online: '&c%player% is not online!'
not-exist: '&c%player% dont have a home with that name!'
success: '&%player% home has been deleted!'
home:
not-exist: '&cThat home doesnt exist!'
no-money: '&cYou dont have enough money! Price: %cost%'
not-safe: '&cYour home location has been corrupted and isnt safe!'
success: '&aSuccessfully teleported!'
payed-money: '&c$%cost% have been removed from your balance'
usage: '&cUsage: /home <home>'
other-player:
not-online: '&c%player% is not online!'
not-exist: '&c%player% dont have a home with that name!'
home-list:
no-homes: '&cYou dont have homes!'
list: '&aYour homes: &f'
usage: '&cUsage: /homes'
other-player:
not-online: '&c%player% is not online!'
no-homes: '&c%player% dont have homes!'
list: '&a%player% homes: &f'
messages-version: 1.0
gui.yml
gui-title: '&2Home GUI' home-item: id: BED name-color: '&6' lore: - '&aX:&f %cord-x%' - '&aY:&f %cord-y%' - '&aZ:&f %cord-z%' - '&aWorld:&f %world%' next-item: id: PAPER name: '&aNext Page &e->' previous-item: id: PAPER name: '&e<- &aPrevious Page' quit-item: id: BARRIER name: '&4Close' gui-version: 1.0
FAQ
● Why /back isnt working propperly since i installed the plugin?
○ This happens because you are using essentials /back command, and have on false the option register-back-in-listener of essentials config.
● About /pwh import
○ /pwh import will import the homes of each players, only if they dont have homes setted by perworldhomes and if they have Essentials homes
● Do you have discord?
○ Yes, my DiscordID is kechufonzo#9197.
I have spent many hours making PerWorldHomes. if you want to support me, leave a review, or give me a little tip to cheer me up and
motivate me to keep updating this resource.
Disclaimer: This plugin could contain bugs, if you find one please report it in discussion section, or pm me.
Great plugin! Super useful and includes so many useful features. Thanks!
In reply to xp10d3:
Hi! I am glad that you find it useful and u like it! Thanks to you for using it and the review!
In reply to kechufonzo:
Np! <3
normal users cant use command like sethome home etc.
How can I change the permissions for them?
In reply to Forge_User_17017258:
Hi! Sorry for the late response! The permissions can be changed with a permission plugin, like LuckPerms or PermissionEx. The permissions used on my plugin are in the Permission section.