GUIDE & SUPPORT
Everything you need
to get running.
Step-by-step setup, a full usage walkthrough, keyboard shortcuts, troubleshooting, and direct access to support — all in one place.
Setup
Get Aegis installed and ready on a fresh machine in under two minutes.
Download the zip
Grab Aegis.zip from the Download page. Save it anywhere — your Desktop, Downloads folder, wherever is convenient.
Extract the zip
Right-click Aegis.zip → Extract All. Choose a permanent folder — do not run Aegis directly from inside the zip. A folder like C:\Aegis\ works well.
Aegis.exe, Aegis.png, and aegis_bootstrapper.bat must be in the same folder.Place the bootstrapper
Drop aegis_bootstrapper.bat into the same folder as Aegis.exe. This file runs silently when Aegis starts and sets up what it needs. If it's missing, Aegis will show you exactly where to put it.
Add an antivirus exclusion (if needed)
Self-contained executables sometimes trigger heuristic AV flags. If Windows Defender quarantines Aegis.exe, add the Aegis folder to your exclusions: Windows Security → Virus & threat protection → Manage settings → Exclusions → Add a folder.
Launch Aegis.exe
Double-click Aegis.exe. You'll see a short boot splash (Bootstrapping → Verifying → Loading → Ready), then the main window opens. No install wizard, no .NET install required.
Using Aegis
The main workflow from launch to execution.
Open or create a script
From the Start page, click + New script to open a blank editor tab. Or click any script in the Explorer sidebar on the left to open an existing one.
Write or paste your script
Type or paste Luau code into the editor. The editor shows line numbers, has an acid-green caret, and supports standard text editing shortcuts. Tabs are preserved.
Launch your game
Open Roblox and get into a game. Aegis needs a running game client before it can inject.
Click Attach
Press the ↪ Attach button in the top-right of Aegis. The status bar at the bottom will update from No client to show a connected state once hooking succeeds.
Click Run ▶
Once attached, hit the acid-green ▶ Run button. Your script executes in the game. Watch the Console panel at the bottom for output and errors.
The Editor
Everything you need to know about writing and managing code.
| Feature | Description |
|---|---|
| Line numbers | Displayed in the left gutter. Stays in sync with your scroll position. |
| Multi-tab | Open multiple scripts at once using the + button in the tab bar. Each tab holds its own code independently. |
| Tab rename | Right-click the script in the sidebar → Rename. The tab label updates automatically. |
| Acid caret | The text cursor is styled in Aegis green. Selections highlight with a soft green tint. |
| Monospace font | Consolas is used throughout the editor for clear, readable code. |
| Left-edge pulse | A subtle acid-green flash on the editor's left border fires on every keystroke — visual feedback that input is registered. |
| Auto-save to tab | Code is saved to the tab in memory as you type. Switching tabs and returning preserves your code for the session. |
.luau file externally if you want to keep them long-term.
Console
The console panel shows real-time output from script execution.
Clear button
Wipes all console output. The panel fades out and back in smoothly.
Collapse / expand
Collapses the console to just its toolbar bar. Click again to restore. Useful when you need more editor space.
Close
Hides the console entirely. It reopens the next time you switch to a script tab.
Typing indicator
Three pulsing dots appear in the console while Aegis is processing or while you're actively typing code. They disappear automatically when idle.
Managing Scripts
The Explorer sidebar gives you full control over your script library.
| Action | How to do it |
|---|---|
| New script | Click + in the tab bar, or + New script on the Start page. |
| Open script | Click any script in the Explorer sidebar, or on the Start page under Recent Scripts. |
| Rename | Right-click the script in the sidebar → ✏ Rename. Type the new name and press Enter. |
| Duplicate | Right-click → 📋 Duplicate. Creates a copy with "(copy)" appended to the name. |
| Execute directly | Right-click → ▶ Execute. Opens the script and runs it immediately. |
| Delete | Right-click → 🗑 Delete. A confirmation dialog appears before deletion. |
| Filter scripts | Type in the Filter scripts box at the top of the sidebar. The list narrows in real time. |
| Collapse sidebar | Click the ‹ arrow at the top of the Explorer. Click › to restore it. |
Keyboard Shortcuts
Standard text-editing shortcuts work in the code editor.
| Shortcut | Action |
|---|---|
| Ctrl + A | Select all code in the editor |
| Ctrl + C | Copy selected text |
| Ctrl + V | Paste |
| Ctrl + Z | Undo |
| Ctrl + Y | Redo |
| Tab | Insert a tab character (4 spaces) |
| Enter | New line (preserved indentation) |
| Home / End | Jump to start / end of line |
| Ctrl + Home | Jump to top of file |
| Ctrl + End | Jump to bottom of file |
Troubleshooting
Common issues and how to fix them.
"aegis_bootstrapper.bat was not detected"
The popup shows you the exact path where the bootstrapper needs to be. Place aegis_bootstrapper.bat in that folder, then relaunch Aegis.exe.
Windows Defender quarantined Aegis.exe
Self-contained .NET executables frequently trigger heuristic AV. Go to Windows Security → Virus & threat protection → Protection history, find the quarantined file, and click Restore. Then add the Aegis folder to exclusions so it isn't flagged again.
Attach doesn't work / status stays "No client"
Make sure Roblox is fully loaded into a game (not just the launcher or home screen). Try attaching again after you're inside a game world. If it still fails, rejoin the game and try again.
Script ran but nothing happened in-game
Check the console for error output. Common causes: the script references a service that isn't loaded yet, or the game has anti-cheat that blocked execution. Try a simple print("test") first to confirm the hook is working.
Aegis crashed or won't open
Make sure you extracted the zip fully — running from inside the zip itself causes crashes. Also verify Aegis.png is in the same folder as Aegis.exe. If the issue persists, ask in Discord with a screenshot.
Support
If you're stuck, the Discord is the fastest way to get help.
Join the Aegis Discord
Get real-time help from the community and the team. Post your issue with a screenshot and someone will help you out. Also the place for script sharing, announcements, and early access to updates.
discord.gg/larpblox