ByteClans Homes is an official addon for ByteClans that adds a complete clan home system with support for multiple homes, default homes, teleport delays and configurable limits.
Allows clans to create and manage shared homes directly through ByteClans commands.
Homes are stored directly inside clan data containers and support automatic default-home assignment, teleport countdowns and configurable limits.
Designed to stay lightweight while integrating naturally with the existing ByteClans ecosystem.
- Multiple homes per clan.
- Configurable home limit.
- Default clan home support.
- Automatic first-home default assignment.
- Teleport countdown system.
- Home renaming support.
- Home deletion and automatic cleanup.
- Fully configurable messages.
- Suggestions/autocomplete support.
- Data stored directly in clan containers.
| Command | Description |
|---|---|
/clan home |
Teleport to the default clan home |
/clan home list |
View clan homes |
/clan home set <name> |
Create a clan home |
/clan home tp <name> |
Teleport to a specific home |
/clan home default <name> |
Set the default home |
/clan home rename <old> <new> |
Rename a home |
/clan home delete <name> |
Delete a home |
settings:
teleport-countdown: 5 # Seconds to wait before teleporting
limit: 3 # Maximum number of homes a clan can have
auto-default: true # Automatically sets the first created home as defaultRequired:
- ByteClans
- Paper 1.21.1+
- Java 21+
- Fork the repository.
- Create a branch:
git checkout -b feature/my-featureor
git checkout -b fix/my-fix- Commit changes and open a Pull Request.
Please follow the existing code style:
- Use
this.for instance fields. - Use
finalwhenever possible. - Avoid unnecessary allocations.
- Keep data access asynchronous whenever required.
- Maintain consistency with ByteClans APIs.
This project is released under the MIT License.
You are free to use, modify, and distribute it with attribution.