ByteClans
ByteClans 是一款轻量级、可扩展的 PaperMC 服务器模组插件。
它开箱即用,提供简洁极简的氏族系统——旨在通过附加组件进行扩展,并充分考虑了开发者的需求。
我们建议查看 GitHub 仓库发布页面中的最新版本,因为最新的更新可能尚未发布在 Modrinth 或其他平台上。
概览
ByteClans 专注于做好一件事:提供一个坚实的氏族基础,供服务器管理员配置,并让开发者在此基础上构建。
该插件内置了核心功能——包括氏族创建、成员管理、邀请系统、聊天模式、PvP 设置和统计信息——同时保持轻量级且易于扩展。
如果您需要帮助,请加入 Discord 服务器。
主要特性
氏族管理:玩家可以通过简单的命令(如 /clan create、/clan disband 和 /clan leave)来创建、解散、离开和管理自己的氏族。
成员管理:使用 /clan invite send 邀请玩家,使用 /clan kick 踢出成员,使用 /clan promote 和 /clan demote 提升或降低权限,并使用 /clan transfer 转移所有权。
灵活的职位系统:在 roles.yml 中定义无限数量的职位。每个职位都有显示名称、优先级以及一组允许的操作——例如邀请成员、踢人、管理设置或解散氏族。
邀请系统:向在线玩家发送氏族邀请。邀请会根据 config.yml 中配置的 TTL(存活时间)自动过期。
氏族聊天:玩家可以使用 /clan chat clan 切换到氏族聊天模式,此时只有氏族成员能看到消息。使用 /clan chat public 切换回公共聊天。
按氏族设置 PvP 模式:服务器管理员可以设置氏族成员之间的默认 PvP 行为。可用模式包括 NO_DAMAGE(成员之间无法互相造成伤害)、SAFE_DAMAGE(允许造成伤害但不会致死)和 FRIENDLY_FIRE(成员之间造成全额伤害)。
统计信息追踪:每个氏族都会追踪总击杀数、死亡数、击杀/死亡比(KDR)和击杀连胜记录。当氏族成员击杀或被击杀时,统计信息会自动更新。
PlaceholderAPI 支持:ByteClans 提供了一整套占位符,用于氏族名称、显示名称、所有者、成员数量、击杀数、死亡数、KDR、连胜记录、PvP 模式、邀请状态等——可直接用于计分板、聊天前缀和其他插件。
无需外部数据库:ByteClans 默认使用内置的 H2 数据库——无需 MySQL 或外部设置。只需将 JAR 文件放入 plugins 文件夹即可运行。对于偏好 MySQL 的服务器,也支持 MySQL。
MiniMessage 和旧版格式支持:所有消息均支持 MiniMessage 格式(如 <red>、<gradient:gold:yellow>)和旧版 Ampersand 格式(如 &c、&l)——可在 config.yml 中配置。
开发者 API:ByteClans 提供了一个清晰的公共 API,包含管理器、查找器、验证器和可取消的事件。开发者可以构建与氏族系统交互的附加组件,而无需触碰插件的内部实现。
展示
安装
- 从 发布页面 下载最新的 ByteClans 版本。
- 将 JAR 文件放入服务器的
plugins/文件夹中。 - 启动 Paper 服务器——配置文件将自动生成。
- 根据需要配置
config.yml、messages.yml和roles.yml。 - 重启服务器。
许可证
本项目根据 MIT 许可证 发布。
您可以自由使用、修改和分发,但需注明出处。
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 (<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
- Download the latest ByteClans release from the releases page.
- Place the JAR inside your server's
plugins/folder. - Start your Paper server — config files will be generated automatically.
- Configure
config.yml,messages.ymlandroles.ymlto your liking. - Restart.
License
This project is released under the MIT License.
You are free to use, modify, and distribute it with attribution.
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ByteClans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
修复:在所有权转移后正确处理氏族成员数据
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