SSCA - v7.0.0 update

Note: This version is an emergency update. Due to modifications to the transformation system in the original SSC version, this version of the mod can only support up to version 1.9.2. Therefore, except for critical bugs, versions after this will no longer support 1.9.2 or earlier versions.

🎭 New Forms

Desmodus (Vampire Bat)

A blood-craving vampire bat variant transmuted by the power of the Moon Essence Cross.

• Mist Form: Dissolve into mist, immune to all damage except the void for ~4.5 seconds; press the skill key again after 1 second to burst, dealing damage and knockback to nearby enemies
• Sonic Burst: Release an ultrasonic wave forward, dealing physical damage and inflicting Nausea; player targets are also Deafened (cannot hear any sound), non-player targets gain Blindness
• Blood Thirst: Combat accumulates Blood Thirst — low thirst grants damage reduction, high thirst grants lifesteal, and max thirst further boosts damage and lifesteal
• Moonlit Frenzy / Sunlight Frailty: Gain attack and speed bonuses under open sky at night; suffer penalties during the day
• Echolocation: Automatically activates at night, periodically highlighting nearby creatures
• Bloodbane Iron: Takes extra damage from iron weapons

Parasitic Fruit Bat

A supportive bat variant born from the Evolution Stone.

• Parasitic Spiritfruit: Launch spiritfruit seeds at creatures — allied hosts receive healing and buff fruits, hostile hosts receive debuff fruits (Slowness, Weakness, Poison, etc.)
• Infection Spore Bomb: Throw an exploding seed that infects enemies (true damage over time, healing reduction, damage reduction) and leaves a poison fog cloud
• Seed Charge System: Exclusive energy mechanism, replenishable by eating vanilla seeds or natural regeneration
• Spirit Fruit Bloom: Passive that accelerates nearby crop growth

Familiar Fox (Red)

A story-driven variant of the SP Familiar Fox with a proper evolution path.

• Blue Fire Ring: A stronger fire ring than the SP Familiar's
• Fox Fire Breath: Reworked secondary skill, distinct from the SP Familiar
• Potion Bag System: Red's exclusive potion storage and quick-use mechanism
• Dynamic Lighting: Fox fire supports dynamic lighting (requires LambDynamicLights)
• Special feral transformation animation and story easter eggs

Mancianima

A forbidden Pillager weapon forged from a familiar vessel, with a proper evolution path.

• Mancianima Brand: Continuously aim at a creature to calibrate, leaving yellow → red brands; killing within the brand window resets the pursuit system
• Soul Leap: Consume mana for short-range teleportation, supporting "Raycast" and "Platform Lock" modes
• Bell Assault: Ring a bell in a village to trigger a Mancianima assault; clear all villagers for loot rewards (1 MC-day cooldown)
• Villager Plunder: Cannot trade with villagers, but killing them plunders items based on their trades, with a chance for extra emeralds
• Binding Anklet: Exclusive accessory that boosts damage of nearby Pillager-faction mobs

---

🎒 New Items

Item	Description
Potion Bag	Red's exclusive potion storage bag, max 8 per slot; supports sneak+right-click to open, right-click to quick-use, drag-and-drop, and double-click merging
Infinite Compressed Energy Potion (Normal/Splash/Lingering)	Empty bottle auto-recharges over time after use, ready to use again when full
Blood Garnet	Vampire Bat exclusive accessory; accelerates Blood Thirst accumulation
Bloodlust Ring	Vampire Bat exclusive accessory; boosts lifesteal at high Blood Thirst
Humus Ring	Parasitic Fruit Bat exclusive accessory; enhances hostile debuff fruit duration
Twin Pod	Parasitic Fruit Bat exclusive accessory; parasitizes a second nearby target per cast
Binding Anklet	Mancianima exclusive accessory; boosts nearby Pillager-faction mob damage

---

✨ Key Feature Updates

