How to Use SCAR Toolkit for Age of Empires IV

The Offline tab is where you go to mess around freely: spawn units, give yourself resources, buff armies, test late-game fights, etc. Almost everything here is intended for single-player / vs AI / custom only.

General Offline Tools

The Offline tab contains a large collection of experiments. If one does not work on a particular patch or scenario, you can simply try a different one. Typical tools include:

• Instant eco / tech unlocks
• Unit and landmark spawning
• God mode / invulnerability experiments
• Economy or timing shortcuts
• Scenario-style helpers for testing army comps

Rate Modifiers (HP / Range / Damage / Walk Speed)

For the four main modifiers:

• HP – increase unit hit points.
• Range – extend attack range (where applicable).
• Damage – increase attack damage.
• Walk Speed – speed up movement.

You must have units selected before applying these. They are not global toggles.

The SCAR / Lua Runner tab is for users who are comfortable writing or editing code. You can:

• Write and save SCAR/Lua scripts.
• Inject them into the current game session.
• Use helper tools to debug entities, distances and player info.

Basic Script Pattern

Most simple scripts follow this structure:

function CustomScript()
    -- your SCAR / Lua code here
end

Rule_AddOneShot(CustomScript)

SCAR Toolkit injects this into the game and executes it once. From there you can add additional rules, timers and logic.

Run Modes: Force Loader, Run (Safe), Run (Raw)

Force Loader

Force Loader is designed for large scripts (roughly 200+ lines). Instead of sending one giant string directly to the game, it:

• Saves your script into a temporary .lua file.
• Then loads and runs that file inside the game.

This can be more reliable for big projects or complex modules.

Run (Safe)

Run (safe) wraps your code in pcall(). That means:

• Some errors are caught and prevented from blowing up the entire engine.
• There is less chance of an instant crash, but it is still possible if your code is heavy.

Run (Raw)

Run (raw) sends your script directly to the game with no pcall, no safety net. If there is a serious bug or infinite loop, it can crash the game instantly.

Use Run (raw) only if you know exactly what your script does.

Debug Tools

Show Entity Info

• Select a unit in-game.
• Use the Show entity info helper.
• It will read and display that entity’s internal info (IDs, blueprint etc.).

Distance Checker

• Checks distances relative to enemy Town Centers.
• Best used in a 1v1 skirmish where ownership is clear.
• Useful for testing “safe scouting radius”, siege ranges, etc.

Player Info

• Displays local player details on top of all Town Centers.
• Can show info for allies and enemies together.

Example: Giving AI Full Control

As mentioned in the Online tab, you can hand full control of your player to the AI using this code in the Script Runner:

function Configure()
    Game_AIControlLocalPlayer()
    AI_SetDifficulty(Game_GetLocalPlayer(), 6)
end

Rule_AddOneShot(Configure)

Run it with your preferred mode (Safe/Raw/Force Loader) and the game AI will take over your slot.

Online Quick Slots (5 Favourite Features)

The Settings tab includes 5 slots where you can save your favourite Online features. Think of them as presets for the tools you use every session.

• Pick up to 5 Online functions you use the most (e.g. 1v1 HUD, ESP, AoE4World, Score HUD, Auto Villager).
• Save them into the quick slots.
• Use these slots as fast toggles instead of hunting through every checkbox each time.

Custom Editor Theme

You can customise the built-in code editor to match your taste:

• Change theme colours (dark, contrast, etc.).
• Make long coding sessions more comfortable on your eyes.

Language Settings

SCAR Toolkit includes basic UI localisation for the editor and some labels. Currently supported languages are:

• English (default)
• Spanish
• Chinese
• Russian

Select your preferred language in Settings. Some advanced debug strings and script names may remain English.

Other Behaviour & Update Options

Depending on your build, Settings may also expose:

• How often the app checks for updates.
• How frequently it refreshes license status.
• Small quality-of-life toggles for notifications or logs.

Spend a few minutes here at the start. A good setup (theme, quick slots, language) makes the rest of SCAR Toolkit feel much smoother.