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
- Host: GitHub
- URL: https://github.com/joncastaway/bhs
- Owner: JonCastaway
- License: gpl-3.0
- Created: 2025-01-12T03:58:48.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-25T00:13:49.000Z (about 1 year ago)
- Last Synced: 2025-03-02T10:15:04.527Z (11 months ago)
- Topics: bhs, blockheads, game, linux, macos, server
- Language: Shell
- Homepage: https://joncastaway.github.io/BHS/
- Size: 321 KB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
The Blockheads Game Server
[![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**
Table of Contents
- Linux Install
- MacOS Install
- Manual Install
- The Android Apps
- Roadmap
- Contributing
- License
- Contact
- Acknowledgments
# The Blockheads Game Server for Linux and MacOS
## Getting Started

### 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

Contributions are welcome! Feel free to fork this repository and submit pull requests.
### 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

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)