Blockheads Server Installer

This repository contains two files:

• installer.sh: A Bash script to install or uninstall the Blockheads server and its dependencies.
• blockheads_server171: The Blockheads server binary.

To get started, download the installer script with:

curl -s -o installer.sh https://cdn.jsdelivr.net/gh/NovaDev404/blockheads-server@main/installer.sh

Make the script executable:

chmod +x installer.sh

Usage

Installer script

Run the installer script with one of the following flags:

• Install the server and dependencies:

  ./installer.sh --install
  

• Uninstall the server and dependencies:

  ./installer.sh --uninstall
  

• For help or no flags:

  ./installer.sh --help
  ./installer.sh -h
  

The uninstall command will prompt you whether you want to remove everything (binary, libdispatch, related packages) or just the Blockheads server and libdispatch.

Requirements

• Debian or Ubuntu-based system
• sudo privileges
• Internet connection to download packages and the binary

Notes

• The uninstall process removes installed packages detected based on the libraries required by the Blockheads server.
• If libdispatch was built and installed from source, the uninstall script attempts to remove related files from /usr/local/lib.
• Please review prompts carefully during uninstall to avoid accidental removal.

Blockheads server binary

Once installed, you can run the server binary with ./blockheads_server171.

Usage: blockheads_server [options]

When run without options, the most recent world will be loaded.
Available options:
    --list (-l) list all available worlds.
    --new WORLD_NAME (-n) create a new world named WORLD_NAME.
    --world_id WORLD_ID (-i) when used with --new, assigns the given id to the newly created world. Otherwise ignored.
    --load WORLD_ID [options] (-o) load the world with the id WORLD_ID.
    --rename-from WORLD_NAME_OR_ID (-r) --rename_to NEW_NAME (-t) rename the world with the id or name WORLD_NAME_OR_ID to NEW_NAME.
    --delete WORLD_NAME_OR_ID (-d) delete the world with the id or name WORLD_NAME.
    --force -f when used with --delete, doesn't prompt for confirmation.
    --port PORT (-p) the port to run on when specified with --new or --load. Default is 15151.
    --max_players MAX (-m) the maximum number of players that will be allowed to connect at once. Default is 16, max is 32.
    --save_delay SECONDS (-s) will only save the world to disk every n seconds (default is 1). This is useful to limit disk activity, but more progress will be lost in the event of a crash or unclean exit.
    --world_width WORLD_WIDTH (-w) (optional) used when creating a new world to sepecify how big the world should be. WORLD_WIDTH must be one of '1/16', '1/4', '1' (default), '4' or '16'. 4 and 16 are 4x and 16x the normal size.
    --custom-rules RULES (-C) (optional) used when creating a new world to sepecify that the world should be created with custom rules enabled. RULES is a json string containing world generation rules.
    --convert-to-custum-rules (-V) (optional) used when loading a world to sepecify that the world should be converted from a vanilla world to a custom rules world.
    --expert-mode (-e) (optional) used when creating a world to select expert mode.
    --no-exit  (optional) prevents the server from shutting down after all players have disconnected.
    --help (-h) display this help text

Run the server normally by just executing:

./blockheads_server171

---

Enjoy your Blockheads server!

License

This repository is licensed under the MIT License (see LICENSE).

The MIT License applies to:

• installer.sh
• README.md

The file blockheads_server171 is a precompiled third-party binary and is NOT covered by the MIT License. It is not created, owned, or maintained by NovaDev404. All rights to this binary remain with its original author(s).