Onslaught CE

Onslaught CE is a native port of Battle Engine Aquila for Windows and Linux.

README

Onslaught CE

Status: preview. From 0.1.8 on it updates itself; from 0.1.7 or earlier, download the latest release once by hand. Last updated: 2026-11-11 Summary: the native Battle Engine Aquila port: how to install, play, update, report a problem and build it, and where the project's other repositories are.

This README follows this source branch, which can describe work that is not in the latest download. The README packaged with your download and the release notes describe the version you installed. Versions 0.1.8 and later have a signed-update path; versions 0.1.0 through 0.1.7 require the one-time manual migration below. On Linux, if you still use 0.1.8 or 0.1.9, check the 0.1.13 or 0.1.12 release notes for their 32-bit dependency caveat.

Onslaught CE is a native port of Battle Engine Aquila (Lost Toys, 2003) for Linux (i686) and Windows (i686), built from the game's source code. You need your own copy of the game.

Contents

Quick start

New players start here. If you already have Onslaught CE, follow Getting the latest version instead.

  1. Choose the package for your system from the Releases page. Extract it into a new, empty, ordinary folder, separate from the original game and every old CE folder.
  2. Run onslaught-ce (Linux) or onslaught-ce.exe (Windows).
  3. It finds your Steam copy of Battle Engine Aquila by itself, or asks once where it is.

Keep the program and its user folder separate from the original game. Careers and settings go to $XDG_DATA_HOME/onslaught-ce (Linux, or ~/.local/share/onslaught-ce when unset) or %APPDATA%\Onslaught CE (Windows) by default. Keep recovery copies of your careers before changing save locations or removing any program folder.

This is an early preview. The main menu and onslaught-ce --version show your version and build. The latest release notes list the checks made and the remaining limits; the source here may include changes that are not in that download.

Getting the latest version: one download by hand, then it updates itself

Why by hand, this once? The updater in Onslaught CE 0.1.0–0.1.6 tidied up at startup by deleting any folder next to the game folder whose name started like it (for example Onslaught CE.old-backup beside Onslaught CE). We know of no case where this deleted anything of a player's, but it could, so 0.1.7 switched updating off. 0.1.8 brings updates back with a new updater that only ever touches its own two folders (versions inside the Onslaught CE folder and update-v2 in your user folder), never anything beside them; it checks every update's signature before using it, and can go back to the previous version. Old launchers cannot reach it, so you download the latest release yourself once; after that it updates itself.

From any earlier Onslaught CE (0.1.0 to 0.1.7):

  1. Close Onslaught CE. Do not start the old version again (from 0.1.0–0.1.6, not even to check its version).
  2. Back up your careers and settings: copy the folder ~/.local/share/onslaught-ce (Linux) or %APPDATA%\Onslaught CE (Windows; paste that into the Explorer address bar) somewhere safe.
  3. Download the latest package for your system from the Releases page.
  4. Extract it into a new, empty folder. Do not extract it over the old one.
  5. Run onslaught-ce (Linux) or onslaught-ce.exe (Windows) from the new folder. It finds your careers and settings by itself. Then point your shortcut at the new folder.

Keep the old folder and your backup until you are happy; never run the old launcher. If you set BEA_USER_DIR for an earlier version, set it the same way for the new version. Anything unusual (a relative BEA_USER_DIR, data in several places, folders you are unsure of): follow the detailed migration instead.

