Minecraft 1.17 Caves and Cliffs Paper Server Update Available

Minecraft 1.17 - Caves and Cliffs Update
Minecraft 1.17 – Caves and Cliffs Update

The 1.17 Caves and Cliffs Part 1 version of Minecraft came out for vanilla very recently but until now the Paper Minecraft server was not available for it. This means that my Raspberry Pi Minecraft script was unable to run this version until now.

Today I checked the Paper Minecraft API server available versions and sure enough 1.17 was finally in the version list so I updated the Raspberry Pi Minecraft server scripts and they are now available! Raspberry Pi not required, the script will work on most versions of Linux that have apt available.

Important Notes

  • The minimum OpenJDK requirement has gone all the way up to OpenJDK 16 for this release. This presents a challenge because the Raspberry Pi OS repositories only contain up to OpenJDK 11! Fortunately the script will take care of this for you using a trick with snapd to install a newer OpenJDK. This does require a reboot so prepare beforehand!
  • Back up your server first. Remember if you use 1.17 and it ends up being too laggy or unstable you can’t change back to the old version because the server files now contain data the old versions don’t understand and will crash on. You can go back by restoring a backup from before the first time you ran 1.17!


SSH into your Raspberry Pi and paste the following commands:

curl https://raw.githubusercontent.com/TheRemote/RaspberryPiMinecraft/master/SetupMinecraft.sh | bash

See the full installation post for more information here: Raspberry Pi Minecraft Server Setup Script w/ Startup Service

Full GitHub project repository available at: Official GitHub Raspberry Pi Minecraft Repository

Benchmarking / Testing Storage

If you want to verify your drive’s performance you may want to run my storage benchmark with:

sudo curl https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh | sudo bash

If you search for the model of your drive on Pi Benchmarks you can compare your score with others and make sure the drive is performing correctly!

Notify of

Inline Feedbacks
View all comments
1 year ago

Hi James,
I’m trying to set this up on Ubuntu 64-bit desktop OS 20.10 (although will likely switch to Ubuntu Server) to make the best use of my Rpi4’s 8GB RAM and get better performance. I have previously had this working on Raspbian 32bit, but this was limited to the 4GB RAM usage.
When calling: ‘curl https://raw.githubusercontent.com/TheRemote/RaspberryPiMinecraft/master/SetupMinecraft.sh | bash’ , the installation goes a bit wrong at this point:

Warning: Failed to open the file /etc/systemd/system/minecraft.service:
Warning: Permission denied
100 312 100 312 0 0 1080 0 --:--:-- --:--:-- --:--:-- 1079
curl: (23) Failure writing output to destination
sed: can't read /etc/systemd/system/minecraft.service: No such file or directory
sed: can't read /etc/systemd/system/minecraft.service: No such file or directory

Which results in the following at end of installation:

Start Minecraft server at startup automatically (y/n)?y
Failed to enable unit: Unit file minecraft.service does not exist.

Setup is complete. Starting Minecraft server...
Failed to start minecraft.service: Unit minecraft.service not found.
Server has failed to start after 30 seconds.

Executing as my user (so non root) does successfully build the server as I can then manually call ./start.sh and it builds/runs, however the SetupMinecraft.sh is not installed, neither is the minecraft.service file (those were all I’ve noticed missing).
I therefore don’t get the benefit of starting the server when RPI is powered on (very useful for me), and also the daily reboots (which I’m keen to not have to manually do).
I have assumed this is because I am not the root user? – however I tried applying sudo and the script is built to exit when run in sudo. I also tried running as the root user (using sudo -i), but this too exits.

Is there anything that can be done to e.g. alter writing/reading access to etc/systemd/system/minecraft.service? Or should I be using a different script for use on Ubuntu?
Any pointers on this would be much appreciated,

Thanks in advance!

2 years ago

Hi James,

Any chance you could create one of your amazing scripts for setting up a vanilla java minecraft server? (Non-paper) I ran my server on a Rpi for years and have recently upgraded my PC so I’m using my old PC as a server. I don’t need to use paper anymore and the minor differences between paper and vanilla are not something I want.
Alternately, if there already is a set of similar scripts for vanilla minecraft, I’d love a pointer.

