📞 Getting Help 📞 Hilfe erhalten

💬 Join Support Discord 💬 Support Discord beitreten 🐛 Report Issue on GitHub 🐛 Problem auf GitHub melden 📧 Email Support 📧 E-Mail Support
💡
Discord support is typically faster than GitHub issues! Discord-Support ist normalerweise schneller als GitHub-Issues!

Resources & Links Ressourcen & Links

📺

YouTube Tutorials

Hosted Servers
Aternos Setup
🛠️

Tools

Auto-Installer
JSON Validator
📚

Documentation

GitHub Repository
MBAIS Standard
💝

Support Us

Donate
Plugin Examples
Examples Beispiele

esploratori/bridgeAPI Module

The bridgeAPI module allows you to customize and enhance BedrockBridge's capabilities through custom plugins. Das bridgeAPI Modul erlaubt es dir, BedrockBridge's Fähigkeiten durch eigene Plugins anzupassen und zu erweitern.

Available Objects:

bridge

Type: WorldBridge

Main bridge instance containing all tools and events

bridgeDirect

Type: BridgeDirect

Direct connection capabilities for sending messages to Discord

database

Type: EsploratoriDatabase

Persistent storage system for bridge plugins

Type Extensions:

// String extensions string.toBedrock() - Convert string for Bedrock display string.toDiscord() - Convert string for Discord display // Player extensions player.mute() - Mute the player player.unmute() - Unmute the player player.muted - Check if muted player.deaf - Check if deafened player.dcNametag - Get Discord nametag // Array extensions array.includesAll() - Check if array includes all elements

WorldBridge Class

Properties

  • discordCommands: bridgeCommands - Handler for Discord command permissions
  • events: bridgeEvents - Bridge event system
  • bedrockCommands: bedrockCommands - Command registration system
  • playerList: Array<{name:string, id:string}> - All players who joined

BridgeDirect Class

⚠️ Must be enabled through bridgeInitializeEvent first!

Properties

  • ready: boolean - Check if bridgeDirect is enabled
  • events: BridgeDirectEvents - BridgeDirect specific events

sendMessage(message, author, picture)

Send a message to Discord

  • message: string - Message content
  • author: string - Display name
  • picture: string - Profile picture URL

sendEmbed(embed, author, picture)

Send an embed to Discord

  • embed: EmbedObject - Discord embed object
  • author: string - Display name
  • picture: string - Profile picture URL

bedrockCommands Class

Properties

  • prefix: string - Current command prefix

registerCommand(name, callback, description)

Register a new command

  • name: string - Command name
  • callback: (player, ...args) => void - Command handler
  • description: string - Help text

registerAdminCommand(name, callback, description)

Register admin-only command (requires esploratori:admin tag)

registerTagCommand(name, callback, description, ...tags)

Register command requiring specific tags

bridgeCommands Class

Properties

  • allow_mode: boolean - Whitelist (true) or blacklist (false) mode
  • list: string[] - List of registered commands

allow(command_name, ...other_commands)

Whitelist specific commands (blocks all others)

forbid(command_name, ...other_commands)

Blacklist specific commands

commandArgument Class

Extends String with parsing methods:

Methods

  • readNumber(): number - Parse as number
  • readInteger(): number - Parse as integer
  • readBoolean(): boolean - Parse as boolean
  • readPlayer(): Player | undefined - Get player by name
  • readLocation(): Vector - Parse "x y z" location

EsploratoriDatabase Class

Properties

  • tableNames: string[] - List of created tables

makeTable(name): Map

Create a persistent Map that survives server restarts

  • name: string - Unique table name

Bridge Events

bridgeInitialize

Fires when bridge starts. Use to enable features like bridgeDirect.

