Multi Version Bridge API #143

Floweynt · 2025-03-13T21:38:05Z

Provide an internal API over Minecraft to remove duplicated code across minecraft versions.

This is implemented via a set of interfaces, which are injected via loom interface injection (at compile time) and Mixins (at runtime). A stub class will be exposed to common as API, which provides static methods. These methods are overwritten via Mixin at runtime.

Goals:

Abstract most version independent logic to common
Reduce maintenance burden for new & old features

Non-goals:

Provide a stable external interface to third-party modules
Implement "multi-version" jars
Have "perfect" abstraction - some leaky abstraction is allowed, but these must be for specific edgecases only, e.g. an OpenGL call that's only needed in 1.8.9

Checklist:

Implement Bridge API for 1.8.9 (reference implementation for ports)
Implement Bridge API for 1.16
Implement Bridge API for 1.20
Implement Bridge API for 1.21
Implement Bridge API for 1.21.4
Port most HUD modules
~~Port other modules~~

During the porting process, 0 or some other suffix may be appended to avoid name collisions. These will be removed once colliding packages & classes have been abstracted away.

moehreag

A lot of good things, but also still some major issues. Of course, this is nowhere near finished, but the more bugs can be fixed already the less we have to find afterwards.

1.20/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/simple/CustomHudEntry.java

moehreag · 2025-03-14T10:55:29Z

1.8.9/src/main/java/io/github/axolotlclient/bridge/impl/AxoRenderContextImpl.java

