This program is supposed to let a unmodified Minetest client connect to
another (mostly) unmodified Minecraft (Java Edition) server.
The Java Server version is whatever the latest git commit to azalea needs.
It compiles to a standalone executable, which will listen on 127.0.0.1:30000
for minetest and then proxy to a minecraft server specified in CONF_DIR/config.txt
You need nightly rust to build some dependencies (rustup default nightly
).
As a minetest client assumes nearly everything is provided by the server
while the server assumes textures, blocks and items are known by the client,
this program does NOT ONLY proxy all traffic, but also sends a texture
pack and block/item/entity definitions, which are obtained from ArcticData.
You can generate these definitions yourself if you don't want to use ArcticData,
possibly by using Minecrafts inbuilt Data Generators instead of it.
This also needs the entity models as .b3d files. You can get these by
downloading Mineclonia, taking all .b3d files that are in that folder
and pasting them into ~/.local/share/bridgetest/models/
(on linux).
- Crafting (Recipes are already implemented, waiting for containers)
- Attacking/usable combat in general
- burn the entire movement thing down and do the same mistakes again
- Rotated Blocks
- Climbable Blocks
- Containers (waiting on upstream)
- Sneaking (waiting on upstream)
- Crafting recipes (sort-of waiting on Containers)
Note:
Currently, nearly everything is a limitation, but
most things are planned to be added. This only lists problems that will
likely remain even if this ever becomes somewhat complete.
Technical Limitations:
-
The Minecraft server needs to be in offline-mode. I could fix that
withazalea-auth
but most people who might use this probably do not
have a minecraft account. -
Any Anticheats are
likelynear-certain to ban you.
(if they don't, you probably found a bug in the anticheat? the traffic sent
by this proxy is looking basically the same as that from any bot.)
That is a slight danger even with GeyserMC in proxy mode, a similar
(but mature) program basically doing the same thing for Bedrock. -
The program cannot run as a server- or clientside mod.
Server-side would probably be possible somehow, but
there are only few protocol librarys for minetest, none of them for Java.A Client-side mod is simply impossible, as the Minetest Modding API (Lua)
does not allow me to rip the entire engine networking out and replace it. -
The program might work on Windows, but I am not testing this.
If you find a windows bug, feel free to open a issue, but I will only work
on that if it won't take too long. PRs fixing windows will be accepted.
for now, i'd prefer getting this mess to work at all :3 -
The upstream library for the minecraft protocol
needs to be the bleeding-edge git version, but you can simply ignore
this warning here if you only want to use this program.
The minecraft protocol is implemented by another library, not by me.
The textures this server is sending are NOT the official minecraft resources.
This repository contains NO textures, but the program will offer to download
the Faithful x32 texture pack (license) if no pack is found.
You can change what pack is used by changing the URL the config file
(at ~/.config/bridgetest.toml
) points to or by changing the texture pack
itself, at ~/.local/share/bridgetest/textures
).
(these paths are dirs::local_data_dir and dirs::config_dir, not hardcoded)
The 3D-models are also not provided by this program.