Server Homes

Essential /home commands on your Minecraft server

Features

• Interactive admin tools
• Configuration file for server admins to tweak settings
• Colorful and interactive text
• Independently saves player homes in separate (editable) configuration files
• Smart tab completion
• Lightweight

Player Commands

- /home <home>        // Teleport to a specified home
- /homes              // List all homes
- /sethome <home>     // Sets a new home
- /delhome <home>     // Delete a specified home
- /confirm            // Confirm a delhome or a sethome overwrite.
- /cancel             // Cancels action

Admin Commands

- /homeadmin list <player>           // List all homes belonging to a specific player. 
- /homeadmin tp <player> <home>      // Teleport to a specific home belonging to a player.
- /homeadmin delhome <player> <home> // Delete a specific home belonging to a player.

Configuration

The configuration file is pretty self-explanatory.

config.yml

home:
  max_homes: 3
  max_homes_vip: 5
  enable_sounds: true
  enable_message: true # enables the countdown message

  confirmation:
    timeout_seconds: 30 # players with the vip permission skip this
    enable_delete_confirm: true
    enable_overwrite_confirm: true

  teleport:
    delay_seconds: 5
    cooldown_seconds: 10
    cancel_events:
      movement: true
      damage: true
      attack: true
      inventory: false
      interact: true

  admin:
    allow_cross_world_teleportation: true
    blocked_worlds:
      # - world_nether
      # - world_end
      # - world

Permissions

Permissions are set using a permissions plugin such as luckyperms or you can set default permissions in plugin.yml

plugin.yml

main: dev.tallenpeli.serverHomes.ServerHomes
name: ServerHomes
version: 2.0.1
api-version: 1.21

commands:
  home:
    description: Teleport to your set home
    usage: /home <name>
    permission: tallenpeli.serverHomes.home
    permission-message: §cYou don't have permission to use the home command!
  homes:
    description: List all your homes
    usage: /homes
    permission: tallenpeli.serverHomes.homes
    permission-message: §cYou don't have permission to use the homes command!
  sethome:
    description: Set your home
    usage: /sethome <name>
    permission: tallenpeli.serverHomes.sethome
    permission-message: §cYou don't have permission to use the sethome command!
  delhome:
    description: Set your home
    usage: /delhome <name>
    permission: tallenpeli.serverHomes.delhome
    permission-message: §cYou don't have permission to use the delhome command!
  confirm:
    description: Confirm a home deletion
    usage: /confirm
    permission: tallenpeli.serverHomes.confirm
    permission-message: §cYou don't have permission to use the confirm command!
  cancel:
    description: Cancels a confirmation request
    usage: /cancel
    permission: tallenpeli.serverHomes.cancel
    permission-message: §cYou don't have permission to use the cancel command!
  homeadmin:
    description: Admin command.
    usage: /homeadmin <options>..
    permission: tallenpeli.serverHomes.admin
    permission-message: §cYou don't have permission to use this command! 

permissions:
  tallenpeli.serverHomes.home:
    description: Teleports you to your home.
    default: true
  tallenpeli.serverHomes.sethome:
    description: Sets the player's home.
    default: true
  tallenpeli.serverHomes.delhome:
    description: Delete a specified home.
    default: true
  tallenpeli.serverHomes.confirm:
    description: Confirm a home deletion.
    default: true
  tallenpeli.serverHomes.cancel:
    description: Cancel a pending confirmation.
    default: true
  tallenpeli.serverHomes.homes:
    description: Lists all your homes.
    default: true

  tallenpeli.serverHomes.vip:
    description: Allows certain players to bypass teleport restrictions.
    default: op
  tallenpeli.serverHome.admin:
    description: Administrative permissions for managing player's homes.
    default: op

Reporting issues/Feature request?

Report issues or request features to the GitHub issue tracker or directly to my inbox at mail@tallenpeli.dev.