You are viewing a potentially older version of this package. View all versions.
dannanboi-StonePortalControl-1.0.2 icon

StonePortalControl

Gives you control over stone portal restrictions and scale.

Date uploaded a week ago
Version 1.0.2
Download link dannanboi-StonePortalControl-1.0.2.zip
Downloads 33
Dependency string dannanboi-StonePortalControl-1.0.2

README

Description

Gives you the control to set item restrictions on stone portals similar to vanilla wood portals and to change the scale/size of the stone portals.

Features

Feature Description
Item Restrictions Allows you to set item restrictions fopr stone portals similar to vanilla wooden portals. This settings is synced with the server.
Portal Scale/Size This paramete set the scale for stone portals to make them smaller and match better in size with wood portals. This settings is synced with the server.
Show enabled text Adds hover-text on the portal to show if item restrictions are enabled or disabled.
Show scale text Adds hover-text on the portal to show it's scale.

Config 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. 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: true.

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

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 the BepInEx folder from this archive into the Valheim dedicated server installation and into each player's Valheim installation (or mod-manager profile).

  2. The resulting plugin path is: BepInEx/plugins/StonePortalControl/dannanboi_StonePortalControl.dll.

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

Compability

Not tested with other mods, 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.

The dannanboi mod philosophy

My mods aim to be smaller modular mods that stays close to the vanilla experince and only affect small parts of the game. Since I believe that this is your experince and run, you should be able to customize it just the way you want to play it without getting a lot of unwanted features "as an added bonus".

Source

Github: https://github.com/dannanboi

CHANGELOG

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.