Grab System Configuration
VIDEO PREVIEW : https://discord.gg/6PpcxDwR9E
This configuration controls the behavior of the Grab mechanic, allowing players to grab, attach, animate, and release another player.
Grab Distance
Config.GrabDistance = 1.45
Defines the maximum distance required to grab another player.
If no player is within this range, the grab action will fail.
Attachment Bone Settings
Config.AttachBone = 0 -- SKEL_Head
Config.FallbackBone = 0 -- SKEL_ROOT
AttachBone determines which bone the victim is attached to (e.g. head/mouth).
FallbackBone is used if the primary bone is unavailable, preventing attachment errors.
Offset & Rotation
Config.Offset = {
x = 0.005, y = 0.577, z = 0.107,
rx = 0.0, ry = 0.0, rz = 0.0
}
Controls the position and rotation of the grabbed player relative to the grabber.
This allows precise alignment for mouth, head, or carry-style grabs.
Victim Animation
Config.VictimAnim =
Specifies the animation played on the grabbed player while attached.
Notification System
Config.Notifications = {
NoPlayerNear = {
message = "No player nearby!",
type = "error"
},
PlayerGrabbed = {
message = "You have grabbed the player!",
type = "success"
}
}
Each notification can be fully customized:
enable or disable it
change the message text
choose notification type (success, error, info)
adjust display duration
Available events:
NoPlayerNear – triggered when no player is in range
PlayerGrabbed – when a player is successfully grabbed
YouWereGrabbed – notification for the victim
PlayerReleased – when the grab is released
YouWereReleased – notification for the victim when released
Core Dependency
This system requires Arcane Core to function correctly.