# Cocoa Cube — Unity Pack

*An AppalachAI Studios asset pack, ready for the Unity Editor.*

**Collection:** squishy-foodies-vol-1
**Asset ID:** `cocoa_cube` · **Slug:** `cocoa-cube`
**Version:** 1.0.0
**License tier:** Free Starter

---

## Howdy, Unity devs

AI-assisted, studio QC'd, and game-ready — this pack is built to import clean and behave itself in your scene.

## What's inside

- `README.md` (readme)
- `LICENSE.md` (license)
- `manifest.json` (manifest)
- `thumbnails/cocoa_cube_thumb.svg` (thumbnail)
- `thumbnails/cocoa_cube.png` (render_thumbnail)
- `models/cocoa_cube.fbx` (fbx)
- `models/cocoa_cube.glb` (glb)
- `animations/animation_manifest.json` (animation_manifest)
- `animations/idle_bounce.json` (animation_recipe)
- `animations/squish_impact.json` (animation_recipe)
- `animations/wobble_recover.json` (animation_recipe)
- `animations/rare_celebration.json` (animation_recipe)
- `unity/SquishyProceduralAnimator.cs` (engine_script)

## Quick start

1. In your Unity project, create the folder **`Assets/AppalachAI/Cocoa Cube/`**.
2. Drop the pack's files into that folder (drag-and-drop into the Project window, or copy them in and let Unity import).
3. Select the imported model and check the **Import Settings** in the Inspector:
   - Set a sensible **Scale Factor** so the model matches your project's metric scale.
   - Enable **Read/Write** only if you need runtime mesh access (it costs memory).
4. Drag the model prefab into your scene.

## Scale & orientation

- Unity is **Y-up, meters, left-handed**. If a model imports rotated, set **Bake Axis Conversion** in the model's import settings (or rotate the root) — FBX from other tools often comes in with a -90° X tweak.
- Sanity-check size against a standard 1.8m capsule before committing.

## Texture & materials

- Materials work best with **URP/HDRP Lit** or the Built-in Standard shader.
- Assign the included maps: **Base Color (sRGB)**, **Normal** (mark the texture as a Normal map in import settings), and **Metallic/Roughness** (linear/raw).
- If you're on URP/HDRP, you may need to **Edit → Rendering → Materials → Convert** legacy materials, or remap the texture slots by hand.

## Animation

Check the **What's inside** list above for which motion system this asset uses:

- **Rigged clip pack** (`models/cocoa_cube_rigged.fbx` + `animations/*.glb`): import the rigged
  model, set the rig type to **Generic** (or Humanoid if it maps cleanly for you), then drop the
  clip files into an **Animator Controller** and play. Each `animations/<clip>.glb` holds one
  loop-ready take.
- **Procedural mover** (`unity/SquishyProceduralAnimator.cs`): add the included script as a
  component (Add Component → **Squishy Procedural Animator**, or drag the `.cs` onto the object)
  and tweak the exposed fields (speed, squish, sway) in the Inspector. No Animator Controller or
  rig required — the script drives the transform/mesh directly.

## License — Free Starter

Free to use in personal or small commercial projects. Attribution appreciated.

All sample IP in this pack is owned by **AppalachAI Studios**. © 2026 AppalachAI Studios.

## Support

Hit a snag or built something fun? Email **hello@appalachaistudios.com**.

---

*Made with care by AppalachAI Studios. Pack version 1.0.0.*