In the game

  • Main menu > Onslaught CE: a page with Bonus Levels, CE Settings, Cheats, Help & Info and Report a Problem. Each row has a hint under the list. The Options page is the original's.
  • Bonus Levels: Aquila Prototype, Building Defence, and Race Challenge 1 to 5 (each below). None of them advances career progress. A bonus level started here comes back to this list with its row highlighted.
  • CE Settings: a list of choices, each written to ce.ini in your user folder when you make it. The page is not on the menu while a session is recorded.
    • Rows: HUD Size and HUD Layout (the HUD on a wide screen, see Screen modes and widescreen), Sharper Text (experimental), End-of-Level Stats, Controller Rumble, Dodge Button (see Dodging), Developer Information, Your Music (shows the folder ce.ini sets: see Your own music below), Music Order, Console Text, Check for Updates at Start and Record Play for Bug Reports (see Help make Onslaught CE more faithful).
    • Choosing: Select opens a row's list of choices, and so do Left and Right, which also move to the choice before or after; in the list they move as Up and Down do. Nothing is written until Select picks a choice other than the one shown, and Escape closes the list unchanged.
    • When a change applies: the row's hint says. It is from the next level for the two HUD rows and Dodge Button, the next time the console opens for Console Text (the developer information text keeps its colour until the next start), otherwise the next time you start the game.
    • If ce.ini cannot be written, a message says so and the row keeps its old choice.
  • Unfinished features: they are listed, switched off, under [Experimental] in ce.ini; they are unsupported and liable to change.
  • Help & Info: Controls & Tips (dodge, zoom, photo mode and screenshots, the console and the free camera), What's Coming (planned features and their current limits; its entries do not start those features), Updates & Rollback (whether CE Settings has update checks on, how to roll back, where ce.ini is), About Onslaught CE (version, licence and links) and Special Thanks.
  • Aquila Prototype: level 201, the original's playable-demo level, which the full game never offers. It does not advance career progress and returns to the Bonus Levels list. Settings can still be saved, including into a career file.
  • Building Defence: a two-player co-op map (level 856) that the original's Multiplayer page leaves out: together, defend the island's buildings against the landing craft. The original ships this scenario twice, as levels 856 and 858, which are the same map, so the list has one entry. Both players share this PC, in split screen, as in the original's multiplayer: each picks a Battle Engine on the Multiplayer start page; player 2 uses the second set of keys in Controller Options, or a second gamepad. Like the other bonus levels it does not advance career progress and comes back to the Bonus Levels list; settings can still be saved.
  • Race Challenge 1 to 5: the original's five one-player time trials (levels 901 to 905): three laps against the clock in the Racer Battle Engine. The original opens them from the Goodies page, in the five cells that follow the first eight of its top row: Race Challenge 1 once you have a grade of C or better in 26 campaign levels, and each later race when the one before it is finished fast enough (under 145, 195, 150 and 105 seconds for races 1 to 4; the fifth opens nothing more). The Unlock All Goodies cheat opens all five at once (see Cheats). Those routes save your career as the original does. The five rows on the Bonus Levels list start the races with none of that. Like the other bonus levels, a race does not advance career progress; when it ends (finished, lost or quit from the pause menu) nothing is saved and you are back on the Bonus Levels list, with that race highlighted. Settings can still be saved during play, including into a career file; bonus-level progress is left out.
  • Cheats: the original game's cheats as On/Off switches, on the Onslaught CE page; see Cheats.
  • The console: the original's developer console, back for solo play; press the ` (grave) key, left of 1 on a US keyboard. See The console.
  • Controllers: gamepads and flight sticks have menu controls and default play controls for solo, local two-player split screen (one pad for each player) and bonus co-op when joystick bindings have not been customized. Controllers can be plugged in while the game runs; for two players, plug both in before starting. See port/controller-input.md.
  • Keyboard: the port releases held keys on focus loss and attempts to repair delayed releases. Typed characters come from key presses rather than a desktop input method; letter and digit keys use their physical positions across keyboard layouts. For the walker's special move, see Dodging.
  • Alt-Tab and minimizing: CE holds the game clock while it waits for a minimized window, helping avoid a fast-forward when you return (the original can do that on a fast PC; BEA_PORT_MINIMIZED_CLOCK=run brings that back for comparison). This adjustment is off during recordings and replays.
  • A quiet console: the developers' messages are hidden unless BEA_PORT_VERBOSE=1 is set.
  • A log file for reports in your user folder, and session recording (both below).
Dodging

In walker mode, with your Battle Engine on the ground and not already dodging, the original dodge is a double tap of the strafe keys. With the default US keyboard bindings:

  • Dodge right: tap A, then D.
  • Dodge left: tap D, then A.

