Home

Welcome to BDSX wiki!

Minecraft Bedrock Dedicated Server that supports node.js.

Supports both OS: Windows & Linux(with Wine)

Basic Minecraft features as usual. node.js features (?) Debug with Visual Studio Code (You can debug addons too)

An example of what you can do with BDSX

Grab the network packet + Get IP Address & XUID

import { events } from "bdsx/events";
import { MinecraftPacketIds } from 'bdsx/bds/packetids';
events.packetAfter(MinecraftPacketIds.Login).on((pkt, networkIdentifier, packetId)=>{
    const ip = networkIdentifier.getAddress();
    if (pkt.connreq === null) return; // Wrong version client
    const cert = pkt.connreq.getCertificate();
    const xuid = cert.getXuid();
    const username = cert.getId();
    console.log(`Connection: ${username}> IP=${ip}, XUID=${xuid}`);
});

---

Getting started -

Requirements:

node.js

Wine (if using Linux)

Recommended:

VSCode

GIT

---

How to Install

---

• Install with the terminal and GIT (Recommended)

git clone https://github.com/bdsx/bdsx.git # clone the project
cd bdsx # Enter to the bdsx directory
bdsx.bat # Run, bdsx.sh for Linux

• Install manually

1. Download the latest Version of Bdsx
2. Make a folder then put the bdsx zip 
3. Extract the bdsx zip on the folder
3. Then click the bdsx.bat 
then all done the server will start the running

---

Starting server with VSCode

1. Open the project with VSCode
2. Open a terminal(Ctrl+Shift+｀)
3. run `npm i` # install npm packages and BDS
4. Press `F5` # build & run
Starting with the executable
run ./bdsx.bat (on Windows)
run ./bdsx.sh (on Linux)

---

File Structure

[bdsx project]
├ [bdsx] # Core Library
├ [addons] # This directory is for *.mcaddon & *.mcpack
├ [example_and_test]
├ [plugins] # This directory is for the local plugins
├ [bedrock_server] # BDS will be installed on server start
├ launcher.ts # Script before launching BDS.
├ index.ts # Main entry point.
├ bdsx.sh # Executable for Linux
└ bdsx.bat # Executable for Windows
# ./launcher.ts imports ./index.ts after launching BDS
# Please start your own code from ./index.ts

---

Discord

https://discord.gg/pC9XdkC

Docker Image

https://hub.docker.com/r/karikera/bdsx

Bug Report

https://github.com/bdsx/bdsx/issues

Hosting Support

https://easyminecrafthosting.com/ (Latin America)

BDSX Core

https://github.com/bdsx/bdsx-core