An open API service indexing awesome lists of open source software.

https://github.com/joncastaway/bhs

The Blockheads Server for Linux and MacOS
https://github.com/joncastaway/bhs

bhs blockheads game linux macos server

Last synced: 11 months ago
JSON representation

The Blockheads Server for Linux and MacOS

Awesome Lists containing this project

README

          




The Blockheads



The Blockheads Game Server




MacOS
Debian
Ubuntu
Arch Linux
Pop!_OS
Trisquel
Linux Mint


Zorin OS
elementary OS
Kali Linux
Tails Linux
MX Linux
Devuan
BunsenLabs


[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]

[contributors-shield]: https://img.shields.io/github/contributors/JonCastaway/BHS.svg?style=for-the-badge
[contributors-url]: https://github.com/JonCastaway/BHS/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/JonCastaway/BHS.svg?style=for-the-badge
[forks-url]: https://github.com/JonCastaway/BHS/network/members
[stars-shield]: https://img.shields.io/github/stars/JonCastaway/BHS.svg?style=for-the-badge
[stars-url]: https://github.com/JonCastaway/BHS/stargazers
[issues-shield]: https://img.shields.io/github/issues/JonCastaway/BHS.svg?style=for-the-badge
[issues-url]: https://github.com/JonCastaway/BHS/issues


This repository contains the server files for running a Blockheads multiplayer server.


Warning:

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.

**You can test our Blockheads Server by using:**
`theblackswan.devon.social` port `15151`

**Check out
other Blockhead Servers
**

Explore the Wiki



Report Bug
·
Request Feature


Table of Contents


  1. Linux Install

  2. MacOS Install

  3. Manual Install

  4. The Android Apps

  5. Roadmap

  6. Contributing

  7. License

  8. Contact

  9. Acknowledgments

# The Blockheads Game Server for Linux and MacOS

## Getting Started

![GettingStarted](https://github.com/user-attachments/assets/181856ca-8597-43d3-97c4-cf13a99c924d)

### 1. Installation | Linux

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

Download and run the server script:
```bash
curl -sL https://raw.githubusercontent.com/JonCastaway/BHS/main/start.sh | bash -s -
```

Create Your server:
```bash
./blockheads_server171 -n MyFirstServer
```

For more options and help use:
```bash
./blockheads_server171 -h
```

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

```bash
nano run.sh
```

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

```bash
./blockheads_server171 -l
```

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

`Start the server in the background`

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

### 2. Installation | MacOS

Download the Blockheads Server App

[Download from App Store](https://apps.apple.com/us/app/blockheadsserver/id662633568)

### 3. Original Server Binaries | Manual Install

You can download the original server binaries from the links below

- [Download The Blockheads Server Binary - archive.org](https://archive.org/download/BHSv171/blockheads_server171.tar.gz)
- [Download The Blockheads Server Binary - majicdave.com](https://majicdave.com/share/blockheads_server171.tar.gz)

### 4. The Blockheads | Android APK

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

- [Download The Original Blockheads Android APK v1.76 - Noodlecake](https://noodlecake.com/wp-content/uploads/2021/02/theblockheads1.7.6.apk)

- [Download The Original Blockheads Android APK v1.76 - archive.org](https://archive.org/download/theblockheads1.7.6/theblockheads1.7.6.apk)
- [Download The Original Blockheads Android APK v1.75 - archive.org](https://archive.org/download/theblockheads1.7.6/The%20Blockheads_1.7.5_APKPure.apk)
- [Download The Original Blockheads Android APK v1.74 - archive.org](https://archive.org/download/theblockheads1.7.6/The%20Blockheads_1.7.4_APKPure.apk)

### 5. Roadmap

Exlore our advancement towards significant [milestones](<[url](https://github.com/Joncastaway/BHS/milestones)>), and delve into the [wiki](https://github.com/Joncastaway/BHS/wiki/Roadmap). Here's a general outline of some key features we're considering:

- [ ] [Current Active Servers](https://github.com/JonCastaway/BHS/wiki/Active-Servers) (in test)
- [ ] World Configuration Editor
- [ ] Web-based User Interface
- [ ] Docker file (in test)

Additionally, review the [open issues](https://github.com/Joncastaway/BHS/issues) for a comprehensive list of suggested features (as well as known issues).

### 6. Contributing

![contributing](https://github.com/user-attachments/assets/5059e3bc-ea8c-4965-96c4-c6c500d0ba06)

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](https://github.com/JonCastaway/BHS/blob/main/LICENCE) file for details.

### 8. Contact

![contact](https://github.com/user-attachments/assets/2b40e187-309b-4a58-be5f-fc71d045298a)

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

[contributors-shield]: https://img.shields.io/github/contributors/JonCastaway/BHS.svg?style=for-the-badge
[contributors-url]: https://github.com/JonCastaway/BHS/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/JonCastaway/BHS.svg?style=for-the-badge
[forks-url]: https://github.com/JonCastaway/BHS/network/members
[stars-shield]: https://img.shields.io/github/stars/JonCastaway/BHS.svg?style=for-the-badge
[stars-url]: https://github.com/JonCastaway/BHS/stargazers
[issues-shield]: https://img.shields.io/github/issues/JonCastaway/BHS.svg?style=for-the-badge
[issues-url]: https://github.com/JonCastaway/BHS/issues

### 9. Acknowledgments

Projects we're inspired by and obtained valuable information:

- [Majic Jungle | Dave Frampton](https://majicjungle.com)
- [The Internet Archive](https://archive.org)
- [Discord | Sapiens](https://discord.gg/ZHwMWruM)
- [Reddit | r/blockheads](https://www.reddit.com/r/blockheads/)
- [Wiki GG | Blockheads](https://theblockheads.wiki.gg/wiki/The_Blockheads_Wiki)
- [Fandom | The Blockheads](https://theblockheads.fandom.com/wiki)