ClanForge 是一款面向 Spigot/Paper(1.20+)的现代模块化 Clan 插件。它专注于公平的 PvP、社区建设以及服务器友好的管理工具。ClanForge 提供灵活的角色等级与权限系统、经济集成、领地共享挂钩、战争系统、聊天频道、排行榜,并为开发者提供了简洁的 API。其目标是功能丰富,同时保持可配置性与高性能。
主要特性
-
支持默认角色等级(领袖、受信任者、成员)及自定义角色的氏族管理。
-
通过 Vault 支持经济系统:银行、维护费、成员费用以及击杀奖励。
-
领地共享集成:WorldGuard、PlotSquared、GriefPrevention。
-
战争、同盟、敌对关系、友军伤害控制以及重生/回家功能。
-
KDR 追踪、通过命令或 GUI 查看的排行榜、公告板。
-
氏族与同盟聊天,支持间谍模式及 PlaceholderAPI 占位符。
-
支持 MySQL 和 SQLite 存储(可配置)。
-
对开发者友好的 API,包含 25+ 个计划中的事件。
-
投票流程、可驯服生物共享规则、生命值/坐标共享。
-
智能 Tab 补全与精致的用户体验。 当前状态(诚实概述)
-
已实现:基础插件、/clan 命令(create、info、leave、list)、内存中的氏族管理器、配置文件与软依赖项、Vault 挂钩、基础 PlaceholderAPI 扩展、存储框架(MySQL/SQLite)。
-
进行中/计划中:完整持久化(架构/CRUD)、GUI 菜单、战争管理、领地共享规则、管理命令、扩展 API 事件、Discord 集成以及网页统计数据。 集成
-
可选依赖项:Vault、PlaceholderAPI、WorldGuard、PlotSquared、GriefPrevention。
-
ClanForge 会在检测到这些插件时自动进行挂钩,并在 config.yml 中提供功能开关。 命令(初始版本)
-
/clan create <name> - 创建一个新的氏族。
-
/clan info - 显示你的氏族详情。
-
/clan leave - 离开你当前的氏族。
-
/clan list - 列出已有的氏族。
-
其他命令(角色等级、战争、银行、聊天、同盟)将随着模块的成熟逐步添加。 配置与存储
-
config.yml 允许你启用/禁用模块、设置经济数值,并选择 mysql 或 sqlite。
-
默认采用轻量级的内存操作模式;生产环境服务器应配置持久化存储。 为什么选择 ClanForge
-
平衡且对服务器友好的设计,每个系统都有清晰的开关选项。
-
代码库整洁,API 易于扩展或与你的生态系统集成。
-
基于路线图开发,透明地展示已实现与计划中的功能。
付费版本
想要获得功能更全面的 ClanForge 付费版,享受高级系统、优先更新和延长支持吗?
在此获取付费版本:
ClanForge is a modern, modular clans plugin for Spigot/Paper (1.20+). It focuses on fair PvP, community building, and server-friendly management tools. ClanForge provides flexible ranks and permissions, economy integration, land sharing hooks, wars, chat channels, leaderboards, and a clean API for developers. It aims to be feature-rich while remaining configurable and performant.
Key Features
-
Clan management with default ranks (leader, trusted, member) and custom roles.
-
Economy support via Vault : banks, upkeep, member fees, and kill rewards.
-
Land sharing integrations: WorldGuard , PlotSquared , GriefPrevention .
-
Wars, alliances, rivalries, friendly fire controls, and regroup/home.
-
KDR tracking, leaderboards via commands or GUI, bulletin boards.
-
Clan and alliance chat with spy mode, PlaceholderAPI placeholders.
-
Storage support for MySQL and SQLite (configurable).
-
Developer-friendly API with 25+ planned events.
-
Voting flows, tamable mobs sharing rules, vitals/coordinates sharing.
-
Smart tab completions and polished UX. Current State (honest overview)
-
Implemented: base plugin, /clan command ( create , info , leave , list ), in-memory clan manager, config and soft-dependencies, Vault hook, basic PlaceholderAPI expansion, storage scaffolding (MySQL/SQLite).
-
In progress/planned: full persistence (schema/CRUD), GUI menus, war management, land sharing rules, moderation commands, extended API events, Discord integration, and web stats. Integrations
-
Optional dependencies: Vault , PlaceholderAPI , WorldGuard , PlotSquared , GriefPrevention .
-
ClanForge detects and hooks these when present, with feature toggles in config.yml . Commands (initial)
-
/clan create <name> - create a new clan.
-
/clan info - show your clan details.
-
/clan leave - leave your current clan.
-
/clan list - list existing clans.
-
Additional commands (ranks, wars, bank, chat, alliances) are being added as modules mature. Configuration & Storage
-
config.yml lets you enable/disable modules, set economy values, and choose mysql or sqlite .
-
Default is lightweight, in-memory operation; production servers should configure persistence. Why Choose ClanForge
-
Balanced, server-friendly design with clear toggles for every system.
-
Clean codebase and API to extend or integrate with your ecosystem.
-
Roadmap-driven development with transparency about what’s implemented vs planned.
Paid Version
Looking for the full-featured version of ClanForge with advanced systems, priority updates, and extended support?
Get the Paid Version here:
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Clan Forge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.2.0] - 2026-11-17
Added
- 支持运行在 Java 25 运行时环境下的 Paper Minecraft 26.3(io.papermc.paper:paper-api:26.3.build.253-stable)。
- 使用 Shadow 8.3.6 和 Foojay JVM 工具链解析器约定升级了 Gradle 构建管线。
- SQLite 和 MySQL 的数据库架构版本 4 自动迁移,包含永久性的 clan_id UUID 列。
- 将氏族任务系统外部化,支持 quests.yml、Vault 货币奖励、控制台命令执行以及 /clan quest [list|info]。
- 自动化的 7 天每周任务重置计划,具有磁盘持久化功能(quest_reset.dat)。
- 跨服务器重启保存的持久性能力冷却跟踪,存储在 ability_cooldowns.yml 中。
- 战争旁观者模式,支持实时分数更新、领土警报以及 /clan war spectate <clan1> <clan2> / /clan war unspectate。
- 带有交互式可点击集气点冒险聊天通知,支持通过 /clan tprally warm-up 进行传送预热。
- 氏族活动跟踪和管理员不活跃清理命令(/aclan purge inactive <days>)。
- 氏族赛季重置命令(/aclan season reset|confirm),在重置进度时保留领地声明。
- 彩色氏族标签占位符(%clanforge_tag_colored%)和可选的自动聊天前缀添加(chat.prepend-clan-tag)。
- 基于等级优先级的氏族箱子权限强制执行(claims.chest-min-rank-priority)。
- 邮箱容量限制、30 天消息自动过期以及分页邮箱浏览功能(/clan mail list [page])。
- ClanForge 中的公共 API 服务访问器(getWarService()、getQuestService()、getAbilityService())。
Fixed
- 修复了氏族重命名导致战争、联盟和关系断裂的问题,通过将重新计算的 UUID 替换为稳定的随机 UUID 来解决。
- 实现了 - 区块移动变化检测,修复了 TRAVEL 任务目标未追踪距离的问题。
- 修复了 EconomyTask 维护费逻辑在开启费用时立即向氏族收费的问题。
- 通过将状态集合转换为 ConcurrentHashMap 和 CopyOnWriteArrayList,修复了战争系统的并发异常。
- 引入了针对前 100 名排名的 30 秒易失性缓存,修复了排行榜主线程延迟尖峰问题。
- 修复了在处理解散的对手氏族期间 removeRival() 时可能出现的 NullPointerException。
- 修复了硬编码的领地等级优先级 50,改为通过 clan.claim-min-rank-priority 进行配置,并首先检查显式等级权限。
[1.1.0] - 2026-08-03
新增
- 数据库迁移与自动架构升级(SQLite
user_version、MySQLclanforge_schema)。 - 专用持久化执行器上的异步存储;MySQL 使用 HikariCP 连接池。
- WorldGuard v6/v7、GriefPrevention 和 PlotSquared v6/v7 的土地共享集成(基于反射机制)。
- 完整的领地保护套件(包括桶、悬挂实体、可驯服生物、爆炸、活塞、液体、火焰、践踏)。
- 全局及按氏族设置的友军火力开关;支持氏族及其盟友共享可驯服生物。
- 持久的战争系统,包含时间/分数结束条件、占领进度以及投降机制。
- 可选的氏族维护费用与成员费用,并设有宽限期(
EconomyTask)。 - 氏族聊天频道与管理员间谍模式,用于氏族间通信。
- 氏族投票(
/clan vote <clan>)、公告板以及带有冷却时间的家园重新集结功能。 - 管理员命令:
/aclan verify <clan>、/aclan permanent <clan>、/aclan wars [end <clan>]。 - 验证状态与永久氏族状态在所有存储后端中持久化保存。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