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: mineos
• Password = <globalSoftwarePassword> (default: dietpi)

To change the password to myPassword, run the following command:

sudo chpasswd --crypt-method SHA512 <<< 'mineos:myPassword'

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.

After the installation, you need to pair your Moonlight with the streaming server with the following command:

moonlight pair

This attempts to auto-detect compatible streaming servers in your network. If this fails, you can add the hostname or IP address manually. In this example 192.168.0.1 is the IP of a Sunshine streaming server:

moonlight pair 192.168.0.1

Moonlight will print a 4-digit PIN to the console which you need to enter into the streaming server’s UI to finish pairing. Then you can start streaming, in this simple example the current desktop session of the streaming server:

moonlight stream -app=Desktop 192.168.0.1

To make configuration and startup of Moonlight simpler, you can edit the config file /etc/moonlight.conf accordingly, enter streaming server host, app and other settings, and then start Moonlight using this config file:

moonlight /etc/moonlight.conf

Since Moonlight is installed from an APT repository, updates will be offered via APT:

apt Update
apt install moonlight-embedded

The Moonlight GUI can be started with the following command:

moonlight-qt

When doing this via SSH or from plain console outside of a desktop session, we observed that it can show a disturbing black border at the top of the screen, covering important parts of the GUI. If happens, it is best to start it from a terminal emulation within a desktop session.

On first start, it will search for and list compatible streaming servers on your network. If this does not work for some reason, you can enforce with a streaming server, using its IP address or hostname. In this example 192.168.0.1 is the IP of a Sunshine streaming server:

moonlight-qt pair 192.168.0.1

The GUI will show a 4-digit PIN which you need to enter into the streaming server’s UI to finish pairing. Then streaming can be started by selecting an available app.

You can also quick start streaming of a specific app from a specific host. In this simple example the current desktop session of the streaming server is streamed, skipping the Moonlight GUI:

moonlight-qt stream 192.168.0.1 Desktop

Since Moonlight is installed from an APT repository, updates will be offered via APT:

apt Update
apt install moonlight-qt