ServerFactions

插件

· 作者 roguiii

基于 GUI 的阵营系统,支持自定义优先级排序的角色、细粒度的权限设置、邀请功能、阵营聊天、可选的多银行派系银行、PlaceholderAPI 支持以及开发者 API。

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

最新 2.1.0+mc26.3 · 26.3 · Paper / Purpur

一键开服(送7天)

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 中注入格式代码。

安装

  1. 需要 Paper 或 Purpur 26.3 以及 Java 25(2.0.0 版本运行于 26.2,1.x 版本运行于 1.21.x)。
  2. 可选依赖项(参见 Dependencies):MultiBank、Vault、PlaceholderAPI、PlayerSettings。
  3. 将 ServerFactions-2.0.0.jar 放入 plugins/ 目录并启动服务器以生成 config.yml。
  4. 调整 faction: 和 economy: 部分,然后运行 /fac admin reload。

依赖项

所有集成均为可选(软依赖);插件可在无这些依赖的情况下正常运行。

插件 用途
MultiBank 各阵营专属银行账户与经济系统(配套插件)。
Vault 用于阵营创建费用的经济回退方案。
PlaceholderAPI 阵营占位符(例如格式化标签)。
PlayerSettings 玩家个人语言解析(配套插件)。

支持 / 源码

源码与问题反馈:

许可证

依据 GNU General Public License v3.0 发布。请参阅 LICENSE。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源