An addon to the Sable Mod that allows for teleporting sublevels across dimensions!
The command to warp a sublevel is /sable dimension_set ...
Allows for teleporting just a sublevel:
Or teleport a sublevel and all connected sublevels (connections being ropes, springs, docking connectors etc). This is the default option
Currently, these block/entities are known to have broken behavior after a teleportation:
- Moving Mechanical Piston (and sticky ofc)
Future Goals:
- Make create contraptions properly teleport instead of disassembling
- Destroy any blocks that are connecting the sublevel to the ground (or fail instead)
If you want to contribute, hit me up on discord. Username is hollow_egg. If you just want to steal the (very bad) code, you can do that too ^-^
NOTICE: An official api for this very thing is going to be made by the Simulated Team. So once that comes out, GO USE THAT. I will probably archive this repo when it does.
[EVERYTHING BELOW IS INFO FOR DEVELOPERS]
The function to teleport a sublevel is WarpSubLevel(subLevel, dimension, position, warpConnected?)
Some block entities require a "fix" after being teleported. This is any case where the nbt holds information about a position, sublevel, or running state (for contraptions). This mod currently includes fixes for:
- Vanilla
- Create
- Create Aeronautics
If you find or develop a mod that has block entities that match this description, feel free to let me know on discord: hollow_egg, and I will implement fixes for those block entities. If you would like to implement those fixes yourself (such as the case of a modpack developer), just follow this guide:
- For data (at the root) containing a position that may change due to teleportation:
BlockEntityRegistry.PublishPosFixer( "MODID", "BLOCK_ENTITY_ID", Set.of("Data_Source", ...))- Same conditions as above, but affecting multiple block entities with the same data:
BlockEntityRegistry.PublishCompoundPosFixer("MODID", Set.of("BLOCK_ENTITY_ID", ...), Set.of("Data_Source", ...))- For data (at the root) containting a sublevel UUID:
BlockEntityRegistry.PublishUUIDFixer("MODID", "BLOCK_ENTITY_ID", Set.of("Data_Source", ...))- For data (at the root) containing a "connection" (just a single sublevel tag and position tag, quick for things like the docking connector):
BlockEntityRegistry.PublishConnectionFixer("MODID", "BLOCK_ENTITY_ID", "SubLevel_Data_Source", "Position_Data_Source")- For data everywhere else, or special conditions: Create a new BlockEntityAccessor (I would use SpringBlockEntity as an example), and publish it with PublishCustomFixer
Examples are available in DimensionalSable.java
