ParCool+ / Compatibility Addon (NeoForge 1.21.1 fork)

Addon for ParCool that smooths animation and gameplay interactions with a small set of third-party mods on Minecraft 1.21.1 and NeoForge.

This tree is a fork of the original compatibility addon, ported to NeoForge and trimmed to the integrations that matter for 1.21.1. Upstream mod and idea: ParCool / alRex_U.

---

Requirements

Mod	Role
ParCool	Required. Tested around 3.4.3.1 for MC 1.21.1 (NeoForge build).
NeoForge	Required. Pinned in gradle.properties (e.g. 21.1.222).

Optional compat layers load only if the corresponding mod is present:

Optional mod	What this addon does
Better Combat	Reduces animation clashes with ParCool’s parkour moves.
Carry On	Stops ParCool actions while you are carrying blocks or entities.
Player Animator	Lets Player Animator win where it conflicts with some ParCool animations.
ETF + EMF	Entity Texture Features + Entity Model Features: while you are in parkour moves that drive the player model (hang, cliff cling, climb, vault, crawl, etc.), the addon registers EMF’s vanilla model condition so ParCool arm/body poses show instead of being overridden by CEM player models from resource packs. Uses EMF’s public API (registerVanillaModelCondition). Tested against EMF 3.0.17 / ETF 7.0.13 on MC 1.21.x NeoForge (gradle.properties: emf_modrinth_version, etf_modrinth_version). Fast Run / Fast Swim are intentionally excluded here so the existing Player Animator integration can still win.

Paraglider and similar cases are handled inside ParCool itself; this addon does not add a separate Paraglider module.

---

Building from source

1. JDK 21 (matches the Gradle toolchain).

2. Compile dependencies (ParCool, Better Combat, Carry On, Player Animator, Cloth Config, plus optional EMF/ETF for IDE support):

   • Easiest: leave libs/ empty (or omit jars you do not care to pin). Gradle pulls matching versions from Modrinth Maven using the *_modrinth_version entries in gradle.properties.

   • Pinned jars: copy release JARs into libs/ using the exact filenames from gradle.properties (e.g. parcool_jar, bettercombat_jar, …). A file present in libs/ wins over Modrinth for that mod.

   • Build deps from source: upstream branches for this stack:

     Mod	Source repository
     ParCool (NeoForge)	alRex-U/ParCool 1.21.1-NF
     Better Combat	ZsoltMolnarrr/BetterCombat 1.21.1 (NeoForge subproject; Gradle setup in the Better Combat readme)
     Carry On	Tschipp/CarryOn 1.21.1
     Player Animator	KosmX/minecraftPlayerAnimator 1.21 (KosmX Maven is also documented there)

     Build each mod’s NeoForge (or Forge API) JAR, then drop it into libs/ with the name expected in gradle.properties.

3. Build:

   ./gradlew.bat build

   On Linux/macOS:

   ./gradlew build

   The mod jar is produced under build/libs/.

4. Dev client:

   ./gradlew.bat runClient

   Runtime mods are taken from the same libs/ vs Modrinth resolution as compile. neoforge.mods.toml gets its version from Gradle (mod_version in gradle.properties).

---

Project layout (high level)

• src/main/java — addon entrypoint, compat managers (Better Combat, Carry On, Player Animator), and client-only EntityModelFeaturesCompat (EMF API via reflection).
• src/main/resources/META-INF/neoforge.mods.toml — mod metadata and optional dependencies.
• build.gradle — ModDevGradle, libs/ with Modrinth fallback, resource filtering for the TOML.

---

Versioning

• Game / loader: see minecraft_version, neo_version in gradle.properties.
• Addon semver: mod_version in gradle.properties (also written into neoforge.mods.toml at build time).

---

License

GNU Lesser General Public License v3 — see LICENSE and the license line in neoforge.mods.toml.