CURRENT TOOL REFERENCE

Astral

A panel-by-panel guide to the current release, including conditional game tabs, floating windows, configuration, and scripting.

Core Tabs

Game Profiles

Mesh Shaders

How the menu is organized

The standard header contains Aimbot, Visuals, Misc, World, Settings, and Lua. A supported game inserts its own tab before Lua. Debug is only present in Debug and PrivTest builds.

Conditional controls

Many child settings appear only after their parent toggle is enabled. If an option from this wiki is not visible, enable the feature above it first. Game tabs appear only while Astral recognizes the matching GameId or PlaceId.

Current menu notes

Flick Bot is intentionally unavailable and forced off. General-purpose bullet tracer controls are not in the Visuals tab; the currently exposed bullet-trail feature is the Criminality-specific local-shot tracer.

Launch & Requirements

What the current Windows client expects and the safest launch order.

Supported environment

Item	Requirement
Operating system	64-bit Windows 10 or Windows 11.
Graphics	A DirectX 11-capable GPU and a current graphics driver.
Runtime	Microsoft Visual C++ 2015-2022 Redistributable (x64). Install it if Windows reports a missing `VCRUNTIME140` or related DLL.
Client	The current Roblox Windows client. Keep the loader and Astral build current after Roblox updates.

Recommended launch order

Download and run the current astral_loader.exe from the Astral website.
Start Roblox and join the target experience.
Launch the selected Astral channel and wait for Initialization complete.
Open the menu with the configured Menu Key, then create or load a profile.

After a Roblox update

If attachment, instance discovery, or a game-specific feature suddenly stops working, update Astral before changing offsets or deleting configs. Roblox updates can make an older build incompatible even when the menu still opens.

Common startup blockers

A stale build, missing VC++ runtime, outdated GPU driver, another overlay hook, insufficient process access, or security software quarantining a required file can prevent startup. Use the console message as the first diagnostic signal.

Interface & Profiles

The main menu plus the floating windows controlled from Settings.

Main and floating windows

Window	Purpose
Main menu	Two-column, four-panel layout. The game tab is inserted only for the current supported game.
Keybind List	Shows configured binds and their active state. It remains visible while the menu is closed.
Player List	Shows avatar, display name, `(@username)`, role, and player status controls.
Appearance	Theme colors and optional animated menu background shader.
ESP Preview	R15/R6 mannequin preview, element settings, colors, and placement.
Configuration	Local, personal-cloud, and marketplace configuration management.
Lua Editor	Script editor, local/cloud script browser, execution controls, and console.

Appearance

Control	What it changes
Accent / Accent Secondary	Primary and secondary highlights used throughout the menu.
Text	Normal interface text color.
Main Border / Outer Border	Panel and outer-window border colors.
Enable Shader	Enables an animated shader behind the menu.
Shader Type	Galaxy, Endportal, Snow, Smoke, or Nebula.
Shader Tint / Opacity	Colors and blends the selected menu shader.

Configuration

Action	Behavior
Create	Saves the current settings as a new local profile.
Load / Save / Delete	Loads, overwrites, or removes the selected local profile. Marketplace entries are read-only.
Personal Cloud	Loads, saves, and deletes configs stored on the signed-in account.
Push Local to Cloud	Uploads the selected local profile to personal cloud storage.
Marketplace config	Entries prefixed with `[Cloud by ...]` can be loaded but not overwritten or deleted.
Refresh / Open Folder	Refreshes all local and cloud lists, or opens the local profile directory.

Profile workflow

Create a local profile first, save after tuning, and then use Push Local to Cloud if you want the same setup on another machine. See Player ESP for the full Preview configuration.

Combat

Every control currently exposed by the Aimbot tab.

Standard Aimbot

