Portal Ores & Teleport Markers

Transport ores, minerals, metals and other restricted items through Valheim portals, and create personal teleport markers using simple /tp commands.

Thunderstore package

Expected published identifier: masukito-PortalOresAndTeleportMarkers.

The manifest package name remains PortalOresAndTeleportMarkers. Thunderstore adds the masukito- prefix only when the ZIP is uploaded using the masukito team. The ZIP filename alone does not assign ownership. See PUBLISHING.md for the release procedure.

Features

• Allows ores, metals and other restricted items to pass through any Valheim portal.
• Removes the non-teleportable restriction while the mod is enabled.
• Hides the non-teleportable icon and tooltip warning from affected items.
• Creates personal teleport points at the player's exact position and altitude.
• Teleports to saved markers using /tp markerName.
• Supports marker names with spaces.
• Provides marker autocomplete using the Tab key.
• Stores markers locally for each player and world.
• Supports Brazilian Portuguese and English.

Portal transport

This Valheim portal mod allows items normally blocked by portal restrictions to be transported through them. This includes:

• Copper ore
• Tin ore
• Iron
• Silver
• Black metal
• Flametal
• Processed metals
• Dragon eggs
• Quest items
• Other vanilla or modded items using Valheim's standard teleport restriction

The rule is applied dynamically and does not depend on a fixed item list. It makes non-teleportable items eligible for portal travel without changing weight, stack size, recipes, damage, value, prefab data, or other item properties.

Teleport markers

Create personal teleport points using your exact current coordinates, including the Y coordinate for altitude, and rotation.

Commands

/tp create markerName
/tp markerName
/tp player playerName
/tp delete markerName
/tp list
/tp help

Examples

/tp create Main Base
/tp Main Base
/tp player Anderson David
/tp delete Main Base
/tp list
/tp help

Press Tab while typing a marker name to autocomplete and cycle through matching markers. Names may contain spaces. Marker cooldown, per-world limit, result limit, and fuzzy autocomplete are configurable.

Teleport to players

Use:

/tp player playerName

to teleport near another player connected to the same world. The command and autocomplete use the character name shown in the world, never the Steam, PlayFab, or platform display name. Press Tab or Shift + Tab to cycle through current character names; names containing spaces and accent-insensitive partial searches are supported.

The command excludes the local player, rejects ambiguous or duplicate character names, never persists player positions, and obtains the target's current position immediately before teleporting. It prefers an active remote Player transform, then a loaded ZDO, and finally the same public ZNet.PlayerInfo position consumed by the minimap. The map fallback works while the map is closed and respects Valheim's position-sharing option. A small position beside, behind, or in front of the target is selected to avoid overlapping player colliders while preserving the target altitude. The marker teleport cooldown is shared with player teleportation.

Collision information may not be loaded for very distant destinations until Valheim streams the area. Players on moving ships or platforms may also move between resolution and arrival; the command uses the freshest replicated position available and fails safely when no valid nearby point can be established.

Markers are stored locally on each player's computer, separated by player profile and persistent world ID. They are not synchronized with the server, are not visible to other players, and do not transfer automatically to another computer. The local database remains at:

BepInEx/config/UnrestrictedMineralPortals/teleport-markers.json

This path intentionally retains the previous internal name so existing markers continue to load after updating.

Installation

Thunderstore or r2modman

Install Portal Ores & Teleport Markers using your preferred Thunderstore-compatible mod manager. Requires BepInExPack Valheim.

Manual installation

Copy the plugin DLL to:

BepInEx/plugins/PortalOresAndTeleportMarkers/UnrestrictedMineralPortals.dll

The DLL keeps its previous filename to preserve safe upgrades. Remove older duplicate copies such as UnrestrictedMineralPortals-1.1.0.dll; development deployment scripts clean known filenames inside the configured plugins directory.

Multiplayer

The portal restriction feature works for players using the mod. Each player who wants to transport ores through portals or use /tp commands must install the mod locally.

Teleport markers are stored locally on each player's computer and are not shared or synchronized with the server. Installing the DLL on a dedicated server does not share marker data between clients.

Configuration

[General]
Enabled = true
Language = auto
DebugLogging = false

[TeleportMarkers]
Enabled = true
MaxMarkersPerPlayer = 50
CooldownSeconds = 3
AllowInMultiplayer = true
AutoCompleteEnabled = true
AutoCompleteMaxSuggestions = 20
AutoCompleteFuzzySearch = true

[TeleportPlayers]
Enabled = true

Existing configuration files keep working because the BepInEx GUID and internal project name are unchanged. Obsolete synchronization settings from older releases are ignored.

Language

Supported options:

• auto — follows the Valheim game language when supported
• pt-BR — Brazilian Portuguese
• en — English

Aliases such as pt, Portuguese, en-US, and English are accepted. Unsupported game languages fall back to English.

Compatibility

