DOCS berries.games ↗

BerryHomes

Homes with a proper menu, for one server or a whole network. Numbered slots or a paged list, fancy names, icons, descriptions, cross-server teleports and every message, menu and number yours to change.

Features

  • A real homes menu. /homes opens numbered slots: set, empty (click to set it) or locked above the player's limit, with a button under each one. Prefer a long list? Switch to the paged, sortable list style.
  • Per-home settings. Right-click a home to rename it, give it a coloured fancy name and a description, pick its icon (from a menu or the item in your hand), pin it to the top or move it to where you're standing.
  • Cross-server homes. Put every server on the same MySQL, MariaDB or MongoDB database and /home takes players to homes on other servers, landing them exactly on the spot. Redis is optional.
  • Limits by rank. berryhomes.limit.<number>, named ranks, extra caps per world or server. Homes above a lost limit stay safe and come back when the rank does.
  • Warmups, cooldowns and costs. Shorter for ranks, cancelled by moving or taking damage, refunded if a teleport fails. Costs go through Vault.
  • Safe teleports. A home that's now lava, in the air or inside blocks asks "teleport anyway?" first.
  • Respects claims. No setting homes in someone else's WorldGuard region, GriefPrevention claim or Lands land.
  • Bring your homes. Import from EssentialsX, HuskHomes and ModernHome, and move between SQLite, MySQL and MongoDB with one command.
  • Light on your server. Homes load while the player logs in, never on the server thread. With 50 players spamming commands and menus, each action cost about 0.13 ms of server time (benchmark).
  • Custom items. Nexo, ItemsAdder and Oraxen items as menu icons and home icons.
  • PlaceholderAPI support, both ways.
  • An API with teleport, set and delete events for other plugins.

Requirements

Server Paper or Folia (and Paper forks like Purpur)
Minecraft 1.21.8 or newer
Java 21 or newer
Other plugins None needed. Vault, PlaceholderAPI, WorldGuard, GriefPrevention, Lands, Nexo, ItemsAdder and Oraxen are optional.
Network (optional) Velocity, plus a MySQL/MariaDB or MongoDB database shared by the servers

Where to next

  1. Install it.
  2. Set the limits for your ranks.
  3. Running a network? Read cross-server.
  4. Make the menus yours on the menus page.

Tip: stuck? The FAQ covers the usual questions, and our Discord has a Product Support ticket button.