Control	Options / range	Purpose
Aimbot Enabled + bind	Hold / Toggle / Always modes through the keybind widget	Turns standard aim assistance on and defines activation.
Aim Mode	Camera, Mouse	Selects camera rotation or mouse movement output.
Target Selection	Closest to Crosshair, Closest Distance, Lowest Health	Ranks eligible players.
Sticky Aim	Toggle	Keeps the current valid target instead of reranking every update.
Show Aimbot FOV Circle	Toggle	Draws the configured targeting radius.
Aimbot FOV	10-800	Maximum screen-space acquisition radius.
Hitboxes	17-part multi-select	Chooses eligible body parts.
Hitbox Priority	Closest to Crosshair, First Visible (Fast), Nearest Point (Multipoint)	Selects the hitbox resolver.
Multipoint Mode	2D Screen-Space, 3D World-Space	Controls how nearest points are generated.
Point Density	Low 9, Medium 15, High 27, Ultra 125	3D multipoint sample count.
Hitbox Scale	0.10x-1.00x	Scales the multipoint sampling region.
Smooth / Smooth Value	1.0-15.0	Reduces abrupt aim movement.
Bezier Smoothing	Intensity 0.1-5.0; Micro-Jitter 0.0-3.0	Adds curved motion and optional micro variation.
Prediction	Amount 0.000-1.000	Leads moving targets by the configured amount.
Team Check (Combat)	Toggle	Excludes teammates from combat targeting.

Backtrack & Silent Aim

Control	Options / range	Purpose
Enable Backtrack	50-500 ms	Uses a recent stored target state inside the selected time window.
Visualize Ghosts	Toggle	Displays the stored backtrack states.
Silent Aim + bind	Toggle and keybind mode	Enables the silent targeting path.
Silent Mode	Rotation, Viewport, Universal	Selects the silent-aim implementation.
Silent Bone	Head, Upper Torso, Humanoid Root Part, Lower Torso, limbs, Closest Part, Closest Point	Chooses the silent target part.
Sticky Aim	Toggle	Retains the current silent target while valid.
FOV / Show FOV	10-800	Sets and optionally displays the silent acquisition radius.

Triggerbot, Anti-Aim & Spinbot

Control	Options / range	Purpose
Triggerbot + bind	Single Click or Hold	Fires while an eligible target is under the trigger condition.
Use Delay / Cooldown	0-300 ms	Adds time-on-target delay and shot cooldown.
Enable Anti-Aim	Toggle	Enables yaw and pitch manipulation controls.
Yaw	None, Backward, Left, Right, Jitter, 3-Way Jitter	Selects the yaw pattern.
Yaw Base	Camera, Velocity, World	Sets the yaw reference frame.
Directional Offset	-180 to 180 degrees	Offsets Backward, Left, or Right modes.
Jitter	Angle 10-180; Speed 0.1-10.0	Controls the two-direction jitter pattern.
3-Way Jitter	Speed 0.1-20.0; three angles -180 to 180	Cycles through three configured yaw angles.
Pitch	None, Up, Down, Upside Down, Custom	Selects pitch behavior; Custom exposes -180 to 180 degrees.
Enable Spinbot	Speed 0.1-5.0	Applies continuous spin at the chosen rate.

Unavailable control

Flick Bot is intentionally removed from the menu and forced disabled by the current build.

Player ESP

Open Settings → Show ESP Preview, then click Config in the preview window.

Preview and master control

Control	Behavior
Master Switch	Enables or disables the standard player ESP renderer.
R15 / R6	Changes the preview rig so element placement can be checked against either body layout.
Element placement	Preview elements can be positioned around the mannequin; the live ESP uses the matching placement.
Custom Elements	Lists custom ESP flags registered by Lua scripts and lets each one be enabled.

Editing elements directly in the preview

