sidaHomes

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

1. Build or download the plugin JAR. 2. Place the JAR in your server `plugins/` folder. 3. Start or restart the server. 4. Edit `plugins/SiDaHomes/config.yml` as needed. 5. 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

```bash ./gradlew build ```

On Windows (PowerShell):

```powershell .gradlew.bat build ```

Compiled JAR output:

`build/libs/`