EnderpearlCrossbow

EnderpearlCrossbow is a lightweight Fabric mod for Minecraft 1.21.1 that enhances the vanilla crossbow by allowing it to load and fire Ender Pearls instead of arrows or fireworks. Instead of manually throwing a pearl with short range and poor accuracy, players can place an Ender Pearl in their off-hand while holding a crossbow, then right-click to load it and fire with significantly improved velocity, accuracy, and range. The mod uses Mixin-based bytecode injection to modify the CrossbowItem class without adding any new items or blocks, and it registers a custom data component (enderpearlcrossbow:is_pearl_loaded) to track whether a pearl is loaded. One mixin modifies the loading logic to accept pearls from the off-hand slot, while another intercepts the shootAll method to spawn an EnderPearlEntity with the crossbow’s speed and divergence, play the throw sound, apply durability damage, clear the loaded projectile, and cancel vanilla shooting behavior. Visually, the mod provides a custom item model override via asset replacement, using a has_component condition to switch the crossbow texture to a custom version with a visible embedded pearl when loaded, along with custom pull animation textures for a seamless experience. In essence, this mod offers a practical, tactical, and reliable way to use Ender Pearls for teleportation by combining the crossbow’s mechanical precision with the pearl’s utility, all while keeping the game balanced and adding no new items.