ClansForPlus
一款功能齐全的 Paper 26.2 模组插件。创建氏族,自定义彩色标签,管理等级和权限,结盟与敌对,共享银行与储物空间,完成任务,并通过可配置的菜单管理一切。所有设置均保存在 YAML 文件中,因此您可以调整插件而无需触碰代码。
特性
- 氏族: 创建、邀请、接受、离开、踢出、解散,设置并传送至氏族家园,查看氏族信息及全服氏族列表。
- 彩色标签: 标签文本始终与氏族名称一致。玩家仅更改颜色,可使用
& 代码、十六进制(&#RRGGBB)或 RGB(<rgb:R,G,B>)。支持逐字母渐变效果。
- 职位与权限: 默认包含领袖、官员和成员。领袖可以创建和删除自己的职位,编辑权限,并分配职位。
- 外交关系: 盟友之间不可互相攻击,敌对者可以。默认情况下会阻止友军伤害,可在配置文件中启用。
- 等级与积分: 氏族通过击杀和任务获得积分。升级可增加成员上限并解锁储物行。
- 统计数据: 记录每位成员的击杀数、死亡数和 K/D 比,并为最近的伤害提供助攻统计。
- 银行与储物: 通过 Vault 存取货币,以及通过升级解锁的共享物品储物空间。
- 任务: 内置 16 个任务,涵盖采矿、PvP、行走、银行操作和积分获取,所有任务均在
quests.yml 中定义。
- 菜单: 完整的氏族菜单说明见
menus.yml。可设置格子位置、材质、名称、描述、发光效果和点击动作。所有者可获得独立的按钮。
- PlaceholderAPI: 为标签页列表、计分板、全息图和聊天提供氏族数据,并提供如
%clans_top_1_name% 这样的顶级氏族占位符。
- WorldGuard 支持: 如果玩家所在区域无法建造,则不能设置氏族家园。
- 安全保存: 采用异步保存方式,具备原子写入和轮换备份功能。
依赖
- Paper 26.2
- Vault(可选):银行与付费公会创建功能
- PlaceholderAPI(可选):占位符支持
- WorldGuard(可选):家园保护
命令
/clan 或 /clan menu:公会菜单
/clan help:完整命令列表
/c <消息>:公会聊天
/clanforplus reload:重载配置文件(仅限操作员)
配置
所有配置项均位于 plugins/ClansForPlus/ 目录下:
config.yml: 创建费用、聊天格式、标签、家园、公告、友军伤害、邀请、名称、积分、等级、任务、外交、排行榜、存档
messages.yml: 所有插件消息
menus.yml: 所有菜单
quests.yml: 任务列表
ranks.yml: 默认等级模板
占位符
玩家氏族:%clans_name%、%clans_modtag%、%clans_role%、%clans_level%、%clans_points%、%clans_bank%、%clans_members%、%clans_kd% 等。
顶级氏族:%clans_top_<place>_<field>%。字段包括:name(名称)、tag(标签)、modtag(模组标签)、level(等级)、points(积分)、bank(银行)、members(成员数)、kills(击杀数)、deaths(死亡数)、kd(击杀死亡比)。
已知限制
- 领导权移交尚未实现。
- 银行和存储交易日志尚未保留。
- 计划添加用于查看氏族和重置统计数据的管理员命令。
- 数据以 YAML 格式存储,当氏族数量非常大时可能会导致性能下降。
ClansForPlus
A full-featured clan plugin for Paper 26.2. Create clans, customize colored tags, manage ranks and permissions, form alliances and rivalries, share a bank and storage, complete quests, and manage everything through configurable menus. All settings live in YAML files, so you can adjust the plugin without touching the code.
Features
- Clans: create, invite, accept, leave, kick, disband, set and teleport to a clan home, view clan info and a server-wide clan list.
- Colored tags: the tag text always matches the clan name. Players change only the color, using
& codes, hex (&#RRGGBB), or RGB (<rgb:R,G,B>). Per-letter gradients are supported.
- Ranks and permissions: Leader, Officer, and Member by default. Leaders can create and delete their own ranks, edit permissions, and assign ranks.
- Diplomacy: allies cannot be attacked, rivals can. Friendly fire is blocked by default and can be enabled in the config.
- Levels and points: clans earn points from kills and quests. Levels raise the member limit and unlock storage rows.
- Stats: kills, deaths, and K/D for every member, with assist credit for recent damage.
- Bank and storage: deposit and withdraw money through Vault, plus a shared item storage unlocked by level.
- Quests: 16 built-in quests for mining, PvP, walking, banking, and points, all defined in
quests.yml.
- Menus: the full clan menu is described in
menus.yml. Set slot, material, name, lore, glow, and click actions. Owners can get separate buttons.
- PlaceholderAPI: clan data for your tab list, scoreboards, holograms, and chat, plus a top-clans placeholder such as
%clans_top_1_name%.
- WorldGuard support: clan homes cannot be set in regions where the player cannot build.
- Safe saving: asynchronous saves with atomic writes and rotating backups.
Requirements
- Paper 26.2
- Vault (optional): bank and paid clan creation
- PlaceholderAPI (optional): placeholders
- WorldGuard (optional): home protection
Commands
/clan or /clan menu: clan menu
/clan help: full command list
/c <message>: clan chat
/clanforplus reload: reload configs (operators)
Configuration
Everything is configurable in plugins/ClansForPlus/:
config.yml: creation cost, chat format, tags, home, announcements, friendly fire, invites, names, points, levels, quests, diplomacy, top, saving
messages.yml: all plugin messages
menus.yml: all menus
quests.yml: quest list
ranks.yml: default rank template
Placeholders
Player clan: %clans_name%, %clans_modtag%, %clans_role%, %clans_level%, %clans_points%, %clans_bank%, %clans_members%, %clans_kd%, and more.
Top clans: %clans_top_<place>_<field>%. Fields: name, tag, modtag, level, points, bank, members, kills, deaths, kd.
Known limitations
- Leadership transfer is not implemented yet.
- Bank and storage transaction logs are not kept yet.
- Admin commands for viewing clans and resetting stats are planned.
- Data is stored in YAML, which may be slow with a very large number of clans.
评论 0
登录后参与评分
还没有评论,来抢沙发吧