Action	Behavior
Left-drag a text element	Moves it to the nearest Top, Bottom, Right, or Left anchor. Elements on the same side automatically restack and save their new order.
Right-click a text element	Opens its element-specific color/options popup and a Font choice of Default or Pixel.
Drag the Healthbar	Snaps the bar to the nearest Top, Bottom, Right, or Left side. Right-click it to set HP Color.
Name popup	Name Color, optional brackets, Gradient Text, Gradient Start, and Gradient End.
Distance popup	Distance Color, optional brackets, and Max Distance 0-1000.
Tool popup	Tool Color and Show Tool Icon.
Flag popups	Team has separate Friendly/Enemy colors; Forcefield, Health %, Movement, Speed, Void Blink, and Lua custom flags each expose their own color.

Boxes & Lines

Control	Options	Behavior
Bounding Box	Corner, Full Rect + color	Draws the selected 2D box style around a player.
Box Fill	Color	Adds a translucent fill inside the player box.
Gradient Fill	2, 3, or 4 colors	Blends the configured colors through the box fill.
Skeleton	Toggle + color	Draws rig limb connections. Marked as a heavier element in the UI.
Head Dot	Toggle + color	Draws a marker over the head position.

Text, Info & Flags

Control	Behavior
Name	Shows either Display Name or Username, selected by Name Type.
Distance	Shows player distance.
Tool Name	Shows the equipped tool or weapon.
Forcefield	Adds a color-configurable forcefield flag.
Team Flag	Shows the resolved team state.
Movement State	Shows the current movement or humanoid state.
Speed / Velocity	Shows movement speed information.
Void Blink Flag	Shows a configurable-color flag for Void Blink state.
Health %	Displays numeric health percentage. This is separate from the Healthbar and the screen Health Indicator.
Text Outline	Outline alpha 0-255 and thickness 0.5-5.0.

Bars and color routing

Control	Options / behavior
Healthbar	Top, Bottom, Right, or Left placement.
Team Check (Visuals)	Filters visual rendering by team.
Use Team Color ESP	Uses the game-resolved team color for ESP.
Diff Enemy/Friendly	Enables separate Friendly Box, Friendly Fill, Enemy Box, and Enemy Fill colors.

Chams & Visuals

Chams, mesh rendering, radar, screen indicators, hit feedback, and map visuals.

Chams

Control	Options / range	Behavior
Type	Off, Convex Hull, Block (Material), Mesh Chams	Selects the player-chams renderer.
Material Type	Neon, Glass, Metal, Galaxy, End Portal, Snow, Smoke, Nebula	Block-chams material or shader.
Material Transparency	0.00-1.00	Controls block-chams opacity.
Visible Check	Occluded Fill and Outline colors	Uses separate colors for occluded geometry.
Outline Thickness	0.5-5.0	Sets outline width.
Gradient	Vertical, Horizontal, Radial + second color	Blends two fill colors.
Fade Effect	Speed 0.1-5.0	Animates opacity.
Pulse Effect	Speed 0.1-5.0	Animates pulse intensity.
Rainbow	Speed 0.1-5.0	Cycles hue.
Liquid RGB	Speed and Scale 0.1-5.0	Applies a flowing RGB effect.
Different Friendly Colors	Friendly Fill and Outline colors	Splits friendly and enemy chams colors.
Wallcheck Threshold	0.01-2.00	Tunes the visibility classification threshold.

Mesh Chams

Control	Options / range	Behavior
Render Engine	CPU, GPU	Selects the mesh-chams render path.
Wireframe	Toggle + color	Draws cached character meshes as wireframes.
Glow Outline	Thickness 0.1-5.0 + color	Draws the multi-pass outline glow.
Fill	Toggle + fill color	Renders filled mesh surfaces.
Fill Shader	None, Galaxy, Aurora, Snow, Plasma, Nebula, Hologram, Iridescent	Applies a GPU fill shader.
Shader Tint	Color	Tints the active shader without replacing its pattern.
Intensity	0.10-2.00	Overall shader strength.
Pattern Scale	0.25-3.00	Pattern size. Snow calls this Snow Density; Hologram uses Scanline Density; Iridescent uses Band Scale.
Animation Speed	0.00-3.00	Animation rate. Iridescent uses View Response, starting at 0.25.
Detail	Usually 0.25-2.50	Shader-specific detail: Star Density, Ribbon Sharpness, Flake Size, Arc Sharpness, Cloud Density, Glitch Amount, or Gloss.
Reset Shader Settings	Button	Returns intensity, scale, speed, and detail for the selected shader to 1.0.
Max Distance	10-1000	Stops mesh-chams rendering beyond the selected distance.

