Gaming & Emulation¶

• Console: To run OpenTyrian from console, use the following command: opentyrian
• Desktop: To run OpenTyrian from desktop, a desktop icon and start menu entry have been added.
• Autostart: To run OpenTyrian automatically at boot, select it from dietpi-autostart menu or directly via: dietpi-autostart 4

Tyrian (OpenTyrian) if not the best game in the world, is the best top down shooter/scroller game ever created.
OpenTyrian is best experienced by using a mouse and the Enter key to change rear fire mode.
It’s old, retro, and a classic etc, but I doubt you will to find a similar recent game that is anywhere close to OpenTyrian addictiveness.

The web interface is accessible via port 1339:

• URL = http://<your.IP>:1339
• Username = admin
• Password = <globalSoftwarePassword> (default: dietpi)

Tweak the server settings by modifying the following files:

• General server settings:

  /mnt/dietpi_userdata/cubrite/settings.ini
  

• Settings for the web administration:

  /mnt/dietpi_userdata/cubrite/webadmin.ini
  

• Settings for the world:

  /mnt/dietpi_userdata/cubrite/world/world.ini
  

You can restart the service by running:

systemctl restart cuberite

• Log files: /mnt/dietpi_userdata/cubrite/logs/
• Service logs: journalctl -u cuberite

Update to newest version:

dietpi-software reinstall 52

The web interface is accessible via port 8443:

• URL: https://<your.IP>:8443
  You can safely ignore the certificate “warning” if one appears.
• Username: root
• Password: The same as your root login password. Default is dietpi

Once logged into the web interface:

1. Click profiles on the left hand side of screen
2. Choose a Minecraft version to match your needs, then click download
3. Click create new server on the left hand side of screen
4. Enter a server name, then click create new server at the bottom
5. Your server will now be visible at the bottom of the dashboard screen, select it
6. In the drop down boxes Change profile to: and Change runnable jar to: select the entry which contains the server version number you downloaded in profiles
7. Click accept EULA
8. Click accept EULA again
9. Click Start

Your server should now be running, on the default port 25565.

Nukkit by default runs a single server, available on LAN.

Tweak the server settings by modifying the following file:

/usr/local/bin/nukkit/server.properties

You can restart the service by running:

systemctl restart nukkit

• Kickstarts (Amiga BIOS/boot system)
  Amiga Kickstart ROM images are required to run the system(s) you want to emulate. These can not be bundled due to copyright restrictions.
  If you own the Amiga Forever product, you can legally download and use Kickstarts you are eligible for, from: https://www.amigaroms.com/
  Remark:Kickstart 1.3 (A500-A2500-A3000-CDTV) is highly recommended to work with most games.
  Kickstarts can be placed in /mnt/dietpi_userdata/amiberry/kickstarts.

• Floppy disks (Amiga .adf images)
  Amiga’s floppy disk images have a .adf file extension.
  You will need obtain at least one ADF image to start your Amiga experience.
  Load your ADF from or place them where every you want it, e.g. create and use:
  /mnt/dietpi_userdata/amiberry/floppy_images
  To allow uploads via file servers, remember to grant required permissions, e.g.:

  chown dietpi:dietpi /mnt/dietpi_userdata/amiberry/floppy_images
  

• Amiberry can be started by running:

  systemctl start amiberry
  

• Optionally, you can enable Amiberry autostart to boot straight into the Amiga environment as fast as possible, with the least possible interference from Linux.
  Run dietpi-autostart 6 from console or dietpi-autostart and select Amiberry fast boot from the menu, then reboot your system.
  If you face issues with the fast boot option or need to have other services starting up first, use dietpi-autostart 8 or select Amiberry standard boot respectively.

Once Amiberry is running, you will need to configure the emulator, to tell it which Amiga system to emulate.

• Select Quickstart (from the left hand side menu)
• Under Amiga model: Select the Amiga model you’d like to emulate (example A500)
• Under Config: Select the additional options for the target Amiga model (if required)
• Click the Set configuration, button to apply changes.

Next you will need to setup the emulator for the Kickstart and floppy disk image you wish to use:

• Select a Kickstart (ROM):

  • On the left hand side, select ROM.
  • Under Main ROM File:, select the browse button (3 dots) …
  • Navigate to your Kickstarts directory:
    /mnt/dietpi_userdata/amiberry/kickstarts*
  • Select the Kickstart (1.3 is recommended) you wish to use.

• Select a Floppy disk image (ADF):

  • On the left hand side, select Floppy drives.
  • Under DF0:, select the browse button (3 dots) …
  • Navigate to your floppy image directory:
    /mnt/dietpi_userdata/amiberry/floppy_images*
  • Select the ROM you wish to use.

* Remark: Amiberry does not currently support symbolic links. If you moved DietPi userdata to an external drive, run the following command to derive it’s actual path:

readlink -f /mnt/dietpi_userdata/amiberry

With dietpi-drive_manager‘s default mount point it looks like:
/mnt/<UUID>/dietpi_userdata/amiberry

On the left hand side, select Display.
Ensure the Fullscreen option is enabled.

This will emulate the Amiga as fast as possible, ensuring you get the maximum FPS for your SBC hardware.

