Pengu’s Teams

Pengu's Teams is an all-in-one NeoForge mod for multiplayer servers that covers everything a group needs to share a world: teams and parties, chunk claims with protection, per-player trust and force-loading, a world map, minimap and waypoints, and a web control panel that runs right inside your server. Claims also show up on BlueMap and JourneyMap (where you can claim straight from the map), and LuckPerms can set limits per player.

Illustration: claiming, force-loading and waypoints at a glance.

Features

Teams and parties

Every player has a personal team; a party shares claims, chat and allies.

• Owner, officer and member ranks, invitations and allies ("friends")
• Team chat with history
• Optional shared lives and team stages
• Server teams that operators can create for spawn, a market and more

Claims and protection

Claim chunks from the map or with commands, and force-load your farms, optionally even while everyone is offline.

• Each team decides who may edit blocks, use doors and chests, interact with entities or fight
• Explosion, mob-griefing, fire, fluid and piston protection
• Per-dimension rules and automatic expiry of abandoned claims

Trust

Let single players into your claims without making them allies, on four levels: Access, Container, Build and Permission. Manage it with /trust and friends, or on the web panel's Trust page.

World map and minimap

A full-screen map and a configurable minimap, drawn as you explore, showing claims, team members, other players and mobs. Allies can share explored map regions with each other.

Waypoints

Place waypoints from the map, a keybind or a command. They show up as beacons in the world and on both maps, and you can share them with your party, chosen players or the whole server. Death points are added for you.

Web control panel

Built into the server: manage your team, allies and trust, chat with your team, and claim chunks on a terrain map from a phone or PC. Operators get an admin area.

BlueMap and JourneyMap

Claims appear as team-coloured areas on BlueMap's 3D web map and as team regions on JourneyMap's full-screen map and minimap. Both integrations are optional.

Claim Mode for JourneyMap

A toolbar button on JourneyMap's full-screen map: drag to claim, right-drag to release, hold Shift to force-load.

Also included: sidebar buttons in the inventory screen (My Team, Party Lives, World Map, Manage Claims, settings) that you can rearrange, an in-game editor for every config file, Game Stages support, and JEI / REI / EMI compatibility (their item lists stay clear of the sidebar).

In game

These pictures are illustrations (drawn mock-ups), not screenshots. They show the idea of each screen; the in-game look differs in detail.

Minimap with claims, waypoints and the info lines below it.

Full-screen world map with claims, players and waypoints.

Claim manager: drag over chunks to claim them.

The My Team screen with members, ranks and allies.

Installation

1. Install NeoForge for Minecraft 1.21.1 (21.1.90 or newer).
2. Put the penguteams-<version>.jar into the mods folder of the server and every client. The mod has its own network messages and screens, so both sides need it.
3. Optional: LuckPerms, BlueMap, JourneyMap, JEI / REI / EMI and Game Stages are picked up automatically when installed. None of them is required.

Getting started

All keys are under Controls → Pengu's Teams: Map & Claims (world map, claim manager, waypoint list, place waypoint here, show/hide minimap, minimap zoom) and Pengu's Teams: Teams (Open My Team).

Commands

Everything is registered under /penguteams; the claim and trust commands also have short forms such as /trust and /claim. Op means permission level 2.

Short forms are on by default; set short_commands: false in penguteams-claims.snbt to keep only the /penguteams claims ... forms. A short form whose name another mod already registers is left to that mod.

Trust levels

Trust covers every claim of the team in every dimension and only ever adds rights on top of the team's own settings. Each level includes the ones before it.

• The trust commands act on the team that owns the chunk you stand in, or on your own team when you stand outside claims.
• The team owner, its officers, players with Permission trust and ops may change trust. Only the owner, officers and ops can give or take away Permission trust.
• Team members never need trust. Fake players (machines) never inherit trust; they follow the team's fake-player settings.

Permissions and LuckPerms

Without a permission mod, limits come from the server config and op levels decide admin rights. With LuckPerms installed, these nodes are read per player:

Example:

/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

A party combines its members' limits according to claiming.party_limit_mode (largest, sum, owner or average), capped by hard_team_claim_limit / hard_team_force_limit. Creating parties, inviting and adding allies also check the command nodes penguteams.team.party.create, penguteams.team.party.invite and penguteams.team.party.allies.add.