Iridescent is camera/view based: surface color responds to view angle and Gloss rather than using a fake automatic shine cycle.

Radar

Control	Options / range
Enable Radar	Master toggle.
Range	50-1000 world units.
Size	100-400 pixels.
Background Alpha	0.10-1.00.
Show FOV Cone	Displays the current viewing cone.
Rotate With Player	Rotates radar orientation with the local player.
Colors	Background, Border, Local Player, Enemy, and Friendly.

HUD, Indicators & Feedback

Feature	Controls	Behavior
Health Indicator	Vertical, Width 50-400, Height 2-20, Color	Draws local health on-screen; it is not the ESP health bar.
Yaw Indicator	Vertical, Width 50-400, Height 2-20, Color	Displays current yaw state on-screen.
OOF Arrows	Name, Distance, Radius 60-300, Size 5-25, Color	Points toward off-screen players.
Damage Indicators	Show Damage / Show Heal + separate colors	Shows damage and healing feedback.
Hit Notifications	Toggle	Displays hit notifications.
Hitmarker	Predicted or Confirmed; Size 8-96; Duration 0.10-1.50 s	Draws immediate predicted or delayed confirmed hit feedback.
Hitsound	Sound browser	Loads choices from `C:\astral\resources\sounds`.
Sound ESP	Toggle + color	Displays sound-origin visuals.

Map and Hit Chams

Feature	Controls
Map Wireframes	Color and Scan Cap 100-10000. Scans world parts and is marked very heavy.
Hit Chams	Duration 0.05-2.00 s, Outline 0.5-5.0, Fade Out, Fill and Outline colors.
Hit Chams Gradient	Vertical, Horizontal, or Radial with a second gradient color.
Hit Chams Pulse	Speed 0.1-10.0.
Hit Chams Rainbow	Speed 0.1-5.0.

Misc & Movement

Movement implementations, camera tools, model changes, networking effects, and experimental extras.

Movement

Feature	Controls	Notes
Walkspeed	Bind; Property (paired), Velocity (scale), or CFrame (teleport); Speed 16-200	Changes movement using the selected implementation.
JumpPower	Bind; Property (paired) or Velocity (impulse); Power 50-300	Changes jump strength.
No Jump Cooldown	Toggle	Removes the normal cooldown gate where supported.
Fly	Bind; Velocity (physics) or CFrame (teleport); Speed 10-500	WASD moves, Space/Ctrl changes height, Shift boosts.
Infinite Jump	Toggle + bind	Allows repeated jump activation.
Noclip	Toggle + bind	Disables local world collision handling.
Player No-Collide	Toggle + bind	Disables collision against other characters.
Viewmodel Mods	FOV 30-120; X/Y/Z offsets -5.0 to 5.0	Adjusts the first-person viewmodel.

Freecam & Tool Modifier

Feature	Controls
Freecam	Enable, activation bind, Active toggle, Camera Speed 10-300. WASD/QE moves and Shift boosts.
Tool Modifier	Material, Transparency 0.00-1.00, and Tool Color.
Materials	Plastic, SmoothPlastic, Neon, ForceField, Glass, CorrodedMetal, Foil, Ice, Brick, Wood.
Dump Tool Info	Requests equipped-tool information in the diagnostic output.

Desync & Extras

