A Server-Engine written in C++, made to work with Minecraft Beta 1.7.3. The goal being to have a semi-modern Server Engine that people can muck about with however they like, and to not have to deal with plugins that're over a decade old.

(as of 0.2.0)

• Players can connect, chat, build and explore
• Commands
• Lua-driven World Generation

How do you run your own BetrockServer instance?

If you're on Linux, simply follow the steps listed below. If you're on Windows, please follow these same steps only after installing Windows Subsystem for Linux (WSL2).

Check the releases page for the latest binary of BetrockServer. Then simply run the executable.

If it complains about lacking a scripts folder, download the src/scripts folder from the repository and place it alongside the executable.

Downloading can be unreliable, since certain libraries, such as libdeflate, may not necessarily be installed. Compiling is honestly the easier and more robust option.

This section is written to be as accessible as possible, so anyone can compile BetrockServer.

Debian/Ubuntu

sudo apt install git cmake build-essential libdeflate-dev liblua5.4-dev

Arch

sudo pacman -Syu git cmake make gcc lua libdeflate

Fedora

sudo dnf install git cmake make gcc lua-devel libdeflate libasan

This installs all the necessary libraries that BetrockServer needs.

git clone --recurse-submodules https://github.com/OfficialPixelBrush/BetrockServer.git
cd BetrockServer

This downloads the repository onto your computer.

cmake -S . -B build
cd build

This configures the development environment.

cmake --build .

This turns the source code into an executable binary file.

./BetrockServer

This runs the built executable and generates a new world, if one isn't already present.

cpack --config CPackConfig.cmake -G TGZ

If you encounter any issues, inaccuracies to the base game or simply want to provide an idea that may make BetrockServer better, please report them on the Issues tab.

Please check if the issue you've found has already been reported or even been solved already.

If not, create a new issue and fill out all the necessary information according to the Bug Report template to the best of your abilities.

• PixNBT - A C++ native NBT parsing library
• BetaPacketPlainTextifier - A utility for turning WireShark captures of Minecraft Client-Server data into Markdown files for easy decoding

Please read the CONTRIBUTING page.

For further reading, to aid development and sources for where certain info has been gotten from.

Some stuff can be found on the BetrockServer Wiki, especially if you're interested in developing your own World Generator or Plugin. It also features a very complete ID Listing, though the one hosted on grahamedgecombe.com is a great alternative for general usage.

If you're more interested in the in-depth technical stuff of Beta 1.7.3, check out my extended fork of mudkipdev's Beta Wiki!

• GitHub
  • beta-wiki (fork) by OfficialPixelBrush
  • beta-wiki (og) by mudkipdev
• Wiki.vg (Now part of the Minecraft Wiki)
  • Protocol
  • Region Files
• Minecraft Wiki
  • NBT Format
  • Region File Format
  • Help:Isometric Renders (Used for the Logo)

Issues	PRs

Branch	Commits
main
latest