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

插图:认领、强制加载与路径点一览。
功能
团队与小队

每位玩家都有一个个人团队;小队共享认领区域、聊天与盟友。
- 所有者、官员与成员等级、邀请与盟友("好友")
- 带历史记录的团队聊天
- 可选的共享生命与团队阶段
- 服务器团队,供管理员为出生点、市场等创建
认领与保护

从地图或使用命令认领区块,并强制加载你的农场,甚至可以选择在所有人离线时仍然生效。
- 每个团队自行决定谁可以编辑方块、使用门和箱子、与实体交互或战斗
- 爆炸、生物破坏、火焰、流体和活塞保护
- 按维度规则以及废弃认领的自动过期
信任

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

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

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

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

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

JourneyMap 全屏地图上的一个工具栏按钮:拖动以认领、右键拖动以释放、按住 Shift 以强制加载。
还包含:物品栏界面中的侧边栏按钮(我的团队、小队生命、世界地图、管理认领、设置),可自由重新排列;每个配置文件的游戏内编辑器;Game Stages 支持;以及 JEI / REI / EMI 兼容(它们的物品列表会避开侧边栏)。
游戏内
这些图片是插图(绘制的示意图),并非截图。它们展示每个界面的概念;游戏内的实际外观在细节上有所不同。

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

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

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

包含成员、等级与盟友的"我的团队"界面。
安装
- 为 Minecraft 1.21.1 安装 NeoForge(21.1.90 或更新版本)。
- 将
penguteams-<version>.jar放入服务器和每个客户端的mods文件夹。本模组有自己的网络消息和界面,因此双方都需要安装。 - 可选: 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_claimed | meta(数字) | 玩家可认领的区块数 |
penguteams.claims.max_force_loaded | meta(数字) | 玩家可强制加载的区块数 |
penguteams.claims.chunk_load_offline | permission | 该成员离线时团队的强制加载保持生效(配合 force_load_mode: default) |
penguteams.claims.no_wilderness | permission | true:只能在认领区域内建造;false:不受 no_wilderness 限制 |
penguteams.web.admin | permission | 网页面板中的管理员权限 |
示例:
/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_teamally_mode:使用盟友列表、将所有人视为盟友,或无人视为盟友no_wilderness:方块只能在认领区域内编辑或使用(可提供按维度选项)claiming.max_claimed_chunks(默认 500)和force_loading.max_force_loaded_chunks(默认 25)force_loading.force_load_mode:never、always或defaultclaiming.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_explosionsforce_disable_minimap和require_game_stage用于控制地图
将任一客户端文件复制到 local/ 可在整合包更新时保留个人设置。每个团队自己的设置(谁可以编辑方块、使用方块、与实体交互或攻击实体、查看你的认领或位置;爆炸;生物破坏;PvP;假玩家)可在团队界面、网页面板或通过 /penguteams team party settings 更改。
网页面板

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

屏幕录像:在认领地图上拖动认领区块。
我的团队 • 团队聊天 • 认领地图 • 信任 • 好友 • 管理 • 浅色主题 • 手机
安全:如果面板可从互联网访问,请将其置于 HTTPS(反向代理)之后,并将 public_url 设置为 HTTPS 地址。所有更改都会经过与游戏内命令相同的检查。设置 allow_non_op_claim_editing: false 可使认领地图对玩家只读。
BlueMap 与 JourneyMap
BlueMap(服务器端)。每个团队的认领区域都会以团队颜色绘制并带轮廓,合并为区域并用团队名称标注,显示在 3D 标记集(显示)和一个平面标记集(默认隐藏)上。标记会立即跟随认领变化。网页面板增加了实时地图页面以及认领地图上的在 BlueMap 中打开按钮。
JourneyMap(客户端)。你被允许看到的认领区域会以团队颜色绘制在 JourneyMap 的全屏地图和小地图上,强制加载的区块以更深色调显示,悬停时显示团队名称。安装 JourneyMap 时,Pengu's Teams 自己的小地图默认关闭。

插图: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) 许可。你可以共享和改编它,包括用于整合包,需署名且不得用于商业目的。标志、美术和纹理专为本项目制作,同样适用此许可。
正在加载版本记录…












正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。