Vedrock

A lightweight Minecraft: Bedrock Edition server software written in V.

Note

Vedrock is currently in early development. APIs, project structure and behavior may change frequently.

Building from source

Prerequisites

• V
• leveldb
• nbt
• raknet
• protocol
• i18n

Some modules aren't available through VPM yet. Until they're published, clone them manually into your V modules directory.

The V modules directory is usually:

• Linux/macOS: ~/.vmodules
• Windows: %USERPROFILE%\.vmodules

git clone https://github.com/vlang/leveldb VMODULES_PATH/leveldb
git clone https://github.com/bedrock-v/nbt VMODULES_PATH/nbt
git clone https://github.com/bedrock-v/protocol VMODULES_PATH/protocol
git clone https://github.com/bedrock-v/raknet VMODULES_PATH/raknet

v install nepinhum.i18n

Clone Vedrock

git clone https://github.com/bedrock-v/Vedrock.git

Run or build

cd Vedrock

# Run without keeping a binary
v run .

# Build
v .

Running with Docker

The Dockerfile builds everything from source - the pinned V compiler, all module dependencies and the server itself. No local V setup is required.

# Build the image
docker build -t vedrock .

# Run the server
docker run -d --name vedrock -p 19132:19132/udp vedrock

Or with Docker Compose:

docker compose up -d

The compose setup mounts worlds/, players/ and vedrock.yml from the repository root so world data and configuration persist across container restarts.

Contributing

Contributions are welcome.

You can contribute by opening issues, reporting bugs, suggesting improvements, improving documentation or submitting pull requests.

Before opening a pull request, please make sure your changes are focused and easy to review. If you want to work on a larger change, opening an issue first is recommended so the design can be discussed before implementation.

By participating in this project, you are expected to follow the bedrock-v Code of Conduct.

You can also read this.