bridge.events.bridgeInitialize.subscribe(e => { e.registerAddition("discord_direct"); // Enable bridgeDirect });

chatUpStream

Modify Minecraft → Discord messages

bridge.events.chatUpStream.subscribe(e => { e.sender_name = `[${e.player.level}] ${e.sender_name}`; e.content = e.content.replace(/bad word/gi, "****"); });

chatDownStream

Modify Discord → Minecraft messages

bridge.events.chatDownStream.subscribe(e => { e.sender = `§b[Discord]§r ${e.sender}`; });

playerJoinLog

Player join events

playerLeaveLog

Player leave events

playerDieLog

Player death events

petDieLog

Pet death events

Example: Custom Command

import { bridge } from "esploratori/bridgeAPI"; // Register a custom command bridge.bedrockCommands.registerCommand("home", (player) => { player.teleport({x: 0, y: 100, z: 0}); player.sendMessage("§aWelcome home!"); }, "Teleport to spawn");

Example: Discord Notifications

import { world } from "@minecraft/server"; import { bridge, bridgeDirect } from "esploratori/bridgeAPI"; // Enable bridgeDirect bridge.events.bridgeInitialize.subscribe(e => { e.registerAddition("discord_direct"); }); // Send notification when legendary item is used world.afterEvents.itemUse.subscribe(e => { if (e.itemStack.nameTag === "legendary-item" && bridgeDirect.ready) { bridgeDirect.sendMessage( `${e.source.name} used a legendary item!`, "Legendary News", "https://i.imgur.com/legendary.png" ); } });

Example: Persistent Storage

import { world } from "@minecraft/server"; import { database } from "esploratori/bridgeAPI"; // Create persistent storage const winners = database.makeTable("dragon_slayers"); // Track dragon kills world.afterEvents.entityDie.subscribe(e => { if (e.deadEntity.typeId === "minecraft:ender_dragon") { const killer = e.damageSource.damagingEntity; winners.set(killer.id, { name: killer.name, kills: (winners.get(killer.id)?.kills || 0) + 1 }); } });

Example: Chat Filter

import { bridge } from "esploratori/bridgeAPI"; const bannedWords = ["badword1", "badword2"]; bridge.events.chatUpStream.subscribe(e => { // Check for banned words for (const word of bannedWords) { if (e.content.toLowerCase().includes(word)) { e.cancel = true; // Prevent message e.player.sendMessage("§cYour message contains banned words!"); return; } } // Add level prefix e.sender_name = `[Lvl ${e.player.level}] ${e.sender_name}`; });

Bridge Plugins Bridge Plugins

📦 Installing Plugins 📦 Plugins installieren

1
Navigate to behavior_packs/BedrockBridge/scripts/bridgePlugins Navigiere zu behavior_packs/BedrockBridge/scripts/bridgePlugins
2
Place your .js plugin file in the folder Platziere deine .js Plugin-Datei im Ordner
3
Open index.js and add: import "./your-plugin-name" Öffne index.js und füge hinzu: import "./dein-plugin-name"
4
Restart your server Starte deinen Server neu

🛠️ Creating Your Own Plugin 🛠️ Eigenes Plugin erstellen

Basic plugin template: Basis Plugin-Vorlage:

// My Custom Bridge Plugin import { world } from "@minecraft/server"; import { bridge, bridgeDirect } from "esploratori/bridgeAPI"; // Enable features you need bridge.events.bridgeInitialize.subscribe(e => { e.registerAddition("discord_direct"); }); // Add your functionality bridge.bedrockCommands.registerCommand("mycommand", (player, ...args) => { player.sendMessage("Hello from my plugin!"); }, "My custom command"); // Hook into events bridge.events.chatUpStream.subscribe(e => { // Modify messages going to Discord }); console.log("My plugin loaded successfully!");

Legacy API (Customise.js) Legacy API (Customise.js)

⚠️
For BedrockBridge versions older than 1.3.0. New versions should use the Bridge API instead. Für BedrockBridge Versionen älter als 1.3.0. Neue Versionen sollten die Bridge API nutzen.

Customise.js Functions

downStreamMessage(sender, message, roles)

Modify how Discord messages appear in Minecraft

upStreamMessage(player, message)

Modify how Minecraft messages appear in Discord

Ignore Lists

  • ignore_death - Prevent death embeds for certain players
  • ignore_log - Prevent join/leave embeds
  • ignore_chat - Prevent chat streaming

Frequently Asked Questions Häufig gestellte Fragen

It doesn't work! What should I do? Es funktioniert nicht! Was soll ich tun? ▼
1. Check if the addon works: Run !status in chat
- If you see "!status" as text → Addon not installed or experiments not enabled
- If it says "offline" → Check your token and run !messages
- If chat isn't streaming → Run /setup again and check bot permissions

Common fixes:
- Enable experiments (Beta API)
- Check the correct version for your Minecraft
- Put BedrockBridge on top of other addons
- Give bot admin permissions 1. Prüfe ob das Addon funktioniert: Führe !status im Chat aus
- Wenn du "!status" als Text siehst → Addon nicht installiert oder Experimente nicht aktiviert
- Wenn es "offline" sagt → Prüfe deinen Token und führe !messages aus
- Wenn Chat nicht streamt → Führe /setup erneut aus und prüfe Bot-Berechtigungen

Häufige Lösungen:
- Aktiviere Experimente (Beta API)
- Prüfe die richtige Version für dein Minecraft
- Setze BedrockBridge über andere Addons
- Gib dem Bot Admin-Berechtigungen
How do I fix "token not valid" on Aternos? Wie behebe ich "Token nicht gültig" auf Aternos? ▼
Aternos starts your server on different nodes each time, invalidating tokens. To fix:

In-game setup: Run scriptevent esploratori:setup and fill the origin field with your server domain (e.g., yourserver.aternos.me)

File setup: Add to variables.json: "origin": "yourserver.aternos.me"

This links your token to the domain instead of the changing IP address. Aternos startet deinen Server jedes Mal auf verschiedenen Nodes, was Token ungültig macht. Lösung:

In-Game Setup: Führe scriptevent esploratori:setup aus und fülle das Origin-Feld mit deiner Server-Domain (z.B. deinserver.aternos.me)

Datei-Setup: Füge zu variables.json hinzu: "origin": "deinserver.aternos.me"

Dies verknüpft deinen Token mit der Domain statt der wechselnden IP-Adresse.
How can everyone run all commands? Wie können alle alle Befehle ausführen? ▼
Discord has native permission management! Go to:
Server Settings → Integrations → BedrockBridge

There you can:
- Set which roles can use bot commands
- Choose allowed channels
- Configure permissions for individual commands

No need for bot-specific permission systems! Discord hat native Berechtigungsverwaltung! Gehe zu:
Servereinstellungen → Integrationen → BedrockBridge

Dort kannst du:
- Festlegen welche Rollen Bot-Befehle nutzen können
- Erlaubte Kanäle wählen
- Berechtigungen für einzelne Befehle konfigurieren

Kein Bot-spezifisches Berechtigungssystem nötig!
How do I update BedrockBridge? Wie aktualisiere ich BedrockBridge? ▼
1. Download the new pack and unzip server_pack
2. Replace the content of development_behaviour_pack folder
3. Restart when convenient (not required immediately)

TL;DR: Replace the old main.js with the new main.js 1. Lade das neue Pack herunter und entpacke server_pack
2. Ersetze den Inhalt des development_behaviour_pack Ordners
3. Starte neu wenn es passt (nicht sofort nötig)

Kurz: Ersetze die alte main.js mit der neuen main.js
Connection issues since February 2024? (v1.3.4 or lower) Verbindungsprobleme seit Februar 2024? (v1.3.4 oder älter) ▼
We updated the bot address. For older versions:
1. Find main.js in the addon files
2. Search for ismp.space (use CTRL+F)
3. Replace it with i.space

Or just update to the latest version! Wir haben die Bot-Adresse aktualisiert. Für ältere Versionen:
1. Finde main.js in den Addon-Dateien
2. Suche nach ismp.space (nutze STRG+F)
3. Ersetze es mit i.space

Oder update einfach auf die neueste Version!
Which Minecraft versions are supported? Welche Minecraft-Versionen werden unterstützt? ▼
BedrockBridge supports versions from 1.19.50 to 1.21.90 (latest).
You must install the correct addon version for your Minecraft version.
Check the GitHub tags for the right version! BedrockBridge unterstützt Versionen von 1.19.50 bis 1.21.90 (neueste).
Du musst die richtige Addon-Version für deine Minecraft-Version installieren.
Prüfe die GitHub-Tags für die richtige Version!

Troubleshooting Guide Fehlerbehebungsanleitung

🔍 Diagnostic Steps 🔍 Diagnoseschritte

Symptom Symptom Possible Cause Mögliche Ursache Solution Lösung
!status shows as text Addon not working Enable experiments, check version compatibility
Status: offline Connection failed Check token, run !messages for errors
No chat streaming Discord setup issue Run /setup again, check bot permissions
Commands not working Wrong prefix or permissions Check prefix in config, verify Discord permissions

📞 Getting Help 📞

Bedrock Setup Bedrock-Einrichtung

1
Download the BedrockBridge addon (.mcaddon file) Lade das BedrockBridge Addon herunter (.mcaddon Datei)
2
Install the addon on your world and enable experiments (Beta API) Installiere das Addon in deiner Welt und aktiviere Experimente (Beta API)
ℹ️ Ignore console error logs - they occur because the addon uses server-only modules Ignoriere Konsolen-Fehlermeldungen - sie entstehen weil das Addon Server-Module nutzt
3
Upload the world back to your server Lade die Welt zurück auf deinen Server
4
Navigate to <main folder>/config/default/permissions.json and add: Navigiere zu <main folder>/config/default/permissions.json und füge hinzu:
"@minecraft/server-net"
5
Start your server, join the game, and run: Starte deinen Server, betrete das Spiel und führe aus:
/scriptevent esploratori:setup
💡
If you're not OP or cheats are disabled, run this in the server console: Wenn du kein OP bist oder Cheats deaktiviert sind, führe dies in der Server-Konsole aus:
execute as <your username> run scriptevent esploratori:setup
6
Fill in the setup form with your token and settings Fülle das Setup-Formular mit deinem Token und Einstellungen aus

🎮 Aternos Installation 🎮 Aternos Installation

New simplified installation for Aternos users (since v1.4.2): Neue vereinfachte Installation für Aternos-Nutzer (seit v1.4.2):

1
Download the pack using the /download Discord command Lade das Pack mit dem /download Discord-Befehl herunter
2
Drop the .mcaddon pack into Menu > Files > packs Ziehe das .mcaddon Pack in Menü > Dateien > Packs
3
Enable Worlds > Options > Beta API Aktiviere Welten > Optionen > Beta API
4
Start the server and enjoy! Starte den Server und genieße!
⚠️
For Aternos: Add your server's origin domain (e.g., yourserver.aternos.me) in the setup to keep your token valid across restarts Für Aternos: Füge die Origin-Domain deines Servers (z.B. deinserver.aternos.me) im Setup hinzu, um deinen Token über Neustarts hinweg gültig zu halten

Commands Reference Befehlsreferenz

📱 Discord Commands 📱 Discord-Befehle

/help

Find all you need to get started with BedrockBridge Bot Finde alles was du brauchst um mit BedrockBridge Bot zu starten

/setup
channel (optional)

Initialize the bot for your server. Sets the chat streaming channel Initialisiere den Bot für deinen Server. Legt den Chat-Streaming-Kanal fest

/new-token

Generate a new token. Old token becomes invalid Generiere einen neuen Token. Alter Token wird ungültig

/announce
message

Send an announcement to Bedrock (no username shown) Sende eine Ankündigung an Bedrock (kein Benutzername angezeigt)

/command
command (without /)

Execute any Minecraft command remotely Führe jeden Minecraft-Befehl remote aus

/ban
username

Ban a player (adds to temp-ban list if offline) Banne einen Spieler (fügt zur Temp-Ban-Liste hinzu wenn offline)

/unban
username

Unban a player Entbanne einen Spieler

/rename
username, nametag

Change a player's nametag (persistent) Ändere das Namensschild eines Spielers (dauerhaft)

/mute
username, time (optional)

Mute a player (they can still use /me or /say) Stumme einen Spieler (kann noch /me oder /say nutzen)

/unmute
username

Unmute a player Entstumme einen Spieler

/find
username

Get player location with dimension indicator Erhalte Spielerstandort mit Dimensionsanzeige

/inventory
username

View player's inventory contents Zeige Inventarinhalt des Spielers

/echest
username

View player's ender chest Zeige Endertruhe des Spielers

/stats
username

Get detailed player info: health, gamemode, location, tags, scores, device, XUID Erhalte detaillierte Spielerinfos: Gesundheit, Spielmodus, Ort, Tags, Punkte, Gerät, XUID

/kill
username

Kill a player Töte einen Spieler

/list

List all online players Liste alle Online-Spieler auf

/gamemodes

List all players and their gamemodes Liste alle Spieler und ihre Spielmodi auf

/claimdc
token

Link your Discord account to show profile picture and name in chat Verknüpfe dein Discord-Konto um Profilbild und Namen im Chat anzuzeigen

/kick
username

Kick a player from the server Kicke einen Spieler vom Server

🎮 Bedrock Commands 🎮 Bedrock-Befehle

Use these commands in Minecraft chat with your configured prefix (default: !) Nutze diese Befehle im Minecraft-Chat mit deinem konfigurierten Präfix (Standard: !)

!help

Returns a list of available commands Gibt eine Liste verfügbarer Befehle zurück

!connect

Reconnect to Discord if disconnected Stelle Verbindung zu Discord wieder her

!linkdc

Get a token to link your Discord account Erhalte einen Token um dein Discord-Konto zu verknüpfen

!unlink

Reset your Discord link (removes custom avatar/name) Setze deine Discord-Verknüpfung zurück (entfernt Avatar/Namen)

!messages

View connection error messages Zeige Verbindungsfehlermeldungen

!status

Check current connection status Überprüfe aktuellen Verbindungsstatus

!logging
on/off

Enable/disable error logging Aktiviere/Deaktiviere Fehlerprotokollierung

!deaf

Stop receiving Discord messages Stoppe Empfang von Discord-Nachrichten

!undeaf

Resume receiving Discord messages Setze Empfang von Discord-Nachrichten fort

Configuration Konfiguration

📝 variables.json Configuration 📝 variables.json Konfiguration

Location: <server-main-folder>/config/54d46e5d-b8c7-486f-8957-f83982bdfc2f/variables.json Ort: <server-hauptordner>/config/54d46e5d-b8c7-486f-8957-f83982bdfc2f/variables.json

💡
Changes require server restart. You can also use in-game setup instead of file configuration. Änderungen erfordern Serverneustart. Du kannst auch In-Game-Setup statt Dateikonfiguration nutzen.
{ "token": "your-discord-token", "prefix": "!", // Command prefix (single character) "discord_link": true, // Allow Discord profile linking "output": 0, // 0: embeds, 1: plain text "startup_notify": true, // Server start notifications "shutdown_notify": true, // Server stop notifications "remote_transfer_disabled": false, // Allow player transfers "partner_servers": "name:host:port", // Comma-separated partner servers "origin": "myserver.aternos.me", // For dynamic IPs (optional) "allow_command_messages": false // Allow NPCs/command blocks to use bridgeDirect }

Configuration Options Explained: Konfigurationsoptionen erklärt:

Option Option Type Typ Description Beschreibung
prefix char Command prefix for Bedrock commands (e.g., !, ., ?) Befehlspräfix für Bedrock-Befehle (z.B. !, ., ?)
discord_link boolean Allow players to link Discord accounts for custom avatars Erlaube Spielern Discord-Konten für eigene Avatare zu verknüpfen
output integer 0: Use embeds for events, 1: Plain text messages 0: Nutze Embeds für Events, 1: Einfache Textnachrichten
partner_servers string Format: "displayName:host:port,name2:host2:port2" Format: "anzeigeName:host:port,name2:host2:port2"
origin string Domain for dynamic IPs (e.g., Aternos servers) Domain für dynamische IPs (z.B. Aternos Server)

Bridge Direct

🔗 Bridge Direct API

Bridge Direct allows other addons to send messages to Discord through scriptevents (since v1.4.0) Bridge Direct erlaubt anderen Addons Nachrichten an Discord über Scriptevents zu senden (seit v1.4.0)

ℹ️ Supports MBAIS standard. Enable "allow_command_messages" for NPC/command block usage. Unterstützt MBAIS Standard. Aktiviere "allow_command_messages" für NPC/Befehlsblock-Nutzung.

Endpoints:

discord:message

Send a message to Discord chat

/scriptevent discord:message {"author":"GameNotification", "message": "Something happened!", "picture":"https://i.imgur.com/9y8IvBG.png"}
discord:embed

Send an embed to Discord chat

/scriptevent discord:embed {"author":"GameNotification", "embed":{"title": "Red alert!", "description": "Something red happened!", "color": 15548997}}
discord:ready

Listen to this event to check if bridgeDirect is enabled and ready

Bridge API

Overview Übersicht
Classes Klassen
Events Events
BedrockBridge - Complete Documentation

BedrockBridge

Connect your Minecraft Bedrock server to Discord seamlessly Verbinde deinen Minecraft Bedrock Server nahtlos mit Discord

Supported Versions: Unterstützte Versionen:

1.19.50 1.19.60 1.19.70 1.19.80 1.20.0 1.20.10 1.20.30 1.20.40 1.20.50 1.20.60 1.20.70 1.20.80 1.21.0 1.21.2 1.21.20 1.21.30 1.21.40 1.21.50 1.21.60 1.21.70 1.21.80 1.21.90 (latest)

How It Works Wie es funktioniert

Minecraft Server ↔️ BedrockBridge Bot ↔️ Discord Server Minecraft Server ↔️ BedrockBridge Bot ↔️ Discord Server

Install the minecraft addon, invite the bot to Discord, and they'll communicate seamlessly! Installiere das Minecraft Addon, lade den Bot zu Discord ein, und sie kommunizieren nahtlos!

Features Funktionen

💬

Chat Bridge Chat-Brücke

Real-time bidirectional chat synchronization Echtzeit bidirektionale Chat-Synchronisation

🎮

Remote Control Fernsteuerung

Execute commands and manage your server from Discord Führe Befehle aus und verwalte deinen Server von Discord aus

📊

Player Stats Spielerstatistiken

View inventories, locations, and detailed player information Zeige Inventare, Standorte und detaillierte Spielerinformationen

🔌

Plugin Support Plugin-Unterstützung

Extend functionality with custom bridge plugins Erweitere Funktionen mit benutzerdefinierten Bridge-Plugins

🔗

Discord Linking Discord-Verknüpfung

Link Discord accounts to show profile pictures and names Verknüpfe Discord-Konten um Profilbilder und Namen anzuzeigen

📢

Event Notifications Event-Benachrichtigungen

Get notified about joins, leaves, deaths, and server status Erhalte Benachrichtigungen über Beitritte, Austritte, Tode und Serverstatus

Installation Guide Installationsanleitung

ℹ️
For expert users: Invite bot, run /setup, install addon, run /scriptevent esploratori:setup, connect! Für erfahrene Nutzer: Bot einladen, /setup ausführen, Addon installieren, /scriptevent esploratori:setup ausführen, verbinden!

Discord Setup Discord-Einrichtung

1
Invite the BedrockBridge bot to your Discord server using the invite link Lade den BedrockBridge Bot mit dem Einladungslink auf deinen Discord Server ein
2
Choose your chat channel and run /setup in it Wähle deinen Chat-Kanal und führe /setup darin aus
3
Generate a token with /new-token and save it securely Generiere einen Token mit /new-token und speichere ihn sicher
⚠️
If messages aren't streaming and your server is connected, give the bot admin permissions and run /setup again. Wenn Nachrichten nicht gestreamt werden und dein Server verbunden ist, gib dem Bot Admin-Berechtigungen und führe /setup erneut aus.