Feature	Controls	Behavior
Desync / Fake Lag	Enable + bind	Activates the desync state.
Interval Lag	50-2000 ms	Pulses desync and displays current send/desync progress.
Desync Ghost Visualizer	Ghost Color, Show Ghost Text	Displays the represented desync position.
Motion Ribbon	Anchor, Lifetime 0.10-2.50 s, Distance 1-40, Sample Distance 0.02-1.00, Width 1-24 px, Glow 0-3, Color	Builds a camera-facing glowing ribbon from sampled character movement.
Ribbon Anchor	Right Hand, Left Hand, Right Foot, Left Foot, Root	Selects the sampled body point.
Proximity Aura	Distance 5-100	Enables the local proximity action inside the chosen range.
Void Blink	Enable + bind, Double Tap to Confirm, Targeting Mode, Distance 5-30	Targets by Closest to Crosshair or Closest Distance and teleports with the selected distance.

Players & Group Match

Control	Behavior
Auto-Whitelist	Automatically marks players matching the configured Roblox Group ID.
Group ID / Apply ID	Sets the group used for automatic whitelisting and refreshes the group list.
Clear Group	Clears the current group whitelist cache.
Client Check	Enables the client-detection check used by the player system.
Clear Friendlies	Removes manually assigned friendly statuses.

World

Lighting, atmosphere, terrain, and water overrides.

Lighting

Control	Options / range
Time of Day	0.0-24.0 hours.
Custom Brightness	0.0-10.0.
Global Shadows	Toggle the Lighting shadow property.
Fullbright	Enables the fullbright override.
Dump Real World Values	Prints current ClockTime, Brightness, and GlobalShadows to the console.

Atmosphere

Control	Options / range
Ambient Color	Color and Intensity 0.00-3.00.
Outdoor Ambient	Color and Intensity 0.00-3.00.
Fog Color	Color, Fog Start 0-1000, Fog End 0-100000.
No Fog	Disables visible fog.

Terrain & Water

Control	Options / range
Water Color	Color override.
Water Transparency	0.00-1.00.
Water Reflectance	0.00-1.00.
Water Waves	Size 0.0-2.0 and Speed 0.0-100.0.

World values can be replaced by the game

Some experiences continuously update Lighting or Terrain. If an override appears to reset on a map change, toggle it off and on after the new map is ready.

Settings & HUD

Application behavior, floating windows, screen information, cursor indicators, and session status.

Application Settings

Control	Options / behavior
Streamproof	Uses the stream-proof window behavior supported by the current overlay path.
VSync	Synchronizes overlay presentation.
Max FPS	30-360 FPS overlay cap.
Menu Key	Changes the key used to open and close the menu; saved immediately.
Show Keybind List	Toggles the active-bind overlay.
Show Player List	Toggles the avatar/display-name player window.
Show Appearance	Toggles theme and menu shader configuration.
Show ESP Preview	Toggles the R15/R6 ESP preview and its Config popup.
Show Config Window	Toggles local/cloud profile management.

On-Screen Info

Control	Options
Style	Lined or List.
Scale	0.5x-2.5x.
Colors	Text Color and BG Color.
Identity / performance fields	Name, FPS, Frametime, Ping, Players, CPU, GPU, RAM, Network, Status, Time.
Player / game fields	Health, Speed, Weapon, Position, Shiftlock, Place ID, Game ID.

Cursor Indicators

Control	Options
Enable Cursor Indicators	Shows up to three feature-state slots near the cursor.
Slot 1 / 2 / 3	None, Aimbot, Silent Aim, Flickbot, Triggerbot, Anti-Aim. Flickbot remains unavailable even though the legacy indicator label exists.
Performance Warnings	FPS Warning, Memory Warning, and GPU Warning.

Session Info

Displays the current GameId, PlaceId, and mesh-cache progress as Parsed X/Y Meshes. A waiting state is shown until Roblox context is available.

Debug (PrivTest)

Diagnostics shown only in Debug or Release_PrivTest builds.

