Skip to content

xero-nova/blockheads

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Blockheads Server

Linux Server Installation

Before you begin, make sure you have the following:

  • Ubuntu 22.04 Server
  • Basic knowledge of Linux

Open the terminal and run the following as root:

curl -sSL https://raw.githubusercontent.com/xero-nova/blockheads/main/install.sh | sudo bash

Windows Server Installation

Before you begin, make sure you have the following:

  • Windows 10/11 with the ability to install WSL
  • Basic knowledge of Linux & WSL

Open PowerShell as Administrator and run:

wsl --install -d Ubuntu-22.04

Run this command in the WSL Terminal:

curl -sSL https://raw.githubusercontent.com/xero-nova/blockheads/main/install.sh | sudo bash

Deployment

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, doesnt 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.
        --help (-h) display this help text
Undocumented Options:
        --owner OWNER sets the owner of the world.
        --no-exit prevents the server from gracefully stopping when the last player leaves.

World Saves

World Saves can be found here:

~/GNUstep/Library/ApplicationSupport/TheBlockheads/saves

About

Blockheads Server Guide for Linux & Windows

Resources

Stars

Watchers

Forks

Languages