js-dos 8.xx Help

Bundle creation

Starting from js-dos v7, the API expects a js-dos bundle that already contains all configuration needed to start the DOS program. js-dos bundle is just a ZIP archive that contains the game itself and a js-dos configuration file (same as dosbox.conf file). For example, digger.jsdos contains:

.jsdos/dosbox.conf - dosbox configuration file (required) .jsdos/jsdos.json - additional configuration (optional) DIGGER.COM - game file

You can generate a js-dos bundle programmatically. But, we recommend you use our bundle generator

Game Studio

Game Studio is part of DOS.Zone community project. It's a recommended tool for creating js-dos bundles.

js-dos bundles generated with game studio always support the latest features that js-dos have. It generates configuration files for you.

Bundles that are generated by game studio is not licensed, you can use them whatever you want.

Use Game Studio to create js-dos bundle

Advanced configuration


This file is a regular dosbox configuration. Not all features are supported, but we will work on it.


This file contains additional configuration that does not exist in the dosbox configuration file. For example, it's used to configure virtual controls. If you used game studio to create bundles then it will also contain all information from dosbox.conf. And it looks like:

{ "layers": [ { "grid": "honeycomb", "title": "Layer#0", "controls": [ { "row": 0

This file can contain any configuration that you want. You can access it with Command Interface. For example:

const ci = await Dos(/*element*/).run(/*bundle url*/); const config = await ci.config(); console.log(config.layers);

This snippet will print information about gestures that config has. It's a very powerful feature, it can be used to add new optional features to js-dos.

Last modified: 26 апреля 2024