Panel	Contents
Performance Graphs	FPS, frametime, and memory graph toggles.
Aimbot Debug	Show Multipoint Points and Show Overlay Diagnostics.
Window Info	Menu position/size, display size, and mouse position.
All Windows	Scrollable list of active ImGui windows with position and size.
Performance	Live FPS, 90-frame FPS history, frame time, delta-time histogram, and frame count.
Weapon Icon Preview	All weapon-font glyphs with character code and mapped weapon tooltip.
Memory & Cache	Player, friendly, group whitelist, and cached entity counts.

Release builds

The Debug tab is intentionally absent from normal Release and Nightly menus. Its absence does not mean the build is incomplete.

Phantom Forces

Appears when the Phantom Forces detector recognizes the current experience.

Control	Behavior
PF Mode	Enables PF model decryption for targeting and ESP.
PF ESP	Enables the PF-specific player renderer with Enemy and Friendly colors.
Team Check	Filters same-team PF players.
Show Weapon	Displays the resolved weapon.
Resolve Names	Resolves PF models back to player names.
Body Part Colors	Separate Head and Torso colors.

Criminality

Dealer, crate, stock, highlight, and local-shot trail systems.

World ESP

Control	Behavior
Dealer ESP	Displays detected dealers.
Mystery Boxes ESP	Displays mystery boxes.
Crates ESP	Displays crate locations.
Crates Highlight	Highlights detected crates.
Highlighted Item / Clear	Shows or clears the currently selected stock item.

Stock Manager

Control	Behavior
Auto-Refresh Stock (10m)	Refreshes cached dealer stock every ten minutes.
Refresh Stock	Requests an immediate stock refresh.
Select Dealer	Chooses from dealers found in the current cache.
Stock List	Shows item quantity; selecting an entry sets it as the highlighted item. Out-of-stock items can be watched for a refresh.

Bullet Trails

Control	Behavior
Enabled	Enables local Criminality shot trails.
FirePos location	Shows a green `Found:` path when the held tool's `WeaponHandle.FirePos` is resolved, otherwise an orange diagnostic status.
Lifetime	0.10-2.50 seconds.
Width	1.0-12.0 pixels.
Glow	0.00-3.00.
Trail Color	Color picker for the trail and glow.
Shot endpoint	Matches a local ammo drop to a new `Workspace.Debris.BulletHole`.

Murder Mystery 2

Role-aware highlighting for GameId 66654135.

Control	Behavior
Murderer ESP	Highlights the detected murderer with a configurable Murderer Color.
Sheriff ESP	Highlights the detected sheriff with a configurable Sheriff Color.

Counter Blox

Dropped item and smoke controls for GameId 115797356.

Control	Behavior
Dropped Items ESP	Displays dropped weapons/items using the ESP Color.
Highlight Items	Multi-selects specific weapons and uses a separate Highlight Color.
Smoke Modifier	Overrides smoke Transparency 0.00-1.00 and Smoke Color.
Smoke Visualizer	Displays a configurable Visualizer Color and Size 1.0-20.0.

Blackout

NPC, tool, and airdrop ESP exposed when Blackout is detected.

Control	Behavior
NPC ESP	Highlights NPCs using separate Military Guard, Rebel Guard, Vulture Guard, and Default NPC colors.
Custom Tool ESP	Enables Blackout-specific tool discovery and display.
Airdrop ESP	Displays airdrops with a configurable Airdrop Color.

Defuse / Division

Conditional support for GameId or PlaceId 112757576021097.

Control	Behavior
Wallbang (Ignore Parts)	Exposes the game-specific wallbang control group.
Enable	Activates the Defuse / Division ignore-parts wallbang path.

Lua Editor & API

The current editor workflow and every registered top-level namespace.

Editor & Script Storage

Control	Behavior
Save Script	Saves the editor text under the entered local script name.
Script List / Load	Loads local scripts or read-only marketplace scripts prefixed with `[Cloud by ...]`.
Refresh Cloud	Refreshes marketplace Lua scripts.
Execute	Runs the current editor text.
Clear	Restores the starter script in the editor.
Clear Console	Removes captured print and error output.
Console	Updates every frame so output from spawned and delayed tasks is captured.

