We have moved to Baltica! For newer versions go and take a look there.

A powerful and easy-to-use client library for Minecraft Bedrock Edition.

npm i @sanctumterra/client

• The Connection class is a bare-bones client, while the Client class offers more features.
• Due to protocol support requirements, versions cannot be automatically switched. Specific client library versions are needed.

const { Client, Logger, DeviceOS } = require("@sanctumterra/client");

const client = new Client({
    host: "127.0.0.1",
    port: 19132,
    offline: true,
    username: "SanctumTerra",
    tokensFolder: "./cache/tokens",
    version: "1.21.50",
    deviceOS: DeviceOS.Android,
    sendAuthInput: true,
    logPacketErrors: false,
    tickRate: 50 // 50 is the default tick rate
});

client.connect();

client.on("TextPacket", (packet) => {
    if (packet.parameters) {
        if (packet.message.includes("chat.type.text")) {
            return Logger.chat(`§f<${packet.parameters[0]}> ${packet.parameters[1]}`);
        }
        if (packet.message.includes("multiplayer.player.joined")) {
            return Logger.chat(`§e${packet.parameters[0]} joined the game`);
        }
        if (packet.message.includes("multiplayer.player.left")) {
            return Logger.chat(`§e${packet.parameters[0]} left the game`);
        }
        if (packet.message.includes("%chat.type.announcement")) {
            return Logger.chat(`§d<${packet.parameters[0]}> ${packet.parameters[1]}`);
        }
    }
    Logger.chat(packet.message);
});

client.on("spawn", () => {
    Logger.info("Spawned!");
});

• Required Parameters: host, port
• Optional Parameters: offline, username, tokensFolder, version, deviceOS, viewDistance, sendAuthInput, logPacketErrors, tickRate

• Events allow you to listen to any implemented packet if it is not implemented you will receive a warning and it should not crash if there is a crash then make an issue on github.

• Supports Minecraft color codes for in-game styled message logging
• Easier to use and understand

• Fixed bugs with BDS.
• Added more options.
• New Listener Events.

• Use latest version of Raknet
• Fixes

• Added support for Minecraft 1.21.50.
• Fixed many bugs.
• Slightly Improved performance.

• Added support for Minecraft 1.21.40.
• New Raknet! It now uses NAPI as Rust is faster.
• connect function now returns [Advertisement, StartGamePacket]

• Added DeviceOS to the Client.

• Removed Protocol Validation
• Added more debug logs
• Improved performance

• Added a couple examples in /examples/ (readline, skinStealer).
• debug logs n options.
• Allow safe disconnection.

• Separated Client into Connection and Client classes.
• Fixed CraftingDataPacket for Shields.
• Improved packet handling for pre-spawn packets.
• Enhanced Listener Events for "secret" / "hidden" events.

• Added support for Minecraft 1.21.30.

• Initial Release of V2.

Made with ❤️ by SanctumTerra