ViScriptTeam

模组

· 作者 zhenshiz

添加了派系和团队系统,基于声望的立场,支持可配置的派系间敌对与合作的团队玩法。

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

需要前置:Kotlin for Forge

最新 forge-1.0.2-beta · 1.20.1 · Forge

一键开服(送7天)

ViScriptTeam

一款用于 RPG 地图、PVE 地图和剧情驱动 Minecraft 服务器的轻量级阵营关系模组。它提供阵营数据、实体阵营分配、玩家个人声望、阵营间敌对关系、友军伤害控制、阵营感知型生物目标锁定以及彩色名称标签等功能。

本模组并非原版团队系统(team system)的替代品。它是专为需要模拟怪物、NPC、势力与玩家之间关系的地图制作者设计的专用阵营层。

核心概念

阵营 (Factions)

阵营 (Faction) 是实体分配和玩家声望的基本单位。阵营 ID 会自动规范化为小写(例如 Guards 变为 guards)。

每个阵营定义如下:

  • 默认声望点数 — 每位玩家对该阵营的初始声望值。
  • 中立阈值 — 低于此值的声望被视为敌对 (Hostile);达到或高于此值时,玩家至少处于中立 (Neutral) 状态。
  • 友好阈值 — 达到或高于此值的声望被视为友好 (Friendly)。
  • 友军伤害开关 — 同阵营实体或友好玩家是否可以互相造成伤害。
  • 攻击敌对阵营开关 — 该阵营内的实体是否会主动攻击敌对阵营的成员。
  • 敌对阵营列表 — 该阵营视为敌对的阵营 ID 集合。

默认配置:

范围 态度
< 50 敌对
50 &ndash; 99 中立
>= 100 友好

实体阵营 (Entity Factions)

任何非玩家实体都可以被分配到某个阵营。这适用于生物、NPC、守卫、刷怪笼生成的生物以及由地图机制控制的实体。

实体阵营分配通过 UUID 存储,因此只要实体保留在世界中,即使实体重新加载,其阵营归属也会持久保存。

玩家不使用实体阵营系统来表达身份。相反,玩家与阵营的关系通过“玩家个人声望”来体现,这使得系统在未来的组队设计方面保持灵活。

玩家声望 (Player Reputation)

每位玩家针对每个阵营都维护着独立的声望分数。该分数决定了该阵营对玩家的态度:

  • 敌对 (Hostile) — 该阵营将玩家视为敌人。该阵营内的实体将主动锁定玩家并造成伤害。
  • 中立 (Neutral) — 该阵营既不攻击也不保护玩家。
  • 友好 (Friendly) — 该阵营将玩家视为盟友。适用友军伤害规则,除非该阵营允许友军伤害,否则玩家将受到同阵营实体的保护而不受伤害。

声望可以设置为绝对值或通过增量进行调整,使其适用于任务奖励、击杀惩罚、剧情触发器以及渐进式声望系统。

队伍 (Parties)

队伍是一个独立于阵营之外的分组系统。它旨在服务于任务、副本实例、剧情事件以及需要知晓“哪些玩家当前组队在一起”的脚本驱动逻辑。

每个队伍包含:

  • 队伍 ID — 唯一的、规范化后的标识符。
  • 队长 (Leader) — 领导队伍的玩家。如果队长离开,下一位成员将自动晋升为队长。
  • 成员列表 — 当前所有在队伍中的玩家。
  • 友军伤害开关 — 队伍成员之间是否可以互相造成伤害。

玩家同一时间只能属于一个队伍。加入新队伍会自动退出之前的队伍。没有剩余成员的空队伍会被自动移除。

阵营间敌对关系 (Inter-Faction Hostility)

阵营间的敌对关系是单向的。如果你希望阵营 A 和阵营 B 相互敌对,你必须添加两个方向的设置:

  • A -> B 不会自动创建 B -> A。

这种设计允许非对称关系,例如一个阵营对另一个阵营持有敌意,但对方并不回敬。

行为细节

名称标签颜色 (Name Tag Colors)

客户端会根据观看者玩家对实体所属阵营的有效态度,以颜色提示渲染实体的名称标签:

态度 颜色
友好 绿色
中立 黄色
敌对 红色

本模组不会强制显示名称标签。可见性仍由原版机制或其他模组(如 CustomNameVisible、实体名称显示规则、地图制作者设置的 NBT 数据)控制。

名称标签数据会在登录、重生、维度切换以及阵营/声望数据修改时同步到客户端。如果玩家身处队伍中,有效态度将根据队伍的立场策略进行计算。

伤害规则 (Damage Rules)

模组会拦截伤害事件,作为安全网以强制执行阵营和队伍规则,即使自定义 AI 或其他机制绕过了正常的目标选择:

  • 同队伍 — 除非队伍启用了友军伤害,否则队伍成员无法互相伤害。
  • 同阵营 — 除非阵营允许友军伤害,否则同阵营实体无法互相伤害。
  • 玩家 vs. 友好阵营 — 当玩家对某阵营持友好态度时,除非该阵营允许友军伤害,否则玩家与该阵营的实体均无法互相伤害。
  • 中立 — 中立关系不提供伤害保护,但实体也不会主动锁定中立玩家。
  • 敌对 — 始终允许造成伤害。

生物目标锁定 (Mob Targeting)

模组在服务端向所有 Mob 实体注入一个低优先级的阵营目标锁定目标:

  • 未分配阵营的实体完全不受影响 — 不会产生额外的扫描开销。
  • 已分配阵营的实体将:
    • 主动攻击对其阵营持敌对态度的玩家。
    • 主动攻击属于敌对阵营的实体(如果启用了该阵营的“攻击敌对阵营”开关)。
    • 永远不会攻击同一阵营内的实体。
  • 目标选择逻辑以低优先级运行,因此与原版 AI 以及使用标准目标系统的绝大多数模组实体兼容。
  • 每刻执行一次健全性检查,清除无效目标;如果 mobs 意外锁定了受保护实体,则停止导航。

对于完全自定义的 AI 实现,模组提供了可直接调用的 FactionApi 方法。

小队有效声望

小队不存储自身的阵营声望。相反,当需要确定阵营态度时,会根据成员的声望动态计算有效声望。

默认策略为 min — 即所有小队成员中最低的声望。这可以防止敌对玩家加入友好小队,从而绕过守卫敌意、Mob AI、地牢访问或阵营权限限制。

内置策略:

策略 描述 推荐用途
min 最低成员声望(默认) 守卫敌意、敌人检测、地牢访问控制
average 成员声望平均值,向下取整 定居点显示、软性评估
leader 仅领袖声望 剧情触发、任务入口点
max 最高成员声望 “小队中任何人认识此阵营”即可的特殊脚本

所有原版/模组的锁定、伤害拦截和名称标签颜色均使用默认的 min 策略。单个玩家的声望始终独立存储 — 小队仅作为运行时评估阵营关系的视角。

数据持久化

所有阵营数据、实体分配、玩家声望和小队成员信息均存储在世界的保存数据中(附加于主世界)。这意味着:

  • 数据在服务器重启后保留。
  • 删除某个阵营会自动清理所有相关的实体分配、玩家声望以及其他阵营中的敌对阵营引用。
  • 小队成员变更会立即保存。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源