Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 1.44 KB

README.md

File metadata and controls

35 lines (26 loc) · 1.44 KB
Raw

ModLoader

This is a tool to load mods onto the Linux version of Bedrock Dedicated Server.

Usage

  • Get libserver_modloader.so, either from releases or building your own
  • Put your compiled mods in a folder called mods/ next to your moddable BDS binary
  • LD_PRELOAD=path/to/libserver_modloader.so ./bedrock_server_symbols_moddable.debug

Compiling from source

  1. git clone https://github.com/minecraft-linux/server-modloader.git --recursive
  2. cd server-modloader
  3. mkdir build && cd build
  4. cmake ..
  5. make

You now have a libserver_modloader.so binary.

Examples, usage info

Check out the wiki for examples and more information.

Getting mods to work on newer versions (1.16+)

Newer versions of BDS don't have exported symbols anymore, so a little hacking is necessary to modify the binary and make the symbols linkable.

Using LIEF, you can create a patched, moddable BDS from bedrock_server_symbols.debug using the following Python script:

import lief
import sys

lib_symbols = lief.parse("bedrock_server_symbols.debug")
for s in filter(lambda e: e.exported, lib_symbols.static_symbols):
    lib_symbols.add_dynamic_symbol(s)
lib_symbols.write("bedrock_server_symbols_patched.debug")