Shape Shifter Curse Forge

A Forge port of Shape Shifter Curse for Minecraft 1.20.1.

This project aims to reproduce the gameplay and features of the Fabric version on Forge, while also including several Forge-specific improvements and experiments.

This is an unofficial Forge port.
The original Shape Shifter Curse project is developed for Fabric.

Features

• Multiple transformable creature forms and transformation stages
• Form-specific abilities and passive effects
• Full player animation system
• Codex / Shape Shifter Book UI
• Form appearance and color customization
• Cursed Moon system
• Curios-based accessory system
• Active abilities and custom keybindings
• Mana and instinct systems
• Custom advancement triggers
• Datapack-driven form and power definitions
• Multiplayer synchronization

Forge-specific Features

This port does not simply copy every Fabric implementation directly.

Some systems are implemented differently to better fit Forge, including:

• A GeckoLib-based player animation system
• Additional form behaviors
• Form affinity behavior for matching vanilla mobs
• Some experimental Forge-only interactions

For example, vanilla mobs matching the player's current form may show special affinity behavior toward the player.

Animation System

The Forge version uses its own GeckoLib-based animation implementation instead of directly depending on Player Animator.

It supports:

• Walking and running
• Sneaking and crawling
• Swimming
• Elytra flight
• First-person arms
• Armor animation synchronization
• Additional form bones such as tails and other non-humanoid parts

The animation system also contains several fixes specifically made for the Forge port.

Accessories

The Fabric version uses Trinkets.

The Forge port uses:

Curios API

Accessories can modify or replace form powers dynamically depending on the player's current form.

Cursed Moon

The Cursed Moon system has been ported to Forge, including:

• Configurable cursed moon phases
• Automatic form progression
• Sleep restrictions
• Form restoration after the cursed moon
• Multiplayer synchronization
• Related advancements

Custom Forms

The port supports datapack-driven form and power definitions.

External form resources can provide their own:

• Models
• Textures
• Animation metadata
• Powers
• Form data

Compatibility with custom form packs is still being tested and improved.

Keybindings

The mod currently provides several configurable controls:

• Primary Active Ability
• Secondary Active Ability
• Toggle Sneak Edge Behavior
• Form Sound

Some abilities may also use vanilla controls such as Jump or Sprint depending on the current form.

Requirements

• Minecraft 1.20.1
• Forge
• GeckoLib
• Curios API

Please make sure all required dependencies are installed before reporting startup issues.

Compatibility

This project is designed specifically for Forge 1.20.1.

The implementation does not depend on Apoli, Origins, Trinkets, or Player Animator.
Equivalent systems required by Shape Shifter Curse are implemented or adapted directly for Forge.

Status

Most major gameplay systems have already been ported.

Current development is mainly focused on:

• Fabric / Forge behavior parity
• Ability trigger correctness
• Multiplayer testing
• Edge-case fixes
• Custom form compatibility

Reporting Bugs

If you find a bug, please include:

• Minecraft version
• Forge version
• Mod version
• Installed dependency versions
• Steps to reproduce
• latest.log or crash report if applicable

Please also mention whether the issue occurs in singleplayer or multiplayer.

Credits

Original project:

Shape Shifter Curse

Original authors and contributors retain credit for the original mod, assets, gameplay concepts, and Fabric implementation.

This repository contains the Forge port and Forge-specific implementation work.

Source Code

Source code is available on GitHub:

https://github.com/gengyoubo/shape-shifter-curse-forge

Disclaimer

This project is an unofficial Forge port and is not the official dual-loader version of Shape Shifter Curse.

If an official Forge / multi-loader version is released in the future, this project may transition toward compatibility, migration, and Forge-specific extension support.