Frequently Asked Questions

Setup, the SD card, buttons, calibration and updates. For the full detail there is the User Manual (PDF).

SD Card & Booting Playing Calibration & Display Updates Buying

// SD Card & Booting

SD card and booting

Can I add VEXXON to my existing PiTrex SD card?#

No — VEXXON needs its own card, and that is by design. VEXXON is its own bare-metal system: kernel.img and kernel7.img are not programs running on top of something else, they are the system. The Pi boots straight into the game with nothing underneath it, which is what keeps the timing tight enough for clean, stable vectors.

Making it load from an existing card would tie the game to the loader and the surrounding SDK setup, where a change on either side can break the other. Staying self-contained is the reason it boots reliably across so many different setups.

Do I need to flash the card with BalenaEtcher or similar?#

No. There is no image to flash. The card you received is ready to use — put it in the Pi and power on. If you ever need to restore it, the files are simply copied onto a FAT32 card.

Where do the files go on the card?#

All files belong in the root of the card, not inside a subfolder. A card with a VEXXON/ folder on it will not boot. The card must be formatted FAT32.

The screen stays black and nothing boots#

  • Check that all files are present at the card root: kernel.img, kernel7.img, bootcode.bin, start.elf, fixup.dat, config.txt.
  • The card must be FAT32.
  • Make sure the Pi and the PiTrex board are seated properly and powered.

Do I need a different card for Pi Zero and Pi Zero 2?#

No. Your card carries both builds and picks the right one for your board automatically.

What should I see when it boots?#

First the owner splash for a few seconds: the title, your name and your serial number (NO. 042) — this is baked into your personal card. Then the start screen with the rotating fighter and PRESS BTN 1. Press Button 1 to start.

// Playing

Controls and gameplay

What does each button do?#

  • Button 1 — fire (hold to keep firing). Also confirms in menus and restarts after game over.
  • Button 2 — drop bomb. Also goes back / closes in menus.
  • Button 3 — open the settings menu.
  • Button 4 — pause during a game; on the start screen it opens the calibration screen.
  • Joystick — steer and change altitude.
Button 1 is always the "yes" button. Early Quick Start guides listed Button 2 for restart — that was a mistake in the guide, not in the game.

I died and I did not hit anything — what happened?#

Most likely you ran out of ammo. Running out of bullets ends the run, exactly like running out of fuel. Since version 1.11 the crash screen tells you which it was: NO AMMO, NO FUEL or BOSS AT WALL. Shoot fuel tanks to refill fuel, and keep an eye on your ammo before the boss.

My settings are gone after a restart#

Settings are only kept if you save them: choose Save Settings in the menu (Button 3). You should see SAVED. If it says FAIL, the card may be write-protected or full.

There is no sound#

Open the menu with Button 3 and check that Music and SFX are ON. The Sounds submenu lets you audition an effect to confirm.

On versions before 1.11 the music switch sometimes needed to be toggled off and on again to take effect. That is fixed in 1.11.

// Calibration & Display

Calibration and display

How does calibration work?#

Every Vectrex is slightly different, so VEXXON lets you align its output to your screen. From the start screen, press Button 4. You get a reference circle and one adjustable value at a time:

  • Joystick up/down — pick the value to adjust.
  • Joystick left/right — decrease / increase it.
  • Button 3 — save and exit (survives a reboot).
  • Button 4 — exit without saving.
  • Button 1 — reset everything to factory defaults (1.11 and later).

Aim for a circle that looks round and centered. Start with Offset X/Y and Size X/Y. You normally do this once.

The calibration circle is invisible / calibration seems to do nothing#

On versions before 1.11 the circle was drawn too dim to be seen on many Vectrex units, so the screen looked broken. Update to 1.11 — the circle is clearly visible now.

The picture is off-center, the wrong size, or distorted#

That is normal for an un-calibrated Vectrex. Use the calibration screen: Offset X/Y for position, Size X/Y for size. If lines look broken or garbled, adjust Delay Zero and Delay T1 in small steps.

Lines look bent, wavy or drifting#

Lower Seg Length in the View menu. On some machines — especially ones that have never been re-capped — setting Seg Length and Seg Cap to around 10 helps a lot.

// Updates

Updates and downloads

How do I get an update?#

Updates are free. Log in at your download area with the personal token printed on the letter that came with your card, and download your personal VEXXON<serial>.zip.

How do I install an update without losing my calibration?#

Copy only these two files onto the card, replacing the old ones:

  • kernel.img
  • kernel7.img

That is the entire update — nothing else changes between versions.

Do not copy the whole folder over. Your calibration lives in vectrexInterface.ini and your settings in vexxon.ini; overwriting them resets both to factory values.

Which version is on my card?#

Open version.txt on the card in any text editor. It shows the game version, for example version=1.11. See the release notes for what changed.

I lost my token#

Write me an e-mail from the address you used for your order and mention your serial number — I will send it to you again.

Does an update change my name and serial number?#

No. Your download is built personally for you, so your name and serial number stay exactly as they are.

// Buying

Buying VEXXON

Is there a digital version I can just download?#

No. VEXXON is a physical release only — a personalised card with its own serial number. A download-only edition was announced during the pre-order phase in 2025, but it was dropped: I decided to concentrate on the physical cards.

The download area is not a shop — it exists so that people who own a card can get updates for it, using the personal token from their card letter.

Why does it cost what it costs?#

The game is CHF 85.00. Everything above that on the order page is shipping and, for some countries, import duty — which is why the total differs depending on where you live.

What the 85 pays for is that nothing here is mass produced. Every card is built individually for its owner: your name and serial number go into the source, the game is compiled for you, and that card exists once. The box is assembled by hand after you order it, and it contains a printed Vectrex overlay, a manual and a card letter with your personal download token, so you keep getting updates.

The shipping went up between the first and second run for two reasons. Several parcels from the first batch arrived dented or crushed, so I moved to sturdier boxes and better packing material. And customs handling for the USA and the EU has become more expensive with the new electronic systems.

Where import duty applies I pay it in advance, so nothing is due when the parcel arrives. No surprise bill from the courier at your door.

Where can I buy it?#

Through the shop at rogerboesch.games. Cards are produced in batches, so availability depends on the current run — the front page always shows the state of the next batch.

You also need a PiTrex board and a Raspberry Pi to play on a real Vectrex. Those are not included and are bought separately.