2 years ago

Hi James

I just updated the minecraft paper server to 1.18 by running the SetupMinecraft.sh and specifying version 1.18.

The 1.18 paper server is in experimental now and they are updating the jar file very often. Is there someway of manually choosing a jar file the server will use? Can i just replace the paperclip.jar? Or does it automatically update?

Thank you! Your bash scripts are awesome!

2 years ago

Thank you! Just what I was wondering about, thanks alot! 🙂

2 years ago

Hello James and thank you for your amazing work!

I’m not sure if it has been already posted but the SetupMinecraft.sh script is forcing the installation of OpenJDK 17, even for Minecraft 1.16.5 (which is not compatible)
I figured out how to manually install and select back by default OpenJDK 11 but I’m encountering another issue and I haven’t figured out yet how to deal with :

When backing up and rebooting (at 4 am), the minecraft server crash and then even the raspberry pi couldn’t be reach via SSH (forcing electrical reboot is then the only option).
Though I noticed the backup is made.
Do you know if there’s the possibility to consult some logs other than the one’s located in /home/pi/minecraft/logs ?

For the record, I’m running RaspiOS 64bits (latest version) with usb3 SSD boot.

Again, thanks!

2 years ago

Hey James,

Wow I didn’t expect such a detailled and quick answer, again thanks a lot !
You’re right, I went from a 1.16.5 backup (using AllowLocalCopy=1 in SetupMinecraft.sh) when I decided to upgrade the OS of my Pi4 from Raspbian Buster 32bits to RPiOS 64 bits beta. The reason was mostly to use most of the 4GB RAM of my Pi for the Minecraft server and to upgrade the bootloader to use native USB Boot.
Last year I discovered your awesome detailled website and set up my Minecraft server with your scripts using the Raspbian Buster version I mentionned earlier. At that time (early 2020), the USB boot wasn’t native on the Pi4 so I followed a guide to make it work (mostly by modifying PARTUUID and using fstab and quirks).
It worked without any significant issue.
I wanted you to know my background to have more insights on this case.

I agree with you, I also don’t think your scripts are causing the crash of my minecraft server and the SSH service. Also when this happens I noticed the Pi still answers to ping (maybe I should connect the Pi to an external display with HDMI to see what’s going on).
By issuing sudo reboot or the sudo -n reboot command at the end of Restart.sh, the Pi reboot normally.
So I think it happens after the restart and the full backup (which is completed).
I found nothing relevant in /var/log/syslog or the system journal for the moment.
For now I’ve just deleted the cron job of the backup and everything works normally, no crash at 4am or either after.

So my guesses are what’s causing this is located somewhere between this RPiOS 64bits version (still in beta) and my SSD (an old Crucial M4 128GB, which firmware is apparently up to date). Maybe this beta OS version doesn’t go well with my USB3 to SATA adapter chipset (a JMicron JMS567 one). Could be an overheat or overload because there’s a lot of IOPS on the disk at that moment ?
As I prefer to stay with RPiOS 64bits to use most of the Pi4 RAM with the server, I ordered the same USB 3.0 Startech adapter you used and tested, at least I won’t have to use quirks with this one because the chipset is different and working with UASP.

When I will receive it I will keep you updated on my progress if you want and if the crash behavior still continue I will install RPiOS 32 bits and will see what happens.


2 years ago

Hi, im having the same problem, ssh and mc server become unreachable after the reboot at 4 pm.

Only strange thing is that when i log on to the pi Locally everything seems to be working, there is internet access, the mc server is running and responsive to commands.

Also connection attempts ar shown as player disconnected on the mc servers console output. Only way is to force a sudo reboot og reset the power, then everything works fine inntil the next day.

Problems started when switching to the 1.18 and upgrading Java.

Was running Arch Linux, thought it was a routing error i couldt fix, and when rebooting the router didnt work i installed raspberry pi os lite 64bit,certain it would solve my problem. But the problem presist and is the exact same problem. Im going crazy 😂