• Custom Keybind System: All forms now support customizable keybinds; players can modify primary/secondary skill keys in ModMenu, with options to sync with SSC or set independently
• Advanced Color Editor: Independent from the main mod's color editor, supporting RGBA/HSV color picking, grayscale inversion, 20-slot preset management, color code import/export, and cross-save synchronization
• Advancement System: Added first-time transformation advancements for all forms
• Accessory Acquisition Rework: Some accessories changed from craftable to found in abandoned mineshaft loot
• REI/JEI Search Support: Mod content can now be found via @ssc or @shape search
• SP Axolotl Enhancements: Vortex Impact reworked into a charge-type skill (hold to charge, max 4 seconds, auto-release at full charge, can release early); Play Dead reworked (can end early by pressing skill key, cooldown adjusted); water spear damage adjusted
• SP Anubis Enhancements: Added wither attack capability
• Jukebox Optimization: Fixed music not following bug, compressed audio files to reduce file size
• Fox Fire Visual Enhancements: Larger fireball, more particle effects, dynamic lighting support

---

🐛 Bug Fixes

• Fixed a critical save-corruption issue where Familiar Fox and other forms' evolution failed on SSC 1.9.1
• Fixed 12+ multiplayer bugs, greatly improving host/client consistency and stability
• Fixed color configuration from one save bleeding into a newly created save (turning white)
• Fixed SP Axolotl being able to move, jump, use items, and attack while playing dead
• Fixed SP Axolotl play-dead being unable to end early
• Fixed SP Snow Fox being unable to use Snow Spike Dash while stationary on the ground
• Fixed mismatch between frost amulet's ice-freeze visual range and actual range for SP Familiar
• Fixed SP Allay and Red's inventory skill consuming items
• Fixed SP Wild Cat's abnormal max health and cat tail bug
• Fixed SP Fallen Allay being attacked by raid mobs
• Fixed Moon Essence Cross being usable during daytime
• Fixed multiple color editor bugs
• Fixed jukebox music not following the player

---

⚙️ Requirements

• Minecraft 1.20.1
• Shape Shifter Curse ≥ 1.9.0 (1.9.2 recommended)
• Trinkets ≥ 3.7.2
• Fabric Loader ≥ 0.14.21

Shape Shifter's Curse — Addon · Changelog (since 2026-06-14)

🎁 Accessory Acquisition

Several form-exclusive accessories can now be found in world chests — crafting recipes are kept, so you can still craft them or find them:

1. Abandoned Mineshaft chests (20% each): Blood Garnet, Bloodlust Ring (Vampire Bat); Humus Ring, Twin Pod (Parasitic Fruit Bat)
2. Desert Pyramid chests (15% each): Crystal of the Anubis Scepter (SP Anubis Wolf); Erosion Sand Prism, Withered Sand Ring (SP Golden Sandstorm)

3. 🧪 Familiar Forms — Potion Handling

1. Potions can now be stacked, and a double-click merges them into one stack.
2. Drag a potion onto the Potion Bag to stash it instantly.
3. Reworked the Familiar forms' potion-retrieval flow, with an improved Potion Bag model, texture, and display.

⌨️ Custom Keybinds

You can now rebind each form's skill keys from ModMenu.

⚔️ Balance & Visuals

1. Red Familiar's Blue Fire Ring buffed — more damage, lower mana cost, now stronger than the SP Familiar's.
2. Foxfire fireball — richer particle trail and a bigger size; it now glows while flying (requires the LambDynamicLights mod).

🐛 Bug Fixes

1. Fixed the Red/SP Familiar amulet's water-freezing area not matching its actual range.
2. Fixed the Allay form's jukebox music not following the player; also compressed the audio to reduce the mod's file size.

SSCA v7.0.0-beta.3 Update Notes

1. Potion bag functionality improved: right-click while holding the bag now quickly uses the potion in the first slot; sneak + right-click opens the potion bag GUI.
2. Bat Desmodus and Parasitic Fruit Bat accessories changed from craftable to loot-only: 20% chance to drop in Abandoned Mineshaft chests.

SSCA v7.0.0-beta.2 Update Notes

1.Added a hidden advancement "Power of the Moon Scar": unlocked after collecting all books related to the Lord of the Spirit Realm (Moon Scar: Lord of the Spirit Realm Chapters 1–8 + Epilogue, 9 books total, plus the Familiar Research Record FF-E-013). Books carry a language-independent hidden identifier, so the advancement works correctly in both Chinese and English.

