ByteClans

ByteClans

PaperMC 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.

---

<i>If you need help, join the Discord server.</i>

---

Key Features

Developer API: Players can create, disband, leave, and manage their clan through simple commands such as /clan create, /clan disband, and /clan leave.
Developer API: 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.
Developer API: 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.
Developer API: Send clan invitations to online players. Invitations expire automatically based on a configurable TTL (time-to-live) defined in config.yml.
Developer API: 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.
Developer API: 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). Developer API: Each clan tracks total kills, deaths, kill/death ratio, and kill streaks. Statistics update automatically when clan members kill or are killed.
Developer API: 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.
Developer API: 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.
Developer API: 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.

---

Showcase

---

Installation

1. Download the latest ByteClans release from the ByteClans. 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.