Menu ▾ ▴

Homes Management

Zathrus Writer

Homes Management

Commands to allow your players set their home locations (one per server or per each world), teleport there or even invite their friends. Administration functions are included to help find and clear unused homes, teleport to them and do whatever is necessary in such area.

MyHome data import

CommandsEX Home Management functions were written with the popular MyHome plugin in mind. It is entirely possible to import the homes.db file from MyHome into CommandsEX. To do this, follow these steps:

  1. copy homes.db file from MyHome plugin into CommandsEX folder in your plugins directory (keep the filename intact)
  2. make sure you have built your CommandsEX with Homes Management support (or downloaded a full build from Bukkit Dev / Sourceforge)
  3. start or restart your server - when CommandsEX will load, you will see information about homes.db file being imported
  4. once the import is done, you will be informed via Console and homes.db will be renamed to homes.db.done
  5. remove homes.db.done file from CommandsEX folder

Configuration

There are 2 config options added to accommodate Homes Management needs:

  • homeQualifyTime - time (in seconds) for a player to be on the server before he's allowed to set and use their home location using /sethome (or /home set) command. Default: 12 hours (43200 seconds)

  • allowMultiworldHomes - set this to true if you want to allow players to have separate home locations in each world. Setting this to false will set player's home in the world they actually reside when using the /sethome command

Special permissions

There is a couple of special permissions, allowing your administrators or groups of users to bypass various limitations. These limitations are in place so new players won't flood your database with homes they use only once and never come back to your server again.

  • cex.bypasshomequalify - Players with this permission are not required to spend a fixed amount of time on the server before being allowed to set home.

  • cex.bypassinvite - Players with this permission can visit all homes without the need to be invited to them.

/cex_home set + /cex_sethome

  • Description: Allows player to set their home location in the given world.
  • Usage: /cex_home set OR /cex_sethome
  • Permission node: cex.sethome
  • Default permission: everyone
  • Aliases: /home set, sethome
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home

  • Description: Allows player to visit their home or their friends' homes.
  • Usage: /cex_home [Player]
  • Permission node: cex.home
  • Default permission: everyone
  • Aliases: home
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home invite

  • Description: Allows player to invite other players to their home.
  • Usage: /cex_home invite \<Player>
  • Permission node: cex.home.invite
  • Default permission: everyone
  • Aliases: /home invite
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home uninvite

  • Description: Allows player to uninvite other players from their home.
  • Usage: /cex_home uninvite \<Player>
  • Permission node: cex.home.invite
  • Default permission: everyone
  • Aliases: /home uninvite
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home list

  • Description: Allows player to list players that this player is invited to.
  • Usage: /cex_home list
  • Permission node: cex.home.list
  • Default permission: everyone
  • Aliases: /home list
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home ilist

  • Description: Allows player to list players who are invited to this player's home.
  • Usage: /cex_home ilist
  • Permission node: cex.home.list
  • Default permission: everyone
  • Aliases: /home ilist
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home listall

  • Description: Allows player to list all homes that are created on the server.
  • Usage: /cex_home listall
  • Permission node: cex.home.listall
  • Default permission: OP only
  • Aliases: /home listall
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home private

  • Description: Allows player to make their home private.
  • Usage: /cex_home private
  • Permission node: cex.home.publicize
  • Default permission: everyone
  • Aliases: /home private
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home public

  • Description: Allows player to make their home public.
  • Usage: /cex_home public
  • Permission node: cex.home.publicize
  • Default permission: everyone
  • Aliases: /home public
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home delete

  • Description: Allows player to delete their own home.
  • Usage: /cex_home delete
  • Permission node: cex.home.delete
  • Default permission: everyone
  • Aliases: /home delete
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home delete \<Player>

  • Description: Allows player to delete any home.
  • Usage: /cex_home delete \<Player>
  • Permission node: cex.home.delete.all
  • Default permission: OP only
  • Aliases: /home delete
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home iclear

  • Description: Allows player to clear all homes where players haven't been online in a given number of days.
  • Usage: /cex_home iclear \<days>
  • Permission node: cex.home.iclear
  • Default permission: OP only
  • Aliases: /home iclear
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_hyes

  • Description: Allows player to confirm the /cex_home iclear command and really delete all homes found by it.
  • Usage: /cex_hyes
  • Permission node: cex.hyes
  • Default permission: OP only
  • Aliases: /home hyes
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

/cex_home tclear

  • Description: Allows player to teleport to first home where players haven't been online in a given number of days.
  • Usage: /cex_home tclear \<days>
  • Permission node: cex.home.tclear
  • Default permission: OP only
  • Aliases: /home tclear
  • Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_home.class

Related

Wiki: CommandsEX CraftBukkit plugin Wiki
Wiki: Configuration

MongoDB Logo MongoDB