2.Added the "Power of the Moon Scar" story chain: once the advancement is unlocked while in SP Familiar Fox form, you receive a one-time whisper hint; sleeping during a Cursed Moon night will then let the SP Familiar Fox truly fall asleep (using the feral sleeping animation) and transform into the RED form upon waking. While in the story RED state, you can use the Moon Essence Cross at any time to freely revert to SP Familiar Fox (without consuming the item). Fully server-authoritative and consistent across reconnect/respawn/multiplayer.

3.Finalized the evolution path of Mancianima (the Evolution Stone variant of the Familiar Fox).

4.Fixed the transformation animation for the addon's feral forms: the 7 feral forms — SP Familiar Fox, RED, SP Snow Fox, SP Anubis, Golden Sandstorm, SP Wild Cat, and Mancianima — now correctly play the "upright→feral" transformation animation instead of the previously incorrect upright animation.

5.Added a first-time tutorial for the color editor: the first time you open the Advanced Color Screen, a step-by-step highlighted guide introduces each functional area and preset management. Once viewed or skipped, it won't pop up again (remembered per save).

6.Optimized the health passive mechanics of the two bat forms (Desmodus Bat, Parasitic Fruit Bat) and added a matching accessory.

7.Further optimized the behavior and multiplayer synchronization of Fruit Bat related abilities (Infection Spore, Parasitic Absorption, Parasitic Seed Field, Parasitic Fruit).

8.Improved the Fox Fire Breath ability sound effect (SP Familiar Fox and RED forms), switching to a more expressive fox screech.

9.Reworked the damage detection of the SP Axolotl "Enhanced Water Burst" ability (now uses a spherical area-of-effect), fixing host/client inconsistency in multiplayer.

10.Improved the combat-state detection sync for Golden Sandstorm and merged it with the existing combat system.

11.SP Familiar Fox is now immune to the relevant effects applied by bat forms (Regeneration, Poison, Absorption), preventing cross-form misfires.

12.Fixed SP Familiar Fox displaying the ordinary Familiar Fox texture; Mancianima texture adjusted accordingly.

13.Fixed several host/client synchronization issues, improving multiplayer stability.

14.Unified the English name of the Moon Essence Cross across all descriptions and story texts.

15.Improved the functionality of the potion bag.

16.Added three potions (to be improved).

17.Fixed a bug that could cause game saves to become corrupted.

Attention: If you have downloaded the previous beta.2 version, please uninstall it immediately! That version may cause a risk of corrupted game saves.

SSCA v6.1.1 Update Notes

1. Fixed the "Enable SSCA Color Editor" toggle being effectively ignored when set to OFF: the "Advanced Color" button was still being injected into the upper-right of SSC's vanilla config screen regardless of the toggle, so clicking "Adjust Appearance Color" always opened the SSCA color editor. The toggle is now properly respected; when OFF the button is no longer injected and any previously-injected leftover button is actively removed.
2. Fixed the FormColorSelectMenu is already in use, only one instance is allowed error that occurred when reopening the color screen after SSCA had intercepted the vanilla FormColorSelectMenu: the singleton lock and temporary-texture state held by the vanilla screen are now cleaned up at the moment of interception, preventing the state leak caused by close() never being called.
3. Removed the addon's hard datapack overrides of the vanilla advancements minecraft:nether/netherite_armor and minecraft:story/shiny_gear: SSC 1.9.2 now patches the item predicates of these advancements at runtime, making the addon's overrides redundant. This improves compatibility with other mods and datapacks that also modify these vanilla advancements.

SSCA v6.1.0 Update Notes

1. New SP Form: Mancianima (branched from Familiar Fox)

1. Three-stage Mark primary skill

   • Yellow Mark: 15 mana, 32-block range mob marking, 5s first-press CD
   • Red Mark upgrade: applies Fear + Wither sound, 1s trigger interval
   • 2s channel for true damage: 20% of target's remaining HP as true damage, capped at 20, +15s CD
   • Fizzles for 5 mana when no target is on crosshair

