RareMagicPortalPlus
Rare Magic Portal Plus (RMPP) is a feature-rich mod designed to overhaul how portals function in Valheim.
Last updated | 4 hours ago |
Total downloads | 20 |
Total rating | 0 |
Categories | Server-side Client-side Transportation Bog Witch Update |
Dependency string | WackyMole-RareMagicPortalPlus-3.0.1 |
Dependants | 2 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202README
Rare Magic Portal Plus
Support Me!
If you enjoy this mod and want to support its continued development.
Every bit of support helps keep the portals running smoothly!
Overview
Rare Magic Portal Plus (RMPP) is a feature-rich mod designed to overhaul how portals function in Valheim. It adds depth, challenge, and immersion to an otherwise straightforward teleportation mechanic. Whether you want to create a thriving portal economy, encourage multiplayer cooperation, enforce item restrictions, or simply customize your portals with vibrant colors, this mod is for you.
Portals become strategic tools for server admins rather than limitless shortcuts. With customizable Crystals, Keys, and Magical Portal Fluid, servers can implement scarcity to foster teamwork, competition, and a thriving in-game economy. From biome-themed portal colors to VIP player restrictions, this mod offers a broad array of options to make portals as unique and dynamic as your world.
If you're tired of the default portal mechanics and want more flexibility and control, Rare Magic Portal Plus is the solution!
This is a complex mod targeting multiplayer servers, so by default most of the settings are disabled.
By default most of the new Portals have Cheat Sword as a requirement, and Biome Colors mode is enabled.
Key Features
- Portal Modes: Normal, TargetPortal, Rainbow, Password Lock, One-Way, and more.
- Dynamic Portal Colors: Match biomes, server events, or player preferences.
- Portal Economy: Introduces Magical Portal Fluid, Crystals, and Keys for strategic teleportation. The colors can consume any item that you choose.
- Player Management: Limit the number of portals per player, enforce weight restrictions, or enable admin-only settings.
- YAML Configuration Support: Easily manage portal-specific settings like colors, access, and behavior.
- More Portals: This mod unlocks the default stone portal and adds 5 more new portals types!
- Teleport Everything: Won't teleport your pets, but all items.
The Vision
The idea behind Rare Magic Portal Plus (RMP) was straightforward: portals felt too overpowered, and I wanted to introduce mechanics that balanced their convenience with meaningful strategy. At the same time, I understood how crucial portals are for navigating dungeons and exploring the world. When Target Portal was released, I saw an opportunity to support its functionality while expanding on my vision.
For large servers, the demand for more portal prefab options was clear, and I realized this mod could potentially become a valuable contribution to the community. After dedicating over two years of work conceptualizing, refining, and developing RMP, it has become the feature-rich mod it is today.
Though the mod is completely free for several reasons, your contributions are always appreciated. If you like to support my efforts, your generosity helps keep the magic flowing and inspires me to continue enhancing the Valheim experience.
1) Portal Modes
Portal modes in **Rare Magic Portal Plus** redefine how portals function, enabling dynamic behavior tailored to specific use cases or server setups. Each mode introduces unique gameplay mechanics, from simple visual enhancements to intricate player and item restrictions. Below are the available portal modes and their functionalities:
A. Normal Mode
The default behavior of portals in Valheim. Players can teleport between linked portals without additional restrictions or special effects.
B. TargetPortal Mode
- Requires the TargetPortal mod to function. Otherwise default to Normal behavior
- Allows precise targeting of destination portals.
- Ideal for creating networks where only certain players or groups can utilize specific portals.
- Has configs to lock TargetPortal's more open features.
C. Crystal and Key
- Normal mode but with Crystal and Keys
D. Rainbow Mode
- Applies a visually dynamic, color-changing effect to the portal.
- Portal Drink temporarily activates this mode, enabling unrestricted teleportation for players under its influence.
- Great for events or showcasing unique portal designs. Has a On/Off config for different rainbow effect for some portals
E. Password Lock Mode
- Players must enter a password to activate the portal.
- Successful entry adds the player to an allowed list for future access.
- Encourages team play and prevents unauthorized use.
F. One-Way Portal
- Converts the portal into a one-way transportation mechanism.
- Only the most recently updated portal in this mode remains active, while others deactivate.
- Dungeon system portal
G. One-Way Password Locked
- Combines One-Way Portal functionality with Password Locking.
- Players must enter a password to use the portal.
- Ensures controlled and restricted one-way travel.
H. Allowed Users Mode
- Only players listed in the YAML configuration can access the portal.
- Ideal for guilds, VIP areas, or personal player bases.
- Admins manage access via server configuration files.
- You Guild mod support. You can add the guild name to only allow guild members to use this mod.
I. Transport Network Mode
- By default a nameless portal that appears inactive. Is named by admin
- When a player gets close to a TN portal the /warp feature becomes available.
- If a player guess or knows the a TN portal name they can do /warp portalName to be transported to that or another TN portal
I. Coordinates Portal Mode
- Admins set specific world coordinates as the destination.
- Ideal for creating shortcuts to hard-to-reach areas or custom-built hubs.
- Players teleport to precise locations without requiring a paired portal.
J. Random Teleport Mode
- Sends players to a random location upon activation. Player is very likly to die! (most of the map is water)
- Adds unpredictability and risk, suitable for adventure servers or event-based challenges.
- Will only transported within the default map size.
- Makes a funny public annoucement when a player takes the portal.
K. Admin-Only Mode
- Restricts portal use to server admins.
- Ensures exclusive access for server management, events, or private builds.
Advanced Usage
Most Portal modes can be combined with Portal Crystals, Keys, for even more control and strategy:
- Crystals and Keys: Enable Crystal and Keys mode for this portal to access the portal
- Quick Teleport: If you want the game to transport players as quickly as possible then enable this. If the portal is close by, this is fine. Longer distance teleports areas will not be fully loaded.
- Hover Text: Yellow Text with the portal Name is displayed when a player hovers over the portal, useful for certain things. Dispalys "Danger, Danger" for random Teleport Mode
Customization Tips
2. Dynamic Portal Colors
Portals don't have to be dull anymore! Customize portals with vibrant colors to match biomes, themes, or server events.
Default Colors by Biome:
These can all be changed or manually changed
- Meadows: Tan
- Black Forest: Blue
- Swamp: Green
- Plains: Orange
- Mistlands: Purple
- Deep North: Cyan
- Ashlands: Red
- Mountain: Black
Special Colors:
- Gold: Endgame or Master portals.
- Rainbow: Dynamic cycling colors when Portal Drink is active. OR rainbow Mode
Custom Features:
- Biome-Forced Colors: Automatically assign colors based on the portal's Biome location.
- Manual Cycling: Use shortcut keys to change portal colors on the fly.
3. Crystal and Key Economy
This system adds a layer of strategy and progression to portal use.
- Crystals are consumed upon entering portals, making their use a calculated decision. // can be anything prefab, from any mod
- Keys grant permanent access to specific color portals without consumption.
3. Magical Portal Fluid
- Introduces Magical Portal Fluid as a required resource for portal construction.
- Fluid scarcity limits the number of portals players can build, creating a more thoughtful and cooperative multiplayer experience.
- Fully Configurable: Adjust drop rates, crafting requirements, and more.
4. Portal Restrictions and Freedom
Take control of what players can transport through portals:
Restrict Items:
- Block specific items like wood, stone, or metals from teleporting.
- Define additional restrictions per portal via YAML configuration.
Teleport Anything Mode:
- Use the Portal Drink to bypass inventory checks temporarily.
- Configurable duration and restricted items for balance.
5. Portals
Promote fairness and balance by setting limits on portal creation:
- Maximum Portals per Player: Configurable caps for regular and VIP players.
- World Portal Limit: Restrict the total number of portals in the world.
- Server Sync Enforcement: Ensure all players follow the same rules.
Recommended Mods for Drop Integration:
- Drop That: Configure loot tables for boss drops and creatures.
- TradersExtended: Add items to trader inventories for multiplayer economies.
- SimpleTrader: Add items to trader inventories for multiplayer economies. Up to 10 items
- TheCodFathersLegacy: a mod to immortalized a loving grandfather as an NPC trader that sells various things.
- KG Marketplace: Include them in player-run marketplaces.
7. Portal Drink
A game-changing potion that allows unrestricted teleportation for a limited time:
- Bypasses normal teleportation rules for items and inventory.
- Active portals temporarily display Rainbow Mode or a White glow.
- Fully Configurable: Adjust duration and item restrictions for balance.
Configuration Options
Rare Magic Portal Plus includes numerous configuration options categorized by their functionality. Below is a detailed list.
General Settings
Option | Default | Description |
---|---|---|
Force Server Config |
true |
Forces server settings to be applied globally. |
YML Portal Logs |
Off |
Enables detailed YAML portal logging. |
Risky Server Save |
Off |
Saves YAML updates only during server shutdown. |
Use Small Server Updates |
On |
Sends only small parts of the YAML to clients. |
Clients Save Data |
Off |
Allows clients to save YAML data locally. |
Modifier key for Color |
LeftAlt |
Sets the modifier key for changing portal colors. |
Modifier key for PortalMode |
LeftCtrl |
Sets the modifier key for changing portal modes. |
1.Portal Modes
Option | Default | Description |
---|---|---|
Default Mode for New Portals |
Normal |
Sets the default portal mode for newly placed portals. |
DisableNoNamed |
False |
No named Portals do not work at all. |
1.2 Target Portal
Option | Default | Description |
---|---|---|
Prevent Target Portal Change |
On |
Disallows non-creators from changing TargetPortal mode. |
Prevent Creator of TargetPortalChange |
Off |
Restricts changes to TargetPortal mode to admins only. |
Force Portal Animation |
Off |
Forces portal animation for TargetPortal mode. |
1.7 Teleportation Enhancements
Option | Default | Description |
---|---|---|
Fly on Warp |
On |
Enables flight during teleportation to avoid fall damage. |
Hide Name |
On |
Hides the name of portals. |
Show Warp Hint Left |
On |
Displays teleportation hints on the left-hand side. |
1.9 Rainbow Mode Settings
This section includes options for configuring the Rainbow Mode feature, which is activated when using a Portal Drink.
Config Option | Default | Description |
---|---|---|
Portal Drink Color Alt | Off |
Changes the portal effect when using a Portal Drink. Default is a Rainbow effect; toggling this changes it to a SwordCheat-like effect. |
1.9.1 Random Teleport Settings
This section focuses on the Random Teleport mode, where portals can send players to random locations.
Config Option | Default | Description |
---|---|---|
Always Active? | true |
Determines whether the portal's visual effects (glow and flames) are always active, or only glow when inactive. |
2.Portal Colors
Option | Default | Description |
---|---|---|
Enabled Colors for Portals |
All Colors | Defines available portal colors: Yellow, Red, Green, Blue, etc. |
Default Color |
Yellow |
Sets the default color for new portals. |
Prevent Color Changing |
Off |
Prevents users from changing portal colors (Admins/Owners override). |
Use Biome Colors by Default |
On |
Overrides default color with biome-related colors. |
Prevent Portal Creators from Changing Biome Color |
On |
Prevents creators from changing portal colors if biome colors are active. |
Biome Colors |
Meadows:Tan,BlackForest:Blue,Swamp:Green,... |
Maps biomes to specific colors. |
3.Crystal and Key Settings
Option | Default | Description |
---|---|---|
Use Gold as Portal Master |
On |
Enables Gold Crystals/Keys as master teleportation resources. |
Crystal Consume Per Transit |
1 |
Sets the number of crystals consumed per portal use. |
Use Top Left Message |
Off |
Displays portal tags/messages in the top-left corner instead of center. |
4.Portal Fluid Settings
Option | Default | Description |
---|---|---|
Add PortalFluid to Wood Portal |
Off |
Requires PortalFluid for crafting wood portals. |
Add PortalFluid to Stone Portal |
Off |
Requires PortalFluid for crafting stone portals. |
Fluid Per Wood Portal |
1 |
Sets the fluid requirement for wood portals. |
Fluid Per Stone Portal |
2 |
Sets the fluid requirement for stone portals. |
Portal Magic Fluid Spawn |
0 |
Defines the starting quantity of PortalFluid for new players. |
5.Portals
Option | Default | Description |
---|---|---|
Only Creator Can Deconstruct |
true |
Restricts portal deconstruction to creators and admins. |
Max Weight Allowed for Portals |
0 |
Limits the maximum weight of items transported through portals. |
Only Admin Can Build |
Off |
Restricts portal construction to admins. |
MaxAmountOfPortals |
0 |
Limits the total number of portals per player. 0 Disables Limit |
MaxAmountOfPortals_VIP |
0 |
Sets a higher portal limit for VIP players. 0 Disables Limit |
5.1 Wood Portal Settings
This section defines configurations specific to Wood Portals, such as crafting requirements, health, and crafting station dependencies.
Config Option | Default | Description |
---|---|---|
Station Requirement Wood | $piece_workbench |
The crafting station required nearby for placing a Wood Portal. Options include Workbench = $piece_workbench , Forge = $piece_forge , or Artisan Station = $piece_artisanstation . |
Level of CraftingStation Req | 1 |
The level of the crafting station required to place a Wood Portal. |
Portal Health Wood | 400f |
The health value of a Wood Portal. |
5.2 Stone Portal Settings
This section defines configurations specific to Stone Portals, including crafting requirements, health, and crafting station dependencies.
Config Option | Default | Description |
---|---|---|
Portal Health Stone | 1000f |
The health value of a Stone Portal. |
Station Requirement Stone | $piece_stonecutter |
The crafting station required nearby for placing a Stone Portal. Options include Workbench = $piece_workbench , Forge = $piece_forge , or Artisan Station = $piece_artisanstation . |
5.3 Original Stone Portal Settings
This section allows customization of the Original Stone Portal (if used) by defining its crafting station and recipe.
Config Option | Default | Description |
---|---|---|
Original Stone Crafting Station | $piece_workbench |
The crafting station required nearby for placing the Original Stone Portal. |
Original Stone Recipe | GreydwarfEye:20,SurtlingCore:10,Obsidian:100,CheatSword:1 |
The crafting recipe for the Original Stone Portal. Format: id:amount,id:amount,... . |
6.Portal Drink
Option | Default | Description |
---|---|---|
Portal Drink Timer |
120 |
Sets the duration of the Portal Drink effect in seconds. |
Portal Drink Wont Allow |
None |
Specifies items disallowed even with Portal Drink. |
7. Colors Allow
This section configures additional items that can be transported through portals of specific colors when CrystalActive is enabled or Prevent Color Changing is set to true. These overrides apply to individual portal colors.
Config Option | Default | Description |
---|---|---|
Color Yellow Allows | "" |
Additional items allowed for Yellow portals. Example: "Iron,Copper" |
Color Blue Allows | "" |
Additional items allowed for Blue portals. Example: "Iron,Copper" |
Color Green Allows | "" |
Additional items allowed for Green portals. Example: "Iron,Copper" |
Color Purple Allows | "" |
Additional items allowed for Purple portals. Example: "Iron,Copper" |
Color Tan Allows | "" |
Additional items allowed for Tan portals. Example: "Iron,Copper" |
Color Cyan Allows | "" |
Additional items allowed for Cyan portals. Example: "Iron,Copper" |
Color Orange Allows | "" |
Additional items allowed for Orange portals. Example: "Iron,Copper" |
Color Black Allows | "" |
Additional items allowed for Black portals. Example: "Iron,Copper" |
Color White Allows | "" |
Additional items allowed for White portals. Example: "Iron,Copper" |
Color Gold Allows | "" |
Additional items allowed for Gold portals. Example: "Iron,Copper" |
Some black versions have different materials and even images.
8. Crystal Selector
This section allows you to replace the default portal crystals with custom items. Integration with mods like JewelCrafting can provide unique crystals for specific portals.
Config Option | Default | Description |
---|---|---|
Use for Crystal Gold | rmp_PortalCrystalGold |
Replace the default Gold crystal with a custom item. Example: "Shattered_Yellow_Crystal" |
Use for Crystal Red | rmp_PortalCrystalRed |
Replace the default Red crystal with a custom item. Example: "Uncut_Yellow_Stone" |
Use for Crystal Green | rmp_PortalCrystalGreen |
Replace the default Green crystal with a custom item. Example: "Simple_Yellow_Socket" |
Use for Crystal Blue | rmp_PortalCrystalBlue |
Replace the default Blue crystal with a custom item. Example: "Advanced_Yellow_Socket" |
Use for Crystal Yellow | rmp_PortalCrystalYellow |
Replace the default Yellow crystal with a custom item. Example: "Perfect_Yellow_Socket" |
Use for Crystal Purple | rmp_PortalCrystalPurple |
Replace the default Purple crystal with a custom item. Example: "Uncut_Purple_Stone" |
Use for Crystal Tan | rmp_PortalCrystalTan |
Replace the default Tan crystal with a custom item. Example: "Simple_Tan_Socket" |
Use for Crystal Cyan | rmp_PortalCrystalCyan |
Replace the default Cyan crystal with a custom item. Example: "Advanced_Cyan_Socket" |
Use for Crystal Orange | rmp_PortalCrystalOrange |
Replace the default Orange crystal with a custom item. Example: "Perfect_Orange_Socket" |
Use for Crystal White | rmp_PortalCrystalWhite |
Replace the default White crystal with a custom item. Example: "Shattered_White_Crystal" |
Use for Crystal Black | rmp_PortalCrystalBlack |
Replace the default Black crystal with a custom item. Example: "Uncut_Black_Stone" |
9. Portal Images
The idea for this came from https://www.nexusmods.com/valheim/mods/1030 or Badgers HD Portals mod in the nexus download link.
He doesn't want it to be shared outside of nexus or in mod packs so I have created my own version that does something similar. His version is better, but this one is freely disruptable.
Support Willybach's HD Valheim or HD Portals if you like.
This section allows you to replace the default portal transporting screen (black background) with a random background image and a inner transport circle with a biome specific image. Very Cool! Restart Required
Option | Default | Description |
---|---|---|
Activate Portal Images |
Off |
Enables animated portal images during teleportation. YOU SHOULD TURN THIS ON, it's AWESOME |
Full Screen Image Only |
Off |
Displays random full-screen images instead of animations. |
Prefab IDs
Use these prefab IDs for custom configurations or integrations with other mods:
- Fluid and Drink:
PortalMagicFluid
,PortalDrink
Prefab IDs (Crystals):
rmp_PortalCrystalRed
,rmp_PortalCrystalGold
,rmp_PortalCrystalTan
,rmp_PortalCrystalGreen
,rmp_PortalCrystalBlue
,rmp_PortalCrystalPurple
,rmp_PortalCrystalCyan
,rmp_PortalCrystalOrange
,rmp_PortalCrystalBlack
,rmp_PortalCrystalWhite
,rmp_PortalCrystalYellow
Prefab IDs (Keys):
rmp_PortalKeyGold
,rmp_PortalKeyRed
,rmp_PortalKeyTan
,rmp_PortalKeyGreen
,rmp_PortalKeyBlue
,rmp_PortalKeyPurple
,rmp_PortalKeyCyan
,rmp_PortalKeyOrange
, rmp_PortalKeyBlack
,rmp_PortalKeyWhite
,rmp_PortalKeyYellow
Compatibility
Rare Magic Portal Plus works seamlessly with many popular Valheim mods, including:
- TargetPortal: A highly recommended mod for advanced portal mechanics. This mod has tight integration with TP.
- Epic Loot, JewelCrafting, Drop That, KG Marketplace, and more!
- Not Compatible with the old RMP 2.0
- Not Compatible with Advanced Portals
- Not Compatible other Portal mods probably(besides Target Portal), I'll work on Teleport Anything if that doesn't work.
Target Portal
So Target Portal is an intersting mod. I really wanted to add it to RMP, so I did.
I works awesome with RMPP.
RMPP actually fixes a lot of my personal gripes with Target Portal through the extra configs too!
Download TargetPortal and RMPP together, you won't be disappointed.
Acknowledgments
- My Wife:
- My Wife again for putting up with all my modding time and being awesome.
- Special thanks to:
- The OdinPlus Team for their guidance and support.
- The Blaxx for making TargetPortal easy to patch. Seriously, I probably overrode half of the patches in this Target Portal to get compatibility. I am glad it worked out. I'll happily take TargetPortal off your hands though :wink:
- GraveBear for updated icons.
- Assets provided by the Unity Asset Store:
Changelog
- v3.0.0: Full rewrite and modularization of features + extra portals.
- v2.x.x: Introduced Portal Colors, Biome Modes, and Portal Drink.
- v1.x.x: Initial release with core functionality.
For feedback, support, or feature suggestions, feel free to
KeyManager
I put over a year of effort into making this mod, I don't want it to be misused or uncredited.