ByteClans is a lightweight, extensible clan plugin for PaperMC servers.
It provides a clean, minimal clan system out of the box — designed to be extended via addons and built with developers in mind.
ByteClans focuses on doing one thing well: providing a solid clan foundation that server owners can configure and developers can build on top of.
The plugin ships with the essentials — clan creation, member management, invite system, chat modes, PvP settings and statistics — while staying lightweight and easy to extend.
If you need help, join the Discord server.
- Create, disband, leave and manage clans.
- Fully configurable role system via
roles.yml— add as many roles as you want. - Invite system with configurable expiration time.
- PvP mode per clan: No Damage, Safe Damage, Friendly Fire.
- Clan chat mode with per-player toggle.
- Kill, death and streak statistics tracked per clan.
- PlaceholderAPI support out of the box.
- No external database required — works out of the box.
- Performant and server-friendly by design.
- Clean developer API with events, managers and lookups — ready for addons.
- Download the latest ByteClans release from the releases page.
- Place the JAR inside your server's
plugins/folder. - Start your Paper server — config files will be generated automatically.
- Configure
config.yml,messages.ymlandroles.ymlto your liking. - Restart.
- Fork the repository.
- Create a branch:
git checkout -b feature/my-featureorgit checkout -b fix/my-fix - Commit your changes and open a Pull Request.
Please follow the existing code style:
- Use
this.for all instance field references. - Use
finalon parameters, local variables and fields wherever applicable. - Respect the module architecture — keep each layer responsible for its own concerns.
- No breaking changes to existing API interfaces without prior discussion.
ByteClans is designed to be a general-purpose clan plugin that works on any server, regardless of game mode.
Pull requests adding features that push the plugin towards a specific game mode — such as clan homes, territory claiming, economy integration, or similar — will be automatically rejected.
If you need features like those, the right approach is to create an addon that depends on ByteClans. The plugin provides a stable API precisely for that purpose.
This project is released under the MIT License.
You are free to use, modify, and distribute it with attribution.