mClans
持久化、带等级体系的氏族,支持外交、家园、银行与进度系统,适用于 Paper、Purpur 和 Folia。
功能介绍
- 实现创建、邀请、加入、离开、踢出、晋升、降级及确认解散等完整流程。
- 强制执行唯一名称/标签、保留字、所有者保护及角色层级体系。
- 氏族从五名成员开始,并通过积分等级扩展配置的最大人数上限。
- 提供 PvP 积分奖励,并针对每个击杀者/受害者设置防刷冷却时间。
- 提供符合 Folia 安全机制的友军伤害保护及私有氏族聊天功能。
- 使用追加式账本存储氏族金库及每笔余额变动记录。
- 将金库连接至 Vault,支持存款及权限控制的取款操作。
- 支持确认的所有权转移及管理离线氏族成员。
- 提供相互联盟、敌对/中立关系,以及可选的盟友间 PvP 保护。
- 提供一个共享的氏族家园,可配置传送冷却时间。
- 展示排名前十的最高分氏族,采用确定性排名算法。
- 通过只读 GUI 展示氏族进度及成员信息。
- 通过 Bukkit Services 暴露成员资格及盟友状态检查接口。
默认配置下无需可选依赖即可游玩。在修改 economy.creation-cost(经济创建成本)之前,创建氏族是免费的。战争、领地主张及跨代理同步均为独立模块,因此启用社交核心不会悄无声息地改变世界保护或 PvP 规则。
要求
- Java 25
- Paper、Purpur 或 Folia 26.3
仅当非零创建成本及银行转账时才需要 Vault 和经济插件支持。mReputation、mBadges 和 PlaceholderAPI 仅为可选集成目标。核心插件可在无它们的情况下启动。
命令
/clan create <name> <tag>
/clan invite <player> 和 /clan accept <name|tag>
/clan info [name|tag]
/clan leave, /clan kick <player>
/clan promote|demote <player>
/clan transfer <player> confirm
/clan ff <on|off>
/clan bank [balance|deposit|withdraw] [amount]
/clan sethome 和 /clan home
/clan ally|enemy|neutral <name|tag>
/clan top
/clan disband confirm
/cc <message>
/clan reload
权限:mclans.use、mclans.admin、mclans.reload。
语言与配置
默认选择英语。设置 language: ru_RU 并运行 /clan reload 可将界面切换为俄语。生成的 config.yml 中记录了名称、标签、邀请过期时间、等级阈值、成员上限、PvP 奖励、家园冷却时间、盟友保护、经济成本及遥测数据的配置说明。
存储
氏族状态使用专用虚拟线程上的版本化本地 H2 数据库。创建和加入过程具有事务性。名称和标签在数据库层保持唯一,接受邀请时会重新检查成员容量,氏族所有者无法无声离开,且金库余额不能变为负数。
构建
./gradlew clean build
插件 JAR 文件输出至 build/libs;Bukkit Services API 构建于 api/build/libs。
根据 MIT 许可证授权。
mClans
Persistent, levelled clans with diplomacy, homes, banking, and progression for Paper, Purpur, and Folia.
What it does
- Implements create, invite, join, leave, kick, promote, demote and confirmed disband flows.
- Enforces unique names/tags, reserved words, owner protection and role hierarchy.
- Starts clans at five members and expands the configured limit through point levels.
- Awards PvP points with a per-killer/per-victim anti-farm cooldown.
- Provides Folia-safe friendly-fire protection and private clan chat.
- Stores the clan bank and every balance change in an append-only ledger.
- Connects the bank to Vault for deposits and permission-controlled withdrawals.
- Supports confirmed ownership transfers and managing offline clan members.
- Provides mutual alliances, enemy/neutral relations, and optional allied PvP protection.
- Provides one shared clan home with a configurable teleport cooldown.
- Shows the ten highest-scoring clans with deterministic ranking.
- Shows clan progression and members in a read-only GUI.
- Exposes membership and ally checks through Bukkit Services.
The default configuration is playable without optional dependencies. Clan creation is free until economy.creation-cost is changed. Wars, claims and cross-proxy synchronization remain separate modules so enabling the social core does not silently alter world protection or PvP rules.
Requirements
- Java 25
- Paper, Purpur or Folia 26.3
Vault and an economy provider are required only for a non-zero creation cost and bank transfers. mReputation, mBadges and PlaceholderAPI remain optional integration targets. The core plugin starts without them.
Commands
/clan create <name> <tag>
/clan invite <player> and /clan accept <name|tag>
/clan info [name|tag]
/clan leave, /clan kick <player>
/clan promote|demote <player>
/clan transfer <player> confirm
/clan ff <on|off>
/clan bank [balance|deposit|withdraw] [amount]
/clan sethome and /clan home
/clan ally|enemy|neutral <name|tag>
/clan top
/clan disband confirm
/cc <message>
/clan reload
Permissions: mclans.use, mclans.admin, mclans.reload.
Language and configuration
English is selected by default. Set language: ru_RU and run /clan reload to switch the interface to Russian. Names, tags, invitation expiry, level thresholds, member limits, PvP rewards, home cooldown, allied protection, economy cost and telemetry are documented in the generated config.yml.
Storage
Clan state uses a versioned local H2 database on a dedicated virtual thread. Creation and joining are transactional. Names and tags are unique at the database layer, member capacity is rechecked while accepting an invite, a clan owner cannot silently leave, and the bank cannot become negative.
Build
./gradlew clean build
The plugin JAR is written to build/libs; the Bukkit Services API is built in api/build/libs.
Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