Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ASTRA228b/Astras-Pull-Mod-V1/llms.txt

Use this file to discover all available pages before exploring further.

Hand modes control which hand release event activates the pull boost. By default, the mod fires whenever either hand leaves a surface, which maximizes responsiveness. If you want more deliberate control — for example, to use one hand for climbing and the other for pulling — you can restrict the trigger to a single hand.

Available modes

The pull triggers when either the left or right hand releases a surface. This is the most responsive mode: every time you let go of a wall or platform with either hand, the boost fires (as long as your selected input is held).Best for: players who want maximum acceleration and don’t need to distinguish between hands.
The pull only triggers when the left hand releases a surface. Your right hand can touch and release surfaces freely without activating the boost.Best for: players who want to control pulls with one specific hand, keeping the other free for natural movement.
The pull only triggers when the right hand releases a surface. Your left hand can touch and release surfaces without activating the boost.Best for: the same reason as Left mode, but for players who prefer right-hand control.

How it works in code

The mod tracks whether each hand was touching a surface on the previous physics frame. A “release” is detected when a hand that was touching is no longer touching:
bool leftReleased  = !leftTouching  && lasttouchleft;
bool rightReleased = !rightTouching && lasttouchright;
GTPlayer.Instance.IsHandTouching() provides the current frame’s contact state. The selected hand mode then decides whether that release should fire the pull:
bool shouldPull = CurrentMode switch
{
    HandPullMode.Left  => leftReleased,
    HandPullMode.Right => rightReleased,
    HandPullMode.Both  => leftReleased || rightReleased,
    _ => false
};
The pull only fires when shouldPull is true and your selected input binding is held at the same time. If you release a surface without holding the input, no boost occurs.
Both mode gives you the fastest response because either hand can trigger the pull. Switch to Left or Right if you find accidental pulls firing when you don’t intend them to.

Build docs developers (and LLMs) love