SiDa Homes

A professional home-management plugin for Paper servers. SiDa Homes provides a clean GUI workflow, persistent SQLite storage, invite-based home sharing, and admin tooling for server moderation.

About

SiDa Homes is designed for servers that want reliable player homes without unnecessary complexity. It supports modern Paper command registration, async data operations, configurable limits, teleport cooldown/delay handling, and optional LuckPerms-based group limits.

Requirements

Server: Paper 1.21+
Java: 21
Optional: LuckPerms (for group-based home limits)

Installation

Build or download the plugin JAR.
Place the JAR in your server plugins/ folder.
Start or restart the server.
Edit plugins/SiDaHomes/config.yml as needed.
Use /sidahomesreload after config changes.

Commands

Player

Command	Description
`/sethome <name>`	Set a home at your current location
`/home`	Open the home GUI
`/home <name>`	Teleport to one of your homes
`/home <player>:<home>`	Visit an invited home
`/delhome <name>`	Delete one of your homes (with confirmation GUI)
`/homeinvite <player> <home>`	Invite a player to one of your homes
`/homesettings`	Toggle home GUI detail display

Admin

Command	Description
`/homeadmin list <player>`	List a player's homes
`/homeadmin delete <player> <home>`	Delete a player's home
`/homeadmin teleport <player> <home>`	Teleport to a player's home
`/homeadmin export`	Export homes data to CSV
`/homeadmin import`	Import homes data from CSV
`/sidahomesreload`	Reload plugin configuration

Permissions

Permission	Default	Description
`sidahomes.sethome`	`true`	Set homes
`sidahomes.home`	`true`	Use `/home` and `/homesettings`
`sidahomes.delhome`	`true`	Delete own homes
`sidahomes.invite`	`true`	Invite players to homes
`sidahomes.bypass.cooldown`	`op`	Bypass teleport cooldown
`sidahomes.bypass.delay`	`op`	Bypass teleport delay
`sidahomes.admin.list`	`op`	List player homes
`sidahomes.admin.delete`	`op`	Delete any player's home
`sidahomes.admin.teleport`	`op`	Teleport to any player's home
`sidahomes.admin.reload`	`op`	Reload config
`sidahomes.admin.import`	`op`	Import homes data
`sidahomes.admin.export`	`op`	Export homes data
`sidahomes.admin.*`	`op`	All admin permissions

Configuration

Main settings are in plugins/SiDaHomes/config.yml:

database: storage backend and file name
limits: default and group-based home limits
cooldown: teleport cooldown settings
teleport: delay and movement-cancel behavior
messages: MiniMessage-formatted plugin messages
gui: GUI titles, names, and lore

Build From Source

./gradlew build

On Windows (PowerShell):

.\gradlew.bat build

Compiled JAR output:

build/libs/