ByteClans

ByteClans

<p align="center"> <a href="https://www.java.com/"> <img src="https://img.shields.io/badge/Java-21+-blue" alt="Java"/> </a> <a href="https://papermc.io/"> <img src="https://img.shields.io/badge/PaperMC-1.19%2B-green" alt="PaperMC"/> </a> <a href="license"> <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"/> </a> <a href="https://discord.com/invite/3K9yrZQRmS"> <img src="https://img.shields.io/discord/1350369915521204276?label=Discord&color=7289DA&logo=discord&logoColor=white" alt="Discord"/> </a> </p>

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.

---

<p align="center"> <a href="https://discord.com/invite/3K9yrZQRmS"> <img src="https://imgur.com/DvyC4jL.png" width="600" alt="ByteSessionRestore preview"> </a> <br/> <i>If you need help, join the Discord server.</i> </p>

---

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.<br> 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.<br> 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.<br> Developer API: Send clan invitations to online players. Invitations expire automatically based on a configurable TTL (time-to-live) defined in config.yml.<br> 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.<br> 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.<br> 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.<br> 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.<br> Developer API: All messages support both MiniMessage format (<red>, <gradient:gold:yellow>) and Legacy Ampersand format (&c, &l) — configurable in config.yml.<br> 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.