GateOfOrethority

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.

🛠 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 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 key.

🛠️ 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.