Spear Core

Spear Core

A lightweight library mod that provides a complete spear weapon system for Minecraft 1.21.1 NeoForge.

Features:
Full spear weapon mechanics: charge, thrust, and momentum-based damage
Three-stage charge system: dismount → knockback → damage
Both left-click jab and right-click charge attacks
First-person and third-person animations with smooth transitions
Velocity-based collision detection with configurable range
Built-in Lunge enchantment (dash forward on attack)
Configurable material presets for custom spears
API for other mods to create custom spear items easily

For Mod Developers:
Extend SpearItem or use SpearProperties to create your own spears with custom stats, materials, and behaviors. No complex setup required.

By default, Spear Core adds no items to the game. To enable the built-in spears:

1. Run the game once to generate the config file
2. Open config/spearcore-common.toml
3. Set enableVanillaSpears = true to enable Wooden, Stone, Iron, Gold, Diamond, and Netherite spears
4. Set enableCopperSpear = true to enable Copper spear