Avoid

🐦‍⬛ Avoid allows you to remove net.minecraft references completely from your code.

🧧 Supported Versions:

• 1.21.11 [LTS¹]
• 26.1 & 26.1.1 & 26.1.2
• 26.2
• 26.3-snapshot-2 [TS²]

¹ Long Term Support² Temporary Support

🔌 Supported ModLoaders:

• Fabric
• NeoForge

🧮 API-s:

• NBT
• Client Chat
• Server Chat
• Chat Colors
• Chat Components [BETA]
• Identification (Identifier)
• Item Querying       [ALPHA]
• Item Components [BETA]
• Editable Item Components [BETA]
• Entity Types                         [BETA]
• Entity Selectors                   [ALPHA]
• Transformed Item Components [BETA]
• Client Screen API
• Font API
• Render Layer API [BETA]
• Command API
• Command Parameter API
• Command Permission API
• Addon Loader (AvoidManager)
• Block Creation API [ALPHA]
• Item Creation API  [ALPHA]
• Entity API [ALPHA]
• Player API [ALPHA]
• World API  [ALPHA]
• Event API  [BETA]

There are also various events expanding your abilities to customize game behaviour, those however may not be listed as a part of an API.

🐙 GitHub: https://github.com/AvoidLib/Avoid 📚 Wiki: https://github.com/AvoidLib/Avoid/wiki

❓ Why?

1. Compatibility Minecraft changes API very often. This library doesn't.
2. Takeover Prevention Microsoft may steal your mods for them when you mod Minecraft. When you mod Avoid, you don't mod Minecraft - but any platform Avoid supports.

👀 But there's hundreds of libraries

I know. This one is created because I don't wanna use others. And because I need full coverage of Minecraft's code.

🧽 What about SpongePowered

SpongePowered doesn't seem to support Minecraft Fabric. Also, I don't think Sponge has client API-s.

🦘 So far, AvoidLib kept compatibility through all these changes¹:

• [26.1] Rendering Name Refactor
  • GuiGraphics -> GuiGraphicsExtractor
  • GuiGraphics#submitGuiElement -> GuiGraphics#addGuiElement
  • GuiGraphics#submitText -> GuiGraphics#addText
  • Screen#render -> Screen#extractRenderState
  • net.minecraft.client.gui.render.state -> net.minecraft.client.renderer.state.gui
• [26.1] Item Stack Refactor
  • ItemStack -> ItemStackTemplate
  • ItemStack#is -> TypedData#is
• [26.1] Stupid World Changes
  • getDayTime() -> getDefaultClockTime()
  • getBlockHolder() -> typeHolder()
• [26.1] Stupid Player Changes
  • displayClientMessage(Component, boolean) ->
    1. sendSystemMessage(Component)
    2. sendOverlayMessage(Component)
• [26.1] Stupid Chat Changes
  • net.minecraft.client.GuiMessageTag -> net.minecraft.client.multiplayer.chat.GuiMessageTag
  • GuiMessageSource addition, which is an enum that says whether the message is:
    1. sent by a player,
    2. by the server for everyone, or
    3. by the server for the player only.
• [26.2] Entity Refactor
  • EntityType -> EntityTypes
  • Entity#getId() throws an exception instead of returning 0 if an ID is not present
• [26.2] GUI Refactor
  • mc.setScreen(...) -> mc.gui.setScreen(...)
  • mc.gui.getChat() -> mc.gui.hud.getChat()
  • OpenToLanScreen -> MultiplayerOptionsScreen

¹ These names may not be accurate,   and some refactorings may be missing.

💴 Yet, no version support was dropped.