Stayk-GateOfOrethority icon

GateOfOrethority

Biome boss portal restrictions

Last updated 2 weeks ago
Total downloads 1275
Total rating 5 
Categories Transportation AI Generated
Dependency string Stayk-GateOfOrethority-1.0.6
Dependants 1 other package depends on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2100 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2100

README

Gate of Ore-thority

Boss-gated teleport restrictions with lore themed flavour text and server sync capabilities.
Disclaimer this was vibe-coded using Copilot & Claude, I know a lot of people don't want to use AI content. However, I don't program and this mod has been a bit of a learning experience while also getting some settings that my group really wanted.

🧙 Features

  • 🔐 Teleport Restrictions: Prevents teleporting with specific items until the corresponding boss is defeated.
  • 📜 Flavorful Feedback: Custom messages for each item, themed to its biome and boss.
  • 🧪 Console Commands: Grant, revoke, list, or reset progression keys for testing and admin control.
  • 🧠 Multiplayer-Aware: Works in both solo and multiplayer environments.

🌍 World Modifier Requirement: Casual Portals

Gate of Ore-thority assumes that your world uses the Casual Portals modifier, which allows players to teleport with ores and other heavy items. This is essential for the mod’s teleport restriction system to function meaningfully—without it, players would be blocked by vanilla mechanics before your mod even runs its checks.

🛠 Console Commands

Command Description
gateoforethority_addkey Grants a progression key to the local player
gateoforethority_removekey Removes a progression key from the local player
gateoforethority_keys Lists all progression keys the player has

🗝️ Teleport Restriction Keys

Gate of Ore-thority uses boss progression flags to restrict teleporting with specific items. These flags are stored in each player's custom data and are typically granted upon defeating the corresponding boss.

Item Name Required Boss Flag Notes
CopperOre defeated_gdking
TinOre defeated_gdking
Copper defeated_gdking
Tin defeated_gdking
Bronze defeated_gdking
IronScrap defeated_bonemass
Iron defeated_bonemass
Ironpit defeated_bonemass
IronOre defeated_bonemass
SilverOre defeated_moder
Silver defeated_moder
BlackMetalScrap defeated_yagluth
BlackMetal defeated_yagluth
MechanicalSpring defeated_queen
DvergrNeedle defeated_queen
BronzeScrap defeated_queen
CharredCogwheel defeated_fader
FlametalOre defeated_fader Not currently used in-game
Flametal defeated_fader Not currently used in-game
FlametalNew defeated_fader
FlametalOreNew defeated_fader

🧙 Multiplayer Boss Flag Behavior

Gate of Ore-thority relies on boss progression flags (e.g. defeated_bonemass) stored in each player’s custom data to determine teleport eligibility. These flags are typically granted when a boss is defeated—but how they’re distributed in multiplayer depends on proximity.

🔑 How Boss Flags Are Granted

  • When a boss is killed, all players who are logged in and nearby will receive the corresponding boss flag.
  • The flag is stored in each player’s m_customData and used by this mod to gate teleport access.
  • The flag is not limited to the player who lands the killing blow.

📍 What Counts as “Nearby”?

  • Players within approximately 50 meters of the boss at the moment of death are considered nearby.
  • This includes anyone actively participating in the fight or spectating within render/combat range.
  • Players who are far away (e.g. in another biome or dungeon) or offline will not receive the flag automatically.

🛠️ Mod Behavior

  • Gate of Ore-thority checks each player’s m_customData for the required boss flag before allowing teleportation with gated items.
  • If a player did not receive the flag due to distance or timing, they will be blocked from teleporting with those items until the flag is granted manually or via another mod.

🔐 Server Override

If Server authoritative is enabled in the config, clients will use the server-defined boss flags for teleport restrictions. This ensures consistent enforcement across multiplayer sessions.

📦 Installation

Requires BepInExPack Valheim.
Place the GateOfOrethority.dll inside your BepInEx/plugins folder.

🧩 Compatibility

  • Compatible with most mods that use Player.m_customData for progression tracking.
  • Designed to be extensible for custom bosses and items.

🐾 Credits

Idea by Stayk
Work by Claude & Copilot Special thanks to the Valheim modding community for prefab insights and biome lore inspiration.