Spear Core: Build Custom Spears in Minecraft Without Java

Spear Core lets you create real, fully animated spears in Minecraft with a few KubeJS lines, no Java required. Grab it for Minecraft today!

Download spearcore for Minecraft 1.21.1, 1.20.1

Original name: spearcore

Minecraft: 1.20.1, 1.21.1

Loaders: Forge, NeoForge

FileVersionLoaderSize
spearcore-1.20.1-forge-3.0.2.jar1.20.1Forge326 КБDownload
spearcore-1.20.1-forge-3.2.1.jar1.20.1Forge361 КБDownload
spearcore-1.20.1-forge-3.2.0hotfix.jar1.20.1Forge330 КБDownload
spearcore-1.20.1-forge-3.2.0.jar1.20.1Forge1.0 МБDownload
spearcore-1.20.1-forge-3.1.0.jar1.20.1Forge329 КБDownload
spearcore-1.20.1-forge-3.0.3.jar1.20.1Forge327 КБDownload
spearcore-1.20.1-forge-3.0.1.jar1.20.1Forge324 КБDownload
spearcore-1.20.1-forge-3.0.0.jar1.20.1Forge326 КБDownload
spearcore-1.21.1-neo-2.0.8.jar1.21.1NeoForge316 КБDownload
spearcore-1.21.1-neo-3.2.0.jar1.21.1NeoForge339 КБDownload
spearcore-1.21.1-neo-3.1.0.jar1.21.1NeoForge337 КБDownload
spearcore-1.21.1-neo-3.0.0.1.jar1.21.1NeoForge330 КБDownload
spearcore-1.21.1-neo-3.0.0.jar1.21.1NeoForge330 КБDownload
spearcore-1.21.1-neo-1.0.jar1.21.1NeoForge270 КБDownload
spearcore-1.21.1-neo-2.0.7.jar1.21.1NeoForge315 КБDownload
spearcore-1.21.1-neo-2.0.6.jar1.21.1NeoForge311 КБDownload
spearcore-1.21.1-neo-2.0.5.jar1.21.1NeoForge311 КБDownload
spearcore-1.21.1-neo-2.0.4.jar1.21.1NeoForge307 КБDownload
spearcore-1.21.1-neo-2.0.3.jar1.21.1NeoForge303 КБDownload
spearcore-1.21.1-neo-2.0.2.jar1.21.1NeoForge303 КБDownload
spearcore-1.21.1-neo-2.0.1.jar1.21.1NeoForge302 КБDownload
spearcore-1.21.1-neo-2.0.jar1.21.1NeoForge299 КБDownload
spearcore-1.21.1-neo-2.0-rc2.jar1.21.1NeoForge298 КБDownload
spearcore-1.21.1-neo-2.0-rc1.jar1.21.1NeoForge298 КБDownload
spearcore-1.21.1-neo-1.2.jar1.21.1NeoForge284 КБDownload
spearcore-1.21.1-neo-1.1.jar1.21.1NeoForge270 КБDownload

Spear Core

Combat mods in Minecraft have always had a high barrier to entry. If you wanted a weapon with custom behavior, you either learned Java or hoped someone else built exactly what you needed. Spear Core changes that equation entirely. It is a shared library that powers a family of spear mods, and it exposes all of that underlying machinery to modpack authors through KubeJS. The result is a tool that lets you register a genuine, fully functional spear using a handful of script lines.

What Spear Core Actually Does

At its heart, this is a foundational library rather than a standalone content mod. It extracts the hard parts of spear combat into reusable systems: movement-based damage calculation, ray-based hit detection, multi-phase charge windows, and mob AI. Spear mods built by the same author depend on it, which means players rarely need to install it manually. If you run a spear mod that lists it as a dependency, your launcher pulls it in automatically.

For modpack authors and tinkerers, though, the real value lies in the KubeJS integration. You can define a new spear item entirely from a startup script, specifying durability, attack damage, charge multipliers, attack speed, enchantability, the four charge-phase durations, reach, hitbox dimensions, forward push, knockback, dismounting behavior, mob reach scaling, and even sounds. Anything you omit simply falls back to the iron spear's default values.

Scripting a Spear in Five Lines

The workflow is refreshingly simple. You register an item with the type spearcore:spear, give it a display name, texture, and stats, and you are done. Because the item is created through the library's own spear class, it behaves like a real spear from the moment it exists: stabbing, charging, first- and third-person animations, enchantment support, and mob AI all work identically to built-in spears. There is nothing else to configure.

One thoughtful safety detail: if your script fails or contains an error, the library keeps running normally. No crash, no error spam, and none of the broken code loads. That makes experimentation low-risk, which matters when you are iterating on balance numbers.

Supported Versions and Loaders

Spear Core targets two Minecraft versions, each with its own loader requirement:

  • Minecraft 1.20.1 with Forge 47.3.0 or newer
  • Minecraft 1.21.1 with NeoForge 21.1 or newer

KubeJS versioning follows the same split: use 2101.x on 1.21.1 and 2001.x on 1.20.1. Remember that the mod must be installed on both the client and the server, since the animations and hit detection run on both sides.

How to Install

If you are setting up a development environment or a pack that needs the library directly, the process is standard. First, confirm your Minecraft version and loader match one of the supported combinations above. Next, place the matching Spear Core jar into your mods folder alongside the correct KubeJS build. Then launch the game once to verify everything loads without errors. Finally, drop your spear registration script into the KubeJS startup scripts folder and reload. If you prefer a smoother path, the foxygame.net launcher bundles Spear Core in its add-on catalog and handles version matching for you, so a single click installs the right build for your setup.

When you download Spear Core, always grab the file that matches your exact Minecraft version. Mixing a 1.21.1 build into a 1.20.1 instance will fail to load, and the same applies in reverse. The repository includes a bilingual KubeJS guide covering full parameter tables, texture conventions, and common pitfalls, which is worth reading before you start tweaking values.

Beyond Custom Items

The library offers more than item registration. Mod authors can extend the spear base class to inherit stabbing, charging, and the multi-phase windows for windup, dismounting, knockback, and damage. A movement hook lets custom mobs join the same "faster movement means harder hits" rules by implementing a single interface, with tunable speed thresholds, reach, and damage multipliers. There are also helpers for ray-based entity sweeping and post-hit momentum handling, plus a reusable AI goal that lets mobs approach, charge, strike, and retreat. A generic lunge implementation rounds out the toolkit.

Spear Core for Minecraft fills a gap that has frustrated pack developers for years. It removes the need to write Java for a weapon that feels native to the game, and it does so while staying lightweight and safe when scripts misbehave. Whether you are building a bronze-age combat pack or prototyping a mob that fights with polearms, this library gives you the foundation without the boilerplate.