{"id":36212,"date":"2026-06-01T20:54:58","date_gmt":"2026-06-01T17:54:58","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/byteclans\/"},"modified":"2026-06-01T20:54:58","modified_gmt":"2026-06-01T17:54:58","slug":"byteclans","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/byteclans\/","title":{"rendered":"ByteClans"},"content":{"rendered":"

# ByteClans<\/p>\n

\n

\"Java\"\/<\/p>\n

\"PaperMC\"\/<\/p>\n


\n \"License\"\/
\n <\/a><\/p>\n

\"Discord\"\/<\/p>\n

**ByteClans** is a lightweight, extensible clan plugin for **PaperMC** servers.
\nIt provides a clean, minimal clan system out of the box \u2014 designed to be extended via addons and built with developers in mind.<\/p>\n

—<\/p>\n

“`
\nWe 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.
\n“`<\/p>\n

—<\/p>\n

## Overview<\/p>\n

ByteClans focuses on doing one thing well: providing a solid clan foundation that server owners can configure and developers can build on top of.
\nThe plugin ships with the essentials \u2014 clan creation, member management, invite system, chat modes, PvP settings and statistics \u2014 while staying lightweight and easy to extend.<\/p>\n

—<\/p>\n

\n

\"ByteSessionRestore<\/p>\n

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

—<\/p>\n

## Key Features<\/p>\n

**Clan Management**: Players can create, disband, leave, and manage their clan through simple commands such as \/clan create, \/clan disband, and \/clan leave.
\n**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.
\n**Flexible Role System**: Define unlimited roles in roles.yml. Each role has a display name, priority level, and a set of allowed actions \u2014 such as inviting members, kicking, managing settings, or disbanding the clan.
\n**Invite System**: Send clan invitations to online players. Invitations expire automatically based on a configurable TTL (time-to-live) defined in config.yml.
\n**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.
\n**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).
\n**Statistics Tracking**: Each clan tracks total kills, deaths, kill\/death ratio, and kill streaks. Statistics update automatically when clan members kill or are killed.
\n**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 \u2014 ready to use in scoreboards, chat prefixes, and other plugins.
\n**No External Database Required**: ByteClans uses an embedded H2 database by default \u2014 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.
\n**MiniMessage and Legacy Support**: All messages support both MiniMessage format (, ) and Legacy Ampersand format (&c, &l) \u2014 configurable in config.yml.
\n**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.<\/p>\n

—<\/p>\n

## Showcase
\n