# HybridFix (\u6df7\u5408\u4fee\u590d)<\/p>\n
Provide a bunch of bugfixes, optimizations and utilities for Forge+Bukkit server and client environments.<\/p>\n
## Fixed issues<\/p>\n
### Forge-Bukkit<\/p>\n
– Bukkit plugins cannot handle some mod explosions(e.g., Tinkers’ Construct EFLN)
\n– Bridge some Forge events to Bukkit<\/p>\n
### Forge<\/p>\n
– (Universal) Fix Forge JarDiscoverer attempting to read `module-info.class` and other multi-release classes.
\n– (Server) Fix `Outdated server` showing in ping before server fully boots.<\/p>\n
### Mods<\/p>\n
#### Common<\/p>\n
– Replace brittle asm transformer patches of Quark with mixins
\n– Fix Swet AI control of Aether Legacy<\/p>\n
#### Client<\/p>\n
– Replace expensive reflection usages in Industrial Craft 2 with direct calls<\/p>\n
#### Server<\/p>\n
– Simple Difficulty, ToughAsNails(And any other similar mods) thirst is not getting reset on player respawn(Luohuayu\/CatServer#536)(MohistMC\/Mohist#2905)
\n– Ring dupe bug in The Betweenlands mod(Luohuayu\/CatServer#204)
\n– Simulate vanilla player respawn, most dupe bugs on player death should be fixed
\n– Fix Twilight Forest saplings can bypass the anti-grief plugin protection bug
\n– Fix Twilight Forest entities(e.g. Naga) can break blocks in protected areas
\n– Fix Twilight Forest Chain with Block can break blocks in protected areas
\n– Fix Thaumcraft 6 taint can spread into protected areas
\n– Fix Thaumcraft 6 flux rift can break blocks in protected areas
\n– Fix trait effects in Tinkers’ Construct can bypass damage protection
\n– Fix So Many Enchantments can disarm players in protected areas
\n– Fix Botania Ring of Loki can bypass grief protection
\n– Fix Botania MineLens can bypass grief protection
\n– Fix Botania Rannuncarpus can bypass grief protection
\n– Fix Industrial Craft 2 miners can break blocks in protected areas
\n– Fix Industrial Craft 2 explosives can break blocks in protected areas
\n– Fix Draconic Evolution ChaosCrystal can break blocks in protected areas
\n– Fix TechReborn(RebornCore) explosions can break blocks in protected areas
\n– Offer events to Applied Energistics 2 Spatial Pylon to prevent some unpermitted griefing
\n– Fix TechGuns explosion can break blocks in protected areas
\n– Add entity blacklist\/whitelist to Applied Energistics 2 Spatial Pylon
\n– Fix webs of InfernalMobs can spawn in protected areas
\n– Fix EpicSiegeMod mob AIs can grief in protected areas
\n– Disable recipe of Blackhole Controller (Deprecated) in Industrial Foregoing
\n– Fix Witchery spells can bypass damage protection
\n– Auto modify Actually Additions’ config to make it fit the server environment
\n– Prevent Mekanism Digital Miner from mining tile entities<\/p>\n
## Features<\/p>\n
– Auto overrides Mohist’s crappy built-in explosion handling with our own method.
\n– Bridge Forge permission processing to Bukkit.
\n– Skip firing event if no listeners registered.
\n– Disable Timings for lower performance overhead.
\n– Compatibility first, shouldn’t break any mods\/plugins.
\n– Built Bukkit plugin into the mod, offers utilities to server owners.
\n– Enhance compatibility with mod FakePlayers.
\n– Offer more or less useful apis for plugin developers to interact with Forge mods easily.
\n– Extensive APIs for mod developers to maintain compatibility with hybrid servers easily.
\n– General CraftBukkit performance improvements.
\n– Auto deobfuscate plugin stacktraces when Censored ASM is installed for easier debugging.
\n– **Cross ClassLoader access, make Forge mods can easily interact with Bukkit plugins. (Details)**
\n– Bukkit APIs backported from modern version.
\n– **Builtin plugin ASM patcher, compatible with your favourite plugins.**
\n– **Bukkit plugin mixin support, allows you to inject code into plugins via mods.** *(Experimental)* (Docs)
\n– Extend Forge’s error recovery system (`removeErroringEntities` and `removeErroringTileEntities`), notify server operators when errors occurred.
\n– Guard player ticking process, kick player instead of directly crash.
\n– Fix Forge bugs that affect server play experience.
\n– (Universal) Optimize entity AI for faster nearest target lookup.<\/p>\n
Configuration file is under `${minecraftDir}\/config\/hybridfix.cfg`<\/p>\n
## How To (Server Admins)<\/p>\n
Download HybridFix and its dependencies(MixinBooter and ConfigAnyTime) from CurseForge, drop HybridFix into `${minecraftDir}\/mods` folder.<\/p>\n
HybridFix can be also installed on the client, some client-side fixes and optimizations will apply.<\/p>\n
## How To (Developers)<\/p>\n
If you are developing mods, you can import HybridFix from curse maven:<\/p>\n
Gradle(Groovy DSL):<\/p>\n
“`groovy
\nimplementation fg.deobf(“curse.maven:hybridfix-1166614:{latest_artifact_id}”)
\n“`<\/p>\n
If you are developing plugins, you can import HybridFix jar directly:<\/p>\n
Maven:<\/p>\n
“`xml Gradle(Groovy DSL):<\/p>\n “`groovy APIs are located at `io.wdsj.hybridfix.api` and `io.wdsj.hybridfix.duck.api` package.<\/p>\n ## Plugin Hooks Currently patched plugins: ## Plugin ASM patcher Currently supported plugins: ## About FakePlayers<\/p>\n HybridFix utilizes Forge FakePlayer to fix some grief bugs, the naming logic is `[modid-ClassName]`.<\/p>\n For example, the botania rannuncarpus patch is using the fake player with name `[botania-SubTileRannuncarpus]`.<\/p>\n You can add these names into whitelist\/blacklist of your plugins to customize behavior.<\/p>\n ## Commands<\/p>\n – `\/hybridfix dumpitem` – Show details of the item holding in the hand. ## Permissions<\/p>\n – `hybridfix.command.use` – Allow to access `\/hybridfix` command. **Note**: Commands and permissions are registered on Bukkit side, that means you can manage permissions with Bukkit permission plugins like LuckPerms.<\/p>\n ## License<\/p>\n This mod is licensed under LGPL-2.1.<\/p>\n Backported Bukkit classes are licensed under GPL-3.0.<\/p>\n Unless explicitly specified in the code, other parts are under LGPL-2.1.<\/p>\n The stripped MCP remapped CraftBukkit JAR in the repository is for development use only and not included in releases.<\/p>\n","protected":false},"excerpt":{"rendered":" Provide bugfixes, optimizations and a set of utilities for Forge+Bukkit server environment.<\/p>\n","protected":false},"featured_media":82889,"template":"","meta":{"_minecraft_slug":"hybridfix","_minecraft_project_id":"4VGtQhPO","_minecraft_author":"Undefined_0721","_minecraft_license":"LGPL-2.1-only","_minecraft_downloads":2310,"_minecraft_follows":3,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hybridfix.zip","_minecraft_size_bytes":5405963,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-15T21:27:20.129261Z","_minecraft_date_created":"2025-01-03T05:05:32.250940Z","_minecraft_date_modified":"2026-02-20T06:24:53.543745Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hybridfix","_minecraft_icon_attachment_id":82889,"_minecraft_imported_at":"2026-06-04T18:04:01+00:00","_minecraft_import_hash":"8716f98f9d6f845b1e68a9481ce57227","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,126,90,92],"mod_loader":[106],"minecraft_version":[385],"class_list":["post-82888","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-management","mod_category-optimization","mod_category-utility","mod_loader-forge","minecraft_version-1-12-2"],"yoast_head":"\n
\n
\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\ncompileOnly files(“PATH-TO-JAR”)
\n“`<\/p>\n
\nThanks to HybridFix internal plugin, we can hook into plugins from Forge side to provide more fixes.<\/p>\n
\n– Residence(SpigotMC)(GitHub)
\n– WorldGuard(BukkitDev)(GitHub)
\n– Citizens(GitHub)<\/p>\n
\nHybridFix uses ASM to inject into plugin classes dynamically at runtime
\nto resolve plugin compatibility problems with Forge+Bukkit environment.<\/p>\n
\n– Residence: Fixes compatibility with Residence 6.0.0.0+.
\n– Universal: Redirects InventoryView INVOKEINTERFACE call to INVOKEVIRTUAL.<\/p>\n
\n– `\/hybridfix dumpentity` – Show details of the entity targeted.
\n– `\/hybridfix dumpblock` – Show details of the block targeted.
\n– `\/hybridfix version` – Show version info.
\n– `\/hybridfix eraseentity` – Forcibly remove targeted entity.
\n– `\/mods` – Like `\/plugins`, show all loaded mods.<\/p>\n
\n– `hybridfix.command.eraseentity.use` – Allow to access `\/hybridfix eraseentity` command.
\n– `hybridfix.command.mods.use` – Allow to access `\/mods` command.<\/p>\n