Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ASTRA228b/Experimental/llms.txt

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

PSA Mod replaces passive physics movement with active joystick-driven acceleration. While enabled, your left or right thumbstick feeds a directional target computed from the head transform’s forward and right vectors, and the mod lerps your velocity toward that target every fixed update. Ground proximity is checked with a downward raycast so the mod can scale air control and drag differently depending on whether you are on a surface or airborne.

Parameters

Type: float | Range: 1 – 12Controls the target speed magnitude the velocity lerp aims for. Higher values reach top speed faster and feel more aggressive. The internal air-control ratio scales proportionally between 0.3 (speed = 1) and 0.7 (speed = 12), so faster settings also give more aerial steering.
Type: float | Range: 0.1 – 2.0The raycast threshold (in world units) used to decide whether you are “grounded.” A downward ray of length 10f is cast every fixed update; if the hit distance is less than or equal to MexGroundDis, the mod treats you as grounded and applies full drag. Increase this to stay grounded on bumpy or sloped surfaces; decrease it to preserve air momentum sooner after leaving a ledge.

Presets

PresetSpeedGround DistanceBest For
Legit4.50.6Subtle competitive movement
Comp6.50.8Tournament-style acceleration
Speed Boost9.51.0Fast open-map traversal
Ice7.50.2Slippery, low-drag sliding
Air Control8.50.4High-speed aerial steering
RandomrandomrandomRandom values within range
Reset10.1Minimum / off state
The Ice preset pairs a high speed with a very small ground distance (0.2), which means the grounded drag kicks in only when you are nearly flush with a surface — producing a slide-like feel. If you want that sensation but with more control, raise MexGroundDis slightly to 0.4–0.5.

How Grounded Detection Works

Every fixed update the mod casts a ray straight downward from the player origin with a length of 10f. The hit distance is compared against MexGroundDis:
  • Grounded (hitDist ≤ MexGroundDis): full drag is applied (scales from 0.98 at low speed to 0.90 at high speed), and a ground-correction lerp prevents the player from sinking below the surface.
  • Airborne (hitDist > MexGroundDis): drag is reduced and the air-control ratio (how much the joystick can steer) scales between 0.3–0.7 based on Speedd.
This means MexGroundDis is the primary knob for determining how “sticky” the mod feels on surfaces.

Getting Started

1

Enable PSA Mod

Toggle PSAEnabled on in the mod window to activate the acceleration system.
2

Load a preset

Click Legit or Comp for a conservative start. Use Speed Boost only in open areas — it can feel overwhelming in confined spaces.
3

Tune ground distance

If the mod feels like it “sticks” too much on ramps, lower MexGroundDis. If you lose ground traction after small bumps, raise it.
4

Select your joystick

Open the Input Settings tab and choose Right Joystick or Left Joystick depending on your controller grip preference.
5

Adjust speed

Fine-tune Speedd until acceleration feels natural for your movement style, or revisit presets to find a closer starting point.
Very high speed values (10+) combined with a large MexGroundDis can make the player difficult to stop once moving. Use the Reset preset to return to safe defaults if the mod feels uncontrollable.

Build docs developers (and LLMs) love