{"id":24168489,"url":"https://github.com/joncastaway/bhs","last_synced_at":"2025-03-02T10:15:11.047Z","repository":{"id":272097797,"uuid":"915519867","full_name":"JonCastaway/BHS","owner":"JonCastaway","description":"The Blockheads Server for Linux and MacOS","archived":false,"fork":false,"pushed_at":"2025-01-25T00:13:49.000Z","size":329,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-02T10:15:04.527Z","etag":null,"topics":["bhs","blockheads","game","linux","macos","server"],"latest_commit_sha":null,"homepage":"https://joncastaway.github.io/BHS/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JonCastaway.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-12T03:58:48.000Z","updated_at":"2025-02-04T16:33:26.000Z","dependencies_parsed_at":"2025-01-12T05:19:56.101Z","dependency_job_id":"ba7125fd-6779-416c-a6e6-daa839df95b3","html_url":"https://github.com/JonCastaway/BHS","commit_stats":null,"previous_names":["joncastaway/bhs-linux-"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonCastaway%2FBHS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonCastaway%2FBHS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonCastaway%2FBHS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonCastaway%2FBHS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JonCastaway","download_url":"https://codeload.github.com/JonCastaway/BHS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241488200,"owners_count":19970829,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bhs","blockheads","game","linux","macos","server"],"created_at":"2025-01-12T22:14:56.366Z","updated_at":"2025-03-02T10:15:11.035Z","avatar_url":"https://github.com/JonCastaway.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://theblockheads.net\"\u003e\n    \u003cimg alt=\"The Blockheads\" src=\"https://github.com/user-attachments/assets/8f162932-0a4d-429d-9f3e-bd97d980e893\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eThe Blockheads Game Server\n\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ca href=\"https://www.apple.com/macos/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"MacOS\" style=\"color: #000000;\"\u003e\u003cimg src=\"https://img.shields.io/badge/MacOS-999999.svg?logo=apple\u0026logoColor=white\" alt=\"MacOS\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://www.debian.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Debian\" style=\"color: #A81D33;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Debian-A81D33.svg?logo=debian\u0026logoColor=white\" alt=\"Debian\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://ubuntu.com/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Ubuntu\" style=\"color: #E95420;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Ubuntu-E95420.svg?logo=ubuntu\u0026logoColor=white\" alt=\"Ubuntu\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://archlinux.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Arch Linux\" style=\"color: #1793D1;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Arch%20Linux-1793D1.svg?logo=arch-linux\u0026logoColor=white\" alt=\"Arch Linux\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://pop.system76.com/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Pop!_OS\" style=\"color: #48B9C7;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Pop!__OS-48B9C7.svg?logo=pop_os\u0026logoColor=white\" alt=\"Pop!_OS\"\u003e\u003c/a\u003e\u003c/td\u003e\n       \u003ctd\u003e\u003ca href=\"https://www.trisquel.info/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Trisquel\" style=\"color: #23af34;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Trisquel-23af34.svg?logo=trisquel\u0026logoColor=white\" alt=\"Trisquel\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://www.linuxmint.com/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Linux Mint\" style=\"color: #87CF3E;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Linux%20Mint-87CF3E.svg?logo=linux-mint\u0026logoColor=white\" alt=\"Linux Mint\"\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ca href=\"https://zorin.com/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Zorin OS\" style=\"color: #0CC1F3;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Zorin%20OS-0CC1F3.svg?logo=zorin\u0026logoColor=white\" alt=\"Zorin OS\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://elementary.io/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"elementary OS\" style=\"color: #64BAFF;\"\u003e\u003cimg src=\"https://img.shields.io/badge/elementary%20OS-64BAFF.svg?logo=elementary\u0026logoColor=white\" alt=\"elementary OS\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://www.kali.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Kali Linux\" style=\"color: #557C94;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Kali%20Linux-557C94.svg?logo=kali-linux\u0026logoColor=white\" alt=\"Kali Linux\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://tails.boum.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Tails\" style=\"color: #563F8A;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Tails-563F8A.svg?logo=tails\u0026logoColor=white\" alt=\"Tails Linux\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://mxlinux.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"MX Linux\" style=\"color: #1E7B6E;\"\u003e\u003cimg src=\"https://img.shields.io/badge/MX%20Linux-1E7B6E.svg?logo=mx-linux\u0026logoColor=white\" alt=\"MX Linux\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://www.devuan.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"Devuan\" style=\"color: #648C8A;\"\u003e\u003cimg src=\"https://img.shields.io/badge/Devuan-648C8A.svg?logo=devuan\u0026logoColor=white\" alt=\"Devuan\"\u003e\u003c/a\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003ca href=\"https://bunsenlabs.org/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"BunsenLabs\" style=\"color: #254c59;\"\u003e\u003cimg src=\"https://img.shields.io/badge/BunsenLabs-254c59.svg?logo=bunsenlabs\u0026logoColor=white\" alt=\"BunsenLabs\"\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n\n\u003c!-- Badges --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/JonCastaway/BHS.svg?style=for-the-badge\n[contributors-url]: https://github.com/JonCastaway/BHS/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/JonCastaway/BHS.svg?style=for-the-badge\n[forks-url]: https://github.com/JonCastaway/BHS/network/members\n[stars-shield]: https://img.shields.io/github/stars/JonCastaway/BHS.svg?style=for-the-badge\n[stars-url]: https://github.com/JonCastaway/BHS/stargazers\n[issues-shield]: https://img.shields.io/github/issues/JonCastaway/BHS.svg?style=for-the-badge\n[issues-url]: https://github.com/JonCastaway/BHS/issues\n\n\u003cp align=\"center\"\u003eThis repository contains the server files for running a Blockheads multiplayer server.\u003c/p\u003e\n\u003cdiv align=\"left\"\u003e\u003cb\u003eWarning:\u003c/b\u003e\u003c/div\u003e\n\u003cdiv align=\"left\"\u003eRunning 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.\u003c/div\u003e\u003cp\u003e\u003c/p\u003e\n\n**You can test our Blockheads Server by using:**\n`theblackswan.devon.social` port `15151`\n\n**Check out \u003ca href=\"https://github.com/JonCastaway/BHS/wiki/Servers\"\u003e\n\u003cstrong\u003eother Blockhead Servers\u003c/strong\u003e\u003c/a\u003e**\n\n\u003ca href=\"https://github.com/JonCastaway/BHS/wiki\"\u003e\u003cstrong\u003eExplore the Wiki\u003c/strong\u003e\u003c/a\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\n\u003ca href=\"https://github.com/JonCastaway/BHS/issues/new?labels=bug\u0026template=bug-report---.md\"\u003eReport Bug\u003c/a\u003e\n·\n\u003ca href=\"https://github.com/JonCastaway/BHS/issues/new?labels=enhancement\u0026template=feature-request---.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\u003col\u003e\n    \u003cli\u003e\u003ca href=\"#1-installation--linux\"\u003eLinux Install\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#2-installation--macos\"\u003eMacOS Install\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#3-original-binaries--manual-install\"\u003eManual Install\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#4-the-blockheads--android-apk\"\u003eThe Android Apps\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#5-roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#6-contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#7-license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#8-contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#9-acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n\u003c/ol\u003e\n\n# The Blockheads Game Server for Linux and MacOS\n\n## Getting Started\n\n![GettingStarted](https://github.com/user-attachments/assets/181856ca-8597-43d3-97c4-cf13a99c924d)\n\n### 1. Installation | Linux\n\nFollow the instructions below to install and set up the Blockheads server on your system.\n\nDownload and run the server script:\n```bash\ncurl -sL https://raw.githubusercontent.com/JonCastaway/BHS/main/start.sh | bash -s -\n```\n\nCreate Your server:\n```bash\n./blockheads_server171 -n MyFirstServer\n```\n\nFor more options and help use:\n```bash\n./blockheads_server171 -h\n```\n\nConfigure Your server:\n`You'll need to replace the WORLD_ID and PORT inside the run.sh script.`\n\n```bash\nnano run.sh\n```\n\n`Replace the placeholders with your WORLD_ID and PORT. You can find your WORLD_ID by typing:`\n\n```bash\n./blockheads_server171 -l\n```\n\n`Save and exit the file by pressing CTRL+X, then Y, and ENTER.`\n\n`Start the server in the background`\n\n ```bash\nnohup ./start.sh \u0026\u003e/dev/null \u0026\n```\n\n### 2. Installation | MacOS\n\nDownload the Blockheads Server App\n\n[Download from App Store](https://apps.apple.com/us/app/blockheadsserver/id662633568)\n\n### 3. Original Server Binaries | Manual Install\n\nYou can download the original server binaries from the links below\n\n- [Download The Blockheads Server Binary - archive.org](https://archive.org/download/BHSv171/blockheads_server171.tar.gz)\n- [Download The Blockheads Server Binary - majicdave.com](https://majicdave.com/share/blockheads_server171.tar.gz)\n\n### 4. The Blockheads | Android APK\n\nIf version 1.76 does not launch, try an earlier version such as 1.75 or 1.74\n\n- [Download The Original Blockheads Android APK v1.76 - Noodlecake](https://noodlecake.com/wp-content/uploads/2021/02/theblockheads1.7.6.apk)\n  \n- [Download The Original Blockheads Android APK v1.76 - archive.org](https://archive.org/download/theblockheads1.7.6/theblockheads1.7.6.apk)\n- [Download The Original Blockheads Android APK v1.75 - archive.org](https://archive.org/download/theblockheads1.7.6/The%20Blockheads_1.7.5_APKPure.apk)\n- [Download The Original Blockheads Android APK v1.74 - archive.org](https://archive.org/download/theblockheads1.7.6/The%20Blockheads_1.7.4_APKPure.apk)\n\n### 5. Roadmap\n\n\u003cimg src=\"https://github.com/user-attachments/assets/dd266407-8234-461e-9a2f-e93b2fb82286\" width=\"674\" height=\"384\"\u003e\n\nExlore our advancement towards significant [milestones](\u003c[url](https://github.com/Joncastaway/BHS/milestones)\u003e), and delve into the [wiki](https://github.com/Joncastaway/BHS/wiki/Roadmap). Here's a general outline of some key features we're considering:\n\n- [ ] [Current Active Servers](https://github.com/JonCastaway/BHS/wiki/Active-Servers) (in test)\n- [ ] World Configuration Editor\n- [ ] Web-based User Interface\n- [ ] Docker file (in test)\n\nAdditionally, review the [open issues](https://github.com/Joncastaway/BHS/issues) for a comprehensive list of suggested features (as well as known issues).\n\n### 6. Contributing\n\n![contributing](https://github.com/user-attachments/assets/5059e3bc-ea8c-4965-96c4-c6c500d0ba06)\n\nContributions are welcome! Feel free to fork this repository and submit pull requests.\n\n#### Contributors\n\u003ca href=\"https://github.com/JonCastaway/BHS/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=JonCastaway/BHS\u0026t=1\" /\u003e\n\u003c/a\u003e\n\n### 7. License\n\nThis project is Licensed under the GPL-3.0 License. See the [License](https://github.com/JonCastaway/BHS/blob/main/LICENCE) file for details.\n\n### 8. Contact\n\n![contact](https://github.com/user-attachments/assets/2b40e187-309b-4a58-be5f-fc71d045298a)\n\nFor any questions or support, please reach out or open an issue on GitHub.\n\n[contributors-shield]: https://img.shields.io/github/contributors/JonCastaway/BHS.svg?style=for-the-badge\n[contributors-url]: https://github.com/JonCastaway/BHS/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/JonCastaway/BHS.svg?style=for-the-badge\n[forks-url]: https://github.com/JonCastaway/BHS/network/members\n[stars-shield]: https://img.shields.io/github/stars/JonCastaway/BHS.svg?style=for-the-badge\n[stars-url]: https://github.com/JonCastaway/BHS/stargazers\n[issues-shield]: https://img.shields.io/github/issues/JonCastaway/BHS.svg?style=for-the-badge\n[issues-url]: https://github.com/JonCastaway/BHS/issues\n\n### 9. Acknowledgments\n\n\u003c!-- - [NAME](URL) --\u003e Projects we're inspired by and obtained valuable information:\n\n-   [Majic Jungle | Dave Frampton](https://majicjungle.com)\n-   [The Internet Archive](https://archive.org)\n-   [Discord | Sapiens](https://discord.gg/ZHwMWruM)\n-   [Reddit | r/blockheads](https://www.reddit.com/r/blockheads/)\n-   [Wiki GG | Blockheads](https://theblockheads.wiki.gg/wiki/The_Blockheads_Wiki)\n-   [Fandom | The Blockheads](https://theblockheads.fandom.com/wiki)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoncastaway%2Fbhs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoncastaway%2Fbhs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoncastaway%2Fbhs/lists"}