Skip to content
DragynrainPublic

About

Open-source engine for Adventure Construction Set adventures (bring your own files)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ACSVM

Play Adventure Construction Set adventures on today's computers, in a browser or on the desktop.

▶ Play in your browser · Playtest guide · Report a problem

The title screen: a pirate ship off an island harbour, with the buttons to play the tutorial or open your own adventure

In 1984 Electronic Arts released Adventure Construction Set, a kit for building your own tile-based fantasy adventures and playing them with friends. People made a lot of them, and many still sit on old C64, PC and Amiga disks. ACSVM is a new, open-source engine that plays those adventures, much as ScummVM does for LucasArts games: you bring the adventure files you own, and the engine runs them.

It comes with a short adventure of its own, First Voyage, so you can try it without any old disks.

ACSVM is a working name. This project has no connection to Electronic Arts and ships none of EA's code, art, music, manual text or adventures.

What it looks like

These screenshots are from First Voyage, drawn in our own pirate art.

A pirate on a wooden dock, a notice on the boards and a door to the trader The trader's store: goods on shelves cut into the wall, a door at each side, the player's gold and the store buttons
Walking. Arrow keys, mouse, touch pad or a gamepad. The panel on the right shows your ratings and what you carry. Stores. Walk up to a shelf to see its price, then buy or sell.
A pirate in a muddy cave facing a red shore crab, with the crab's ratings in the side panel The end-of-adventure window: You found the chest of coin!
Fights. Show more details lists every creature in the room with its temper, speed and weapon. The end. First Voyage takes under five minutes.

The world map of First Voyage in Explore mode, with its terrain list

Explore shows an adventure the way its designer built it: the world map, every region and room, and the lists of things, creatures and messages.

About Adventure Construction Set

Stuart Smith wrote Adventure Construction Set (ACS) on a Commodore 64, in Forth, and Electronic Arts published it in 1984. Apple II, Amiga and MS-DOS versions followed by 1987. It came with a full adventure, Rivers of Light, based on the Epic of Gilgamesh. Its real point, though, was the editor: you drew your own pictures, laid out a world map, regions and rooms, filled them with treasure, traps and monsters, wrote the messages, and saved the result to a disk you could hand to a friend.

ACS was the first construction set for graphical role-playing games. The text-only Eamon came earlier, but nothing like ACS followed until The Bard's Tale Construction Set in 1991 and Unlimited Adventures in 1993. For most of a decade, if you wanted to make your own graphical RPG, ACS was close to the only choice. What made it stand out:

  • Your game on its own disk. Each adventure was a disk anyone could copy and pass on. A fan club and a newsletter grew up around trading them.
  • Up to four players at one computer, taking turns.
  • Creatures with personalities. A designer could make a creature a fighter or a slinker, and an enemy, a friend, a neutral or a thief, so monsters fought each other as well as you.
  • Skills that grow with use, and weight that slows you down, both rare in role-playing games of the time.
  • A random adventure made by the program itself (Auto-Construct), built to the size and difficulty you asked for.

Reviewers at the time disliked its fiddly interface. They also saw the point: anyone could make a game. Years later, when Bethesda began Morrowind, Todd Howard said he was excited to make a tool like the ACS he remembered from the Apple II.

Why it's worth preserving

The adventures people made with ACS are small, odd and personal: made at home by players, traded by mail, and kept on floppy disks that are now forty years old. Many of the disk images online are damaged, and playing them means setting up an emulator for a 1980s computer and learning its controls. When those disks go, the games go with them. ACSVM keeps them playable on a modern computer or in a browser, so the people who made them, and anyone curious, can still play them.

Further reading: Wikipedia · MobyGames · The CRPG Addict's 2015 playthrough · The CRPG Addict on The Return of Heracles, Smith's earlier game · Dan Boris's ACS Viewer, which first mapped the file format

What you can do

  • Play the tutorial. Pick First Voyage on the title screen. Notes on the way explain moving, taking things, the store, a fight and a spell.
  • Play your own adventures. Drag a file onto the window, or use Open…. The table below lists what it opens. The file is read on your computer and never uploaded. The web page keeps an anonymous count of visits and a few events, with no cookies (what it counts).
  • Play together. Several players take turns at one keyboard, the way the original was played. Up to four gamepads work as well.
  • Save anywhere. A save file holds only the seed and the moves played, so it is tiny, and it replays a game exactly. That also makes it the best thing to attach to a bug report.
  • Pick a look. You can keep the original pixels, smooth them, or load an HD pack of new art. A coverage report shows which pictures a pack replaces.
  • Make it comfortable. Larger text, a colour-blind palette, an on-screen touch pad, and a turn-based option so the game waits for you.

Which files it opens

Computer Open this Status
Commodore 64 the adventure's .d64 disk image Plays. Tested on fan adventures from several collections.
Amiga the adventure's .adf disk image, or the adventure file copied off it Plays. Newer than the C64 and PC support, so less tested.
PC (MS-DOS) ADVEN.FPY or ADVEN.HRD from the adventure's folder Plays. Tested on EA's built-in adventure only.
ACSVM an .advx bundle Our own format for new adventures (docs/content.md).
Apple II Not supported yet. Its disks are laid out differently, and that reader isn't written.

Unzip downloaded disk images first. Other C64 formats (.d71, .g64, .t64, .prg) don't open.

How faithful is it?

Each rule (movement, combat, magic, creatures' behaviour, stores, encounters) is written down in docs/rules/ before it is coded. Most of it was then measured against the real C64 program running in an emulator: we set up a situation, ran it hundreds of times and compared the results with ours. Where something couldn't be measured, the rule says so and says what the engine does instead.

As a check on the whole, an automated replay plays EA's own Rivers of Light through to the end with two players.

If something plays differently from what you remember, please tell us. It is the most useful report we can get.

Status

All the rules are in, and the desktop and browser versions both work. We are now running a public playtest before 1.0, and we'd especially like to hear from people who played ACS back in the day:

  1. Read the short playtest guide.
  2. Play First Voyage, then your own disks.
  3. Open an issue using one of the forms: Something broke, Plays differently from the original, or Playtest notes.

Please don't attach saves or screenshots of EA's or other people's adventures to a public issue. The forms explain how to describe them instead.

Running it yourself

The easiest way is the browser version, which needs no installation. To build the desktop viewer you need Rust 1.95 or newer:

cargo build --release
target/release/acs-viewer            # then drag a file onto the window
target/release/acs-viewer GAME.D64   # or open one straight away

docs/usage.md covers the rest: the controls, the command line, the acs inspector (adventures to JSON, pictures to PNG), building for the web, and running the tests.

For the curious

  • docs/design.md: the plan and how the pieces fit
  • docs/rules/: the rules, one file per topic
  • docs/capture.md: how the original is measured in the VICE emulator
  • docs/content.md: writing new adventures from text files and starter kits
  • CONTRIBUTING.md: how to help, including the clean-room policy and the rule that no EA material ever enters the repository

Licenses

About

Open-source engine for Adventure Construction Set adventures (bring your own files)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages