企鹅的队伍

企鹅的队伍

Pengu的Teams是一个一体化模组,集成了队伍、区块声明与保护、强制加载、世界地图、小地图、路径点以及基于浏览器的控制面板,并可选集成BlueMap、JourneyMap和LuckPerms。

Pengu's Teams:团队、区块认领、地图与网页控制面板,尽在一个 NeoForge 模组中

Pengu's Teams 是一款适用于多人服务器的全能型 NeoForge 模组,涵盖团队共享世界所需的一切功能:团队与小队、带保护的区块认领、按玩家信任与强制加载、世界地图、小地图与路径点,以及直接运行在服务器内的网页控制面板。认领区域也会显示在 BlueMap 和 JourneyMap 上(可直接在地图上认领),LuckPerms 可为每位玩家设置限制。

动态插图:认领区块、强制加载、盟友在隔壁认领以及放置路径点
插图:认领、强制加载与路径点一览。


功能

团队与小队

团队与小队

每位玩家都有一个个人团队;小队共享认领区域、聊天与盟友。

  • 所有者、官员与成员等级、邀请与盟友("好友")
  • 带历史记录的团队聊天
  • 可选的共享生命与团队阶段
  • 服务器团队,供管理员为出生点、市场等创建

认领与保护

认领与保护

从地图或使用命令认领区块,并强制加载你的农场,甚至可以选择在所有人离线时仍然生效。

  • 每个团队自行决定谁可以编辑方块、使用门和箱子、与实体交互或战斗
  • 爆炸、生物破坏、火焰、流体和活塞保护
  • 按维度规则以及废弃认领的自动过期

信任

信任等级与受信任玩家

让单个玩家进入你的认领区域而不将他们设为盟友,共分四个等级:访问、容器、建造 和 权限。使用 /trust 及类似命令管理,或在网页面板的"信任"页面操作。

世界地图与小地图

世界地图与小地图

全屏地图与可配置的小地图,随探索绘制,显示认领区域、团队成员、其他玩家和生物。盟友之间可以共享已探索的地图区域。

路径点

路径点

从地图、快捷键或命令放置路径点。它们会以信标的形式显示在世界中以及两张地图上,并且你可以与小队、指定玩家或整个服务器共享。死亡点会自动为你添加。

网页控制面板

网页控制面板

内置于服务器:在手机或电脑上管理你的团队、盟友与信任,与团队聊天,并在地形地图上认领区块。管理员还可进入管理区域。

BlueMap 与 JourneyMap

BlueMap 与 JourneyMap

认领区域会以团队颜色显示在 BlueMap 的 3D 网页地图上,并作为团队区域显示在 JourneyMap 的全屏地图和小地图上。两项集成都为可选。

JourneyMap 认领模式

插图:JourneyMap 全屏地图上的认领模式

JourneyMap 全屏地图上的一个工具栏按钮:拖动以认领、右键拖动以释放、按住 Shift 以强制加载。

还包含:物品栏界面中的侧边栏按钮(我的团队、小队生命、世界地图、管理认领、设置),可自由重新排列;每个配置文件的游戏内编辑器;Game Stages 支持;以及 JEI / REI / EMI 兼容(它们的物品列表会避开侧边栏)。


游戏内

这些图片是插图(绘制的示意图),并非截图。它们展示每个界面的概念;游戏内的实际外观在细节上有所不同。

小地图插图
显示认领区域、路径点及其下方信息行的小地图。

世界地图插图
显示认领区域、玩家与路径点的全屏世界地图。

认领管理器插图
认领管理器:在区块上拖动即可认领。

团队界面插图
包含成员、等级与盟友的"我的团队"界面。


安装

  1. 为 Minecraft 1.21.1 安装 NeoForge(21.1.90 或更新版本)。
  2. 将 penguteams-<version>.jar 放入服务器和每个客户端的 mods 文件夹。本模组有自己的网络消息和界面,因此双方都需要安装。
  3. 可选: LuckPerms、BlueMap、JourneyMap、JEI / REI / EMI 和 Game Stages 在安装后会被自动识别。它们均非必需。

快速上手

操作方式
打开你的团队界面打开我的团队 快捷键(默认未绑定)或"我的团队"侧边栏按钮;/penguteams team info 会在聊天中打印相同内容
创建小队团队界面、网页面板,或 /penguteams team party create <name>
邀请好友/penguteams team party invite <player>;对方可在聊天、团队界面或网页面板中接受
打开世界地图按 M
认领区块在地图上按 C 打开认领管理器,然后用鼠标左键拖动。右键拖动可释放;按住 Shift 可强制加载
认领你所在的区块/claim(用 /abandonclaim 释放)
允许好友在你的认领区域建造站在你的认领区域内时执行 /trust <player>
打开网页面板/penguteams web 并点击链接

所有快捷键位于 控制 → Pengu's Teams: Map & Claims(世界地图、认领管理器、路径点列表、在此处放置路径点、显示/隐藏小地图、小地图缩放)和 Pengu's Teams: Teams(打开我的团队)下。


