Fancy clans

插件

· 作者 mrfrench

一个高效且轻量级的氏族插件

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

最新 v.1 · 1.21.4 · Bukkit / Paper

一键开服(送7天)

FancyClans

一款面向 Spigot/Paper 1.8.x 至 1.21.x+ 的高级轻量级公会系统,拥有精致的界面、渐变样式、结盟功能以及 PlaceholderAPI 支持。

特性

  • 创建与管理公会 — 创建、解散(带有两次点击的安全确认)、查看资料。
  • 自动生成标签 — 智能缩写公会名称,支持可配置的停用词、手动覆盖及最大标签长度限制。
  • 标签样式 — 自定义前缀,以及可随时更改的 16 色调色板。
  • 高级渐变系统 — 内置 20 种渐变预设(火焰、冰霜、皇家、霓虹、赛博朋克等),并支持为公会标签设置自定义十六进制渐变。
  • 样式切换 — 可在每个公会的渐变模式和传统单色标签模式之间切换。
  • 公会描述 — 在公会菜单中或通过占位符显示自定义描述。
  • 交互式 GUI — 多页容器菜单,包含颜色选择器、渐变工作室和预设浏览器。
  • 结盟系统 — 基于请求的盟友系统,支持接受/拒绝/解除,具有每公会盟友上限和待处理请求超时机制。
  • 高级聊天格式化 — 所有消息中均支持十六进制颜色 (&#RRGGBB)、平滑渐变 ({gradient:#ff6b35:#ff0000:text})、彩虹 ({rainbow:text}) 和闪烁 ({shimmer:#color:text}) 效果。
  • 完全可翻译 — 所有面向用户的字符串均位于 messages.yml 中,管理员无需触碰代码即可重新设计插件外观。
  • PlaceholderAPI + TAB 支持 — 提供用于聊天、TAB 面板和计分板的即插即用标签占位符。
  • 持久化存储 — 公会数据自动保存至 plugins/FancyClans/clans.json。
  • 可选更新检查器 — 指向任意 JSON/文本端点,以便在服务器启动时接收新版本通知。

要求

要求 版本
服务端软件 Spigot 或 Paper 1.8.x - 1.21.x+
Java 8 或更高版本(1.8-1.16 服务器使用 8,1.18+ 服务器使用 17+)
PlaceholderAPI(可选) 2.11.x
TAB(可选) 任何近期构建版

PlaceholderAPI 和 TAB 为软依赖 —— 没有它们插件也能正常运行。

版本兼容性

服务器版本 渐变标签 十六进制颜色 预设支持 GUI 标记
1.8.x - 1.12.x 近邻传统 近邻传统 完整支持 Lore 回退
1.13.x - 1.15.x 近邻传统 近邻传统 完整支持 PersistentDataContainer
1.16.x - 1.17.x 完整十六进制 完整十六进制 完整支持 PersistentDataContainer
1.18.x - 1.21.x+ 完整十六进制 完整十六进制 完整支持 PersistentDataContainer

安装

  1. 下载 FancyClans-1.0.0.jar。
  2. 将其放入服务器的 plugins/ 文件夹。
  3. 重启(或重载)服务器。
  4. 根据需要编辑 plugins/FancyClans/config.yml 并运行 /clan reload。

命令

命令 描述 权限
/clan 打开交互式公会菜单 fancyclans.menu
/clan create <name> 创建全新公会 fancyclans.create
/clan info 查看你的公会完整资料 fancyclans.use
/clan info <clan> 查看其他公会的资料 fancyclans.use
/clan tag 预览你的公会标签 fancyclans.use
/clan setprefix [text] 更改标签前缀(留空以清除) fancyclans.prefix
/clan setcolor [color] 选择标签颜色或列出调色板 fancyclans.color
/clan setgradient <start> <end> 为你的标签设置自定义十六进制渐变 fancyclans.gradient
/clan gradient 浏览所有 20 种渐变预设 fancyclans.gradient
/clan gradient <preset> 将渐变预设应用到你的标签 fancyclans.gradient
/clan gradient preview <start> <end> 预览渐变而不应用它 fancyclans.gradient
/clan gradient clear 移除渐变并恢复为单色 fancyclans.gradient
/clan toggle 在渐变模式和传统模式之间切换 fancyclans.gradient
/clan setdescription [text] 设置你的公会描述(留空以清除) fancyclans.description
/clan description [clan] 查看公会描述 fancyclans.use
/clan ally <clan> 请求结盟 fancyclans.ally
/clan ally accept <clan> 接受结盟请求 fancyclans.ally
/clan ally deny <clan> 拒绝结盟请求 fancyclans.ally
/clan ally remove <clan> 解除结盟 fancyclans.ally
/clan allies 列出盟友和待处理请求 fancyclans.use
/clan leave 离开当前公会 fancyclans.leave
/clan disband 永久解散你的公会(双重确认) fancyclans.disband
/clan help 显示帮助屏幕 fancyclans.use
/clan reload 重载配置和翻译文件 fancyclans.reload
/clan version 显示当前运行版本 fancyclans.use

/fancyclans 可作为所有命令的别名。

权限

权限 描述 默认值
fancyclans.use 允许使用基础 /clan 命令 true
fancyclans.menu 允许打开交互式公会菜单 true
fancyclans.create 允许创建公会 true
fancyclans.disband 允许解散公会 true
fancyclans.leave 允许离开公会 true
fancyclans.prefix 允许更改标签前缀 true
fancyclans.color 允许更改标签颜色 true
fancyclans.gradient 允许使用渐变相关命令(setgradient, gradient, toggle) true
fancyclans.description 允许设置公会描述 true
fancyclans.ally 允许管理结盟 true
fancyclans.reload 允许重载配置 op
fancyclans.admin 管理员访问权限(包含 fancyclans.reload) op

渐变预设

FancyClans 包含 20 种内置渐变预设。玩家可以使用 /clan gradient 浏览并使用 /clan gradient <name> 应用。

预设 起始色 结束色 预览
fire #ff6b35 #ff0000 橙色到红色
ice #00d4ff #0066ff 浅蓝到蓝色
sunset #ff6b35 #ff006e 橙色到粉色
ocean #00b4d8 #023e8a 青色到深蓝色
forest #22c55e #065f46 绿色到深绿色
royal #a855f7 #6366f1 紫色到靛蓝色
neon #00ff88 #ff00ff 绿色到洋红色
pastel #fbbf24 #fb7185 黄色到粉色
cyber #00ffff #ff00ff 青色到洋红色
gold #fbbf24 #f59e0b 黄色到金色
crimson #ef4444 #991b1b 红色到深红色
emerald #22c55e #16a34a 绿色到祖母绿
sapphire #3b82f6 #1d4ed8 蓝色到蓝宝石色
amethyst #a855f7 #7c3aed 紫色到紫水晶色
sakura #fbbf24 #fb7185 金色到粉色
midnight #1a1a2e #0f3460 深海军蓝到蓝色
lava #ff4500 #8b0000 橙红色到深红色
arctic #e0f7fa #00bcd4 冰白色到青色
toxic #39ff14 #00ff41 霓虹绿到酸橙绿
vapor #ff6ec7 #7b2ff7 粉色到紫色

占位符

PlaceholderAPI 扩展 ID:fancyclans

占位符 返回值
%fancyclans_tag% 包含括号和颜色的完整标签,例如 [AB]
%fancyclans_tag_raw% 不带样式的原始标签字母
%fancyclans_tag_colored% 不带括号的彩色标签
%fancyclans_tag_gradient% 应用了渐变样式的标签
%fancyclans_tag_legacy% 采用传统单色模式的标签
%fancyclans_name% 氏族名称
%fancyclans_prefix% 标签前缀文本
%fancyclans_color% 标签颜色代码
%fancyclans_description% 氏族描述
%fancyclans_style_mode% 当前样式模式(渐变/传统)
%fancyclans_gradient_start% 渐变起始十六进制颜色
%fancyclans_gradient_end% 渐变结束十六进制颜色
%fancyclans_gradient_preset% 已应用的渐变预设名称
%fancyclans_level% 氏族等级
%fancyclans_xp% 氏族经验值
%fancyclans_balance% 氏族银行余额
%fancyclans_allies% 逗号分隔的盟友名称列表
%fancyclans_ally_count% / %fancyclans_allies_count% 盟友数量
%fancyclans_members% 成员数量
%fancyclans_owner% 氏族拥有者名称

典型的 TAB 或聊天设置示例:

%fancyclans_tag% %player_name%: %message%

配置

config.yml

所有视觉设置均位于 config.yml 中。颜色支持 Minecraft 格式代码(&c)、十六进制颜色(&#FFAA00)或渐变({gradient:#ff6b35:#ff0000:Your text})。

标签格式:

  • tag-format.prefix / tag-format.suffix — 标签的开闭括号。
  • tag-format.default-color — 当氏族未选择颜色时的备用颜色。

缩写:

  • abbreviation.stop-words — 生成标签时忽略的单词。
  • abbreviation.overrides — 手动设置的 "氏族名称": "AB" 配对(优先级最高)。
  • abbreviation.max-tag-length — 生成的标签字母数量(最多 3 个)。

氏族设置:

  • clan.min-name-length / clan.max-name-length — 名称长度限制。
  • clan.allowed-characters — 用于有效名称的正则表达式字符类。
  • clan.max-prefix-length — 标签前缀的最大长度。
  • clan.max-description-length — 描述的最大长度。
  • clan.available-colors — 允许的标签调色板(共 15 种颜色)。

联盟:

  • alliances.max-allies — 每个氏族的盟友上限(默认:5)。
  • alliances.request-timeout-seconds — 待处理请求的有效时长(默认:86400 = 24小时)。

渐变设置:

  • gradients.default-style-mode — 新氏族的默认样式模式,可选 "gradient" 或 "legacy"。
  • gradients.allow-style-toggle — 允许玩家在两种模式之间切换。
  • gradients.allow-custom-gradients — 允许使用自定义十六进制渐变颜色。
  • gradients.primary / secondary / success / error / warning / info / bar — 用于 UI 元素的强调渐变。
  • gradients.rainbow-speed — 彩虹色循环速度。
  • gradients.shimmer-enabled — GUI 物品上的闪烁效果开关。
  • gradients.presets — 20 种内置渐变预设(可自定义)。

更新检查器:

  • update-checker.enabled / update-checker.url — 可选的版本发布检查功能。

messages.yml

所有面向用户的字符串均位于 messages.yml 中。支持以下语法:

  • {prefix} — 顶部定义的全局前缀。
  • 占位符如 {name}、{max}、{usage}、{tag}、{preview}。
  • 通过 &c 添加颜色,通过 &#FFAA00 添加十六进制颜色,通过 {gradient:#start:#end:text} 添加渐变。
  • 通过 {rainbow:text} 实现彩虹效果,通过 {shimmer:#color:text} 实现闪烁效果。

编辑完成后请运行 /clan reload。

从源码构建

该项目使用 Maven,并针对 Java 8 进行编译以确保最大的服务器兼容性。

mvn clean package

生成的 jar 文件将写入 target/FancyClans-1.0.0.jar。

数据存储

氏族、成员、颜色、联盟及待处理请求的数据存储在 plugins/FancyClans/clans.json 中。该文件会在每次相关更改发生时以及服务器关闭时自动写入,因此无需对其它内容进行手动备份——但一如既往,在进行重大服务器变更前请务必备份数据。

此 README 部分由 AI 生成

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源