Relocator

Have you ever found a nice place to build a home, only to find somewhere better after you finished? With the Relocator, the tedium of moving your house block by block is a problem of the past! Inspired by Dracula's castle from Castlevania, and the Midnight Hotel from Skulduggery Pleasant.

Coming soon to Neoforge 1.21.1 and onward!

Contents

A block that allows you to teleport your house or any other structure in the world to any other position at will, along with any entities within it. Move cottages, castles, floating islands, or any other build!

A carriable item that allows you to bring your house to you! Good for exploration, nomadic playstyles, or when you need a ready-made mineshaft.

Relays that allow you to shape the footprint of your teleport. Crush the terrain beneath you, or perform a pinpoint landing on a single block!

Ability to rotate your house to face other directions to suit your new environment. 

An Address Log to record and revisit past locations.

Getting Started/Tutorial

1. Begin by finding Metastable Ore. It's found rarely, and requres at least an iron pickaxe to mine. Once you collect some Metastable Crystal, the required crafting recipes will unlock in your recipe book. 
2. Craft a Rosen Stone and then a Relocator. You'll also need to craft Rosen Catalysts to use as fuel. An Address Log is also useful to save locations you might like to revisit. 
   
   
3. Place the Relocator in your house/base. It works best if you set it facing the same direction as the front door/main entrance to your base so that rotation is in-line with the layout of the structure.
   
   
4. Set the domain of the Relocator in the menu. An example of setting the domain can be seen in the Gallery. 
   The domain is set in each direction outward from the Relocator.
   
   If a Relocator Relay is within the set domain, the Relay's domain will be added to the teleport. These relays must sit within the domain of a Relocator or another relay to be included. This means they can be daisy-chained to form intricate shapes, such as teleporting long underground bases! 
   
   Note: The "Above ground level" value allows you to determine how your house defines ground level when using the 'Snap to Ground' option when teleporting.  Setting a value of '5' would define that the Relocator is five blocks above ground level. Using a negative value allows for snapping to a set number of blocks underground.
   
   
5. Insert Rosen Catalyst for fuel, and insert the X (East-West), Y (Height), and Z (North-South) coordinates of your destination. You may also use the facing buttons to rotate your house upon landing. After this, you are ready to travel!
   
   Note: The Y Coordinate may be left blank for an automatic snap-to ground, if you aren't targeting a certain height. 

    Be aware that the Relocator will obliterate any terrain that existed at your destination before your arrival!

Don't be surprised if teleportation takes a few seconds to kick in! The larger the teleport domain, the longer the load time.

Rosen Pearls

1. Rosen Pearl allows you to carry your house with you as a deployable teleport. To use it, craft a Rosen pearl and use it on the Relocator by shift-right clicking. 
2. It will then become an Attuned Rosen Pearl with bound coordinates. 
3. When you find a place you want to teleport your house to, simply throw the pearl as you would an ender pearl.
4. Your house will teleport with the Relocator facing toward you.

Known Bugs

Teleportation to your current coordinates or rotation on the spot can cause ghost blocks or a desync error. The easiest fix is to simply leave the world and log back in. In general, try to avoid teleporting your structure into itself for best results. No damage will be caused if you do, however.

Use in Modpacks

Use in Modpacks is allowed without restrictions, as long as you link back to this page. I would also be interested to know!

Special Thanks