Configuration

Server configs live per world in <world>/serverconfig/; a copy in config/ is the default for new worlds and is what a modpack ships. Operators can edit the claims config in game (the server settings button on the map, or Ctrl + S), and every file can also be edited by hand while the server is stopped.

Highlights from the claims config:

• pvp_mode: always, never or per_team
• ally_mode: use ally lists, treat everyone as allied, or nobody
• no_wilderness: blocks can only be edited or used inside claims (per-dimension option available)
• claiming.max_claimed_chunks (default 500) and force_loading.max_force_loaded_chunks (default 25)
• force_loading.force_load_mode: never, always or default
• claiming.max_idle_days_before_unclaim and force_loading.max_idle_days_before_unforce to clean up abandoned bases
• claim_dimension_blacklist / claim_dimension_whitelist (a whole mod can be matched with "somemod:*")
• piston_protection, flowing_fluid_protection, fire_spread_protection, protect_unknown_explosions
• force_disable_minimap and require_game_stage to control the map

Copy either client file to local/ to keep personal settings across modpack updates. Each team's own settings (who may edit blocks, use blocks, interact with or hit entities, see your claims or your location; explosions; mob griefing; PvP; fake players) are changed in the team screen, on the web panel, or with /penguteams team party settings.

Web panel

Screenshot: the dashboard.

1. Start the server. The panel listens on 0.0.0.0:8095 by default; set bind_address, port and public_url in penguteams-web.snbt when the server sits behind a proxy or a domain name.
2. In game, run /penguteams web and click the link. Each link works once and expires after a few minutes; the session lasts 24 hours by default. The link is only sent to you and never logged.
3. Operators also see the Admin page.

Changes made in game show up live. The panel has light and dark themes, works on phones and loads nothing from the internet, so it also works on LAN servers.

Screen recording: claiming chunks by dragging on the claims map.

My team • Team chat • Claims map • Trust • Friends • Admin • Light theme • Phone

Security: put the panel behind HTTPS (a reverse proxy) if it is reachable from the internet, and set public_url to the HTTPS address. Every change goes through the same checks as the in-game commands. Set allow_non_op_claim_editing: false to make the claims map view-only for players.

BlueMap and JourneyMap

BlueMap (server side). Every team's claims are drawn as team-coloured areas with outlines, merged into regions and labelled with the team name, on a 3D marker set (shown) and a flat one (hidden by default). Markers follow claim changes right away. The web panel adds a Live map page and an Open in BlueMap button on the claims map.

JourneyMap (client side). Claims you are allowed to see are drawn as team-coloured regions on JourneyMap's full-screen map and minimap, with force-loaded chunks in a darker shade and the team name on hover. Pengu's Teams' own minimap starts switched off when JourneyMap is installed.

Illustration: Claim Mode on JourneyMap's full-screen map.

• Claim Mode: turn it on with the button on the full-screen toolbar. Left click or drag claims, right click or drag releases, and holding Shift when you press the button force-loads or stops force-loading instead. Your drag is previewed (green claim, red release, orange force-load, grey stop) and sent when you let go; one drag covers up to 1024 chunks.
• Right-click menu: with Claim Mode off, right-click the map and open Pengu's Teams to claim, release, force-load or stop force-loading the chunk under the cursor, or to open the claim manager.

Migrating from FTB mods

Coming from FTB Teams, FTB Chunks and FTB Library? Pengu's Teams imports teams, parties, claims, force-loads, team settings, server configs, the client map and waypoints automatically the first time a world starts with it. After a migration without errors the FTB files are packed into backup zips and removed; if anything fails, or an FTB mod is still installed, they are kept. A summary is written to <world>/penguteams/migrated_from_ftb.txt. See the migration guide for the file mapping and what you have to update yourself (permission nodes, data pack tags, commands in scripts).

For modpack makers and developers

• Modpack-friendly: ship defaults in config/, and let players keep personal client settings in local/.
• Addon authors: Core API, Teams API, Claims API and the Web API.
• Architecture notes and the full changelog are on GitHub.

Links

• Source code on GitHub
• Report a bug or request a feature
• Changelog

License

Pengu's Teams is licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). You may share and adapt it, including in modpacks, with credit and not for commercial purposes. The logo, artwork and textures were made for this project and fall under the same license.