Core namespaces

Namespace	Registered API
`memory`	`read`, `write`, `read_string`, `read_ptr`, `write_ptr`, `deref`, `chain`, `read_struct`, `write_struct`. Primitive types: byte, int, float, double, uint64, int64.
`offsets`	Generated class/field tables, for example `offsets.Humanoid.Health`.
`astral`	`on`, `off`, `bind`, `version`, `tick`, `spawn`, `delay`, `cancel`, `sleep`, `wait`, `notify`.
`astral.time`	`now`, `delta`, `since`.
`astral.math`	`clamp`, `lerp`, `round`, `sign`, `angle_between`.
`astral.table`	`map`, `filter`, `find`, `index_by`.
`astral.log`	`debug`, `info`, `warn`, `error`.
`astral.store`	`set`, `get`, `delete`, `keys`. Persists string, number, and boolean values.
`astral.esp`	`register_flag(id, name, default_color)` and `add_player_flag(userid, id, text)`.

Namespace	Registered API
`draw`	`text`, `text_pixel`, `animated_text`, `animated_text_pixel`, `get_text_size`, `get_text_size_pixel`, `line`, `rect`, `rect_filled`, `circle`, `circle_filled`, `world_to_screen`.
`game`	`local_player`, `camera`, `workspace`, `place_id`, `is_alive`.
`players`	`all`, `me`, `count`, `get`, `find`, `closest`, `filtered`, `query`.
`input`	`is_key_down`, `is_key_pressed`, `get_mouse_pos`, plus the `VK` constants table.
`http`	`get`.
Constructors	`vec2(x, y)` and `vec3(x, y, z)`.

Lua UI

Group	Registered API
Windows	`ui.begin`, `ui.finish`, `ui.window`, `ui.begin_child`, `ui.end_child`, `ui.set_next_window_pos`, `ui.set_next_window_size`.
Widgets	`ui.text`, `ui.button`, `ui.checkbox`, `ui.combo`, `ui.color_edit`, `ui.drag_int`, `ui.drag_float`, `ui.slider_int`, `ui.slider_float`, `ui.input_text`.
Layout	`ui.separator`, `ui.same_line`, `ui.spacing`, `ui.tooltip`, `ui.collapsing_header`.
Persistent state	`ui.state`, `ui.bind_checkbox`, `ui.bind_slider_int`, `ui.bind_slider_float`, `ui.bind_input_text`.

ui.* calls are only valid inside an astral.on("ui", ...) handler. Prefer ui.window(name, fn) because it always balances Begin/End.

Examples

-- draw every frame
local id = astral.on("render", function()
    local me = players.me()
    if me then
        draw.text(24, 80, "Health: " .. tostring(me.health), 0xFFFFFFFF)
    end
end)

-- later: astral.off("render", id)

astral.on("ui", function()
    ui.window("My Script", function()
        local enabled, changed = ui.bind_checkbox("demo.enabled", "Enabled", false)
        ui.text(enabled and "active" or "inactive")
    end)
end)

Keybinds

Current bindable features and how their activation modes behave.

Bind modes

Mode	Behavior
Hold	Active only while the configured key is held.
Toggle	Each key press switches the feature between active and inactive.
Always	Active while the parent feature is enabled, without requiring a held key.

Feature	Where	List overlay
Menu Key	Settings → Application Settings	No
Aimbot	Aimbot → Standard Aimbot	Yes
Silent Aim	Aimbot → Silent Aim	Yes
Triggerbot	Aimbot → Triggerbot	Yes
Walkspeed	Misc → Movement	Yes
JumpPower	Misc → Movement	Yes
Fly	Misc → Movement	Yes
Infinite Jump	Misc → Movement	Yes
Noclip	Misc → Movement	Yes
Player No-Collide	Misc → Movement	Yes
Freecam	Misc → Freecam	No
Desync	Misc → Desync / Fake Lag	Yes
Void Blink	Misc → Void Blink Teleport	No