• On the left hand side, select CPU and FPU.
• Under CPU Speed, select the fastest option.
• If you find this change slows down the emulation, try using the fixed value of 25 MHz.

It is recommended to save your settings. This will ensure the settings are applied on next startup of Amiberry.

• On the left hand side, select Configurations.
• Enter the name, e.g. “autostart”, then click Save.

To update Amiberry to the latest version, simply reinstall it:

dietpi-software reinstall 108

How can I transfer Kickstarts & Floppy Images to the device?

Make sure you have one of DietPi’s File Servers installed.

• Floppy Disk Image (.adf) directory as chosen before, e.g. /amiberry/floppy_images
• Kickstarts (.rom) directory = /amiberry/kickstarts

How can I open the configuration window once the emulator has started?

The pre-defined key for that is F12.

How can I reboot the Amiga emulation environment (Amiga reset)?

Use Ctrl+Left Win+Right Win keys.
If you don’t have an Right Win key, try using the Menu key instead.

What are the default controls for Joystick, when using a Keyboard?

When using a keyboard, the default joystick controls are:

• Up/Down/Left/Right = Up/Down/Left/Right
• Page Down = Fire/Button 1
• Page Up = Fire/Button 2

How can I improve performance (frame rate)?

A lower resolution may improve performance on most games. From the emulator main menu:

• On the left hand side, select Display.
• 640x256 is high resolution.
• 320x256 is low resolution and should provide improved performance.

Overclocking your system will improve performance. Stability may vary across devices and overclocking is not officially supported:

• From a terminal, run dietpi-config.
• Select the Performance Options menu.
• Select Overclocking.
• Select an overclocking profile, then reboot the system to apply the change.

How do I set the floppy drive speed for compatibility?

Floppy drive emulation is to set to 800 % by default. This reduces loading times by up to 8x.
You can lower this to 100 %, increasing compatibility:

• On the left hand side, select Floppy drives.
• Change the Floppy Drive Emulation Speed value to 100 %.

Some games are not in full screen

Games run at various resolutions, from the emulator main menu:

• On the left hand side, select Display.
• Change the Height value to 200 or 256.
• Press the Resume or Start button.

DXX-Rebirth can be started by running dxx-rebirth.
To automatically start DXX-Rebirth at boot, simply run dietpi-autostart 7 from console or dietpi-autostart and select DXX-Rebith (Descent 1/2) from the menu, then reboot your system.

We have created a pilot called DietPi. The config has been setup for WSAD style play and is recommended for FPS players who use WSAD + mouse.

• W/A/S/D = Forward/Backwards/Left/Right
• Q/Z = Up/Down
• E/R = Rotate Z (forward) axis
• F = Launch flare
• Alt+F2 = Save game

How do I transfer the original Descent full game files?¶

Before you begin, you will need the original game files, from a legal copy and installation of Descent.
Make sure you have one of DietPi’s File Servers installed.

• Copy your Descent 1 Game files to /mnt/dietpi_userdata/dxx-rebirth/descent_1_game
• Copy your Descent 2 Game files to /mnt/dietpi_userdata/dxx-rebirth/descent_2_game

• The default server/query port is: 25565

• Port: 25575
• Password: <globalSoftwarePassword> (default: dietpi)
• Console command: mcrcon -p <globalSoftwarePassword>

• Launcher: /opt/papermc
• Config and data: /mnt/dietpi_userdata/papermc
• Logs: /var/log/papermc

• Service: journalctl -u papermc
• File: /var/log/papermc/latest.log

Tweak the server settings by modifying the following file or any file within the config directory that ends in .yml:
/mnt/dietpi_userdata/papermc/server.properties

Since PaperMC runs as Java application, it’s system memory demand highly depends on the Java heap size, that can be adjusted. The absolute minimum head size that is required to run PaperMC is 512 MiB, which will result in ~850 MiB overall used system memory. We recommend to raise it to a minimum of 1 GiB (~1.35 GiB overall memory usage) for production use, or higher, depending on the amount of users and installed plugins.

To change the Java heap size, do the following:

1. Run dietpi-services from console.
2. Select papermc.
3. Select Edit.

4. Uncomment the line that starts with #ExecStart= (remove the leading #) and add/change e.g. -Xms1G -Xmx1G right behind the java command to apply 1 GiB heap size. Additionally you need to add an ExecStart= above to unset the command of the original service, so that it finally looks like this:

   ExecStart=
   ExecStart=/usr/bin/java -Xms1G -Xmx1G -jar /opt/papermc/paperclip.jar --nogui --noconsole
   

5. Use Ctrl+O and Enter to save the file, then Ctrl+X to return to the dietpi-services menu. On exit, it will ask whether you want to restart the service to apply the changes.

You can restart the service by running:

systemctl restart papermc

How do I interface with the server’s console?¶

Use the installed tool MCrcon: mcrcon -p <globalSoftwarePassword>

How do I find and install plugins?¶

https://www.spigotmc.org/resources/categories/spigot.4/

Just move the downloaded JAR file to the /mnt/dietpi_userdata/papermc/plugins directory.

What version of Minecraft does this work on?¶

PaperMC is built to run on Java edition, however with the optional Geyser and Floodgate plugins, it can run on Bedrock edition as well.
Just choose to install them at the beginning.