• To my beta testers, Gametheraleo, and RealTerminal. You know what you did. 
• mBanders for the globe texture used on the Relocator model: https://www.mineimatorforums.com/index.php?/topic/68610-minecraft-earth-textures/ 
• TurtyWurty (https://www.youtube.com/@TurtyWurty) and KaupenJoe (https://www.youtube.com/@ModdingByKaupenjoe), without whose excellent Youtube tutorials, this mod would not have been possible.

Notes

• Feel free to comment if you find any issues, and I'll do my best to patch them quickly!
• No generative AI was used in the development of this mod. Only googling, Youtube tutorials, and far too many hours of trial and error. 

Relocator

Have you ever found a nice place to build a home, only to find somewhere better after you finished? With the Relocator, the tedium of moving your house block by block is a problem of the past! Inspired by Dracula's castle from Castlevania, and the Midnight Hotel from Skulduggery Pleasant.

Contents

• A block that allows you to teleport your house or any other structure in the world to any other position at will, along with any entities within it. Move cottages, castles, floating islands, or any other build!
• A carriable item that allows you to bring your house to you! Good for exploration, nomadic playstyles, or when you need a ready-made mineshaft.
• Relays that allow you to shape the footprint of your teleport. Crush the terrain beneath you, or perform a pinpoint landing on a single block!
• Ability to rotate your house to face other directions to suit your new environment.
• An Address Log to record and revisit past locations.

Getting Started/Tutorial

1. Begin by finding Metastable Ore. It's found rarely, and requres at least an iron pickaxe to mine. Once you collect some Metastable Crystal, the required crafting recipes will unlock in your recipe book.
2. Craft a Rosen Stone and then a Relocator. You'll also need to craft Rosen Catalysts to use as fuel. An Address Log is also useful to save locations you might like to revisit.
3. Place the Relocator in your house/base. It works best if you set it facing the same direction as the front door/main entrance to your base so that rotation is in-line with the layout of the structure.
4. Set the domain of the Relocator in the menu. An example of setting the domain can be seen in the Gallery. The domain is set in each direction outward from the Relocator. If a Relocator Relay is within the set domain, the Relay's domain will be added to the teleport.
   If a Relocator Relay is within the set domain, the Relay's domain will be added to the teleport. These relays must sit within the domain of a Relocator or another relay to be included. This means they can be daisy-chained to form intricate shapes, such as teleporting long underground bases! Note: The "Above ground level" value allows you to determine how your house defines ground level when using the 'Snap to Ground' option when teleporting. Setting a value of '5' would define that the Relocator is five blocks above ground level. Using a negative value allows for snapping to a set number of blocks underground.
5. Insert Rosen Catalyst for fuel, and insert the X (East-West), Y (Height), and Z (North-South) coordinates of your destination. You may also use the facing buttons to rotate your house upon landing. After this, you are ready to travel!

_ Notes: The Y Coordinate may be left blank for an automatic snap-to ground, if you aren't targeting a certain height. Be aware that the Relocator will obliterate any terrain that existed at your destination before your arrival Don't be surprised if teleportation takes a few seconds to kick in! The larger the teleport domain, the longer the load time. In the interest of game balance, the Relocator can only be used in the Overworld. _~~~~

Rosen Pearl

1. Rosen Pearl allows you to carry your house with you as a deployable teleport. To use it, craft a Rosen pearl and use it on the Relocator by shift-right clicking.
2. It will then become an Attuned Rosen Pearl with bound coordinates.
3. When you find a place you want to teleport your house to, simply throw the pearl as you would an ender pearl.

Known Bugs

• Teleportation to your current coordinates or rotation on the spot can cause ghost blocks or a desync error. The easiest fix is to simply leave the world and log back in. In general, try to avoid teleporting your structure into itself for best results. No damage will be caused if you do, however.
• Paintings can sometimes be shifted on the wall when teleporting via the Rosen Pearl. 
• In modpacks, any fluid containers that render the fluid externally using a Block Entity Renderer may not visually update after teleporting. Its contents are still there, the block just needs to be updated by interacting with it. You can also re-log into the world to force an update.

Use in Modpacks

Use in Modpacks is allowed without restrictions, as long as you link back to this page. I would also be interested to know!

This mod was designed with Vanilla+ in mind, but is compatible with JEI and many other mods. Not all mods have been tested, so please use at own risk. As always, make a backup of your world before installing new mods. 

This mod is compatible with any energy, fluid, and inventory blocks/block entities that utilise the Neoforge Capabilities. 

Special Thanks

• To my beta testers, Gametheraleo, and RealTerminal. You know what you did.
• mBanders for the globe texture used on the Relocator model: https://www.mineimatorforums.com/index.php?/topic/68610-minecraft-earth-textures/
• TurtyWurty (https://www.youtube.com/@TurtyWurty) and KaupenJoe (https://www.youtube.com/@ModdingByKaupenjoe), without whose excellent Youtube tutorials, this mod would not have been possible.

Notes

• Feel free to comment if you find any issues, and I'll do my best to patch them quickly!
• No generative AI was used in the development of this mod. Only googling, Youtube tutorials, and far too many hours of trial and error.