StonePortalControl

Description

Gives you full control over stone portals. Server-synced options in multiplayer.

Overview

Configuration and values

Item restrictions true blocks inventory items with m_teleportable = false through stone portals, including items added by other mods. This check remains active even if the world's portal modifier allows all cargo. false restores the stone portal's original item allowance. Wooden portals are never changed. This only toggles item restrictions; it does not disable the plugin, scaling, hover options or version enforcement.

Portal scale A decimal number from 0.5 through 1, using a decimal point. (Any number less than 50% would make them unusable due to collisions; therefore, 50% is the smallest number.) 1 is 100% and 0.5 is 50% of the original scale on each axis. Default: 1

Show enabled text true adds Item restrictions: Enabled or Item restrictions: Disabled below the vanilla portal text. Default: false.

Show scale text true adds Scale: 50%, Scale: 75%, Scale: 100%, etc., using the active scale value. Default: false.

Offline play uses your local file. When joining a server, its settings override and lock the active values. Your local file is never overwritten by the server.

Manual Installation

1. Extract to BepInEx/plugins/StonePortalControl/dannanboi_StonePortalControl.dll on clients and servers

2. Start the game or server once. It creates: BepInEx/config/dannanboi.stoneportalcontrol.cfg.

Compatibility

It has not been tested with other mods; it should work as its footprint is minimal.

A client with this mod also rejects a multiplayer server that lacks the matching mod. Remove/disable the mod in that profile to join a server without it.

dannanboi Mod Philosophy

My mods aim to be small, modular mods that stay close to the vanilla experience of Valheim and work well together or independently. You can stack all my mods with all options switched on to change the game a lot, but you can also cherry-pick just the features you want or like for your style of playing. I believe that, as a player, it is truly your experience and run, and as such, you should be able to customize it just the way you want to. You should never be forced into unwanted features "as an added bonus" or "nice to have"; they should always be options. All my mods are designed with a hierarchical mindset in multiplayer, where the server dictates all gameplay-influencing options and purely visual options stay local and up to each player.

Credits

You the player. Thanks you for using my mod!

Source

GitHub: https://github.com/dannanboi

1.0.4

• Added config option to change the recipe.

1.0.3

• Added [General] Enabled, a local startup switch. Setting it to false and restarting disables the mod's patches, networking and runtime updates. Re-enabling also requires a restart.
• Moved hover-text options into [UI]. They are now local-only, update live while connected and are never synchronized with or checked against the server. Server updates do not change each player's visibility preferences.
• Renamed Show enabled text to Show item restrictions text and Show scale text to Show portal scale text. Both default to false. Vanilla portal hover text is preserved.
• Kept all gameplay options under [Settings], synchronized, locked and dictated by the server in multiplayer: Item restrictions, Portal scale and the new Disable Stone Portal Recipe.
• Added Disable Stone Portal Recipe. When true, it prevents discovery, removes the stone portal from building menus and blocks placement, including an already selected placement preview. Existing built portals remain usable.
• Recipe disabling removes previously learned stone portal knowledge from loaded characters. Other characters are updated when they next load with the setting active; normal character saves retain the removal. Turning the option off restores normal recipe discovery for eligible characters.
• Added live synchronization of the recipe setting. Recipe and building-menu refreshes occur on native game events or settings changes, with no recurring player scans or recipe polling.
• Added automatic migration of previous hover-option names and locations, preserving explicit preferences and removing obsolete entries. New names take precedence when both old and new keys exist; missing UI options default to false. Generated BepInEx metadata reflects the new names and defaults.
• Enabled clients now check local config metadata once per second while connected so UI edits apply live. File contents are read only after changes; gameplay values remain locked to the server. Logs distinguish server-controlled gameplay from local UI preferences.

1.0.2

• Bugfixes when connecting in multiplayer.

1.0.1

• Minor adjustments.

1.0.0

• Initial release.