A portable private server for Deepworld.
Find a file
Array in a Matrix f31cf9cc29
Some checks failed
Build / build (push) Has been cancelled
Update README.md
2024-05-01 17:26:34 -04:00
.github/workflows Custom build logic (#49) 2024-05-01 16:16:17 +02:00
api Custom build logic (#49) 2024-05-01 16:16:17 +02:00
build-logic Custom build logic (#49) 2024-05-01 16:16:17 +02:00
deepworld-config@6052c53944 Fix space biome not configuring properly 2024-02-17 22:39:04 +01:00
gameserver Custom build logic (#49) 2024-05-01 16:16:17 +02:00
gradle/wrapper Updated dependencies and gradle wrapper 2022-08-14 00:20:24 +02:00
shared Custom build logic (#49) 2024-05-01 16:16:17 +02:00
src/main Custom build logic (#49) 2024-05-01 16:16:17 +02:00
.dockerignore initial docker image 2024-04-29 15:01:58 -04:00
.gitattributes Custom build logic (#49) 2024-05-01 16:16:17 +02:00
.gitignore Custom build logic (#49) 2024-05-01 16:16:17 +02:00
.gitmodules Update .gitmodules 2022-04-17 14:34:19 +02:00
build.gradle Custom build logic (#49) 2024-05-01 16:16:17 +02:00
docker-compose.yml simple docker compose 2024-04-29 16:35:24 -04:00
Dockerfile Update Dockerfile 2024-05-01 17:22:54 -04:00
gradle.properties Improved overall project structure 2021-07-09 01:48:23 +02:00
gradlew Open source commit 2021-04-17 21:59:53 +02:00
gradlew.bat Open source commit 2021-04-17 21:59:53 +02:00
LICENSE.md Initial commit 2021-04-17 21:59:34 +02:00
README.md Update README.md 2024-05-01 17:26:34 -04:00
settings.gradle Custom build logic (#49) 2024-05-01 16:16:17 +02:00

Brainwine

build release

Brainwine is a Deepworld private server written in Java, designed to be portable and easy to use.
It's still a work in progress, so keep in mind that it's not yet feature-complete. (A to-do list can be found here.)
Brainwine currently supports the following versions of Deepworld:

  • Windows: v3.13.1
  • iOS: v2.11.0.1
  • MacOS: v2.11.1

Quick Local Setup

  • Install Java 8.
  • Download the latest Brainwine release.
  • Run Brainwine, go to the server tab and start the server.
  • Go to the game tab and start the game.
    • If this isn't available for you, download a patching kit for your platform and follow the instructions there.
  • Register a new account and play the game.

Building

Prerequisites

  • Java 8 Development Kit
git clone --recurse-submodules https://github.com/kuroppoi/brainwine.git
cd brainwine
./gradlew dist

The output will be located in the /build/dist directory.

Using docker

To host brainwine using a docker you first need to build the image. On your server run the following:

git clone https://github.com/kuroppoi/brainwine && cd brainwine
docker buildx build -t brainwine:latest .

If you want to change the default ports exposed by the image use the --build-arg flag (e.g. --build-arg="GATEWAY_PORT=3000").

Now run the image in a container:

docker run --name "brainwine" --volume $PWD:/data brainwine:latest

If you want to use docker compose run this instead:

docker compose up

The server configuration files and the world data is saved in a docker volume and will accessible from /data/ in the container. Feel free to add or remove options passed to docker or edit the compose file.

Usage

Execute brainwine.jar to start the program. Navigate to the server tab and press the button to start the server.
It is also possible to start the server immediately with no user interface:

# This behavior is the default on platforms that do not support Java's Desktop API.
java -jar brainwine.jar disablegui

To connect to a local or remote server, download a patching kit for your desired platform.
Alternatively, Windows users may use the program's user interface to configure the host settings and start the game.