Install Homes
Single server
- Place the Homes Paper JAR in the server plugins folder.
- Start once to generate the configuration files.
- Put your AP key in
plugins/Homes/config.ymland restart. - Leave network.mode as single-server. The default SQLite storage requires no external database.
- Open /homes and verify that creating, renaming and teleporting to a home works.
Networked setup
- Install the Homes Paper JAR on every backend.
- Install the Homes Velocity JAR on each proxy.
- Use the same network.mode everywhere and give each backend a server-name matching velocity.toml.
- Use shared MySQL, MariaDB or MongoDB storage. SQLite cannot be shared between servers.
- For cross-proxy mode, enable Redis and configure each proxy public host/port so clients can be transferred.
Client compatibility
The source includes a chest GUI fallback for older clients. ViaVersion/ViaBackwards are optional and improve client protocol detection in AUTO mode.