LPHomes

Lightweight, GUI-based homes plugin. Simple, friendly, and easy to set up.

Set homes, teleport to them, and manage everything from a clean menu. No clutter, no complicated setup — drop it in, tweak the GUI if you want, and you're good.

Features

• Configurable GUI — the homes menu and delete confirmation aren't hardcoded. Change items, slots, lore, titles, and what left/right click do
• Commands & menu — classic /sethome, /home, /delhome, or open /homes and click around
• Pagination — lots of homes? The menu pages through them
• Teleport delay — optional countdown before teleport; moving cancels it
• Safe location check — if a home looks unsafe (lava, void, blocked space…), players get a warning and can still confirm
• Home limits — set a default limit, or give players more with lphomes.limit.<number>
• Admin tools — open and manage another player's homes, reload everything without a restart
• Custom messages — every message lives in messages.yml (colors, hover, click)
• Custom model data & heads — GUI items support model data; you can also use a texture URL for player heads
• Database support — MariaDB or SQLite
• Folia support

Commands

Permissions

Example configs

Click a section below to expand.

teleport-time: 5
default-limit: 2
check-for-safe-location: true

use-remote-database: false

database: hostname: "127.0.0.1" port: 3306 name: "minecraft" username: "root" password: "your_password" parameters: "useSSL=false&serverTimezone=UTC"

Set `use-remote-database: true` for MariaDB. Otherwise SQLite is used automatically.

</details>

<details>
<summary><b>messages.yml</b></summary>

```yaml
prefix: "&9Homes &f- "

no-perm: "&cYou don't have permission to do this action."
successful-teleport: "&aYou successfully teleported."
cancelled-movement: "&cYou canceled teleportation because you moved"
un-safe-location: "&fThe home location is not safe. <hover:show_text:'Click for teleportation!'><click:run_command:'/homes confirm'><b><green>[TELEPORT]</b></click></hover>"
no-confirm: "&cThere is no action to confirm."
#%time%
time-left: "&cYou have %time% s before teleport. Do not move!"
reload: "&aPlugin successfully reloaded."
reload-fail: "&cPlugin reload failed."
usage:
  sethome: "&cUsage: /sethome <name>"
  delhome: "&cUsage: /delhome <name>"
  invalid-name: "&cThis name is invalid."
  home: "&cUsage /home <name>"
  #%limit%
  limit: "&cYou reached your limit of homes %limit%"
  #%name%
  same-home: "&cYou already have this home."
  #%name%
  dont-exist: "&cHome %name% doesn't exist."
  manage: "&cUsage: /homes manage <player> "
  #%player%
  invalid-player: "&cPlayer %player% is not a valid player."

cmd:
  #%name%
  created: "&aHome %name% successfully created."
  #%name%
  deleted: "&aHome %name% successfully deleted."

title: "&8Your Homes (Page %current-page%/%max-page%)"
rows: 6
items:
  background:
    material: GRAY_STAINED_GLASS_PANE
    name: " "
    slots:
      - "0-8"
      - "45-53"
  home-template:
    material: CYAN_BED
    name: "&b&lHome: &f%home%"
    lore:
      - "&aLeft click for Teleport."
      - "&cRight click for delete."
    left-click-actions:
      - teleport
    right-click-actions:
      - delete
  previous-page-button:
    material: ARROW
    name: "&a&l<- Previous page"
    slots:
      - "48"
    left-click-actions:
      - prev_page
  next-page-button:
    material: ARROW
    name: "&a&lNext page ->"
    slots:
      - "50"
    left-click-actions:
      - next_page
  close-button:
    material: BARRIER
    name: "&c&lClose menu"
    slots:
      - "49"
    left-click-actions:
      - close

title: "&4Delete home %home%?"
rows: 3
items:
  background:
    material: BLACK_STAINED_GLASS_PANE
    name: " "
    slots:
      - "0-26"
  confirm-button:
    material: GREEN_STAINED_GLASS_PANE
    name: "&a&l[ Confirm ]"
    slots:
      - "10"
      - "11"
      - "12"
    left-click-actions:
      - confirm_delete
  cancel-button:
    material: RED_STAINED_GLASS_PANE
    name: "&c&l[ Cancel ]"
    slots:
      - "14"
      - "15"
      - "16"
    left-click-actions:
      - cancel_delete

Requirements

• Paper 1.21+ (or Folia)
• Java 21

License

MIT — see LICENSE.