ECLIPSE
Install guide

Download Eclipse

Windows 64-bit, about 60 MB, Java included. It installs without administrator rights and does not change your Beyond All Reason install.

Before you start

Before you start

Windows will warn you. The installer is not code-signed, so SmartScreen shows an unknown-publisher warning. That is expected. The download itself is checked: the installer verifies a signature over the package's hash before it unpacks anything.
Use a password you do not use anywhere else. The Eclipse server has no certificate yet, so signing in travels unencrypted. Treat the account as throwaway until that changes.

What you need

  • Beyond All Reason, installed and started once. Eclipse does not include the game and cannot install it. Download it free from the BAR site. Starting BAR once puts the engine and the game files where Eclipse can find them.
  • 64-bit Windows. There is no macOS or Linux build.
  • A window of at least 1280×720. Eclipse opens full screen; F11 switches to a window.
  • About 80 MB of disk for Eclipse itself, plus a one-off 37 MB download of tree and rock sets the first time you generate a map with biome trees. Generated maps are 15–80 MB each and land in your BAR maps folder.
  • Memory. The launcher sits in about a gigabyte, but map generation starts a separate process that can take several gigabytes for a minute.
  • Java is not a requirement — a Java runtime ships inside the download.
Step by step

Install and first game

Install Beyond All Reason and start it once

Skip this if you already play. Otherwise get Beyond All Reason first — it is free — install it and launch it at least once so it downloads its engine and game files. Eclipse reads that install; it never replaces it and never touches your BAR account.

Download Beyond All Reason ↗

Download the installer

One file, about 110 KB. It fetches the real package — roughly 60 MB — while it runs.

Download for Windows

Prefer to unpack it yourself? There is a zip instead. If your browser or network blocks the download, that is because it comes over plain HTTP from an IP address — see troubleshooting.

Run it, and click through the Windows warning

Windows SmartScreen will say the publisher is unknown, because the file is not code-signed. Click More info, then Run anyway.

You will not be asked for an administrator password — Eclipse installs into your own user folder, at %LOCALAPPDATA%\NeroxisLauncher.

Watch it install itself

A small window titled Installing Eclipse for Beyond All Reason walks through Connecting…Downloading… N of M MBChecking the download…Unpacking…Starting the launcher…

The check in the middle is the important one: the package's signature is verified against a key built into the installer, and the download is rejected if the hash does not match.

First start: say yes to the shortcut

Eclipse asks once whether to create a desktop shortcut, and puts Eclipse on your desktop if you say yes. Look at the top right of the window: it should read ● Beyond All Reason found. If it says the data folder was not found, jump to troubleshooting — nothing will start until that is fixed.

The Eclipse window on first start, showing the PLAY tab with Create game and Generate map buttons and a Beyond All Reason found indicator.
First start, not signed in. Everything offline already works.

Make your first map and play it — no account needed

  • On the PLAY page, click Create game.
  • In the left column pick Offline skirmish vs AI.
  • Leave ★ Generate map selected at the top of the map list.
  • Open the gear beside it if you want to choose the format, size, style or biome — or leave it alone for a 4v4 on a sensible size.
  • Click Start skirmish.

The map is built in a few seconds (about 7 for a 16×16), written into your BAR maps folder, and BAR starts on it. The first time, Eclipse also downloads the 37 MB of tree and rock sets — that happens once.

Make an account to play with other people

  • Click Sign in to play online at the top right, then Create account.
  • Pick a user name (2–20 letters, digits or _), an email address, and a password of at least 6 characters. Use a password you do not use anywhere else — the connection is not encrypted yet.
  • Your first 90 days are free. Nothing to enter, no card. One account per person — the free time is per player, not per name.

Eclipse stores the login token, never your password. You can turn off Stay signed in on this computer if you would rather type it every time.

Play a game on the server

  • The Eclipse games toggle shows the rooms on this server. Click one to join, or use Create gameOnline gameCreate to open your own.
  • In the room: pick a team, add AIs if you want, set the start boxes from a preset or drag them on the minimap, and press Ready.
  • Everything else downloads by itself while you wait — the map, the game version and the engine version. Watch for ✔ Map Ready, ✔ Game Ready and ✔ Engine.
  • The host presses Start, and Eclipse launches BAR into the game for you.

Updating

Eclipse updates itself. It checks on every start, and when a new version is ready a green bar appears with Restart to update. One click and it swaps itself over.

Do not re-download the installer to update. Running the exe again on a working install just starts the launcher.

Where everything lives

Eclipse itself: %LOCALAPPDATA%\NeroxisLauncher — the launcher, its Java runtime, your settings and the downloaded tree sets.

Generated maps go into your BAR data folder under maps\, as Eclipse_Mapgen_<code>.sdz files, so BAR itself lists them too.

Uninstalling

There is no uninstaller. Delete %LOCALAPPDATA%\NeroxisLauncher and the Eclipse shortcut from your desktop, and it is gone.

Maps it generated stay in your BAR maps folder until you delete them — from the MAPS page, or by hand.

The zip, if you prefer

Same thing without the installer: unzip it anywhere and double-click bar-map-launcher.bat inside the folder. Note that this route does not check any signature — the installer is what does that.

Download the zip (~60 MB)

If something goes wrong

Troubleshooting

It says the BAR data folder was not found
Eclipse looks in the default place, %LOCALAPPDATA%\Programs\Beyond-All-Reason\data. If you installed BAR somewhere else, either set a BAR_DATA environment variable pointing at that data folder, or type the path into the BAR data folder field — it is in Create game, in the Map generator column, behind the gear icon.
"Generation failed: some styles do not support every player count or size"
Exactly what it says. Several styles only work in a range — the island styles want big maps, and a few want exactly two teams. Pick another style, another size, or set the style back to Random land map.
"No engine found" or "Could not get the engine"
Eclipse borrows BAR's engine, its unpacker and its downloader. Start the official BAR launcher once and let it finish installing, then try again.
My browser or my network blocks the download
The download comes over plain HTTP from an IP address rather than a signed domain, and some browsers and many corporate networks refuse that. Try a different network, or keep the file when your browser offers to. The integrity check is the signature the installer verifies, not the transport.
Reinstalling lost my settings
It can: if the install folder is there but broken, the installer deletes and replaces it, and your settings and saved map choices go with it. Your generated maps are unaffected — they live in the BAR maps folder, not in Eclipse's.
Map generation is slow or runs out of memory
Generation runs in its own process with a large heap, and the biggest maps really do want several gigabytes for a minute. On a machine with little RAM, stay at 16×16 or below.
Trees look wrong, or every map has the same fir trees
The biome-appropriate trees come from a 37 MB download from GitHub that happens on the first generation. If GitHub was unreachable, Eclipse carries on with BAR's own fir trees and says so. Generate again once you are back online.
Eclipse is a small project on a single server. Things break, the server goes down, and there is no promise that anything is backed up. Treat it as what it is — somewhere to play on maps nobody has seen before, not somewhere to keep anything important.