This is a mirror of https://codeberg.org/l-koehler/bridgetest
I likely won't see pull requests / issues here!

This program is supposed to let a unmodified Minetest client connect to
another (mostly) unmodified Minecraft (Java Edition) server.
The Java Server version needed is 1.21.5, use ViaProxy if you need another version.
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).

Installation Instructions

This program needs the minecraft textures.
I won't just bundle these due to copyright reasons, but you can get them:

• From the Minecraft client:
  • Get a minecraft jar file (should be something like minecraft-1.21.4-client.jar)
  • Unpack it (jar files are glorified zip archives)
  • Grab the folders in assets/minecraft/textures/
• or from the internet:
  • Go here (mcasset.cloud)
  • Click "Download Folder"
  • You'll need to unpack that zip file, it contains your textures.

Regardless of method, you now have a bunch of directories.
Checkpoint: These directories should contain a bunch of PNG files.
Now, move these so you'll have this folder structure:

<bridgetext-data-directory>
└── textures
    ├── block
    ├── colormap
    └── ...

The bridgetest-data-directory is ~/.local/share/bridgetest on Linux.
On Windows, it should be C:\Users\Alice\AppData\Roaming\bridgetest.
It will be created on the first start, alternatively you can create it yourself.

Some models are also needed and will be downloaded on the first start.

Troubleshooting Steps

• Ensure you are running the latest commit for bridgetest.
• Try using luanti compiled from somewhat recent source.
• Make a issue report, most likely any problems are caused by bridgetest.

Things that are still missing from a usable version

• Crafting (Containers work (mostly, the UI is broken))
• Attacking/usable combat in general

Other, smaller, broken things

• Rotated Blocks (ex. ladders that have a "side")
• Climbable Blocks (ladders/vines)
• Sneaking (waiting on upstream)
• Swimming
• Various block interactions like opening doors, using levers etc.
• Particles (will suck to implement, delayed until i cant do other stuff instead)
• Imprecisions in the movement (the client speed/gravity etc is not exact, so
  server/client will drift out of sync for up to half a block, at which point the
  proxy re-positions the client)

Even more limitations (ones that don't affect gameplay)

• The Minecraft server needs to be in offline-mode. I could fix that
  with azalea-auth but most people who might use this probably do not
  have a minecraft account. TODO later

• Any Anticheats are likely near-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 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 proxy can only handle one client at a time, but could probably be
  rewritten to handle more clients without changing that much.

Attributions

This program automatically downloads entity models.
These were not made by me and are licensed under the CC-BY-SA 4.0.
The Models are taken from Mineclonia, a minetest mod.
This Mod is owned on ContentDB by ryvnf, a full list of contributors is here.