+import net.minecraft.resource.Identifier;
+import org.jetbrains.annotations.Nullable;
+
+public class AxoRenderContextImpl implements AxoRenderContext {


On 1.8.9, this should ideally be an implementation akin to GuiGraphics on 1.20.1/1.21. On those newer versions, it should be a wrapper implementation. Another reason to prefer newer methods as a base are differences in parameter types and method usages, f.e. in regards to drawing textures (blitSprite methods) due to render types as well as text rendering (which isn't directly being delegated to the TextRenderer/Font). As such, a stateful matrix implementation might be necessary for 1.8.9 as well.

1.8.9/src/main/java/io/github/axolotlclient/bridge/impl/AxoRenderContextImpl.java

1.8.9/src/main/java/io/github/axolotlclient/bridge/impl/Bridge.java

common/src/main/java/io/github/axolotlclient/modules/hud/gui0/hud/item/ArrowHud.java

common/src/main/java/io/github/axolotlclient/modules/hud/gui0/hud/simple/CPSHud.java

common/src/main/java/io/github/axolotlclient/modules/hud/gui0/hud/simple/PingHud.java

moehreag · 2025-03-14T12:10:22Z

common/src/main/java/io/github/axolotlclient/modules/hud/gui0/hud/simple/ReachHud.java

-		return camera.distanceTo(receiving.getRotationVec(1));
+	private static double getAttackDistance(AxoEntity attacking, AxoEntity receiving) {
+		Vec3 camera = attacking.getRotation(1);
+		return camera.dist(receiving.getRotation(1));


Other versions do a manual raycast here which probably works better. However, the method used is not available on 1.8.9.

Floweynt · 2025-03-16T04:45:35Z

Resolved some of the comments. The code currently is ugly and has extraneous diffs, but I will clean them up later with some automated tooling. I just want to get everything in a working state before I deal with that.

…ause mojmap) note that this commit DOES NOT implement proper functionality (events, calling the correct render events, etc).

Floweynt · 2025-05-13T16:28:27Z

Limiting the scope of this now. Only porting Hypixel and HUD modules, and not even all HUD modules. I want this to be in an usable state in a few months, and begin testing soon.

Future work can include porting other modules / cleanup.

improve user agent format

- too early initialization of hud bounds - potion hud sprites - wrong parameters in gui mixins - icon hud getting cut off - trap upgrade icons - add a few todos

# Conflicts: # 1.16_combat-6/src/main/java/io/github/axolotlclient/AxolotlClient.java # 1.16_combat-6/src/main/java/io/github/axolotlclient/modules/hud/HudManager.java # 1.16_combat-6/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/PotionsHud.java # 1.16_combat-6/src/main/java/io/github/axolotlclient/modules/hypixel/StatsMod.java # 1.20/src/main/java/io/github/axolotlclient/AxolotlClient.java # 1.20/src/main/java/io/github/axolotlclient/modules/hud/HudManager.java # 1.20/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/PotionsHud.java # 1.20/src/main/java/io/github/axolotlclient/modules/hypixel/StatsMod.java # 1.21.7/build.gradle.kts # 1.21.7/src/main/java/io/github/axolotlclient/AxolotlClient.java # 1.21.7/src/main/java/io/github/axolotlclient/mixin/PlayerEntityRendererMixin.java # 1.21.7/src/main/java/io/github/axolotlclient/modules/hud/HudManager.java # 1.21.7/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/PotionsHud.java # 1.21.7/src/main/java/io/github/axolotlclient/modules/hypixel/StatsMod.java # 1.21/src/main/java/io/github/axolotlclient/AxolotlClient.java # 1.21/src/main/java/io/github/axolotlclient/modules/hud/HudManager.java # 1.21/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/PotionsHud.java # 1.21/src/main/java/io/github/axolotlclient/modules/hypixel/StatsMod.java # 1.8.9/src/main/java/io/github/axolotlclient/AxolotlClient.java # 1.8.9/src/main/java/io/github/axolotlclient/modules/hud/HudManager.java # 1.8.9/src/main/java/io/github/axolotlclient/modules/hud/gui/hud/PotionsHud.java # 1.8.9/src/main/java/io/github/axolotlclient/modules/hypixel/StatsMod.java # common/src/main/java/io/github/axolotlclient/AxolotlClientCommon.java # common/src/main/resources/assets/axolotlclient/lang/en_us.json # gradle.properties

- store filters as base64 to prevent conflicts with commas

**Changelog**: - fix a few bugs (#154, #155, #168) - add Bedwars StatsOverlay (#145) - Fix various hypixel issues (#167) - add Inventory HUD (#152) - big internal refactors (#143) - add Config Profiles (#161)

feat: initial bridge API implementation (1.8.9, some hud modules port)

62e28f6

moehreag suggested changes Mar 14, 2025

View reviewed changes

cleanup based on github comments

56ffc97

Floweynt added 7 commits March 19, 2025 00:54

fix compilation on some other versions (1.21.4 is not implemented bec…

11946c4

…ause mojmap) note that this commit DOES NOT implement proper functionality (events, calling the correct render events, etc).

preliminary bridge implementation for 1.21.4

eb79328

begin porting hypixel modules

aa04636

scissor and some other stuff

38be609

Things compile now

594785a

Get rid of hypixel modules

421d605

Fix some startup crashes + things not building for some reason.

32856e4

Floweynt added 18 commits May 13, 2025 11:32

migrate 1.8.9 to the common hud system rather than hosting both systems.

f304381

Improve bridge implementation on 1.8.9

1e304c0

squashme

be16f6c

cleanup for 1.16

90acafa

hud now doesn't crash

9fdabd1

1.20 runs without crashing, mostly

2db0554

add license headers

76f749e

"stable" for 1.21

b718887

merge "properly"

74d3d27

implement new bridge apis for 1.8.9

b2568b4

merge dev, again

d2bdcb9

implement new bridge api for 1.16

da95df1

bridge clean up & commands

9e25fb9

merge dev

44c521b

bug fixes

1719dca

uncomment some TODOs

557925c

fix config file logic

0b1a547

validate bridge implementations for 1.8.9, 1.16, and 1.20

8983413

Floweynt and others added 25 commits July 17, 2025 12:33

resolve some comments

7ebfbe2

fix mixin config

e4ef4e1

fix imports

864f402

bump gradle & loom

4c4b6e4

improve user agent format

cleanup user agent

df128cc

ensure config loading

0a8dd01

attempt some bugfixes

ac93b88

fix a lot of bugs

dbbbda5

- too early initialization of hud bounds - potion hud sprites - wrong parameters in gui mixins - icon hud getting cut off - trap upgrade icons - add a few todos

bump config lib

9d213e7

add keybind to toggle hud rendering

760c861

use consumeClick handlers for keybindings

0d55989

add bridge API for resource manager access

343f83e

fix another bug

29c909a

disable mc jar verification for 1.16_combat-6

f9dbf40

the same but so that it hopefully works

17e89e0

clean up main class

81bb698

Implement bridge for AutoBoop filters

63b4729

- store filters as base64 to prevent conflicts with commas

bump config lib + fabric loader version

bd531a4

fix resource reloads

840d55d

add missing AxoSprites Mixin to 1.21.8

768dd83

(1.8.9) fix hotbar hud

dafa142

Implement PlayerHuds

b9f5cd6

rename common hud package

55f1159

clean up a bit

dbb7a95

moehreag approved these changes Aug 5, 2025

View reviewed changes

moehreag marked this pull request as ready for review August 5, 2025 14:56

moehreag merged commit b2f1b7e into dev Aug 5, 2025
0 of 2 checks passed

moehreag mentioned this pull request Aug 21, 2025

3.1.5 #172

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Multi Version Bridge API #143

Multi Version Bridge API #143

Uh oh!

Floweynt commented Mar 13, 2025 •

edited

Loading

Uh oh!

moehreag left a comment

Uh oh!

Uh oh!

moehreag Mar 14, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

moehreag Mar 14, 2025

Uh oh!

Floweynt commented Mar 16, 2025

Uh oh!

Floweynt commented May 13, 2025 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Multi Version Bridge API #143

Multi Version Bridge API #143

Uh oh!

Conversation

Floweynt commented Mar 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

moehreag left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

moehreag Mar 14, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

moehreag Mar 14, 2025

Choose a reason for hiding this comment

Uh oh!

Floweynt commented Mar 16, 2025

Uh oh!

Floweynt commented May 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Floweynt commented Mar 13, 2025 •

edited

Loading

Floweynt commented May 13, 2025 •

edited

Loading