Hommr
Easily set, teleport, and manage your homes.
Hommr
<div align="center"> <img src="https://github.com/AxenoDev/Hommr/blob/master/.github/hommr.png?raw=true" alt="Hommr Logo" width="200"> <br>
<br>
</div>
Hommr is a simple, lightweight, and modern home management plugin for Minecraft servers running Paper. It allows players to set, delete, and teleport to multiple homes with ease.
✨ Features
- 📍 Modern Tech: Players can set multiple homes to save important locations. - 🚀 Modern Tech: Quick teleportation to saved homes. - 📋 Modern Tech: View a list of all your saved homes with world information. - 🔐 Modern Tech: Control who can set homes and how many homes they can have. - 🛠️ Modern Tech: Events and API methods for other plugins to hook into. - 💻 Modern Tech: Built with the latest technologies (Java 21, Paper API).
📥 Installation
1. Download the latest release from the Releases page. 2. Place the JAR file into your server's `plugins` folder. 3. Restart your server.
🎮 Commands & Permissions
| Command | Description | Permission | |-------------------|----------------------------------------------------------|---------------------------------| | `/home [name]` | Teleport to a specific home (or list if none specified). | `hommr.home.list` (for listing) | | `/sethome <name>` | Set a new home at your current location. | `hommr.home.set` | | `/delhome <name>` | Delete an existing home. | `hommr.home.delete` | | `/home list` | List all your saved homes. | `hommr.home.list` | | `/home help` | Show the help menu. | - |
⚙️ Configuration
The `config.yml` file is automatically generated when you first run the plugin. Currently, it is minimal, but more options will be added in future updates.
👨💻 Developer API
Hommr provides an API for developers to interact with the plugin. You can listen to events such as `HomeSetEvent`, `HomeDeleteEvent`, and `HomeTeleportEvent`.
Maven Dependency
To use the API, add the following to your `build.gradle`:
```groovy repositories { maven { url = uri("https://jitpack.io") } }
dependencies { compileOnly "com.github.AxenoDev:Hommr:VERSION" } ```
Replace `VERSION` with the latest version from the releases.
📄 License
This project is licensed under the GNU GENERAL PUBLIC LICENSE v3.0.