Mods / Temporal Hole

Tags: #Storage #Technology #Utility
Author: PurplePi
Side: Both
Created: May 22nd at 4:20 AM
Last modified: Jun 11th at 6:21 PM
Downloads: 679
Follow Unfollow 44

Recommended download (for Vintage Story 1.20.11 - 1.20.12):
temporalhole-v1.2.0.zip  1-click install


This mod was created to add an end game solution to one of the most annoying parts of exploration: running out of space for loot.

The Temporal Hole requires cupernickel and jonas parts to create, but it is capable of holding a theoretically infinite amount of loot.

Once the loot has been sent through, it requires specialist equipment to retrieve: The Temporal Extractor uses mechanical power to pull items back through the Temporal Hole.

 

While holding an item, Ctrl-click on the Temporal Hole to drop the item into it. Alternatively, Ctrl-click on an item with the Temporal Hole. Once you get back to base, click on the Extractor with your Temporal Hole to place it in the machine. The Hole will emit teal particles while it contains items, and items are extracted in a random order. Items are only extracted while the Extractor receives mechanical power, and extraction can be sped up by increasing the speed of rotation.

After being extracted, Items will fall into the base of the extractor, and will fall through the bottom if there isn't a block underneath. Be careful, as items can despawn in this form. If a chute is added beneath the Extractor, it will automatically output items through it, though in this mode extraction is throttled by the chutes flow rate.

 

The mod also comes with some config options:

holeLimit: can be used to set a limit on the number of stacks a Temporal Hole can hold, mostly there if the server owner wants to nerf its storage capacity. Setting it to -1 or lower will revert to normal limitless behaviour

powerlessExtraction: lets the Temporal Extractor extract items without power at a base rate of 1 stack every 4 seconds. This speed can be increased if a faster source of  power is attached.

extractionSpeedModifier: allows you to increase or decrease how fast the Temporal Extractor extracts items. Also affects the base speed if powerlessExtraction is enabled


 

This mod is coded with a bit of jank. I couldn't figure out how to attach an inventory to an item, so items are stored as an attribute attached to the Temporal Hole. I couldn't even use the games ItemstackAttribute, because for some reason they get erased a few frames after being set, so I had to convert them into bytes and save them that way. I also wanted the contents to stay when transferred between worlds, so item codes are saved as well, which also acts as a nice backup.

I also haven't really tested the limits, but I stuffed 256 stacks in before I got bored, and it still worked fine. If you run into any problems please leave a comment.

Mod Version For Game version Downloads Release date Changelog Download 1-click mod install*
1.2.0
1.20.11 - 1.20.12
510 Jun 1st at 1:11 AM temporalhole-v1.2.0.zip 1-click install
  • Changed description text of the Temporal Extractor to mention the need for mechanical power
  • Adds 3 new config options:
    • holeLimit: can be used to set a limit on the number of stacks a Temporal Hole can hold, mostly there if the server owner wants to nerf its storage capacity. Setting it to -1 or lower will revert to normal limitless behaviour
    • powerlessExtraction: lets the Temporal Extractor extract items without power at a base rate of 1 stack every 4 seconds. This speed can be increased if a faster source of  power is attached.
    • extractionSpeedModifier: allows you to increase or decrease how fast the Temporal Extractor extracts items. Also affects the base speed if powerlessExtraction is enabled
1.1.0 96 May 26th at 1:55 AM temporalhole-v1.1.0.zip 1-click install
  • Completely re-wrote how items get added to the temporal hole, previously it relied on some jank by overriding the Items TryMerge method, but now works via a harmony patch and sending a packet to the server telling it to handle the inventory stuff properly
  • Items can now be added to the Temporal Hole by ctrl-clicking on them while holding it. This is much faster if you have a bunch of items in different slots, as you can now just click on each one in a row, rather than dragging each one to the hole individually

 

De-janking my code made getting the mod working the way I wanted so much easier, so take that as a lesson to do things the right way instead of settling for quick workarounds

1.0.0
1.20.9 - 1.20.10
73 May 22nd at 4:21 AM temporalhole-v1.0.0.zip 1-click install

-Initial release


10 Comments (oldest first | newest first)

💬 Entity, Jun 12th at 8:54 PM

I would love to see another part to this that adds an interface, allowing you to select which items to pull out, instead of extracting items in random order.

💬 PurplePi , Jun 2nd at 4:59 PM

Amadeo4444 Yeah, that one's my bad, I've changed the description on the extractor to hopefully make it clearer

💬 Amadeo4444, Jun 2nd at 2:16 AM

in fact, after connecting the mechanical power everything started working, I just didn't see any information about it and I thought it would spin by itself

💬 PurplePi , Jun 1st at 12:08 AM

Amadeo4444 Do you have mechanical power attached to it? I'm not sure if I explained that part well enough. The arms of the machine should be spinning around.

💬 Amadeo4444, May 30th at 7:45 PM

I'm playing on version 1.20.10, putting items into the temporal hole works, but Temporal Extractor, although it generates teal particles, does not extract items from it. I tested with and without the funnel.

💬 Taeo, May 28th at 8:39 PM

Slick idea for a jonas device

💬 Vogi, May 26th at 4:31 PM

Really interesting idea, I like it! :)

💬 PurplePi , May 26th at 2:02 AM

Vigilance It should hopefully work with Xandu's inventory tweaks now, and as a bonus, I managed to let you store things by just ctrl-clicking on them with the Temporal Hole instead of dragging everything in individually.

In a way I should thank you, since getting everything working required actually implementing things properly instead of using janky workarounds.

💬 PurplePi , May 25th at 7:35 PM

Vigilance Yeah, any mods that change the way the inventory works will probably break that functionality. I'll do my best to add in a secondary method of using it that will hopefully work regardless.

💬 Vigilance, May 25th at 6:52 PM

I am not sure I understand the use case. Ctrl click with an item on my cursor? I think I've gotten used to Xandu's inventory tweaks, which I think would block that function and just swap the hole back and forth, unless I'm insane and the vanilla function already does that. 

 (edit comment delete)