8<a id="readme-top"></a>

<p align="center"> <a href="https://theblockheads.net"> <img alt="The Blockheads" src="https://github.com/user-attachments/assets/8f162932-0a4d-429d-9f3e-bd97d980e893"> </a> </p> <div align="center"> <h1 align="center">The Blockheads Game Server </h3> <div align="center"> <table> <tr> <td><a href="https://www.apple.com/macos/" target="_blank" rel="noopener noreferrer" title="MacOS" style="color: #000000;"><img src="https://img.shields.io/badge/MacOS-999999.svg?logo=apple&logoColor=white" alt="MacOS"></a></td> <td><a href="https://www.debian.org/" target="_blank" rel="noopener noreferrer" title="Debian" style="color: #A81D33;"><img src="https://img.shields.io/badge/Debian-A81D33.svg?logo=debian&logoColor=white" alt="Debian"></a></td> <td><a href="https://ubuntu.com/" target="_blank" rel="noopener noreferrer" title="Ubuntu" style="color: #E95420;"><img src="https://img.shields.io/badge/Ubuntu-E95420.svg?logo=ubuntu&logoColor=white" alt="Ubuntu"></a></td> <td><a href="https://archlinux.org/" target="_blank" rel="noopener noreferrer" title="Arch Linux" style="color: #1793D1;"><img src="https://img.shields.io/badge/Arch%20Linux-1793D1.svg?logo=arch-linux&logoColor=white" alt="Arch Linux"></a></td> <td><a href="https://pop.system76.com/" target="_blank" rel="noopener noreferrer" title="Pop!_OS" style="color: #48B9C7;"><img src="https://img.shields.io/badge/Pop!__OS-48B9C7.svg?logo=pop_os&logoColor=white" alt="Pop!_OS"></a></td> <td><a href="https://www.trisquel.info/" target="_blank" rel="noopener noreferrer" title="Trisquel" style="color: #23af34;"><img src="https://img.shields.io/badge/Trisquel-23af34.svg?logo=trisquel&logoColor=white" alt="Trisquel"></a></td> <td><a href="https://www.linuxmint.com/" target="_blank" rel="noopener noreferrer" title="Linux Mint" style="color: #87CF3E;"><img src="https://img.shields.io/badge/Linux%20Mint-87CF3E.svg?logo=linux-mint&logoColor=white" alt="Linux Mint"></a></td> </tr> <tr> <td><a href="https://zorin.com/" target="_blank" rel="noopener noreferrer" title="Zorin OS" style="color: #0CC1F3;"><img src="https://img.shields.io/badge/Zorin%20OS-0CC1F3.svg?logo=zorin&logoColor=white" alt="Zorin OS"></a></td> <td><a href="https://elementary.io/" target="_blank" rel="noopener noreferrer" title="elementary OS" style="color: #64BAFF;"><img src="https://img.shields.io/badge/elementary%20OS-64BAFF.svg?logo=elementary&logoColor=white" alt="elementary OS"></a></td> <td><a href="https://www.kali.org/" target="_blank" rel="noopener noreferrer" title="Kali Linux" style="color: #557C94;"><img src="https://img.shields.io/badge/Kali%20Linux-557C94.svg?logo=kali-linux&logoColor=white" alt="Kali Linux"></a></td> <td><a href="https://tails.boum.org/" target="_blank" rel="noopener noreferrer" title="Tails" style="color: #563F8A;"><img src="https://img.shields.io/badge/Tails-563F8A.svg?logo=tails&logoColor=white" alt="Tails Linux"></a></td> <td><a href="https://mxlinux.org/" target="_blank" rel="noopener noreferrer" title="MX Linux" style="color: #1E7B6E;"><img src="https://img.shields.io/badge/MX%20Linux-1E7B6E.svg?logo=mx-linux&logoColor=white" alt="MX Linux"></a></td> <td><a href="https://www.devuan.org/" target="_blank" rel="noopener noreferrer" title="Devuan" style="color: #648C8A;"><img src="https://img.shields.io/badge/Devuan-648C8A.svg?logo=devuan&logoColor=white" alt="Devuan"></a></td> <td><a href="https://bunsenlabs.org/" target="_blank" rel="noopener noreferrer" title="BunsenLabs" style="color: #254c59;"><img src="https://img.shields.io/badge/BunsenLabs-254c59.svg?logo=bunsenlabs&logoColor=white" alt="BunsenLabs"></a></td> </tr> </table> </div>

<p align="center">This repository contains the server files for running a Blockheads multiplayer server.</p> <div align="left"><b>Warning:</b></div> <div align="left">Running curl to bash scripts from the internet can be risky. It's always recommended to review the code before executing it to ensure it is safe and does not contain any malicious content.</div><p></p>

Check out <a href="https://github.com/JonCastaway/BHS/wiki/Servers"> <strong>other Blockhead Servers</strong></a>

<a href="https://github.com/JonCastaway/BHS/wiki"><strong>Explore the Wiki</strong></a> <br /> <br />

<a href="https://github.com/JonCastaway/BHS/issues/new?labels=bug&template=bug-report---.md">Report Bug</a> · <a href="https://github.com/JonCastaway/BHS/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>

</p> </p> </div> <details> <summary>Table of Contents</summary> <ol> <li><a href="#1-installation--linux">Linux Install</a></li> <li><a href="#2-installation--macos">MacOS Install</a></li> <li><a href="#3-original-binaries--manual-install">Manual Install</a></li> <li><a href="#4-the-blockheads--android-apk">The Android Apps</a></li> <li><a href="#5-roadmap">Roadmap</a></li> <li><a href="#6-contributing">Contributing</a></li> <li><a href="#7-license">License</a></li> <li><a href="#8-contact">Contact</a></li> <li><a href="#9-acknowledgments">Acknowledgments</a></li> </ol>

The Blockheads Game Server for Linux and MacOS

Getting Started

GettingStarted

1. Installation | Linux

Follow the instructions below to install and set up the Blockheads server on your system.

Download and run the server script:

curl -sL https://raw.githubusercontent.com/JonCastaway/BHS/main/start.sh | bash -s -

Create Your server:

./blockheads_server171 -n MyFirstServer

For more options and help use:

./blockheads_server171 -h

Configure Your server: You'll need to replace the WORLD_ID and PORT inside the run.sh script.

nano run.sh

Replace the placeholders with your WORLD_ID and PORT. You can find your WORLD_ID by typing:

./blockheads_server171 -l

Save and exit the file by pressing CTRL+X, then Y, and ENTER.

Start the server in the background

nohup ./start.sh &>/dev/null &

2. Installation | MacOS

Download the Blockheads Server App

Download from App Store

3. Original Server Binaries | Manual Install

You can download the original server binaries from the links below

4. The Blockheads | Android APK

If version 1.76 does not launch, try an earlier version such as 1.75 or 1.74

5. Roadmap

Exlore our advancement towards significant milestones, and delve into the wiki. Here's a general outline of some key features we're considering:

[ ] Current Active Servers (in test)
[ ] World Configuration Editor
[ ] Web-based User Interface
[ ] Docker file (in test)

Additionally, review the open issues for a comprehensive list of suggested features (as well as known issues).

6. Contributing

contributing

Contributions are welcome! Feel free to fork this repository and submit pull requests.

Contributors

7. License

This project is Licensed under the GPL-3.0 License. See the License file for details.

8. Contact

contact

For any questions or support, please reach out or open an issue on GitHub.

BHS

Install / Use

README