Backported Spears

Note: Porting this mod to older versions will take a while! This is because of how the original spear code is written. It needs to be completely rewritten for versions before 1.21 for it to even work!


1.20.1 is still in beta and Fabric only. Forge port will be made once it is polished!


Special Thanks to:


-GoblinGamerMC for making compatibility patches for popular content mods.


-MrPalo for making the Chinese localization.


This mod attempts to accurately backport the spears added in the 1.21.11 Mounts of Mayhem update. From the spears themselves, to technical changes that came with them.


To start: here are the spears in action:


First Person Stab





Third Person Stab (Back)





Third Person Stab (Front)





Piercing Effect and Minimum Attack Reach demonstration





Charge Attack





I am aware that some of the animations shown here are not 1:1 with the official ones as they are the original WIP versions (from before v1.4.0) of these animations. I can't just show the final product because people might think I just clipped 1.21.11 and edited it.


Compatibility:


-Resource packs for 1.21.11 that change the texture, sound effects or localization of spears will also work here


-Datapacks that use item components added by 1.21.11 will likely work as long as this mod in installed


-Better Combat: overrides the spear animation this mod adds for the spears


First Person Stab and Charge with Better Combat





Third Person Stab and Charge with Better Combat (Front)





-Dragonloot/Ender Dragon Loot: Adds a dragon spear. Note, this has the special property of being able use Lunge while gliding. (1.21.1, for now)





-Copper Age Backport: Backports the copper spear. (1.20.1 and 1.21.1)


-Oreganized: Adds an electrum spear, which has higher charge attack damage than other spears. (1.21.1, for now)


-There are also compatibility patches for the following mods made by GoblinGamerMC:


Mowzie's Mobs


Iron's Spells & Spellbooks


Hazen 'N Stuff


Eternal Starlight


Crystal Chronicles


L Ender's Cataclysm


Bosses of Mass Destruction


NOTE: These patches are currently only in 1.21.1, please do not pressure this person to port it to older versions as it is not possible yet! These patches rely on data components like most modern datapacks, something that did not exist prior to 1.20.4.


Config (note: Currently only in 1.21.1, will add this to 1.20.1 once ported to Forge):


-lunge_hunger_cutoff: prevents lunge from working if the player has less that 3 food bars (true by default)


-spear_charge_attacks: allows spears to perform their right-click charge ability (true by default)


-spear_stabbing_animation: makes spears play different attack animation (true by default, false if Better Combat is installed)


-can_use_lunge_while_gliding: Self explanatory (false by default, ignored by dragon spears)


-can_use_lunge_while_in_water: Again, self explanatory (false by default)


-tridents_use_spear_attack_animation: makes Tridents (including modded ones) also use the spear stabbing animation (false by default)


Miscellaneous:


Advancements:


-Mob Kabob: Hit five mobs with any spear in one charge attack


Enchantments:


-Lunge: Spears propel the user forward


Technical Changes (1.21.1 only as again, item components didn't exist prior to 1.20.4):


-"piercing_weapon", "kinetic_weapon", "use_effects", "swing_animation", "attack_reach" and "minimum_attack_charge" item components have been backported


-"post_piercing_attack" enchantment component have been backported


-"apply_impulse" and "apply_exhaustion" enchantment effects have been backported


-"spear_mobs" advancement criterion have been backported