KyveraClans

插件

· 作者 roxyboy2474

KyveraClans:支持个人资料、角色、邀请和专用聊天的模组——包含菜单、管理员管理和自动备份功能,适用于 Paper 服务器。

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

最新 1.2.3-RELEASE · 26.2 · Paper

一键开服(送7天)

Kyvera Clans

组建你的团队。打造专属风格。保持全员互联。

通过 Kyvera Clans 将你的社区凝聚在一起,这是一个专为 Paper 服务器设计的基于菜单的公会系统。玩家可以创建自己的公会,邀请好友,管理成员并进行私密交流。管理员可以通过游戏内设置和可选集成来掌控全局。

无论是简单的生存社区还是城市建造服务器,都能启用适合你玩家的功能。

版本 1.2.4 · 英文与德文 · 服务端插件
作者:kyvera Studios


每个团队的归属地

为你的公会赋予身份标识:自定义名称、显示标签、颜色和描述。其个人资料页汇集了队长信息、成立日期、成员列表以及招募状态。

通过三种角色管理你的团队:

角色 职责
队长 (Leader) 管理公会资料,任命官员,转让领导权并解散公会
官员 (Officer) 处理邀请和申请,移除普通成员
成员 (Member) 参与公会并使用已授权的功能

官员无法移除队长或其他官员。敏感操作需要确认。

玩家同时只能属于一个公会。创建或加入公会时,会自动清除该玩家其他待处理的邀请和申请。

结构化的固定位置菜单

减少在设置中搜索的时间。

菜单功能会保持其分配的位置,即使其他功能被禁用也是如此。内容保持在框架内,导航始终位于底部行。

队长和官员拥有专用的 公会设置 页面,其中包含清晰分离的控制选项:

  • 个人资料: 名称、颜色、显示标签和描述
  • 招募: 招募状态和申请
  • 成员: 邀请、成员列表和角色管理
  • 管理: 带有确认机制的公会删除

可用控件遵循玩家角色和服务端启用的功能。

邀请好友。欢迎新成员。

发送直接邀请或将公会开放为申请制。

玩家可以逐个查看邀请,查看是谁发出的,并检查剩余时间。他们还可以撤回自己待处理的申请。

关闭招募会阻止新的申请,但保留直接邀请。过期的条目会自动清理,登录提醒会突出显示未处理的邀请和申请。

让公会对话保持集中

使用 /clan chat 切换公共和私人聊天,或者在不改变聊天模式的情况下发送一条公会消息:

/clan chat <message>

你可以独立于 outgoing(发出)聊天模式来静音 incoming(接收)公会消息。

聊天通知使用一致的前缀、易读的颜色和清晰的说明。输入提示包括时间限制和可点击的取消选项。

如果私人公会聊天不可用,消息将被拦截而不是公开发送。


选择服务器所需的功能

核心公会系统无需经济插件即可运行。可选模块让你可以在准备好时进行扩展。

在新安装中,等级、虚拟银行、地块、外部 API 写入和操作费用默认处于禁用状态。

公会等级

通过可配置的 XP 阈值和等级上限赋予公会成长进度。你自己的插件可以通过开发者 API 发放 XP。

不包含自动的 XP 奖励(如方块破坏、击杀或在线时长)。

虚拟公会银行

维护共享的虚拟余额,支持可配置的余额上限、交易限制和每日取款限额。

公会银行与玩家钱包是独立的。两者之间的自动转账需要开发者集成。

可配置的操作费用

配合兼容的经济提供商,可以设置以下项目的单独价格:

  • 创建公会和重命名
  • 公会颜色和显示标签
  • 描述修改
  • 招募设置更改
  • 邀请

价格默认为零。如果没有兼容且启用的经济提供商,费用将不生效,面向玩家的费用显示也会隐藏。

无效或未更改的公会操作不会收费。

与 PlotSquared 联动的光合地块

将符合条件的地块链接到你的公会,并为建筑、容器、PvP 和爆炸伤害配置支持的政策。

地块限制和允许的世界是可配置的。链接需要一个单所有者、未合并的地块,相应的公会角色权限以及可用的地块槽位。

现有的 PlotSquared 信任条目会被保留。不包含 Universal WorldEdit、FAWE 和自动化保护。


游戏内管理

打开 /kyveraclans edit 来管理服务器的公会系统。

管理员可以:

  • 管理单个公会、资料、成员和领导权
  • 调整公会和成员数量限制
  • 配置邀请持续时间和申请过期时间
  • 启用或禁用玩家功能
  • 选择服务器语言
  • 查看操作日志、存储状态和备份信息
  • 打开 等级、银行、地块、API 和费用 的独立设置页面

后台保存会合并待处理的更改并重试失败的写入。当存储不可用时,新的公会更改会被暂时阻止。自动备份会保留之前的公会数据和配置。

内置英文和德文

核心界面包括英文和德文的菜单、描述、提示、确认信息和聊天通知。

英文为默认语言。 切换语言的方法如下:

  1. 打开 /kyveraclans edit。
  2. 选择 Features and permissions → Language。
  3. 选择 English 或 Deutsch。
  4. 运行 /kyveraclans reload。

