immersive-home/app/addons/godot-xr-tools/objects/world_grab_area.gd

65 lines
1.8 KiB
GDScript3
Raw Permalink Normal View History

2023-12-14 01:03:03 +02:00
@tool
@icon("res://addons/godot-xr-tools/editor/icons/hand.svg")
class_name XRToolsWorldGrabArea
extends Area3D
## XR Tools World-Grab Area
##
## This script adds world-grab areas to an environment
##
## For world-grab to work, the player must have an [XRToolsMovementWorldGrab]
## node configured appropriately.
## If true, the grip control must be held to keep holding the climbable
var press_to_hold : bool = true
## Dictionary of temporary grab-handles indexed by the pickup node.
var grab_locations := {}
# Add support for is_xr_class on XRTools classes
func is_xr_class(name : String) -> bool:
return name == "XRToolsWorldGrabArea"
# Called by XRToolsFunctionPickup
func is_picked_up() -> bool:
return false
func can_pick_up(_by: Node3D) -> bool:
return true
# Called by XRToolsFunctionPickup when user presses the action button while holding this object
func action():
pass
# Ignore highlighting requests from XRToolsFunctionPickup
func request_highlight(_from, _on) -> void:
pass
# Called by XRToolsFunctionPickup when this is picked up by a controller
func pick_up(by: Node3D, _with_controller: XRController3D) -> void:
# Get the ID to save the grab handle under
var id = by.get_instance_id()
# Get or construct the grab handle
var handle = grab_locations.get(id)
if not handle:
handle = Node3D.new()
add_child(handle)
grab_locations[id] = handle
# Set the handles global transform. As it's a child of this
# climbable it will move as the climbable moves
handle.global_transform = by.global_transform
# Called by XRToolsFunctionPickup when this is let go by a controller
func let_go(_by: Node3D, _p_linear_velocity: Vector3, _p_angular_velocity: Vector3) -> void:
pass
# Get the grab handle
func get_grab_handle(p: Node3D) -> Node3D:
return grab_locations.get(p.get_instance_id())