Advanced Portals

Author: RandyKnapp Source: Github Patreon: patreon.com/randyknapp Discord: RandyKnapp's Mod Community

Adds three new portals to provide a lore-friendly and balanced way to reduce the item-transport slog!

• Ancient Portal: Allows teleporting Copper and Tin
  • Requires: 20 Ancient Bark, 5 Iron, 2 Surtling Cores
• Obsidian Portal: Allows teleporting Iron
  • Requires: 20 Obsidian, 5 Silver, 2 Surtling Cores
• Black Marble Portal: Allows teleporting anything
  • Requires: 20 Black Marble, BlackMetal 5, 2 Refined Eitr

Version 1.2.0!

Portals are now fully configurable building pieces. Alongside the recipe and teleport settings, you can change each portal's build category, whether it needs a crafting station at all, and which station that is. Every setting applies live, without restarting the game.

Upgrading from 1.1.x: the config file has been reorganised and your previous customisations will not carry over. Delete randyknapp.mods.advancedportals.cfg and re-apply any changes you had made.

Jotunn is required. A version check runs on server connection to make sure every player has the mod installed properly. Settings are synced from the server and can be edited live, either in the in-game Configuration Manager or by editing randyknapp.mods.advancedportals.cfg.

Configuration:

Each portal has its own config section named after it: [Ancient Portal], [Obsidian Portal], [Black Marble Portal]. Every setting is server-synced and only editable by an admin.

• Enabled: Allow building this portal. Existing portals of this type are not removed.
• Building Cost: What it costs to build, as ITEM,QUANTITY,REFUNDABLE entries separated by |. ITEM is the item ID (found here), QUANTITY is a whole number, and REFUNDABLE is true or false for whether you get it back on removal. For example: ElderBark,20,true|Iron,5,true|SurtlingCore,2,true
• Requires Workbench: Whether a crafting station is needed to build this portal at all.
• Workbench: Which crafting station is required, e.g. piece_workbench, forge, blackforge, piece_artisanstation. Ignored when Requires Workbench is off.
• Piece Category: Which tab of the hammer build menu the portal appears in.
• Allowed Items: Items allowed to teleport through the portal, as ITEM1, ITEM2, ITEM3, ...
• Allow Everything: Allow all items through the portal. Overrides Allowed Items.
• Use All Previous: Also allow everything the portals listed above this one allow. The Obsidian portal inherits from the Ancient portal; the Black Marble portal inherits from both.

In the in-game Configuration Manager each portal is a single collapsible row under Building Pieces, with a table editor for the build cost. The teleport settings appear under the portal's own section.

Installation:

• Manual: Drop the AdvancedPortals.dll into your BepInEx/plugins folder. Download Jotunn and install similarly.
• ThunderStore: When using a thunderstore mod manager the files should be placed in the correct directory for you. Dependencies should install automatically.

1.2.0

• Portals now use the shared configurable-piece system. Each portal gains new server-synced settings that apply live, without a restart:
  • Requires Workbench / Workbench - whether a crafting station is needed at all, and which one.
  • Piece Category - which hammer build tab the portal appears in.
  • Building Cost - now supports a per-ingredient refund flag.
• Disabling a portal is now reversible in-game. Previously a disabled portal stayed gone until a restart.
• Fixed: editing your own config file while connected to a server no longer overwrites the values the server sent you.
• Breaking: the config file has been reorganised and your previous customisations will not carry over. Each portal now has its own section named after it ([Ancient Portal]), and the build cost format changed from Item:Quantity,Item:Quantity to Item,Quantity,Refundable|Item,Quantity,Refundable. Delete randyknapp.mods.advancedportals.cfg and re-apply any changes you had made.

1.1.3

• Fixed an issue with the AllowEverything config option no longer being used in the teleport check.

1.1.2

• Changed portals metal check patch to better respect other mods including World Advancement & Progression.

1.1.1

• Fixed a small typo issue that only manifested when TargetPortal was installed.

1.1.0

• Overhauled portal appearances to better match vanilla styles!
• Now requires Jotunn to run, please install this new dependency!

1.0.11

• Update for Valheim version 0.219.13 Bog Witch.

1.0.10

• ServerSync Update fixing a multiplayer issue

1.0.9

• Update for 0.217.24 - Hildr's Request

1.0.8

• Fixing the Portal Saving issue with the changes that were presented in a recent update.
• This now adds the Custom Portal Prefabs to the PortalPrefab list during Game.Awake reducing the need to patch any ZDOMan stuff.

1.0.7

• Hildir's Request Update 0.217.14

1.0.6

• Restored Portal Connections on Dedicated Servers.

1.0.5

• Updated Portal Connection logic which was preventing Advanced Portals from connecting

1.0.4

• Updates for 0.216.9 Valheim

1.0.3

• Vapok fixed a bug that makes Adventure Backpacks work with Advanced Portals

1.0.2

• Added bronze to Ancient portal transport list (how could I forget?)
• Updated to support other mods that extend the inventory (Thanks Vapok)

1.0.1

• Added compatibility with AnyPortal and TargetPortal
• Fixed a bug with Obsidian and Black Marble portal recipes
• Added 5 BlackMetal to the default recipe for Black Marble portals (delete your config to automatically use the new recipe)

1.0.0

• Initial Release