BHomes

BHomes

A simple home-management plugin for Paper servers, forked from SiDaHomes.

BHomes provides persistent SQLite storage, configurable limits, teleport cooldown/delay handling, optional LuckPerms-based group limits, and a full TPA system with blocked player management.

About

BHomes is designed for servers that want reliable player homes without unnecessary complexity. it supports modern paper command registration, and configurable limits. (Now with foila support!)

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/BHomes/config.yml as needed.
5. Use /bhomesreload after config changes.

Commands

Player

Admin

Permissions

Configuration

Main settings are in plugins/BHomes/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
• tpa: TPA request timeout configuration
• messages: MiniMessage-formatted plugin messages (includes TPA messages with clickable accept/deny buttons)

TPA Features

• /tpa <player> — Send a teleport request to a player
• /tpahere <player> — Ask a player to teleport to you
• /tpablock <player> — Toggle blocking TPA requests from a player
• /tpaaccept [player] — Accept a pending request (with optional player name to accept a specific one)
• /tpadeny [player] — Deny a pending request
• Clickable accept/deny buttons — Received requests show green [ACCEPT] and red [DENY] buttons in chat
• Request timeout — Configurable expiry via tpa.timeout in config.yml
• Blocked players — Stored in the same SQLite database, persisted across restarts
• Folia-compatible — Uses player-based schedulers for teleport delays

Build From Source

./gradlew build

Compiled JAR output:

build/libs/