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 和费用 的独立设置页面
后台保存会合并待处理的更改并重试失败的写入。当存储不可用时,新的公会更改会被暂时阻止。自动备份会保留之前的公会数据和配置。
内置英文和德文
核心界面包括英文和德文的菜单、描述、提示、确认信息和聊天通知。
英文为默认语言。 切换语言的方法如下:
- 打开
/kyveraclans edit。
- 选择 Features and permissions → Language。
- 选择 English 或 Deutsch。
- 运行
/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 状态。此额外要求可以在管理员设置中禁用。
开始使用
- 停止您的 Paper 服务器并备份现有数据。
- 将
KyveraClans-1.2.4-Paper.jar 放入 plugins 文件夹。
- 移除之前的 Kyvera Clans JAR 文件。
- 启动服务器并打开
/clans。
- 使用
/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 创建。专为共同游戏的社区而建。
Kyvera Clans
Build your team. Make it your own. Keep everyone connected.
Bring your community together with Kyvera Clans, a menu-based clan system for Paper servers. Players can create their own clans, invite friends, organize members and communicate privately. Administrators stay in control through in-game settings and optional integrations.
From a simple survival community to a Citybuild server, enable the features that fit your players.
Version 1.2.4 · English & German · Server-side
Author: kyvera Studios
A home for every team
Give your clan an identity with a custom name, display tag, color and description. Its profile brings together the leader, founding date, member list and recruitment status.
Manage your team through three roles:
| Role |
Responsibilities |
| Leader |
Manage the clan profile, appoint officers, transfer leadership and disband the clan |
| Officer |
Handle invitations and applications and remove regular members |
| Member |
Participate in the clan and use permitted features |
Officers cannot remove the leader or other officers. Sensitive actions require confirmation.
Players can belong to one clan at a time. Creating or joining a clan clears their other pending invitations and applications.
Organized menus with fixed positions
Spend less time searching for settings.
Menu functions keep their assigned positions, even when other features are disabled. Content stays inside the frame, and navigation remains in the bottom row.
Leaders and officers have a dedicated Clan Settings page with clearly separated controls for:
- Profile: name, color, display tag and description
- Recruitment: recruitment status and applications
- Members: invitations, member lists and role management
- Management: clan deletion with confirmation
Available controls follow the player’s role and the server’s enabled features.
Invite friends. Welcome new members.
Send direct invitations or open your clan to applications.
Players can review invitations individually, see who sent them and check how much time remains. They can also withdraw their own pending applications.
Closing recruitment blocks new applications while keeping direct invitations available. Expired entries are cleaned up automatically, and login reminders highlight outstanding invitations and applications.
Keep clan conversations together
Switch between public and private chat with /clan chat, or send one clan message without changing your chat mode:
/clan chat <message>
You can mute incoming clan messages independently of your outgoing chat mode.
Chat notices use a consistent prefix, readable colors and clear instructions. Input prompts include a time limit and a clickable cancellation option.
If private clan chat becomes unavailable, messages are blocked instead of being sent publicly.
Choose the features your server needs
The core clan system works without an economy plugin. Optional modules let you expand it when you are ready.
Levels, the virtual bank, plots, external API writes and action costs are disabled by default on fresh installations.
Clan levels
Give clans progression through configurable XP thresholds and level limits. Your own plugins can award XP through the developer API.
Automatic XP rewards for block breaking, kills or playtime are not included.
Virtual clan bank
Maintain a shared virtual balance with configurable balance caps, transaction limits and daily withdrawal limits.
The clan bank is separate from player wallets. Automatic transfers between the two require a developer integration.
Configurable action costs
With a compatible economy provider, set individual prices for:
- Clan creation and renaming
- Clan colors and display tags
- Description changes
- Recruitment changes
- Invitations
Prices default to zero. Without a compatible enabled economy provider, fees are inactive and player-facing cost displays are hidden.
Invalid or unchanged clan actions are not charged.
Clan plots with PlotSquared
Link eligible plots to your clan and configure supported policies for building, containers, PvP and explosion block damage.
Plot limits and allowed worlds are configurable. Linking requires a single-owner, unmerged plot, the appropriate clan role and an available plot slot.
Pre-existing PlotSquared trust entries are preserved. Universal WorldEdit, FAWE and automation protection is not included.
Administration in game
Open /kyveraclans edit to manage your server’s clan system.
Administrators can:
- Manage individual clans, profiles, members and leadership
- Adjust clan and member limits
- Configure invitation durations and application expiry
- Enable or disable player features
- Select the server language
- Review the action log, storage status and backup information
- Open separate settings pages for levels, the bank, plots, the API and costs
Background saving combines pending changes and retries failed writes. New clan changes are temporarily blocked when storage is unavailable. Automatic backups retain previous clan data and configuration.
English and German included
The core interface includes English and German menus, descriptions, prompts, confirmations and chat notices.
English is the default. To switch languages:
- Open
/kyveraclans edit.
- Select Features and permissions → Language.
- Choose English or Deutsch.
- Run
/kyveraclans reload.
The language applies to the whole server. Translations are embedded in the JAR; separate editable language files are not created.
Player names, clan names, descriptions and chat content keep their original text.
Optional integrations
Vault and PlotSquared adapters are included in the main Kyvera Clans JAR. Install the external dependencies separately when you want to use them.
| Integration |
Function |
| Vault |
Connect compatible player-wallet economies for clan action fees |
| Vault-compatible economy plugins |
Provide payments through their registered Economy service |
| PlotSquared |
Link clan plots and enforce supported permission policies |
| PlaceholderAPI |
Display clan information in compatible plugins |
| TAB |
Display clan placeholders through PlaceholderAPI |
| Custom plugins |
Connect through ClanApi and ClanEconomy |
Vault requires an actual economy provider. The PlotSquared adapter targets the 7/8 API families; your installed version must be checked for compatibility.
Enable only what you use
Both built-in adapters can be disabled independently in config.yml:
integrations:
vault:
enabled: false
plotsquared:
enabled: false
Restart the server after changing adapter settings. These switches disable Kyvera Clans’ connections, while the external plugins remain installed and available.
Clan modules and fees have separate switches. Disabling a feature retains stored clan data. Plot policy enforcement requires the active PlotSquared adapter.
PlaceholderAPI
| Placeholder |
Output |
%kyveraclans_name% |
Clan name |
%kyveraclans_tag% |
Formatted clan tag |
%kyveraclans_role% |
Role in the selected server language |
%kyveraclans_members% |
Member count |
%kyveraclans_online% |
Online member count |
Developer API
Connect your own quests, rewards, economies and plot systems through the public API.
The included API.md explains service registration, events, operation IDs, result codes and custom economy providers.
The API JAR is a developer dependency and should not be installed as a server plugin. Payment recovery limitations are documented; uncertain Vault crash outcomes require verified administrator reconciliation.
Commands
Player commands
| Command |
Description |
/clans or /clan |
Open the clan menu |
/clan chat |
Switch outgoing clan chat mode |
/clan chat <message> |
Send one private clan message |
/clan invitations |
Review pending invitations |
/clan requests |
Review clan applications or view your own |
/clan progress |
View enabled level, bank and plot features |
/clan cancel |
Cancel a pending input |
/clanplot link |
Link an eligible PlotSquared plot |
/clanplot unlink |
Unlink the current plot |
German alternatives include /clan einladungen, /clan anfragen and /clan abbrechen.
Admin commands
| Command |
Description |
/kyveraclans edit |
Open the admin panel |
/kyveraclans clans |
Manage individual clans |
/kyveraclans features |
Open optional module settings |
/kyveraclans log |
Review the action log |
/kyveraclans status |
Check storage status |
/kyveraclans reload |
Reload core settings and language |
/kyverabridge pending |
Inspect uncertain payment operations |
/kyverabridge resolve <UUID> <decision> |
Record a verified payment outcome |
/kyveraclan is an alias for /kyveraclans. Read the included recovery guide before resolving payment operations.
Permissions
| Permission |
Access |
Default |
kyveraclans.use |
Player clan features |
Everyone |
kyveraclans.admin |
Clan administration |
Operators |
kyverabridge.use |
Plot linking commands |
Everyone |
kyverabridge.admin |
Integration administration and payment recovery |
Operators |
Core administration also requires OP status by default. This additional requirement can be disabled in the admin settings.
Get started
- Stop your Paper server and back up existing data.
- Place
KyveraClans-1.2.4-Paper.jar in the plugins folder.
- Remove previous Kyvera Clans JARs.
- Start the server and open
/clans.
- Configure your server with
/kyveraclans edit.
Only one Kyvera Clans plugin JAR is needed.
When upgrading from the separate Citybuild Bridge, remove its JAR but retain its data folder for migration.
Configuration, clan data and documentation are stored in plugins/KyveraClans. The included English README and API guide explain advanced setup.
Update notifications
Optional Modrinth checks can notify configured administrators and operators when a newer version is available, with a clickable download link.
Checks can be disabled. Updates are not installed automatically.
Requirements and compatibility
| Requirement |
Details |
| Platform |
Paper |
| Java |
25 |
| Target Minecraft versions |
26.1.2–26.2 |
| Client-side installation |
None |
The plugin compiles against Paper 26.2 and declares a minimum API version of 26.1.2. Bukkit, Spigot and Purpur support is not claimed.
Validation: full compilation, 75 automated regression tests and matching English/German translation checks. Live gameplay, inventory rendering and compatibility with your exact server and dependency versions still require testing.
Thank you for choosing Kyvera Clans
Whether you run a small server with friends or a growing community, thank you for making Kyvera Clans part of your server.
Your feedback, bug reports and suggestions help us improve the experience for players and administrators.
Created by Kyvera Studios. Built for communities that play together.
评论 0
登录后参与评分
还没有评论,来抢沙发吧