ByteClans is a lightweight and extensible clan plugin built for PaperMC servers running Minecraft 1.19 or higher.
It provides a clean and solid foundation for managing clans — giving server owners full control over roles, permissions, and clan settings,
while offering developers a stable API to build addons and integrations on top of.
It provides a clean and solid foundation for managing clans — giving server owners full control over roles, permissions, and clan settings,
while offering developers a stable API to build addons and integrations on top of.
If you need help, join the Discord server.
What is ByteClans?
ByteClans is a clan management plugin focused on simplicity, performance, and extensibility.
Players can create clans, invite others, manage roles, chat privately with their clan, track statistics, and configure PvP behavior — all through simple commands.
Server owners can fully customize roles, permissions, messages, and clan defaults through configuration files.
Developers can build addons using the public API, listening to events and interacting with managers without modifying the plugin itself.
ByteClans is a clan management plugin focused on simplicity, performance, and extensibility.
Players can create clans, invite others, manage roles, chat privately with their clan, track statistics, and configure PvP behavior — all through simple commands.
Server owners can fully customize roles, permissions, messages, and clan defaults through configuration files.
Developers can build addons using the public API, listening to events and interacting with managers without modifying the plugin itself.
Key Features
![[IMG]](//proxy.spigotmc.org/c10e5744b27788fe353e7359d219cf5b3e67dca1/68747470733a2f2f6d656469612e74656e6f722e636f6d2f646364344a754f2d614f67414141416a2f737469636b65722d6d696e6563726166742e676966)
- 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 (<red>, <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.
Why ByteClans?
ByteClans focuses on doing one thing well — providing a solid clan foundation that works on any server, regardless of game mode.
It ships with the essentials and stays out of the way. No forced mechanics, no bloat.
Features tied to a specific game mode — such as clan homes, territory claiming, or economy integration — are intentionally left out.
Instead, ByteClans provides a stable API so developers can build exactly what their server needs through addons.
Simple for server owners. Powerful for developers.
Commands
Installation
- Download the latest ByteClans release.
- Place the .jar file into your server's plugins/ folder.
- Start your server — configuration files will be generated automatically.
- Configure config.yml, messages.yml, and roles.yml to your liking.
- Restart your server.
Resource Information
Author:
----------
Total Downloads: 5
First Release: Mar 20, 2026
Last Update: Mar 20, 2026
Category: ---------------
All-Time Rating:
Find more info at github.com...0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings