Advance ClanX

插件

· 作者 YourSenior

一款专业级、高性能的 Minecraft 服务器氏族管理系统。以极致可扩展性、极低资源占用和无缝玩家体验为核心构建。

0 本站下载 0 关注 更新于 9 个月前

最新 1.1.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

AdvanceClans

logo

1. 插件概述

名称: AdvanceClans (Advance ClanX)
版本: 1.0
描述: 一款面向 Minecraft 服务器的专业级、高性能氏族管理系统。专注于极致的可扩展性、最低的资源占用以及无缝的玩家体验。

2. 核心特性(性能)

性能分析

  • 极端负载处理:经过测试,支持每秒 30 次击杀/死亡。
  • 零 TPS 影响:所有数据库操作(点数更新、成员变更)均异步执行。主服务器线程永远不会被阻塞。
  • 内存效率:对在线玩家使用智能缓存(约 10-20MB 额外开销)。不使用 Bukkit.getOfflinePlayer().getName(),从而防止常见的“null”错误和卡顿。
  • 可扩展性:针对每个氏族 1,000+ 名成员 和 200+ 个活跃氏族进行了优化。
  • 数据库:使用带 WAL 模式(预写式日志)的 SQLite,以实现安全、并发的高速数据访问。

3. 命令与权限

玩家命令

命令 用法 描述 权限
/clan /clan 主 GUI 菜单。 clans.use
/clan create /clan create <name> 创建新氏族。 clans.create
/clan join /clan join <name> 申请加入氏族。 clans.join
/clan accept /clan accept 接受氏族邀请。 clans.accept
/clan leave /clan leave 离开当前氏族。 clans.leave
/clan info /clan info [clan] 查看氏族统计信息。 clans.info
/clan top /clan top 排行榜 GUI。 clans.top
/clan chat /clan chat 切换氏族聊天模式。 clans.chat
/clan home /clan home 传送至氏族出生点。 clans.home

领袖/管理员命令

命令 用法 描述 权限
/clan invite /clan invite <p> 邀请一名玩家。 clans.invite
/clan kick /clan kick <p> 踢出一名成员。 clans.kick
/clan disband /clan disband 解散氏族。 clans.disband
/clan sethome /clan sethome 设置出生点位置。 clans.sethome
/clan cowner /clan cowner set <p> 晋升为共同所有者。 clans.cowner
/clan set colour /clan set colour <c> 更改氏族颜色。 clans.set
/forceclan delete /forceclan delete <c> 管理员:删除氏族。 force.op
/forceclan remove /forceclan remove <c> <p> 管理员:移除成员。 force.op

4. PlaceholderAPI 集成

在记分板、标签页列表或聊天中使用这些占位符:

  • %advanceclans_clan% - 玩家的氏族名称。
  • %advanceclans_role% - 玩家的职位(LEADER, COOWNER, MEMBER)。
  • %advanceclans_points% - 氏族的总点数。
  • %advanceclans_color% - 氏族的显示颜色代码。
  • %clans_name% → 显示玩家的氏族名称。
  • %clans_name_plain% → 显示去除颜色代码后的玩家氏族名称。
  • %clans_list_<#>_name% → 显示排行榜中该位置氏族的名称。
  • %clans_list_<#>_leader% → 显示排行榜中该位置氏族的领袖。
  • %clans_list_<#>_point% → 显示排行榜中该位置氏族的点数余额。 注意:将 <#> 替换为排行榜中的排名数字(例如,第一名氏族使用 %clans_list_1_name%)。

5. 技术规格

  • 依赖项:需要 PlaceholderAPI。
  • 数据库结构:
    • clans:存储名称、领袖名称、点数、颜色和出生点位置。
    • members:存储 UUID、氏族名称、职位和 last_known_name(防止出现“null”问题)。
    • allies:存储氏族联盟关系。
  • 配置文件:
    • config.yml:核心限制和权限。
    • msg.yml:100% 可翻译的消息。
    • gui.yml / settingsgui.yml:完整的 GUI 自定义。

7. 数据存储内部逻辑

该插件采用多层方法来确保数据完整性和性能:

数据存储机制

  • 数据库引擎:带 WAL(预写式日志) 模式的 SQLite。这允许插件在写入数据库的同时从其中读取,从而防止在较简单的插件中常见的“数据库已锁定”错误。
  • 架构设计:
    • clans:用于元数据的主表(所有者名称、点数、颜色、出生点位置)。
    • members:连接玩家 UUID 与氏族名称的链接表。它包含一个 last_name 列,每次玩家加入时都会更新该列,确保即使玩家更改了名称或处于离线状态,插件也能在不查询 Mojang API 或使用 Bukkit 沉重的 getOfflinePlayer 方法的情况下显示其名称。
    • allies:一个简单的关系表,用于氏族之间的联盟。

功能逻辑

  • 异步执行:诸如 updatePoints、createClan 和 forceDeleteClan 等功能在单独的线程上运行。这意味着如果数据库保存数据需要 100ms,服务器的 TPS 仍能保持在完美的 20.0。
  • 智能缓存:启动时,插件将所有成员到氏族的关系到加载到一个 HashMap<UUID, String> 中。这使得插件能够以常数时间复杂度 (O(1)) 检查玩家是否在氏族中,而无需触及硬盘。
  • 原子更新:点数更新使用 SQL 算术运算(SET points = points + ?),而不是先读取、修改再写回。这防止了“竞争条件”,即同时发生的两次击杀可能会相互覆盖。
  • 持久化策略:任何更改都会立即保存到 SQLite 文件中。如果服务器意外崩溃,不会有任何点数丢失的风险。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源