Dodge Button. Onslaught CE adds one press for it. Hold Left Ctrl and press A or D (or press the direction while holding Left Ctrl), or, on a gamepad, hold B (the right face button on an Xbox-style pad; the tutorial cue calls it the right button) and push the left stick left or right. The game then makes the two taps itself, through its own controls, and the dodge is the original one: the same speed, length and cost. For the instant it takes, about 0.15 seconds (three of the game's twenty updates a second), your own left and right are held back so that they cannot spoil it. If you pushed the same direction just before (0.1 to 0.2 seconds earlier), the first tap waits a moment, because the game would otherwise dash the other way. It follows whatever inputs you use to strafe, so a remapped layout works too. For the next dodge, let go and press again, or change direction with the button still held; a press made early in a dodge (it lasts about three quarters of a second) is dropped, one made in its last 0.35 seconds follows it at once. A key or button you have bound to a control of your own is not used, and flight sticks have no Dodge Button. It is on by default (Dodge Button: On on CE Settings, dodge_button=0 in ce.ini turns it off, from the next level), and it is off in session recordings and replays, demos and network games. The double tap below works as before, with it on or off.

Try releasing the first key before pressing the other. Aim for about 0.15 game seconds between presses: with the default timing, the second press must be more than 0.1 and less than 0.2 game seconds after the first. Too fast or too slow will not trigger a dodge. If you changed the bindings or use a different keyboard layout, check the left and right movement inputs in Controller Options and use those instead.

In eligible ordinary solo play, the English tutorial can show a contextual dodge cue when the radio message starts. The cue is off during session recording and replay; use this guide while recording. The same keyboard sequence and timing apply.

Zooming

With the default mouse binding, scroll the wheel down to zoom in and up to zoom out. With the default gamepad bindings in eligible ordinary play, the right bumper zooms in and the left bumper zooms out. You can change the bindings in Controller Options. Manual zoom only works with weapons that support it; some weapons zoom while charging instead. The English tutorial can show a zoom cue in eligible ordinary solo play, but not in recordings or replays.

Cheats

Onslaught CE > Cheats, in the main menu, turns the original game's cheats on and off. They are kept in ce.ini in your user folder and apply to every career. Typing a code into a career's name works too, as in the original. The Cheats page's switches are off while a session is being recorded and in replays; a code typed into a career's name still works then, as in the original.

CheatOriginal codeWhat it does
Unlock All LevelsTURKEYEvery level shows as open in the level select. Your career's real progress is not changed. In the console it also allows map, win and lose.
Unlock All GoodiesMALLOYEvery goodie on the Goodies page is open. Nothing is written to your career.
Goodie HintslatêteThe Goodies page shows the available unlock hints. While it is on, goodies cannot be opened, even with Unlock All Goodies.
God Mode OptionMaladimAdds God to Controller Options (in the pause menu, applying at once, and in Options, from the next level). God on: no damage and energy that never runs out. Set this way it is kept in ce.ini, not in your career. Turning the cheat off ends god mode.
Free CameraAuroreIn a level, F detaches the camera so you can fly around the battle. In the console it also allows camera and the remote camera.

These are default keyboard bindings. In ordinary play, Space changes the Battle Engine between walker and aircraft. F toggles Free Camera when its cheat is enabled. With the defaults, use the arrow keys to look around in Free Camera; ordinary mouse-look does not turn that camera.

Free Camera controls:

  • F: free camera on or off. Off returns to your previous view.
  • W / S: fly forward and back, in the direction you are looking.
  • A / D: slide left and right.
  • Arrow keys: turn left and right, look up and down. There is no up or down key and no speed key: look up or down, then fly, at one fixed speed.
  • Esc: freeze or unfreeze the battle without a menu. The camera still flies while the battle is frozen, so you can line up a screenshot. With photo mode (F11) the view is clear of the HUD, and F12 saves it.

The battle keeps going while you look around unless you freeze it, and your Battle Engine can be hit.

The cheats themselves write nothing to your career (only the end-of-level statistics read the original's count of god-mode uses, to show "CHEATER!"). A level you finish with their help, including one ended with the console's win, counts like any other: a win opens the next levels, earns its goodies and records its grade (a level's grade is only ever raised, never lowered). A code in a career's name works when the name contains it exactly, including latête on Linux and Windows.

The console

The original game has a developer console that the PC release never showed. Onslaught CE brings it back for solo play: press the ` (grave) key, left of 1 on a US keyboard, during a level. It drops down over the top of the screen, as a dark panel with the game's own log (what it loaded, and what commands print), and takes a command line. It never runs the original's command interpreter: it has its own list of commands, and never runs script files or key binds (so an autoexec.con in the game folder is ignored).

  • Keys: Enter runs the line, Tab completes a command name, Up and Down recall earlier lines, PgUp and PgDn scroll the log, Esc or the grave key closes the console. The game does not pause for it. A line holds up to 63 printable characters; anything longer, or a character the console cannot take, is refused rather than cut.
  • Always available: help (and help <command>), version, status, showvars, show <variable>, set <variable> <value> (views, weather, hit-flash colours and the console's own cg_consolealpha, each checked against its range), cg_whatami (graphics card), listatmospherics, navmapon and navmapoff (the landscape's navigation map), setgammabias <0 to 0.005> (full screen only), fmv_play (lists the game's films: the cutscenes 1-33, GILL_M_on_a_fork and UsTheMovie play from the Goodies page, ltlogo and openingfmv when the game starts; none plays during a battle), playsound <name> (a sound the level has already loaded) and splitscreen horizontal|vertical (for the next two-player game).
  • Developer information: devstats (or devstats on/off) shows the original developers' information text in the top left: level, game time, event-list size and events processed, thing count, frame rate, health, energy and score (or "GOD mode Score") and the Aug bar, and the game's own DEFAULT heap use. It is the text the developer build drew; the PC release never showed it. The TEXDATA and VBDATA heap lines of the original are left out: the PC game has no such heaps. Developer Information on CE Settings (dev_stats=1 in ce.ini) turns it on in every level; devstats changes it until the level ends. It is pale yellow as in the original, or green with Console Text: Green (console_theme=green), and only reads the game.
  • Your music: music says what your playlist holds and plays; music adddir <folder> adds a folder of your own tracks (the rest of the line is the folder, spaces included); music playtype single|linear|random; music next skips to your next track; music clear goes back to the game's music. These are the original's playlist commands (m_adddir, m_playtype), which the PC release never registered. They last for the session; ce.ini keeps the settings (below).
  • Photo mode: photo (or photo on/off) hides the HUD for pictures, as F11 does, and closes the console; F12 saves a screenshot (below).
  • With Free Camera on: camera (as the F key), remotecameraon (views from whatever is under the crosshair) and `