2. Teleport secondary skill

   • Costs 15 mana, CD 5s
   • Two modes selectable via client config:
     • Raycast: straight line teleport toward crosshair, max 8 blocks, stops at blocks
     • Platform: hold to preview landing spot with purple particles visible only to self, release to teleport; refused with no CD/mana cost if no platform ahead

3. Villager Drain

   • Launches an AoE raid on villagers / wandering traders
   • Targets enter a Prepare → Flee → Resolve flow lasting one full MC day
   • Grants mana / XP rewards on resolution

4. Dedicated Mancianima mana system

   • Independent max mana and regen curve
   • Regen pauses for 5s on being hit or casting
   • HUD resistance bar: synced yellow/red mark layers + channel progress

5. Mancianima passives

   • Extended bare-hand attack range
   • Weapon attack speed / range adaptation
   • Immune to negative effects, custom invincibility frames, on-hit i-frames
   • Automatic aggro tracker that makes villagers / traders flee within range
   • Ranged projectile tracking mixin

6. HUD visual system

   • Marked targets auto-glow with state color (Yellow / Orange / Red), visible only to the Mancianima player
   • Crosshair tracking aim assist

7. Full localization & assets

   • Complete form textures, 3D model, form-selection scroll lang keys

---

2. New Advanced Color Editor (dedicated GUI screen, disabled by default)

• 5 color channels independently adjustable: Primary / Accent 1 / Accent 2 / Eye A / Eye B
• 3 grey-reverse toggles independently adjustable
• Dual RGB / HSV sliders + hex input
• Real-time preview on the player
• Disabled by default — must be manually enabled via ModMenu → SSCA settings; once enabled, it replaces the original basic color editor entry

---

3. New Palette Preset Save & Export system (also disabled by default, enabled together with the Advanced Color Editor)

1. Palette Preset Manager screen

   • 20 preset slots, each independently named / savable / overridable / clearable / applyable

2. Dual preset storage modes

   • Per Instance (default): all presets stored in palette_presets_global.json, shared across saves / servers under the same instance
   • Per Save: presets are split per current server address or single-player world name, isolated

3. Palette Share Code (PaletteCodec)

   • Encodes a complete palette into a 56-character SSCA-... string
   • For pasting to others or reuse across saves

4. /ssc_addon palette command tree (no OP required, self-only)

   • /ssc_addon palette export — generates a click-to-copy share code for the current form
   • /ssc_addon palette apply <code> — applies a share code in one click

5. Quick buttons

   • Below the preview box: one-click Open config/ssca/ folder
   • Top right: Export Current Color / Export All

6. Unsaved Changes confirmation dialog

   • Exiting the color editor with unsaved changes prompts a 3-way choice: Save & Exit / Discard & Exit / Back to Editing

---

4. Client-side sync chain improvements

• Continuously re-pushes the working state every tick, bypassing the SSC main-mod's tick-time color rollback and eliminating the "color snaps back to old value" flicker
• Applying a preset now also syncs to SSC's PlayerCustomConfig, keeping ModMenu's displayed values consistent with the actual rendered palette

Fixed a bug that could cause skill key bindings to fail. Now the skill key bindings for SSCA are directly read from the SSC key bindings.

SSCA v6.0.0 Update Notes

1. Added new SP form SP Anubis (Netherjudge)
2. Added evolution-stone variant form Golden Sandstorm
3. Added SP Anubis and Golden Sandstorm exclusive trinkets
4. Added new hostile mob Witch Familiar
5. Familiar Fox / SP Familiar Fox can now freeze water surfaces; Red Familiar Fox hitbox enlarged
6. SP Axolotl crawling hitbox aligned with upstream Apoli CrawlingPower
7. Migrated large amounts of Java tick logic into Apoli JSON powers; supports addon hot-reload
8. Reinforced whitelist system (bidirectional actor/target checks; active skills respect whitelist)
9. ModMenu config split into independent client / server sections
10. Golden Sandstorm health regen reworked: no longer regens from hunger, only natural recovery
11. Added new lore book The Lost Caravan Bell related books
12. Multiplayer / server stability fixes; client–server behavior consistency improvements
13. HUD, cooldown bar, and resource loading optimizations
14. Required dependency bumped to shape-shifter-curse >= 1.9.0