命令

所有内容都注册在 /penguteams 下;认领和信任命令还有简短形式,如 /trust 和 /claim。Op 表示权限等级 2。

命令参考卡

命令作用
/penguteams team ...团队信息与列表、团队聊天、创建/加入/离开小队、邀请、踢出、盟友、小队设置、所有权转移。管理员还可以管理服务器团队、强制添加/移除/解散小队以及管理团队阶段
/claim / /abandonclaim认领或释放你所在的区块,或半径范围内(0–512 方块)的每个区块
/penguteams claims load / unload强制加载或停止强制加载你团队的认领区块
/claimslist按维度显示你的认领与强制加载数量及其上限
/abandonallclaims请求确认后释放你团队的所有认领
/trust、/containertrust、/accesstrust、/permissiontrust、/untrust、/trustlist管理谁可以使用你的认领区域
/penguteams claims admin ...管理员工具:绕过保护、按玩家奖励认领和强制加载、以其他团队身份认领/取消认领、查看已加载区块以及服务器范围的清理
/penguteams web / web logout获取网页面板的一次性登录链接,或结束你的所有网页会话

简短形式默认开启;在 penguteams-claims.snbt 中设置 short_commands: false 可只保留 /penguteams claims ... 形式。若其他模组已注册同名的简短形式,则该命令归该模组所有。


信任等级

信任覆盖团队在所有维度中的所有认领区域,且只会在团队自身设置之上增加权限。每个等级都包含之前的等级。

等级命令允许
访问/accesstrust <player>门、活板门、栅栏门、按钮、拉杆、压力板、床及其他无物品栏的方块
容器/containertrust <player>还包括箱子、熔炉及其他带物品栏或菜单的方块;右键点击动物、村民、物品展示框和盔甲架
建造/trust <player>还包括破坏和放置方块、编辑告示牌、使用桶,以及击打非生物实体,如物品展示框、画、盔甲架和船
权限/permissiontrust <player>还包括管理团队的信任列表,最多可给予建造信任
  • 信任命令作用于你所在区块的所属团队;当你站在认领区域外时,作用于你自己的团队。
  • 团队所有者、其官员、拥有权限信任的玩家和管理员可以更改信任。只有所有者、官员和管理员可以给予或收回权限信任。
  • 团队成员永远不需要信任。假玩家(机器)永不继承信任;它们遵循团队的假玩家设置。

权限与 LuckPerms

没有权限模组时,限制来自服务器配置,管理员权限由 op 等级决定。安装 LuckPerms 后,以下节点会按玩家读取:

节点类型含义
penguteams.claims.max_claimedmeta(数字)玩家可认领的区块数
penguteams.claims.max_force_loadedmeta(数字)玩家可强制加载的区块数
penguteams.claims.chunk_load_offlinepermission该成员离线时团队的强制加载保持生效(配合 force_load_mode: default)
penguteams.claims.no_wildernesspermissiontrue:只能在认领区域内建造;false:不受 no_wilderness 限制
penguteams.web.adminpermission网页面板中的管理员权限

示例:

/lp group vip meta set penguteams.claims.max_claimed 1000
/lp group vip meta set penguteams.claims.max_force_loaded 50
/lp group vip permission set penguteams.claims.chunk_load_offline true

小队会根据 claiming.party_limit_mode(largest、sum、owner 或 average)合并其成员的限制,并受 hard_team_claim_limit / hard_team_force_limit 封顶。创建小队、邀请和添加盟友还会检查命令节点 penguteams.team.party.create、penguteams.team.party.invite 和 penguteams.team.party.allies.add。


配置

服务器配置按世界存放在 <world>/serverconfig/;config/ 中的副本是新世界的默认值,也是整合包所附带的内容。管理员可以在游戏内编辑认领配置(地图上的服务器设置按钮,或 Ctrl + S),所有文件也可以在服务器停止时手动编辑。

文件端内容
penguteams-teams.snbt服务器,按世界小队规模和共享生命
penguteams-claims.snbt服务器,按世界认领和强制加载限制、保护、信任简短命令、新团队的默认值
penguteams-web.snbt服务器,按世界网页面板地址、会话、权限
penguteams-bluemap.snbt服务器,按世界BlueMap 标记
config/penguteams-client.snbt客户端侧边栏
config/penguteams-map-client.snbt客户端地图、小地图和路径点
config/penguteams-migration.snbt两端自动数据导入

认领配置的要点:

  • pvp_mode:always、never 或 per_team
  • ally_mode:使用盟友列表、将所有人视为盟友,或无人视为盟友
  • no_wilderness:方块只能在认领区域内编辑或使用(可提供按维度选项)
  • claiming.max_claimed_chunks(默认 500)和 force_loading.max_force_loaded_chunks(默认 25)
  • force_loading.force_load_mode:never、always 或 default
  • claiming.max_idle_days_before_unclaim 和 force_loading.max_idle_days_before_unforce 用于清理废弃基地
  • claim_dimension_blacklist / claim_dimension_whitelist(整个模组可用 "somemod:*" 匹配)
  • piston_protection、flowing_fluid_protection、fire_spread_protection、protect_unknown_explosions
  • force_disable_minimap 和 require_game_stage 用于控制地图

