The-Homebrew-Cloud/dosbox-wii
2
0
Fork 0
mirror of https://github.com/retro100/dosbox-wii.git synced 2024-11-04 17:35:10 +01:00
Code Issues Packages Projects Releases Wiki Activity
616ec67f7b
dosbox-wii/docs/Wii_user_manual.md
retro100 6d43b892ec
Update Wii_user_manual.md
2021-03-21 14:26:01 +01:00

3.6 KiB
Raw Blame History

Wii user manual

General

You need a Wii Remote and a USB keyboard. The C: drive will automatically be mounted to sd:/DOSBox/ if loaded from apps/dosbox-wii/. Otherwise, the directory the dol is loaded from will be mounted as C, and sd:/DOSBox as D (if present). The Z: driver is a virtual drive that is part of DOSBox.

Other drives can be mounted using the MOUNT command. Prefix sd: for an SD card, and usb: for a USB drive. The Wii's DVD drive and network folders can't be mounted at this time.

The configuration file is loaded from the directory the dol is located in (if present) and sd:/DOSBox/dosbox.conf otherwise. This file will be created automatically after you start DOSBox. Please edit it with a text editor to choose settings appropriate for each game.

Press the Home button, type "exit", press Ctrl+F9, or press Reset (on the console) to exit.

Compatibility

Most games work properly now; however, many games will require some sort of adjustment to the dosbox.conf file. It is recommended to try the game you want to play on the PC version of DOSBox first to discover the optimum settings. If you need multiple different dosbox configurations (e.g. one configuration per game) then follow the section multiple different dosbox configurations.

Using multiple different dosbox configurations

By default, Dosbox Wii uses the dosbox.conf configuration file from the app directory if it exists. If Dosbox Wii is installed in the sd:/apps/dosbox-wii directory, this is the sd:/apps/dosbox-wii/dosbox.conf configuration file.

If the dosbox.conf file does not exist in the app directory (e.g. sd:/apps/dosbox-wii/dosbox.conf), Dosbox Wii will try to load the file from the DOSBox root directory by default (e.g. sd:/DOSBox/dosbox.conf). If it does not exist either, it will be created in the DOSBox root directory (e.g. sd:/DOSBox/dosbox.conf).

To use different configurations for different DOS games for the Dosbox Wii, you can simply use multiple Dosbox Wii installations.

  1. The configuration file in the DOSBox root directory should not exist (no sd:/DOSBox/dosbox.conf file). Best is to move the configuration file from sd:/DOSBox/dosbox.conf to sd:/apps/dosbox-wii/dosbox.conf. Create desired number of copies of the directory sd:/apps/dosbox-wii. For example, sd:/apps/dosbox-wii-game1, sd:/apps/dosbox-wii-game2, sd:/apps/dosbox-wii-game3, etc. All Dosbox Wii installations (copies) share the same DOSBox root directory (sd:/DOSBox), which is not a problem.

  2. The directories (copies) sd:/apps/dosbox-wii, sd:/apps/dosbox-wii-game1, sd:/apps/dosbox-wii-game2, etc. should each contain the files boot.dol, dosbox.conf, icon.png and meta.xml.

  3. Per Dosbox Wii installation (sd:/apps/dosbox-wii, sd:/apps/dosbox-wii-game1, sd:/apps/dosbox-wii-game2, etc.) the title in the file meta.xml should be adjusted in the XML tag <name>, so that the different installations are also listed with different titles in the Homebrew Channel.

  4. Different configurations can now be made per Dosbox Wii installation. The configuration is to be made in the files sd:/apps/dosbox-wii/dosbox.conf, sd:/apps/dosbox-wii-game1/dosbox.conf, sd:/apps/dosbox-wii-game2/dosbox.conf, etc.. In the section [autoexec] you can also start the respective game. If the game is terminated, it can also terminate the dosbox automatically. For example, an entry for the game SC2000 could look like this:

    # ... other stuff ...

[autoexec]
C:
cd games/sc2000
sc2000.exe
exit

    The individual configurations per Dosbox Wii installation can also use a different mapper per installation. Accordingly in the section [sdl] with mapperfile = path-to-mapper-file.