GeyserRecipeFixPatcher

GeyserRecipeFixPatcher

A small Paper/Folia plugin that installs Geyser Recipe Fix with local Folia-support patches applied, without redistributing any of the original plugin's code.

WARNING: Made with AI (cuz idk how to use Java)

PLEASE SUPPORT THE ORIGINAL DEVELOPER

I am a random dev, and you should really not trust random stuff you find on the Internet. Take a look at the source code which is only a few hundred lines long. (click on the GitHub "view source" link on the side). And if you prefer, compile the project yourself with mvn clean package (requires Java JDK 21+ and Maven installed).

What it actually does, on your own server, every boot

1. Asks Modrinth (the author's own official distribution channel) for the latest published build of Geyser Recipe Fix, and downloads it fresh.
2. Applies a small set of targeted bytecode edits directly to the two class files that need them (see PATCHES.md for the exact list). These edits never reproduce the original author's method bodies - they swap two collection allocations for thread-safe equivalents, and redirect two call sites to a couple of small helper classes that ship with this plugin.
3. Writes the result to plugins/GeyserRecipeFix.jar and asks you to restart the server once, exactly like installing a normal plugin update.
4. Repeats this on every startup, so you always end up running the latest upstream release with the same patches applied.

This repository never contains, bundles, or distributes any of Geyser Recipe Fix's code. The only copy of that code that ever exists is the one downloaded straight from Modrinth onto your own server, which you then locally and momentarily transform before running it - the same basic idea as a ROM/game patch (.bps/.xdelta) or a Linux distro's source patch: ship the delta, not the copyrighted base.

Why this exists

Geyser Recipe Fix is © Sideways-Sky, all rights reserved, with no OSS license attached. The author hasn't responded to a request to add one. This patcher exists so a set of Folia-compatibility fixes can reach users of that plugin without redistributing the author's copyrighted code - it fetches the real thing from the real place, and only ships the diff.

This is not a substitute for legal advice, and it's a materially different (lower) risk profile than distributing a patched jar yourself, but it isn't risk-zero: default copyright also covers the right to prepare derivative works, not just to redistribute copies. If the author ever responds, upstreaming these fixes directly (see PATCHES.md for the exact diff) would be the cleanest outcome for everyone.

Setup

1. Install PacketEvents and Geyser and/or Floodgate, same as Geyser Recipe Fix normally requires.
2. Build this project: ./gradlew build, then drop build/libs/GeyserRecipeFixPatcher-1.0.0.jar into your plugins/ folder. (Do not manually download/place GeyserRecipeFix.jar yourself - this plugin manages that file.)
3. Start the server once. GeyserRecipeFixPatcher will download, patch, and install plugins/GeyserRecipeFix.jar, then tell you to restart.
4. Restart. Geyser Recipe Fix now runs, patched, as a normal plugin - GeyserRecipeFixPatcher doesn't need to do anything else until a new upstream release appears.

Config (plugins/GeyserRecipeFixPatcher/config.yml)

• allowed-versions: leave empty to always track Modrinth's latest, or list specific version numbers you've verified, so nothing changes unexpectedly.
• auto-update: turn off if you want to review new versions manually via /grfpatcher update before they're installed.

Commands

• /grfpatcher status - shows the currently installed upstream version.
• /grfpatcher update - checks Modrinth and re-patches immediately.

Permission: geyserrecipefixpatcher.admin (defaults to ops).

Verifying the patch actually applied

Every patch run checks that each edit it made actually matched something in the downloaded jar (see JarPatcher.UnsupportedUpstreamVersionException). If upstream ever changes the structure these patches target, the run fails loudly in the console/log instead of silently installing a broken jar - watch for a GeyserRecipeFixPatcher update in that case.

Building from source

Requires JDK 21 and internet access to Maven Central + repo.papermc.io (for paper-api and the Mojang-mapped NMS dev bundle used only to compile the small helper classes that get injected - see PATCHES.md).

./gradlew build

This project was written and reviewed carefully, but hasn't been build- and run-tested against a live Paper/Folia server in the environment it was authored in. Test it on a dev server before relying on it in production, and please open an issue with the console output if the compatibility check ever fails.