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 |
安装
- 下载
FancyClans-1.0.0.jar。
- 将其放入服务器的
plugins/ 文件夹。
- 重启(或重载)服务器。
- 根据需要编辑
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 生成
FancyClans
A premium, lightweight clan system for Spigot/Paper 1.8.x through 1.21.x+ with a polished interface, gradient styling, alliances and PlaceholderAPI support.
Features
- Found and manage clans — create, disband (with a two-click safety confirmation), inspect profiles.
- Auto-generated tags — smart abbreviation of clan names with configurable stop-words, manual overrides and a max tag length.
- Tag styling — custom prefix and a 16-color palette that can be changed at any time.
- Premium gradient system — 20 built-in gradient presets (Fire, Ice, Royal, Neon, Cyberpunk, etc.) plus custom hex gradients for clan tags.
- Style toggle — switch between gradient and legacy single-color tag modes per clan.
- Clan descriptions — set a custom description visible in the clan menu and via placeholders.
- Interactive GUI — multi-page chest menu with a color picker, gradient studio, and preset browser.
- Alliances — request-based ally system with accept/deny/break, per-clan ally limits and pending-request timeouts.
- Premium chat formatting — hex colors (
&#RRGGBB), smooth gradients ({gradient:#ff6b35:#ff0000:text}), rainbow ({rainbow:text}), and shimmer ({shimmer:#color:text}) effects in all messages.
- Fully translatable — every user-facing string lives in
messages.yml, so admins can restyle the plugin without touching code.
- PlaceholderAPI + TAB — drop-in tag placeholders for chat, TAB boards and scoreboards.
- Persistent storage — clans are saved to
plugins/FancyClans/clans.json automatically.
- Optional update checker — point it at any JSON/text endpoint to get notified of new releases on startup.
Requirements
| Requirement |
Version |
| Server software |
Spigot or Paper 1.8.x - 1.21.x+ |
| Java |
8 or newer (8 for 1.8-1.16 servers, 17+ for 1.18+ servers) |
| PlaceholderAPI (optional) |
2.11.x |
| TAB (optional) |
any recent build |
PlaceholderAPI and TAB are soft dependencies — the plugin runs fine without them.
Version Compatibility
| Server Version |
Gradient Tags |
Hex Colors |
Presets |
GUI Markers |
| 1.8.x - 1.12.x |
Nearest legacy |
Nearest legacy |
Full support |
Lore fallback |
| 1.13.x - 1.15.x |
Nearest legacy |
Nearest legacy |
Full support |
PersistentDataContainer |
| 1.16.x - 1.17.x |
Full hex |
Full hex |
Full support |
PersistentDataContainer |
| 1.18.x - 1.21.x+ |
Full hex |
Full hex |
Full support |
PersistentDataContainer |
Installation
- Download
FancyClans-1.0.0.jar.
- Drop it into your server's
plugins/ folder.
- Restart (or reload) the server.
- Edit
plugins/FancyClans/config.yml to your taste and run /clan reload.
Commands
| Command |
Description |
Permission |
/clan |
Open the interactive clan menu |
fancyclans.menu |
/clan create <name> |
Found a brand new clan |
fancyclans.create |
/clan info |
View your clan's full profile |
fancyclans.use |
/clan info <clan> |
View another clan's profile |
fancyclans.use |
/clan tag |
Preview your clan tag |
fancyclans.use |
/clan setprefix [text] |
Change your tag prefix (leave empty to clear) |
fancyclans.prefix |
/clan setcolor [color] |
Pick a tag color or list the palette |
fancyclans.color |
/clan setgradient <start> <end> |
Set a custom hex gradient on your tag |
fancyclans.gradient |
/clan gradient |
Browse all 20 gradient presets |
fancyclans.gradient |
/clan gradient <preset> |
Apply a gradient preset to your tag |
fancyclans.gradient |
/clan gradient preview <start> <end> |
Preview a gradient without applying it |
fancyclans.gradient |
/clan gradient clear |
Remove gradient and revert to single color |
fancyclans.gradient |
/clan toggle |
Toggle between gradient and legacy mode |
fancyclans.gradient |
/clan setdescription [text] |
Set your clan's description (leave empty to clear) |
fancyclans.description |
/clan description [clan] |
View a clan's description |
fancyclans.use |
/clan ally <clan> |
Request an alliance |
fancyclans.ally |
/clan ally accept <clan> |
Accept an alliance request |
fancyclans.ally |
/clan ally deny <clan> |
Decline an alliance request |
fancyclans.ally |
/clan ally remove <clan> |
Break an alliance |
fancyclans.ally |
/clan allies |
List allies and pending requests |
fancyclans.use |
/clan leave |
Leave your current clan |
fancyclans.leave |
/clan disband |
Permanently disband your clan (double-confirm) |
fancyclans.disband |
/clan help |
Show the help screen |
fancyclans.use |
/clan reload |
Reload configuration and translations |
fancyclans.reload |
/clan version |
Show the running version |
fancyclans.use |
/fancyclans works as an alias for every command.
Permissions
| Permission |
Description |
Default |
fancyclans.use |
Allows using the base /clan command |
true |
fancyclans.menu |
Allows opening the interactive clan menu |
true |
fancyclans.create |
Allows creating a clan |
true |
fancyclans.disband |
Allows disbanding your clan |
true |
fancyclans.leave |
Allows leaving your clan |
true |
fancyclans.prefix |
Allows changing the tag prefix |
true |
fancyclans.color |
Allows changing the tag color |
true |
fancyclans.gradient |
Allows using gradient commands (setgradient, gradient, toggle) |
true |
fancyclans.description |
Allows setting your clan description |
true |
fancyclans.ally |
Allows managing alliances |
true |
fancyclans.reload |
Allows reloading the configuration |
op |
fancyclans.admin |
Administrative access (includes fancyclans.reload) |
op |
Gradient Presets
FancyClans includes 20 built-in gradient presets. Players can browse them with /clan gradient and apply with /clan gradient <name>.
| Preset |
Start |
End |
Preview |
fire |
#ff6b35 |
#ff0000 |
Orange to red |
ice |
#00d4ff |
#0066ff |
Light blue to blue |
sunset |
#ff6b35 |
#ff006e |
Orange to pink |
ocean |
#00b4d8 |
#023e8a |
Cyan to dark blue |
forest |
#22c55e |
#065f46 |
Green to dark green |
royal |
#a855f7 |
#6366f1 |
Purple to indigo |
neon |
#00ff88 |
#ff00ff |
Green to magenta |
pastel |
#fbbf24 |
#fb7185 |
Yellow to pink |
cyber |
#00ffff |
#ff00ff |
Cyan to magenta |
gold |
#fbbf24 |
#f59e0b |
Yellow to gold |
crimson |
#ef4444 |
#991b1b |
Red to dark red |
emerald |
#22c55e |
#16a34a |
Green to emerald |
sapphire |
#3b82f6 |
#1d4ed8 |
Blue to sapphire |
amethyst |
#a855f7 |
#7c3aed |
Purple to amethyst |
sakura |
#fbbf24 |
#fb7185 |
Gold to pink |
midnight |
#1a1a2e |
#0f3460 |
Dark navy to blue |
lava |
#ff4500 |
#8b0000 |
Orange-red to dark red |
arctic |
#e0f7fa |
#00bcd4 |
Ice white to cyan |
toxic |
#39ff14 |
#00ff41 |
Neon green to lime |
vapor |
#ff6ec7 |
#7b2ff7 |
Pink to purple |
Placeholders
PlaceholderAPI expansion id: fancyclans
| Placeholder |
Returns |
%fancyclans_tag% |
Full tag including brackets and colors, e.g. [AB] |
%fancyclans_tag_raw% |
Raw tag letters without styling |
%fancyclans_tag_colored% |
Colored tag without brackets |
%fancyclans_tag_gradient% |
Tag with gradient styling applied |
%fancyclans_tag_legacy% |
Tag with legacy single-color mode |
%fancyclans_name% |
Clan name |
%fancyclans_prefix% |
Tag prefix text |
%fancyclans_color% |
Tag color code |
%fancyclans_description% |
Clan description |
%fancyclans_style_mode% |
Current style mode (gradient/legacy) |
%fancyclans_gradient_start% |
Gradient start hex color |
%fancyclans_gradient_end% |
Gradient end hex color |
%fancyclans_gradient_preset% |
Applied gradient preset name |
%fancyclans_level% |
Clan level |
%fancyclans_xp% |
Clan experience points |
%fancyclans_balance% |
Clan bank balance |
%fancyclans_allies% |
Comma-separated ally names |
%fancyclans_ally_count% / %fancyclans_allies_count% |
Number of allies |
%fancyclans_members% |
Number of members |
%fancyclans_owner% |
Clan owner's name |
A typical TAB or chat setup:
%fancyclans_tag% %player_name%: %message%
Configuration
config.yml
All visual settings live in config.yml. Colors use Minecraft format codes (&c), hex (&#FFAA00), or gradients ({gradient:#ff6b35:#ff0000:Your text}).
Tag format:
tag-format.prefix / tag-format.suffix — the opening and closing brackets of the tag.
tag-format.default-color — fallback color when a clan hasn't picked one.
Abbreviation:
abbreviation.stop-words — words ignored when generating a tag.
abbreviation.overrides — manual "Clan Name": "AB" pairs (take priority).
abbreviation.max-tag-length — how many tag letters are generated (max 3).
Clan settings:
clan.min-name-length / clan.max-name-length — name length bounds.
clan.allowed-characters — regex character class for valid names.
clan.max-prefix-length — maximum tag prefix length.
clan.max-description-length — maximum description length.
clan.available-colors — the allowed tag color palette (15 colors).
Alliances:
alliances.max-allies — ally limit per clan (default: 5).
alliances.request-timeout-seconds — how long pending requests stay valid (default: 86400 = 24h).
Gradient settings:
gradients.default-style-mode — "gradient" or "legacy" for new clans.
gradients.allow-style-toggle — allow players to toggle between modes.
gradients.allow-custom-gradients — allow custom hex gradient colors.
gradients.primary / secondary / success / error / warning / info / bar — accent gradients for UI elements.
gradients.rainbow-speed — rainbow color cycling speed.
gradients.shimmer-enabled — shimmer effects on GUI items.
gradients.presets — the 20 built-in gradient presets (can be customized).
Update checker:
update-checker.enabled / update-checker.url — optional release checking.
messages.yml
Every user-facing string lives in messages.yml. Supports:
{prefix} — the global prefix defined at the top.
- Placeholders like
{name}, {max}, {usage}, {tag}, {preview}.
- Colors via
&c, hex via &#FFAA00, gradients via {gradient:#start:#end:text}.
- Rainbow via
{rainbow:text}, shimmer via {shimmer:#color:text}.
Run /clan reload after editing.
Building from source
The project uses Maven and targets Java 8 for maximum server compatibility.
mvn clean package
The resulting jar is written to target/FancyClans-1.0.0.jar.
Data storage
Clans, members, colors, alliances and pending requests live in plugins/FancyClans/clans.json. The file is written on every relevant change and on shutdown, so no manual backups of anything else are needed — but as always, back up before major server changes.
THIS README IS PARTIALLY AI-GENERATED
评论 0
登录后参与评分
还没有评论,来抢沙发吧