
Frame Changer
Adds customizable Nether portal frames and stylish obsidian decor.
Screenshots





About this Mod
Overview
Obby obby obby! (Oi oi oi!)
This mod adds some lovely obsidian building block decor, courtesy of Finneganso.
To facilitate building portals out of such blocks, players can also customize what blocks can be used in Nether portals, using the block tag frame_changer:portal_frames. A few other tweaks and extensibilities are added in the config for modpack developers.
Config
There are a few different categories of changes, detailed below:
Custom Portal Frames
- Portal frames can be made of anything in the tag
frame_changer:portal_frames(default: true) - 1.21.1+: Portal frames can wild shape (i.e. no longer constricted to rectangles). (default: true)
- Minimum and maximum # of blocks making up the portal is also configurable.
Custom Exit Portals
- When entering a new portal, the portal on the other side is made out of a custom block (default: false)
- The block ID of the custom exit portal frame. (default:
"minecraft:obsidian")- Note: the formatting is key! The string should look like "
modID:blockID". Valid examples include"minecraft:enchanting_table","architects_palette:moonshale", etc. - You can also set the blockID to be something that isn't in
portal_frames. The exit portal would still form on the other side, but if it's broken for any reason it will not naturally reignite.
- Note: the formatting is key! The string should look like "
Portal Break Changes
- Does breaking a portal have a chance of making obsidian-based blocks in its frame turn into crying variants? (default: false)
- If Spelunkery is installed, and their config's
"portal_destruction_crying_obsidian"is set to true, then the behavior for obsidian decor from this mod will still be enabled.
- If Spelunkery is installed, and their config's
- The chance that obsidian blocks are converted into their crying variants if a portal is broken (default: 0.33)
Tags (datapack required)
- As mentioned, the block tag
frame_changer:portal_framescontains the blocks that can make up valid Nether portals. By default, this just includes obsidian and derivative decor included in this mod.
Requires Blueprint. Optionally compatible with Spelunkery with hammer and chisel items, and Create + Spelunkery for portal fluid.
Feel free to direct any suggestions and bugs to the issue tracker! This might not work with some other portal-tweaking mods, so let me know of any potential incompatibilities.
Again, thanks to Finneganso for offering his block textures! And thank you to Roundaround's Nicer Portals mod for inspiring more customizable portal frames.
Available Versions
How to Install Frame Changer on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Frame Changer". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1, 1.19.2
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Frame Changer server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Frame Changer compatible with forge and neoforge?
Frame Changer officially supports forge, neoforge for Minecraft 1.21.1, 1.20.1, 1.19.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Frame Changer – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Frame Changer consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Frame Changer with just one click on your server.