语言应用于整个服务器。翻译嵌入在 JAR 文件中;不会创建单独的可编辑语言文件。

玩家名称、公会名称、描述和聊天内容保留其原始文本。


可选集成

Vault 和 PlotSquared 适配器已包含在主 Kyvera Clans JAR 中。 当你想要使用它们时,请单独安装外部依赖项。

集成 功能
Vault 连接兼容的玩家钱包经济系统,用于氏族行动费用
与 Vault 兼容的经济插件 通过其注册的经济服务提供支付
PlotSquared 链接氏族地块并执行支持的权限策略
PlaceholderAPI 在兼容的插件中显示氏族信息
TAB 通过 PlaceholderAPI 显示氏族占位符
自定义插件 通过 ClanApi 和 ClanEconomy 进行连接

Vault 需要一个实际的经济提供商。PlotSquared 适配器针对的是 7/8 API 系列;请检查您安装的版本是否兼容。

仅启用您需要的部分

两个内置适配器可以在 config.yml 中独立禁用:

integrations:
  vault:
    enabled: false
  plotsquared:
    enabled: false

更改适配器设置后需重启服务器。这些开关将禁用 Kyvera Clans 的连接,而外部插件仍保持安装并可用的状态。

氏族模块和费用有单独的开关。禁用某项功能不会保留已存储的氏族数据。地块策略执行需要活跃的 PlotSquared 适配器。

PlaceholderAPI

占位符 输出
%kyveraclans_name% 氏族名称
%kyveraclans_tag% 格式化后的氏族标签
%kyveraclans_role% 在所选服务器语言中的角色
%kyveraclans_members% 成员数量
%kyveraclans_online% 在线成员数量

开发者 API

通过公共 API 连接您自己的任务、奖励、经济和地块系统。

随附的 API.md 说明了服务注册、事件、操作 ID、结果代码以及自定义经济提供商。

API JAR 是开发依赖项,不应作为服务器插件安装。支付恢复限制已在文档中说明;不确定的 Vault 崩溃结果需要经管理员核实确认。


命令

玩家命令

命令 描述
/clans 或 /clan 打开氏族菜单
/clan chat 切换外出氏族聊天模式
/clan chat <message> 发送一条私密的氏族消息
/clan invitations 查看待处理的邀请
/clan requests 查看氏族申请或查看您自己的申请
/clan progress 查看启用的等级、银行和地块功能
/clan cancel 取消待处理的输入
/clanplot link 链接符合条件的 PlotSquared 地块
/clanplot unlink 解除当前地块的链接

德语替代选项包括 /clan einladungen、/clan anfragen 和 /clan abbrechen。

管理员命令

命令 描述
/kyveraclans edit 打开管理面板
/kyveraclans clans 管理单个氏族
/kyveraclans features 打开可选模块设置
/kyveraclans log 查看操作日志
/kyveraclans status 检查存储状态
/kyveraclans reload 重新加载核心设置和语言
/kyverabridge pending 检查不确定的支付操作
/kyverabridge resolve <UUID> <decision> 记录已验证的支付结果

/kyveraclan 是 /kyveraclans 的别名。在解决支付操作之前,请阅读随附的恢复指南。

权限

权限 访问权限 默认值
kyveraclans.use 玩家氏族功能 所有人
kyveraclans.admin 氏族管理 操作员
kyverabridge.use 地块链接命令 所有人
kyverabridge.admin 集成管理和支付恢复 操作员

核心管理通常还需要 OP 状态。此额外要求可以在管理员设置中禁用。


开始使用

  1. 停止您的 Paper 服务器并备份现有数据。
  2. 将 KyveraClans-1.2.4-Paper.jar 放入 plugins 文件夹。
  3. 移除之前的 Kyvera Clans JAR 文件。
  4. 启动服务器并打开 /clans。
  5. 使用 /kyveraclans edit 配置您的服务器。

只需要一个 Kyvera Clans 插件 JAR。

当从单独的城市建设桥接器(Citybuild Bridge)升级时,请移除其 JAR 但保留其数据文件夹以进行迁移。

配置、氏族数据和文档存储在 plugins/KyveraClans 中。随附的英文 README 和 API 指南解释了高级设置。

更新通知

可选的 Modrinth 检查可以在有新版本可用时通知配置的管理员和操作员,并提供可点击的下载链接。

可以禁用检查。更新不会自动安装。

要求和兼容性

要求 详情
平台 Paper
Java 25
目标 Minecraft 版本 26.1.2–26.2
客户端安装 无

该插件基于 Paper 26.2 编译,并声明最低 API 版本为 26.1.2。未声称支持 Bukkit、Spigot 和 Purpur。

验证: 完整编译、75 项自动化回归测试以及匹配的英/德文翻译检查。实时游戏画面、物品栏渲染以及与您的确切服务器和依赖版本的兼容性仍需测试。


感谢您选择 Kyvera Clans

无论您是运行一个小服务器与朋友一起游玩,还是运营一个不断发展的社区,感谢您让 Kyvera Clans 成为您服务器的一部分。

您的反馈、错误报告和建议帮助我们改善玩家和管理员的体验。

由 Kyvera Studios 创建。专为共同游戏的社区而建。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源