Home - bdsx/bdsx GitHub Wiki
Welcome to BDSX wiki!
node.js.
Minecraft Bedrock Dedicated Server that supportsSupports 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:
Wine (if using Linux)
Recommended:
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
Docker Image
https://hub.docker.com/r/karikera/bdsx
Bug Report
https://github.com/bdsx/bdsx/issues
Hosting Support
https://easyminecrafthosting.com/ (Latin America)