Skip to main content

VRC Pickup

Allows objects to be picked up, held and used by players.

Proximity Rules

note

All of the rules described in this section also apply to "Interactables", i.e. UdonBehaviours that have an Interact event (they will also show a "Proximity" slider in the Inspector).

The "Proximity" value defines from how far away your pickup will be grabbable. It is given in meters, aka. "Unity units", where the side-length of one default Cube equals 1 unit.

There are 2 mechanisms of grabbing where the Proximity value will be in play:

  • Raycast: If you are far away from a pickup, or you are running in desktop mode, pickups will be highlighted if the "laser" coming out of your hands (in VR) or your head (desktop) intersects the collider on a pickup object. The distance calculation to compare against Proximity is different in VR and Desktop mode:
    • VR: The distance between the origin of the laser (i.e. your hand controllers) and the impact point on the collider, in meters
    • Desktop: The distance between the origin of the laser (i.e. your head or main camera position) minus an "extra reach" value to compensate for being unable to move your hands forward. This is an approximate value that also takes your avatar scale into account ("longer arms"). Since it is subtracted from the distance, it will allow you to grab objects that are technically outside of the "Proximity" range, but could be grabbed by moving your arms while standing in this position in VR.
  • Hover (VR only): If your hands are close enough to an object, pickups will be highlighted even if a ray in the direction of the UI laser would not intersect the object. This allows more natural "grabbing" of objects. The distance of reach is a sphere centered on your hands with a radius of 0.4 meters times your avatar scale (note that this value is not directly comparable to the "avatar scaling" system available to users, although changing the avatar scale that way can affect the reach).
    • The "Proximity" value is still compared against the raw distance between your hand and the collider on the pickup, meaning the "reach distance" described is only an upper bound for the closeness at which "Hover" mode will engage.
    • For example, setting the Proximity to 0 will require the hand to be inside the collider for the pickup to be highlighted (it will still be grabbable in Desktop mode however, because of the "extra reach" desktop users get to compensate).
    • As an advanced technique, you may want to adjust the Proximity value based on the data provided via the avatar scaling system.

Requires:

  • Rigidbody
  • Collider
ParameterDescription
Momentum Transfer MethodThis defines how the collision force will be added to the other object which was hit, using Rigidbody.AddForceAtPosition.
Note: the force will only be added if 'AllowCollisionTransfer' is on.
Disallow TheftIf other users are allowed to take the pickup out of someone else's grip
Exact GunThe position object will be held if set to Exact Gun
Exact GripThe position object will be held if set to Exact Grip.
Allow Manipulation When EquippedShould the user be able to manipulate the pickup while the pickup is held if using a controller?
OrientationWhat way the object will be held.
Auto HoldShould the pickup remain in the user's hand after they let go of the grab button.
- Auto Detect: Automatically detects what to do
- Yes: After the grab button is released the pickup remains in the hand until the drop button is pressed and released
- No: After the grab button is released the pickup is let go
Note: This only applies to control schemes which lack an independent "Use" input from "Grab", such as Desktop, Vive, and Vive-like input systems. This does not apply to Quest, Quest-like, and other input systems with a defined trigger.
Use TextText that appears when the user has an object equipped, prompting them to "fire" the object.
Requires "Auto Hold" to be set to "Yes".
Throw Velocity Boost Min SpeedHow fast the object needs to move to be thrown.
Throw Velocity Boost ScaleHow much throwing should scale. Higher = faster thrown while lower means slower throw speed.
PickupableCan you pick up the pickup?
ProximityThe maximum distance this pickup is reachable from. See section above for more details.