ServerFactions
适用于 Paper/Purpur 26.3(Java 25)的基于 GUI 的阵营系统。
版本 2.1.0 · Minecraft 26.3 · 服务端插件
ServerFactions 允许玩家创建阵营,通过自定义优先级排序的角色和细粒度的权限来组织成员,并通过库存图形界面管理所有内容。它可选地集成 MultiBank 以实现按阵营划分的银行、Vault 用于收取创建费用,以及 PlaceholderAPI 以提供占位符。
注意:ServerFactions 是一个 社交/群组 插件。它不实现领地宣称、战争、势力值或领土占领功能。如需保护领地,请将其与 LandClaim 等宣称类插件搭配使用。
功能特性
- 具有身份标识的阵营。 名称、简短标签、主色/次色以及公开/私有可见性,均可在设置图形界面中进行编辑。
- 自定义角色。 支持按优先级排序的角色及每角色的权限:邀请、踢出、编辑设置、管理角色、晋升、降级和访问银行。领袖角色(优先级 0)受保护,无法被分配或重新创建。新创建的阵营默认拥有 Officer / Member / Recruit 三个角色。
- 以图形界面为核心的管理。 成员、角色、邀请、设置、成员上限、颜色选择器、转移领导权、公共阵营浏览器以及确认对话框均为库存图形界面;所有点击操作在服务端完全取消(防止物品栏复制)。文本输入使用告示牌编辑器。
- 邀请系统。 限时邀请,过期时间可配置。
- 阵营聊天。 使用
/fac chat 切换仅限阵营成员的聊天频道。
- 可选的阵营银行。 当存在 MultiBank 时,自动为每个阵营创建一个 MultiBank 账户。
- 可配置的创建费用。 通过经济系统(MultiBank 或 Vault)收取。
- 友军伤害开关、可配置的动作音效以及成员上限限制。
- 数据持久化。 使用 SQLite,通过单线程执行器进行异步写入,并在关闭时刷新数据;所有 SQL 查询均使用预编译语句。
- 本地化。 内置
en_US、pt_PT 和 fr_FR(MiniMessage 格式),涵盖所有聊天消息和反馈信息;部分图形界面按钮标签目前仅支持英文。
- 集成与 API。 提供 PlaceholderAPI 扩展,以及开发者 API(
ServerFactionsProvider),包含阵营生命周期事件。
命令
单个命令 /fac,别名为 /f 和 /faction。
| 命令 |
说明 |
权限 |
/fac |
打开主派系菜单。 |
serverfactions.use |
/fac create |
开始创建派系。 |
serverfactions.use |
/fac invite <player> |
邀请一名玩家加入你的派系。 |
serverfactions.use |
/fac chat |
切换派系聊天。 |
serverfactions.use |
/fac info [faction] |
显示你的派系信息,或按名称显示另一个派系的信息。 |
serverfactions.use |
/fac list |
浏览公开派系。 |
serverfactions.use |
/fac invites |
查看你待处理的邀请。 |
serverfactions.use |
/fac leave |
离开你的派系。 |
serverfactions.use |
/fac admin disband <faction> |
强制解散一个派系。 |
serverfactions.admin |
/fac admin reload |
重新加载配置。 |
serverfactions.admin |
权限
| 节点 |
说明 |
默认值 |
serverfactions.use |
使用基础 /fac 命令。 |
true |
serverfactions.admin |
访问 /fac admin(解散、重载)。 |
op |
配置
config.yml 中的关键设置:
faction:
creation-cost: 100.0
max-tag-length: 4
max-name-length: 24
min-name-length: 3
invite-expiry-hours: 24
default-member-limit: 0 # 0 = unlimited
default-member-limit-enabled: false
absolute-max-members: 50
max-roles: 15 # custom roles per faction
friendly-fire: true
economy:
mode: auto # auto (MultiBank then Vault), MultiBank, or Vault
priority: ["MultiBank", "Vault"]
multibank:
auto-create-bank: true
bank-name-prefix: "Faction: "
config.yml 还提供了一个完整的 gui: 部分,用于重新定位和调整每个菜单的大小(尺寸必须是 9 的倍数),以及一个用于操作反馈的 sounds: 部分。阵营名称和标签被限制在安全的字符集中,以防止在聊天、Tab 列表和 GUI 中注入格式代码。
安装
- 需要 Paper 或 Purpur 26.3 以及 Java 25(2.0.0 版本运行于 26.2,1.x 版本运行于 1.21.x)。
- 可选依赖项(参见 Dependencies):MultiBank、Vault、PlaceholderAPI、PlayerSettings。
- 将
ServerFactions-2.0.0.jar 放入 plugins/ 目录并启动服务器以生成 config.yml。
- 调整
faction: 和 economy: 部分,然后运行 /fac admin reload。
依赖项
所有集成均为可选(软依赖);插件可在无这些依赖的情况下正常运行。
| 插件 |
用途 |
| MultiBank |
各阵营专属银行账户与经济系统(配套插件)。 |
| Vault |
用于阵营创建费用的经济回退方案。 |
| PlaceholderAPI |
阵营占位符(例如格式化标签)。 |
| PlayerSettings |
玩家个人语言解析(配套插件)。 |
支持 / 源码
源码与问题反馈:
许可证
依据 GNU General Public License v3.0 发布。请参阅 LICENSE。
ServerFactions
A GUI-driven faction system for Paper/Purpur 26.3 (Java 25).
Version 2.1.0 · Minecraft 26.3 · Server-side
ServerFactions lets players create factions, organize members with custom priority-ordered roles
and granular permissions, and manage everything through inventory GUIs. It integrates optionally
with MultiBank for per-faction banks, Vault for a creation cost, and PlaceholderAPI for placeholders.
Note: ServerFactions is a social/group plugin. It does not implement land claims, war, power or
territory capture. For land protection, pair it with a claim plugin such as LandClaim.
Features
- Factions with identity. Name, short tag, primary/secondary colors and public/private
visibility, all editable from a settings GUI.
- Custom roles. Priority-ordered roles with per-role permissions: invite, kick, edit settings,
manage roles, promote, demote and access bank. The leader role (priority 0) is protected and
cannot be assigned or recreated. New factions get default Officer / Member / Recruit roles.
- GUI-first management. Members, roles, invites, settings, member limit, color picker,
transfer leadership, public faction browser and confirmation dialogs are all inventory GUIs; all
clicks are fully cancelled server-side (no inventory duping). Text input uses a sign editor.
- Invites. Time-limited invites with a configurable expiry.
- Faction chat. Toggle faction-only chat with
/fac chat.
- Optional faction bank. Auto-creates a MultiBank account per faction when MultiBank is present.
- Configurable creation cost. Charged through the economy (MultiBank or Vault).
- Friendly fire toggle, configurable action sounds, and member limits.
- Persistence. SQLite with asynchronous writes on a single-thread executor and a flushed
shutdown; all SQL uses prepared statements.
- Localization. Bundled
en_US, pt_PT and fr_FR (MiniMessage) for all chat messages and
feedback; some GUI button labels are currently English-only.
- Integrations & API. PlaceholderAPI expansion, plus a developer API
(
ServerFactionsProvider) with faction lifecycle events.
Commands
Single command /fac with aliases /f and /faction.
| Command |
Description |
Permission |
/fac |
Open the main faction menu. |
serverfactions.use |
/fac create |
Start faction creation. |
serverfactions.use |
/fac invite <player> |
Invite a player to your faction. |
serverfactions.use |
/fac chat |
Toggle faction chat. |
serverfactions.use |
/fac info [faction] |
Show your faction, or another faction by name. |
serverfactions.use |
/fac list |
Browse public factions. |
serverfactions.use |
/fac invites |
View your pending invites. |
serverfactions.use |
/fac leave |
Leave your faction. |
serverfactions.use |
/fac admin disband <faction> |
Force-disband a faction. |
serverfactions.admin |
/fac admin reload |
Reload the configuration. |
serverfactions.admin |
Permissions
| Node |
Description |
Default |
serverfactions.use |
Use the base /fac commands. |
true |
serverfactions.admin |
Access /fac admin (disband, reload). |
op |
Configuration
Key config.yml settings:
faction:
creation-cost: 100.0
max-tag-length: 4
max-name-length: 24
min-name-length: 3
invite-expiry-hours: 24
default-member-limit: 0 # 0 = unlimited
default-member-limit-enabled: false
absolute-max-members: 50
max-roles: 15 # custom roles per faction
friendly-fire: true
economy:
mode: auto # auto (MultiBank then Vault), MultiBank, or Vault
priority: ["MultiBank", "Vault"]
multibank:
auto-create-bank: true
bank-name-prefix: "Faction: "
The config.yml also exposes a full gui: section to reposition and resize every menu (sizes must
be multiples of 9), plus a sounds: section for action feedback. Faction names and tags are
restricted to a safe character set to prevent formatting injection in chat, tab list and GUIs.
Installation
- Requires Paper or Purpur 26.3 and Java 25 (2.0.0 runs on 26.2, 1.x on 1.21.x).
- Optional companions (see Dependencies): MultiBank, Vault, PlaceholderAPI, PlayerSettings.
- Drop
ServerFactions-2.0.0.jar into plugins/ and start the server to generate config.yml.
- Tune the
faction: and economy: sections and run /fac admin reload.
Dependencies
All integrations are optional (soft dependencies); the plugin runs without them.
| Plugin |
Purpose |
| MultiBank |
Per-faction bank accounts and economy (companion plugin). |
| Vault |
Economy fallback for the faction creation cost. |
| PlaceholderAPI |
Faction placeholders (e.g. formatted tag). |
| PlayerSettings |
Per-player language resolution (companion plugin). |
Support / Source
Source and issues:
License
Released under the GNU General Public License v3.0. See LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