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 that push the plugin toward a specific game mode — such as clan homes, territory claiming, economy integration, or similar — will be automatically rejected. If you need those kinds of features, you have two supported paths:
- Create an addon that depends on ByteClans. The plugin provides a stable API specifically for extending functionality without bloating the core.
- Fork the project and adapt it to your needs if your use case requires tighter integration or custom behavior.
This project is released under the MIT License.
You are free to use, modify, and distribute it with attribution.