ByteClans

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.

We recommend checking the latest versions in the GitHub repository releases, as the most recent updates may not yet be published on platforms such as Modrinth or others.

Overview

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.

Key Features

Clan Management: Players can create, disband, leave, and manage their clan through simple commands such as /clan create, /clan disband, and /clan leave.
Member Management: Invite players with /clan invite send, kick members with /clan kick, promote or demote with /clan promote and /clan demote, and transfer ownership with /clan transfer.
Flexible Role System: Define unlimited roles in roles.yml. Each role has a display name, priority level, and a set of allowed actions — such as inviting members, kicking, managing settings, or disbanding the clan.
Invite System: Send clan invitations to online players. Invitations expire automatically based on a configurable TTL (time-to-live) defined in config.yml.
Clan Chat: Players can switch to clan chat mode using /clan chat clan to send messages only visible to clan members. Switch back to public chat with /clan chat public.
PvP Mode Per Clan: Server owners can set a default PvP behavior between clan members. Available modes are NO_DAMAGE (members cannot damage each other), SAFE_DAMAGE (damage is allowed but cannot kill), and FRIENDLY_FIRE (full damage between members). Statistics Tracking: Each clan tracks total kills, deaths, kill/death ratio, and kill streaks. Statistics update automatically when clan members kill or are killed.
PlaceholderAPI Support: ByteClans provides a full set of placeholders for clan name, display name, owner, member count, kills, deaths, KDR, streaks, PvP mode, invite state, and more — ready to use in scoreboards, chat prefixes, and other plugins.
No External Database Required: ByteClans uses an embedded H2 database by default — no MySQL or external setup needed. Simply drop the JAR into your plugins folder and you're ready to go. MySQL is also supported for servers that prefer it.
MiniMessage and Legacy Support: All messages support both MiniMessage format (, gradient:gold:yellow) and Legacy Ampersand format (&c, &l) — configurable in config.yml.
Developer API: ByteClans exposes a clean public API with managers, lookups, validators, and cancellable events. Developers can build addons that interact with the clan system without touching the plugin's internals.

Showcase

Installation

1. Download the latest ByteClans release from the releases page.
2. Place the JAR inside your server's plugins/ folder.
3. Start your Paper server — config files will be generated automatically.
4. Configure config.yml, messages.yml and roles.yml to your liking.
5. Restart.

License

This project is released under the MIT License.
You are free to use, modify, and distribute it with attribution.