A bare MiSTer I/O board on a desk, fan in the middle, a microSD card in its slot.

Guide · Workbench 3.1

On the core

Every step of the Workbench 3.1 guide, and what happened to it on a MiSTer. The automated ones are one command.

The story behind this ledger is the core. What follows is one row per step of the guide, for anyone whose finished A1200 is going to live on a MiSTer.

Automated a script or the WinUAE pipeEliminated the core has no such stepOnce set in the OSD and savedBy hand still a click or a shell line on the Amiga

Start from a Workbench 3.1 hardfile that boots, the one WinUAE filled or one copied back from the card, and from the directory that has the scripts:

scripts/fetch_archives.sh archives mister
export SSHPASS
scripts/build_mister_image.sh --source A1200e-fresh.hdf \
    --out build/mister/A1200e-2026-09-27c.hdf \
    --romicon-newicons /path/WHDLoad_installs --ship

That copies the source and never writes to it, then runs rows 05 to 10 below against the copy: Picasso96 with the MiSTer monitor and uaegfx removed, the proven 16-bit 1280 by 720 ScreenMode, MUI, ClassAct, NewIcons, Scalos as the Backdrop with both palette files, lha and Installer, the RomIcon repair, and check_guide_hdf.sh. Any missing file fails the build. The sha256 is printed and written beside the output; --ship copies to /media/fat/games/Amiga/ and refuses a name that is already there. On the board: F12, the new file as primary master, reset. The first boot merges the NewIcons pictures into the disk and trashcan icons and flags that it has done so. The disk was proven in WinUAE first, with the other ledger’s verify_winuae_desktop.sh; AmiPilot cannot reach the core, so the looking happens before the copy.

  1. 01What the guide asks you to gatherKickstart, the six Workbench disks, and the archives. WinUAE is not one of them.
  2. 02Setting up WinUAEROM, RAM, chipset, and a hardfile. The properties window, JIT, and the Programs directory are gone.
  3. 03Formatting the disk and installing Workbenchcreate_system_hdf.sh replaces HDToolBox and Format. The six ADF swaps are floppy0.
  4. 04Windows, Clean Up, and SnapshotDrag, resize, Clean Up, Snapshot. The core has no shortcut for any of them; the Scalos Backdrop makes the first one moot.
  5. 05lha and Installerinstall_c_tools.sh writes lha and Installer into C:. The Shell stays closed.
  6. 06Picasso96install_picasso96.sh writes the libraries and the MiSTer monitor. The mint writes the 16-bit ScreenMode the board saved once; 24-bit rows draw wrong colors.
  7. 07MUIinstall_mui.sh writes the libraries and the MUI drawer. Saving Stuntzi.prefs stays a menu.
  8. 08ClassActSkip it for MagicWB. install_classact.sh writes SYS:Classes for the NewIcons path.
  9. 09Replacing the iconsFour choices. install_newicons.sh takes method 2. WHDLoad RomIcons get their .newicon merged in. MagicWB icons get their pens.
  10. 10Scalosinstall_scalos.sh writes the files, the menu, the Backdrop, and both palette files. No drag.
  11. 11Installing WHDLoadThe Programs folder is gone. A Workbench that already has C:WHDLoad skips the installer.
  12. 12Installing a gameNo directory mount. An installer that wants the original disks gets them from DF0.
  13. 13Turning JIT offThere is no JIT on the core, so there is nothing to disable.
  14. 14AmiCDROMWinUAE SCSI emulation has no counterpart on this core. The chapter goes.
  15. 15AWebbsdsocket.library emulation is a WinUAE option. Without it, AWeb has no network.

Adapted from The Green Amiga Alien guide. Hardfile and RTG details follow the Minimig-AGA README. Pipe commands are in the driver note.