Clean repo for open source release

Remove build artifacts, dev tool configs, unused dependencies,
and third-party source dumps. Add proper README, update .gitignore,
clean up Makefile.

src/main/java/com/tiedup/remake/client/events/EntityCleanupHandler.java

@@ -0,0 +1,71 @@
+package com.tiedup.remake.client.events;
+
+import com.mojang.logging.LogUtils;
+import com.tiedup.remake.client.animation.BondageAnimationManager;
+import com.tiedup.remake.client.animation.PendingAnimationManager;
+import com.tiedup.remake.core.TiedUpMod;
+import net.minecraftforge.api.distmarker.Dist;
+import net.minecraftforge.event.entity.EntityLeaveLevelEvent;
+import net.minecraftforge.eventbus.api.SubscribeEvent;
+import net.minecraftforge.fml.common.Mod;
+import org.slf4j.Logger;
+
+/**
+ * Automatic cleanup handler for entity-related resources.
+ *
+ * <p>This handler automatically cleans up animation layers and pending animations
+ * when entities leave the world, preventing memory leaks from stale cache entries.
+ *
+ * <p>Phase: Performance & Memory Management
+ *
+ * <p>Previously, cleanup had to be called manually via {@link BondageAnimationManager#cleanup(java.util.UUID)},
+ * which was error-prone and could lead to memory leaks if forgotten.
+ * This handler ensures cleanup happens automatically on entity removal.
+ */
+@Mod.EventBusSubscriber(
+    modid = TiedUpMod.MOD_ID,
+    bus = Mod.EventBusSubscriber.Bus.FORGE,
+    value = Dist.CLIENT
+)
+public class EntityCleanupHandler {
+
+    private static final Logger LOGGER = LogUtils.getLogger();
+
+    /**
+     * Automatically clean up animation resources when an entity leaves the world.
+     *
+     * <p>This event fires when:
+     * <ul>
+     *   <li>An entity is removed from the world (killed, despawned, unloaded)</li>
+     *   <li>A player logs out</li>
+     *   <li>A chunk is unloaded and its entities are removed</li>
+     * </ul>
+     *
+     * <p>Cleanup includes:
+     * <ul>
+     *   <li>Removing animation layers from {@link BondageAnimationManager}</li>
+     *   <li>Removing pending animations from {@link PendingAnimationManager}</li>
+     * </ul>
+     *
+     * @param event The entity leave level event
+     */
+    @SubscribeEvent
+    public static void onEntityLeaveLevel(EntityLeaveLevelEvent event) {
+        // Only process on client side
+        if (!event.getLevel().isClientSide()) {
+            return;
+        }
+
+        // Clean up animation layers
+        BondageAnimationManager.cleanup(event.getEntity().getUUID());
+
+        // Clean up pending animation queue
+        PendingAnimationManager.remove(event.getEntity().getUUID());
+
+        LOGGER.debug(
+            "Auto-cleaned animation resources for entity: {} (type: {})",
+            event.getEntity().getUUID(),
+            event.getEntity().getClass().getSimpleName()
+        );
+    }
+}