Changing a bind

Use the small keybind control beside the feature name, press the new key, and select the desired mode in the keybind popup. Enable Show Keybind List to verify active state without reopening the menu.

Performance Guide

The controls most likely to affect frame time and the order to tune them.

Feature	Cost signal	First adjustment
Map Wireframes	Marked Very heavy; scans world parts.	Lower Scan Cap or disable it.
Mesh Chams	Marked beta / not recommended for low-end systems.	Use GPU engine, lower Max Distance, then disable Fill or Glow.
Standard Chams	Marked heavy.	Disable animated effects and gradients before disabling the base renderer.
ESP Skeleton	Marked with a performance warning.	Disable Skeleton while keeping boxes/text.
Motion Ribbon	Cost rises with long lifetime and dense sampling.	Increase Sample Distance, reduce Lifetime/Distance, then reduce Glow.
3D Multipoint	Ultra uses 125 points per evaluated hitbox.	Use Low or Medium density, or switch to 2D mode.

Recommended tuning order

Disable Map Wireframes.
Reduce Mesh Chams Max Distance and confirm the GPU engine is selected.
Disable mesh Fill shaders or Glow Outline one at a time.
Disable ESP Skeleton and lower multipoint density.
Shorten Motion Ribbon Lifetime/Distance and increase Sample Distance.
Use the PrivTest FPS/frametime graphs to compare one change at a time.

Menu-open versus menu-closed FPS

If only the menu-closed path is slow, compare overlays that continue rendering while closed: keybind list, player list, on-screen info, ESP, chams, radar, indicators, ribbon, and game-specific ESP. The Debug graphs can isolate whether the problem is render cost or update/cache work.

Troubleshooting

Fast checks based on the current menu and diagnostics.

The menu does not open

Confirm the console reached Initialization complete. Press the saved Menu Key, not an assumed default. If the key was changed in another profile, check the saved menu-key setting or launch with a clean profile.

Aimbot is not acquiring a target

Check the parent toggle and bind state, FOV, selected hitboxes, Team Check, and target-selection mode. For Phantom Forces, enable PF Mode so player models can be resolved.

ESP is not showing

Open ESP Preview → Config and enable Master Switch plus at least one element. Check Visuals Team Check and game-specific modes. The preview can show configuration even before a live target is eligible.

Mesh Chams are missing or a shader looks flat

Confirm Type is Mesh Chams, Fill is enabled, the shader is not None, and targets are inside Max Distance. Session Info should show mesh parsing progress. For Iridescent, change the camera angle: it is view dependent.

Criminality bullet trails do not appear

Enable Bullet Trails while the weapon is equipped. The menu should show a green Found: FirePos path. A trail is emitted only after a local ammo drop is matched to a new Workspace.Debris.BulletHole.

A config did not save

Select a local or Personal Cloud profile before pressing Save. Marketplace entries cannot be overwritten. After a cloud operation, use Refresh and wait for the list to update before closing the client.

The Hitsound list is empty

Add supported sound files to C:\astral\resources\sounds, then re-enable Hitsound so the list is loaded again.

World values reset after a map change

Some games continuously write Lighting and Terrain properties. Wait for the new map to finish loading, then toggle the affected override off and on.

High CPU/GPU use or FPS drops

Follow the Performance Guide. Map Wireframes, mesh chams, Skeleton ESP, dense multipoint, long glowing ribbons, and multiple animated effects are the first settings to test.

Credits

Core third-party components visible in the current source tree.

Dear ImGui

Immediate-mode interface and overlay window framework.

LuaJIT

Embedded Lua runtime used by the editor and Astral API.

ImGui TextEditor

Syntax-colored editor used by the Lua window.

FreeType

Font rasterization used by the interface.

Reference coverage

This wiki is organized from the current menu implementation, game-specific panels, overlay windows, and registered Lua namespaces. Conditional children are documented under the same parent panel in which they appear.