Transcient Grabbing: Difference between revisions

From Resonite Wiki
m ProbablePrime moved page Grab Smuggling to Transcient Grabbing: Lets name it after the component that handles it :)
m fixed tardis, Virgils do not go to other worlds, only the tardis by navy3001 and ultrawidegamer does
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{stub}}
'''Transcient Grabbing''' (sometimes called "grab smuggling") is a [[Resonite]] feature that allows a [[user]] to transfer items ([[Slot]]'s [[Component:ObjectRoot|ObjectRoot]] or [[Component:Grabbable|Grabbable]]) from one [[World|world]] to another.
'''Grab Smuggling''' is a [[Resonite]] feature that allows a [[user]] to bring items ([[Slot]]'s [[Component:ObjectRoot|ObjectRoot]] or [[Component:Grabbable|Grabbable]]) from one [[World|world]] to the next, smuggling the item that the user is holding. Useful for when a user needs to get a copy of an item from a world for a project or to be used as a reference, or also as a way to bring an item to a world for storage and saving reasons.
 
== 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 [[Component:TranscientGrabbable|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|avatar]] as those are protected.


== Examples ==
== Examples ==


=== Specialty Items ===
=== Specialty Items ===
* This makes items like [[User:Virgil|Virgil]]'s TARDIS work, by grabbing onto the item as you get transported to another world while still being inside the item.
* This makes items like Navy's TARDIS by navy3001 and ultrawidegamer, 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.
* 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 ===
=== Local Home ===


(TODO: Write how this works with the [[Local Home|local home]]. Along with use cases for this.)
Most of the things you can do when transferring an item from other worlds will work in the [[Local Home|local home]], with one exception: Slots that have the [[Component:SimpleAvatarProtection|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 ==
== Limitations ==


=== Permissions ===
=== Components ===


The following permissions prevent grab smuggling:
The following components prevent transcient grabbing:
* [[Component:WorldPermissions|WorldPermissions]] can stop items from spawning into the world, which include items being transferred from one world to another.
* [[Component:GrabBlock|GrabBlock]] can be used in a world that the item is at, stopping any chance from the slot from being transferred.


(TODO)
=== References ===


=== 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]])).


You can grab smuggle 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.


Avatars lose all sorts of references in this way when grab smuggled across worlds.
== See Also ==
* [[Component:TranscientGrabbable]] Powers this feature.

Latest revision as of 05:08, 7 September 2024

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 Navy's TARDIS by navy3001 and ultrawidegamer, 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

Components

The following components prevent transcient grabbing:

  • WorldPermissions can stop items from spawning into the world, which include items being transferred from one world to another.
  • GrabBlock can be used in a world that the item is at, stopping any chance from the slot from being transferred.

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.

See Also