Portal transport uses a minimal postfix on Valheim's standard Inventory.IsTeleportable() validation. UI handling hides the confirmed restriction indicator without permanently changing item data, replacing inventory grids, or removing listeners. Vanilla and modded items work when they use the standard teleport restriction.

Authors

• Anderson David
• masukito

Uninstallation

Delete UnrestrictedMineralPortals.dll. Optionally delete its configuration and local marker database if you do not want to retain settings or teleport points.

Manual test checklist

• Carry copper, tin, iron, silver, black metal, flametal, a dragon egg, and a modded restricted item through a portal.
• Confirm the non-teleportable icon and tooltip warning are hidden while enabled and restored when disabled.
• Run /tp help, create a marker with spaces, list it, teleport to it, and delete it.
• Verify exact altitude, cooldown, limits, persistence, separate profiles/worlds, Tab autocomplete, Portuguese, and English.
• Connect two clients and confirm local teleport markers remain private while portal transport works for installed clients.

Changelog

2.3.1

• Fixed /tp player to use the in-world character name instead of the platform display name.
• Added active Player/Transform, loaded ZDO, and public map-position resolution in that order.
• Added explicit feedback for unavailable and non-shared remote positions.
• Fixed distant players shown on the map failing because their ZDO was not loaded locally.
• Added safe handling for duplicate character names.

2.3.0

• Added /tp player playerName to teleport to connected players.
• Added player name autocomplete using the Tab key.
• Added safe positioning near the target player.
• Added support for player names containing spaces.
• Added player teleport messages in Brazilian Portuguese and English.
• Updated /tp help with the new player teleport command.

2.2.1

• Added masukito as the primary project and assembly company metadata.
• Added Thunderstore publishing instructions for the masukito team.
• Fixed local package naming metadata that could display the author as Unknown.
• Documented the expected package identifier as masukito-PortalOresAndTeleportMarkers.

2.2.0

• Updated the public mod name to Portal Ores & Teleport Markers to represent portal transport and teleport markers.
• Added masukito as a mod author alongside Anderson David.
• Reworked the Thunderstore description for improved discoverability.
• Expanded the README with portal transport and /tp marker documentation.
• Added clear local marker and multiplayer information.
• Recreated the mod icon with a magical portal, ores, metals, /tp, and player teleportation.

2.1.0

• Removed server synchronization for teleport markers.
• Restored local per-player and per-world marker storage.
• Removed shared markers and /tp list all.
• Removed marker networking, RPCs and protocol validation.
• Added the /tp help command.
• Added automatic language detection based on the Valheim game language.
• Added auto as the default language option.
• Kept Brazilian Portuguese and English translations.
• Preserved marker autocomplete, persistence, cooldown and marker limits.

2.0.1

• Fixed marker network initialization on current Valheim versions.
• Removed invalid patches targeting ZRoutedRpc.Awake() and parameterless ZNet.Shutdown().
• Added resilient RPC lifecycle registration and connection reset handling.
• Fixed initial and incremental marker synchronization lifecycle.
• Fixed non-teleportable item icon detection on the current Valheim UI.
• Fixed independent non-teleportable tooltip handling.
• Improved compatibility with inventory UI mods.
• Improved cleanup of outdated plugin DLLs during local deployment.

2.0.0

• Added server-authoritative teleport marker storage and validation.
• Added initial synchronization, incremental create/delete updates, cache resynchronization, and protocol version 1.
• Added /tp list all, public markers, shared teleportation, and qualified Owner:Marker resolution.
• Added persistent owner authorization and blocked deletion, spoofed identity, coordinates, and destinations from clients.
• Added synchronized autocomplete with own-marker priority and owner-only delete suggestions.
• Added Server/Local storage, sharing, shared teleport, and marker-name length settings.
• Added bounded payload validation, finite-coordinate checks, RPC origin checks, and operation rate limits.
• Added Portuguese (Brazil) and English network marker messages.
• Preserved legacy local files without automatically trusting or importing their coordinates.

1.2.0

• Added marker name autocomplete using the Tab key.
• Added cycling between matching teleport markers.
• Added Shift+Tab support for reverse cycling.
• Added prefix, partial, accent-insensitive, and fuzzy marker matching.
• Added autocomplete support for /tp and /tp delete.
• Added configurable autocomplete limits and fuzzy search.

1.1.0

• Added personal teleport markers.
• Added /tp create, /tp, /tp delete and /tp list commands.
• Markers preserve the player's exact position, altitude, and rotation.
• Added persistent markers separated by player and world.
• Added configurable marker limits, multiplayer access, and teleport cooldown.

1.0.1

• Removed the non-teleportable icon from restricted items while portal restrictions are disabled.
• Removed the related non-teleportable warning from item tooltips.
• Preserved the original UI when the mod is disabled.

1.0.0

• Initial release.
• Allows restricted items to be transported through Valheim portals.
• Supports vanilla items and modded items using Valheim's standard teleport restriction.