9a31f21b55
First visible bondage animation pipeline orchestrator. Consumes the primitives added in P3-01..P3-04 + P3-09 to rebuild the livingAnimations map of a player based on currently equipped bondage items. Design decisions : - IdentityHashMap dedup (armbinder covers N regions -> 1 unique stack). Defensive even though the capability already dedupes (so we don't depend on an upstream invariant that might regress). - Sort by posePriority ASC so highest-priority iterates last -> wins conflicts (Map.put last-write-wins semantics in livingAnimations). - Option B : JSON items don't bind IDLE, let EF defaults flow through after resetLivingAnimations() which re-pushes default motions. - null-check on animations() : 99% of V2 legacy items lack the JSON block and return null from the parser, must be skipped silently. - @OnlyIn(Dist.CLIENT) at class level : ClientAnimator is client-only, server class-loader must never touch this handler. - Extracted testable methods (extractSortedDefinitions + applyDefinitions) with functional callbacks (Runnable + LivingAnimationAdder + Function resolvers). Generic <T> on extractSortedDefinitions lets tests pass Object dummies without MC ItemStack bootstrap. Tests (15) covering : - rebuildBondageAnimations null-safety - extractSortedDefinitions : empty input, null resolver result, identity dedup (multi-region), ASC priority sort, null entries skipped - applyDefinitions : reset-only on empty, null/empty animations skipped, multi-binding single item, two-item conflict last-write-wins, reset ordering before any adder, end-to-end multi-region dedup, animResolver contract (no internal dereference) Note : this commit provides the HANDLER. The first visible bondage animation still requires P3-06 (hook it to PacketSyncV2Equipment + LivingEquipmentChangeEvent) and P3-08 (updateMotion state machine) to fully light up. Jalon = pipeline viable, not yet wired. 212 tests GREEN (197 baseline + 15 new).
TiedUp! - Minecraft 1.20.1 Forge Mod
Community remake of the TiedUp! mod for Minecraft 1.20.1 (Forge). Adds restraint and roleplay mechanics to the game.
Original mod by Yuti & Marl Velius (1.12.2). This is an independent remake, not affiliated with the original developers.
Features
- Restraint items (binds, gags, blindfolds, collars, straps, and more)
- NPC entities with AI and personality-driven dialogue (Kidnapper, Damsel, Guard, Trader, Maid, Master)
- Kidnapper camp world generation
- Captivity and prison mechanics
- Player animation system with 3D item rendering
- Multiplayer synchronization
- Mod compatibility (Minecraft Comes Alive, Wildfire's Female Gender Mod)
- In-game guide book (Patchouli)
Requirements
- Java 17
- Minecraft 1.20.1
- Forge 47.4.10+
- PlayerAnimator 1.0.2-rc1+
Building
# First time setup
make setup
# Build the mod
make build
# Clean and rebuild
make rebuild
# See all available commands
make help
Or directly with Gradle:
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
./gradlew build
The built JAR will be in build/libs/.
Development
# Run Minecraft client
make run
# Run dedicated server
make server
# Multiplayer testing (server + 2 clients)
make mptest
# Generate IDE configurations
make idea # IntelliJ IDEA
make eclipse # Eclipse
Project Structure
src/main/java/com/tiedup/remake/
├── blocks/ # Custom blocks and block entities
├── cells/ # Captive cell management
├── client/ # Rendering, GUI, animations
├── commands/ # /tiedup command
├── compat/ # Mod compatibility (MCA, Wildfire)
├── core/ # Main mod class, config, sounds
├── dialogue/ # NPC conversation system
├── entities/ # Custom NPCs and AI
├── events/ # Event handlers
├── items/ # All mod items
├── mixin/ # Minecraft bytecode modifications
├── network/ # Multiplayer packet system
├── personality/ # NPC personality system
├── state/ # Player state tracking
├── v2/ # Next-gen items and blocks
└── worldgen/ # Structure generation
Dependencies
Some dependencies are included as local JARs in libs/ because they are not available on Maven Central:
| Library | Version | Usage |
|---|---|---|
| PlayerAnimator | 1.0.2-rc1+1.20 | Player pose animations |
| bendy-lib | 4.0.0 | Model part bending |
| Architectury | 9.2.14 | Required by MCA |
| Minecraft Comes Alive | 7.6.13 | Optional compatibility |
| Wildfire Gender Mod | 3.1 | Optional compatibility |
License
GPL-3.0 with Commons Clause - see LICENSE for details.
TL;DR: Free to use, modify, and distribute. Cannot be sold or put behind a paywall. The 3D models are the property of their creators; if their names are listed, please ask them for permission otherwise me.
Status
This mod is under heavy rework. Things will break, APIs will change, features will come and go. If you want to build and use it as-is, that's on you.
Contributing
Contributions are welcome. Rules:
- Pull requests only - no direct pushes
- Clear commit messages - describe what and why, not how
- Test your changes before submitting - at minimum, make sure it compiles and runs
- Bug fixes, new features, improvements - all welcome
- Areas where help is especially needed: textures, 3D models, multiplayer testing