将任一客户端文件复制到 local/ 可在整合包更新时保留个人设置。每个团队自己的设置(谁可以编辑方块、使用方块、与实体交互或攻击实体、查看你的认领或位置;爆炸;生物破坏;PvP;假玩家)可在团队界面、网页面板或通过 /penguteams team party settings 更改。


网页面板

网页面板仪表盘(截图)
截图:仪表盘。

  1. 启动服务器。面板默认监听 0.0.0.0:8095;当服务器位于代理或域名之后时,在 penguteams-web.snbt 中设置 bind_address、port 和 public_url。
  2. 在游戏中运行 /penguteams web 并点击链接。每个链接仅可使用一次,并在几分钟后过期;会话默认持续 24 小时。链接只会发送给你,且从不记录到日志。
  3. 管理员还会看到 管理 页面。
页面作用
仪表盘你的团队、限制、邀请、快捷操作
我的团队成员与等级、邀请、团队设置、离开或解散
好友团队的盟友
团队聊天与游戏内相同的聊天
认领地图在服务器渲染的地形上拖动以认领、释放、强制加载和卸载,并按维度显示认领摘要
信任按等级添加玩家、更改等级、移除单个或全部
实时地图安装 BlueMap 时显示 BlueMap
玩家服务器已知的所有玩家,含团队和在线状态
管理所有团队、服务器团队、按玩家奖励限制、只读配置

游戏内所做的更改会实时显示。面板有浅色和深色主题,支持手机,且不从互联网加载任何内容,因此也可在局域网服务器上使用。

在网页认领地图上拖动认领区块(屏幕录像)
屏幕录像:在认领地图上拖动认领区块。

我的团队 团队聊天 认领地图
信任 好友 管理
浅色主题 手机上的面板
我的团队 • 团队聊天 • 认领地图 • 信任 • 好友 • 管理 • 浅色主题 • 手机

安全:如果面板可从互联网访问,请将其置于 HTTPS(反向代理)之后,并将 public_url 设置为 HTTPS 地址。所有更改都会经过与游戏内命令相同的检查。设置 allow_non_op_claim_editing: false 可使认领地图对玩家只读。


BlueMap 与 JourneyMap

BlueMap(服务器端)。每个团队的认领区域都会以团队颜色绘制并带轮廓,合并为区域并用团队名称标注,显示在 3D 标记集(显示)和一个平面标记集(默认隐藏)上。标记会立即跟随认领变化。网页面板增加了实时地图页面以及认领地图上的在 BlueMap 中打开按钮。

JourneyMap(客户端)。你被允许看到的认领区域会以团队颜色绘制在 JourneyMap 的全屏地图和小地图上,强制加载的区块以更深色调显示,悬停时显示团队名称。安装 JourneyMap 时,Pengu's Teams 自己的小地图默认关闭。

插图:JourneyMap 全屏地图上的认领模式
插图:JourneyMap 全屏地图上的认领模式。

  • 认领模式:通过全屏工具栏上的按钮开启。左键点击或拖动可认领,右键点击或拖动可释放,按下按钮时按住 Shift 则改为强制加载或停止强制加载。拖动时会预览(绿色认领、红色释放、橙色强制加载、灰色停止),松开时发送;一次拖动最多覆盖 1024 个区块。
  • 右键菜单:关闭认领模式时,右键点击地图并打开 Pengu's Teams,可认领、释放、强制加载或停止强制加载光标下的区块,或打开认领管理器。

从 FTB 模组迁移

来自 FTB Teams、FTB Chunks 和 FTB Library?Pengu's Teams 会在世界首次启动时自动导入团队、小队、认领、强制加载、团队设置、服务器配置、客户端地图和路径点。迁移无错误完成后,FTB 文件会被打包进备份 zip 并删除;若有任何失败,或仍安装着 FTB 模组,则会保留它们。摘要会写入 <world>/penguteams/migrated_from_ftb.txt。有关文件映射以及你需要自行更新的内容(权限节点、数据包标签、脚本中的命令),请参阅迁移指南。


面向整合包制作者和开发者

  • 对整合包友好:将默认值放在 config/ 中,并让玩家将个人客户端设置保存在 local/ 中。
  • 附加模组作者:核心 API、团队 API、认领 API 以及 Web API。
  • 架构说明和完整的更新日志在 GitHub 上。

链接

许可证

Pengu's Teams 采用 Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) 许可。你可以共享和改编它,包括用于整合包,需署名且不得用于商业目的。标志、美术和纹理专为本项目制作,同样适用此许可。