An open API service indexing awesome lists of open source software.

https://github.com/yzen90/bedrock-server

Convenience scripts for Minecraft™ Bedrock Servers
https://github.com/yzen90/bedrock-server

bedrock-edition bedrock-server linux minecraft minecraft-server ubuntu

Last synced: about 1 month ago
JSON representation

Convenience scripts for Minecraft™ Bedrock Servers

Awesome Lists containing this project

README

          

# Minecraft™ Bedrock Server convenience scripts

### Tested with Ubuntu Server 18.04

## Contents
- [Minecraft™ Bedrock Server convenience scripts](#minecraft-bedrock-server-convenience-scripts)
- [Tested with Ubuntu Server 18.04](#tested-with-ubuntu-server-1804)
- [Contents](#contents)
- [Get the scripts](#get-the-scripts)
- [Update the scripts](#update-the-scripts)
- [New bedrock server instance](#new-bedrock-server-instance)
- [Import existing bedrock server files to new instance](#import-existing-bedrock-server-files-to-new-instance)
- [Import example](#import-example)
- [Update bedrock server instance](#update-bedrock-server-instance)
- [Instance update example](#instance-update-example)

## Get the scripts

Install required packages:

sudo apt install curl grep wget unzip

Clone the repository:

git clone https://github.com/xrnoz/bedrock-server.git
cd bedrock-server

Or download and extract:

wget https://github.com/xrnoz/bedrock-server/archive/master.zip
unzip master.zip
cd bedrock-server-master

[Back to top](#minecraft-bedrock-server-convenience-scripts)

## Update the scripts

With git:

cd bedrock-server
git pull

Or download and extract in directory that conains existing bedrock-server-master directory:

wget https://github.com/xrnoz/bedrock-server/archive/master.zip -O master.zip
unzip -o master.zip
cd bedrock-server-master

[Back to top](#minecraft-bedrock-server-convenience-scripts)

## New bedrock server instance

`./new `

- `` Name that will be used as the systemd service name in the form of `mcbs-` and in the `./instances` and `./run` directories for the new bedrock server instance. This argument will be converted to lowercase and it's whitespace trimmed.

After creation the bedrock server instance can be run with `./run//bedrock_server.sh`. To create the systemd service for the instance, run `sudo ./install-service `. After service install, run `systemctl status mcbs-` to verify the service status.

[Back to top](#minecraft-bedrock-server-convenience-scripts)

## Import existing bedrock server files to new instance

`./import `

- `` Path of directory that contains existing worlds directory and permissions.json, server.properties, allowlist.json files.

- `` Name that will be used as the systemd service name in the form of `mcbs-` and in the `./instances` and `./run` directories for the new bedrock server instance. This argument will be converted to lowercase and it's whitespace trimmed.

After the import is completed the bedrock server instance can be run with `./run//bedrock_server.sh`. To create the systemd service for the instance, run `sudo ./install-service `. After service install, run `systemctl status mcbs-` to verify the service status.

### Import example

Source directory:

/
└─ path/
└─ to/
└─ bedrock/
├─ permissions.json
├─ server.properties
├─ allowlist.json
└─ worlds/
└─ ...

Import:

:~/bedrock-server$ ./import /path/to/bedrock/ awesome-world

Run:

:~/bedrock-server$ ./run/awesome-world/bedrock_server.sh

Install service and verify:

:~/bedrock-server$ sudo ./install-service awesome-world
:~/bedrock-server$ systemctl status mcbs-awesome-world

[Back to top](#minecraft-bedrock-server-convenience-scripts)

## Update bedrock server instance

`./update `

- `` Name of the instance that will be updated. This argument will be converted to lowercase and it's whitespace trimmed.

If the service for the instance is installed and is active, it must be stopped first with `sudo systemctl stop mcbs-` to be able to update. After the update is completed, the service can be started again with `sudo systemctl start mcbs-`.

To force the update if the instance is up to date, run `rm ./instances//running-version` before `./update `.

### Instance update example

:~/bedrock-server$ sudo systemctl stop mcbs-awesome-world
:~/bedrock-server$ ./update awesome-world
:~/bedrock-server$ sudo systemctl start mcbs-awesome-world

[Back to top](#minecraft-bedrock-server-convenience-scripts)