Transcient Grabbing

From Resonite Wiki
Revision as of 02:22, 25 July 2024 by AmasterAmaster (talk | contribs) (Lets try this again... since it was moved. Written technical information on how this works, written about how this interacts with the local home. (This page is under construction!))
This page is in a state of significant expansion or restructuring. You are welcome to assist in its construction by editing it as well.

This article or section is a Stub. You can help the Resonite Wiki by expanding it.


Transcient Grabbing (sometimes called "grab smuggling") is a Resonite feature that allows a user to transfer items (Slot's ObjectRoot or Grabbable) from one world to another.

Technical

How it works

Doing this makes a special slot in a user's userspace (a holder slot) and the slots or objects that is being grabbed by the user will be placed within that holder slot and then gets the TranscientGrabbable component added on the slot's object root. Then the slot gets pasted into the new focused world and that component is removed from it.

This cannot be done with users or user's avatar as those are protected.

Examples

Specialty Items

  • This makes items like Virgil's TARDIS work, by grabbing onto the item as you get transported to another world while still being inside the item.
  • One could make a backpack item that carries a slot that has all the user's items under it, effectively traveling and carrying items through the worlds.

Local Home

Most of the things you can do when transferring an item from other worlds will work in the local home, with one exception: Slots that have the SimpleAvatarProtection component will cause any slot in the local home to break, whether that is spawning them in, bringing them using transcient grabbing, or attempting to bring it out from the local home.

This breaks due to a user not having a user ID, or anything that identifies that user as that same registered user in Resonite.

Limitations

Permissions

The following permissions prevent grab smuggling:

(TODO)

References

You can transfer anything, but the down side is that anything referenced in the Assets Slot will be lost as references will be broken (even if the item looks totally fine, you have to be absolutely sure that the references are recreated if they are no longer there (Non-Persistent Slot)).

Avatars lose all sorts of references in this way when transferred between worlds.

- Component:TranscientGrabbable Powers this feature.