FAQ
Do Paper and Folia need different jars?
No. One jar works on both.
Does it need any other plugins?
No. Vault (for costs), PlaceholderAPI, WorldGuard, GriefPrevention, Lands, Nexo, ItemsAdder and Oraxen are all optional.
Will my players lose their EssentialsX, HuskHomes or ModernHome homes?
No. /ahome convertall imports EssentialsX homes, /ahome import huskhomes imports HuskHomes, /ahome import modernhome imports ModernHome. Add dryrun to check first. See storage & importing.
/home runs the wrong plugin's command
Another plugin (often EssentialsX) also has /home. Remove it from that plugin (for EssentialsX, add home, sethome, delhome and homes to disabled-commands in its config), or rename BerryHomes' commands in config.yml.
Homes from my other server don't show up
Every server must use the same database (not SQLite) and the same table-prefix, and each needs its own server-name. See cross-server.
Players arrive at spawn instead of the home on the other server
Check the target server's server-name matches its name in velocity.toml exactly, and that the server can reach the database. /ahome debug on each server shows the storage and server name it's using.
A player lost a rank. What happens to their extra homes?
With over-limit: lock (the default) they're kept and shown as locked, and come back when the rank does. With keep they stay usable; the player just can't set new ones.
How do I give a rank more homes?
Give them berryhomes.limit.<number> (e.g. berryhomes.limit.8), or add a named rank under limits.ranks and give berryhomes.limit.<rank>.
Can players use colours in home names?
In fancy names, yes (/home rename <home> <gradient:#5CE1C1:#3BA8FF>Base, or the menu). The plain name used in /home <name> stays simple so it's easy to type. Take berryhomes.fancynames.colors away to allow fancy names without colours.
Can I use custom items from Nexo, ItemsAdder or Oraxen?
Yes, as menu items and home icons: material: nexo:<id>, itemsadder:<namespace>:<id> or oraxen:<id>.
Does it work with Geyser / Bedrock players?
It hasn't been tested with Geyser yet. The menus are normal chest menus; if typing names in the anvil is awkward for Bedrock players, set text-input.mode: chat.