BossGatedPortals

BossGatedPortals Plus

A progression mod for Valheim portals:

• Ores and metals can go through portals once that biome's boss is beaten. Each boss unlocks its own

biome's goods.

• A world portal limit that grows with each boss killed: 2 portals at the start, more after every boss,

no limit after the last one. On for new worlds only.

Optional extras (companions that travel with you, faster portals) are off by default.

Works with XPortal and TargetPortal. All settings are server-synced and editable live with F1.

Progression (on by default)

• One tier per boss, each unlocking its biome's items. Item lists are configurable.
• Unlock rule (UnlockWhen): the boss killed on this world (default), or also each player having

picked up the boss drop, or the drop alone. CumulativeTiers lets a later tier unlock earlier ones.

• The final tier unlocks everything. A NeverTeleport list keeps items blocked forever.
• Everything you carry counts: your inventory, backpacks (AdventureBackpacks, Backpacks, RustyBags),

and anything a mod brings through with you (a cart, tames' saddlebags).

• Hints when a portal refuses you say where the item is ("in your Cart") and which part of the world

still has to be conquered. They never name a boss.

• Portals only glow when you can go through, and tooltips and inventory icons show what you can

teleport right now.

• Unlock announcements to everyone on a boss's first kill.
• For admins: portalgate status and portalgate limit on/off console commands, optional AdminBypass,

and startup checks that log item typos, duplicates and conflicting mods.

Portal limit (on for new worlds)

• Caps how many portals the whole world can hold (everyone's together). Defaults: 2 before any boss, then 4,

6, 8, 10, 12, 16, 20, and no limit after the final boss (each tier's MaxPortals).

• New worlds only. A world that already has portals when the server first loads it with this mod is left

without a limit, so installing or updating never locks anyone's portals. Admins can switch a world with portalgate limit on/off.

• Building over the limit is refused before any materials are used.
• PortalLimitLockWhenOver (on): while the world is over its limit, no portal works until enough are

destroyed. The mod never removes portals.

• PortalLimitAdminsExempt (off) lets admins build past the limit (their portals still count).
• PortalLimitCountStonePortals (on): Stone Portals count like wood ones. Off = they don't count, can always

be built, and keep working when the world is over its limit.

• Counts vanilla, XPortal and TargetPortal portals. Portal pieces from other mods only count if that mod

registers them as game portals.

Optional extras (off by default)

Travel with your companions (5 - Travel)

• Mount: ride into a portal and arrive in the saddle.
• Cart: arrives hitched to you, or to your horse (OdinHorse).
• Tames: following, named, or all tames nearby, with radius, height, headcount and creature lists.
• Works through vanilla, XPortal and TargetPortal portals. Their cargo follows the same rules as your

inventory. Steps aside while TeleportEverything is on.

Faster portals (4 - Portal Speed)

• FadeSeconds (default 1) and MinimumLoadingSeconds (default 8) match the game. Lower them, down to 0.

Real loading is never skipped.

• Steps aside while QuickTeleport, FastTeleport or Proper Portals is installed.

Installation

Requires: BepInExPack_Valheim, Jotunn.

• Install on the server and every client, with the same major.minor version (e.g. any 1.3.x).
• Gale / r2modman: install BossGatedPortals as usual.
• Manual: copy BossGatedPortals.dll to BepInEx/plugins/BossGatedPortals/.

Config: BepInEx/config/BarryWhite.BossGatedPortals.cfg. Settings from 0.2.x carry over automatically.

Tiers (defaults)

| Tier | Biome | Unlocks | |---|---|---| | T0 | Meadows | nothing | | T1 | Black Forest | CopperOre, Copper, CopperScrap, TinOre, Tin, Bronze, BronzeScrap | | T2 | Swamp | IronOre, IronScrap, Iron, Ironpit | | T3 | Mountains | SilverOre, Silver, DragonEgg | | T4 | Plains | BlackMetalScrap, BlackMetal | | T5 | Mistlands | MechanicalSpring, DvergrNeedle | | T6 | Ashlands | FlametalOreNew, FlametalNew, FlametalOre, Flametal, CharredCogwheel | | T7 | Deep North | GoldOre, Gold, and everything else |

Hildir's chests never teleport unless HildirChestsByTier is on.

Per-tier settings:

| Setting | Meaning | |---|---| | GlobalKey | World key set by the boss kill | | BossItem | Boss drop the player must have held (when UnlockWhen asks for it) | | Items | Items unlocked, comma-separated | | Hint | Shown when blocked | | UnlockMessage | Announced on first kill | | AllowEverything | T7 only: unlock all blocked items | | MaxPortals | Portal limit once this boss is killed. -1 = no limit |

Settings

All admin-only and server-synced, except 8 - Client, which each player sets for themselves.