✦ 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

Commands

User 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.

 

Configs:

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
Messages:
  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

 

 


If you need any kind of help you cand send me a message here or via discord, or leave yout problem on discussion section! I do spanish and english support.
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.

 

Comments

Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files