Raspberry Pi Getting Started Guide .md 4.1 KB
Guide for running OpenRSC on a Raspberry Pi 3b+ or newer
The Raspberry Pi 3B+ (and earlier editions) do not have enough memory to run the game client and the game server at the same time. Raspberry Pi 4 and above with 2GB or more RAM are capable of running both.
This project is design for the Raspberry Pi 3B+ with 1GB of RAM to act as a home LAN game server for Android and PC game clients to connect to at home. Due to limited memory and processor speeds, it is not advisable to host a public server with a Raspberry Pi 3B+, nor have more than 2 or 3 online players at a time due to in-game slow downs.
Example result on a Raspberry Pi 3B+ when running the "top" command on a CentOS 7 install only running the game server with a single logged in player:
Tasks: 172 total, 1 running, 122 sleeping, 0 stopped, 0 zombie
%Cpu(s): 33.6 us, 5.5 sy, 0.0 ni, 60.5 id, 0.4 wa, 0.0 hi, 0.0 si, 0.0 st
KiB Mem : 948268 total, 10392 free, 720148 used, 217728 buff/cache
KiB Swap: 499708 total, 479484 free, 20224 used. 207656 avail Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
2206 root 20 0 412612 351060 11088 S 151.3 37.0 2:23.28 java
You will want to have a bootable microSD card running a fresh install of CentOS arch64: http://isoredirect.centos.org/altarch/7/isos/armhfp/CentOS-Userland-7-armv7hl-RaspberryPI-GNOME-1908-sda.raw.xz
You can write to your microSD card using various utilities. Here is a great open source tool for any platform: https://www.balena.io/etcher/
First, SSH into your Pi and use the default credentials:
ssh root@YOUR_PI's_IP_ADDRESS
SSH user password: centos
You will need to expand the filesystem to use the entire microSD card:
/usr/bin/rootfs-expand
You should overclock your Pi 3B+ as it is generally pretty slow otherwise: https://haydenjames.io/raspberry-pi-3-overclock/
yum install -y nano
nano /boot/config.txt
Paste the following: (3B+ only!)
core_freq=500 # GPU Frequency
arm_freq=1350 # CPU Frequency
over_voltage=4 # Electric power sent to CPU / GPU (4 = 1.3V)
disable_splash=1 # Disables the display of the electric alert screen
force_turbo=1
sdram_freq=600
boot_delay=1
# gpu_mem=320 # Reserved memory for GPU
Once installed, perform OS updates and various utilities via:
yum update -y && sudo yum install git wget sqlite3 ant screen -y
Verify Java is installed correctly:
java -version
It should look something like:
openjdk version "1.8.0_222"
OpenJDK Runtime Environment (build 1.8.0_222-b10)
OpenJDK Zero VM (build 25.222-b10, interpreted mode)
Now download the zip release of this repo - or clone it with Git.
Open the firewall ports:
firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent
firewall-cmd --zone=public --add-port=43594/tcp --permanent
firewall-cmd --zone=public --add-port=43595/tcp --permanent
firewall-cmd --zone=public --add-port=43596/tcp --permanent
firewall-cmd --zone=public --add-port=43597/tcp --permanent
firewall-cmd --zone=public --add-port=43598/tcp --permanent
firewall-cmd --zone=public --add-port=43599/tcp --permanent
firewall-cmd --reload
Start the game server in a background "screen" session:
./run_server.sh
To view the "screen" background session, type:
screen -r
Press CTRL + A + D to leave the screen view and keep the server running in the background.
Now that the game server is running, you will want to download the same project files on your PC and edit the following to set the server IP:
Cache/ip.txt
Replace the contents of this file with the local network IP address of your Raspberry Pi. If you do not know it, type "ifconfig" on the Pi over SSH.
Now start up the game client from your PC by launching "Open_RSC_Client.jar"
java -jar Open_RSC_Client.jar