# Melon Mini — Roblox Pack

*An AppalachAI Studios asset pack, tuned up for Roblox Studio.*

**Collection:** squishy-foodies-vol-1
**Asset ID:** `melon_mini` · **Slug:** `melon-mini`
**Version:** 1.0.0
**License tier:** Free Starter

---

## Howdy, Roblox builders

This pack is set up to feel at home in Studio. It's AI-assisted, studio QC'd, and game-ready — meaning we sweated the import details so you can spend your time building the experience, not wrestling with meshes.

## What's inside

- `README.md` (readme)
- `LICENSE.md` (license)
- `manifest.json` (manifest)
- `thumbnails/melon_mini_thumb.svg` (thumbnail)
- `thumbnails/melon_mini.png` (render_thumbnail)
- `models/melon_mini.fbx` (fbx)
- `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)
- `roblox/SquishyProceduralAnimator.lua` (engine_script)

## Quick start — two ways in

**Option A: Studio (the friendly way)**
1. In Roblox Studio, open the **Asset Manager** (View → Asset Manager).
2. Click **Import**, choose the included mesh file, and let Studio upload it.
3. Drag the resulting MeshPart into your workspace.

**Option B: Open Cloud (the bulk way)**
1. Use the **Open Cloud Assets API** with your API key to upload meshes programmatically — handy when you've got a whole collection.
2. Reference the returned asset IDs in your place or package.

## Scale & orientation

- Suggested scale: **4 studs**. Roblox studs aren't meters, so start here and nudge to fit your world's proportions.
- The pivot is set so the model **faces +Z** (Studio's "forward"). When you insert it, it should look the way you expect — if not, check the PivotEditor and rotate on the Y axis.

## Collision

- For **decorative** props, turn **CanCollide off** to keep your physics budget happy and avoid players snagging on clutter.
- For anything players stand on or bump into, leave collision on and consider setting the **CollisionFidelity** to Box or Hull for performance over Precise.

## Texture notes

- Apply the included texture via the MeshPart's **TextureID**, or use a SurfaceAppearance for full PBR (base color, normal, roughness, metalness).
- Keep an eye on texture memory if you're placing lots of copies — reuse the same uploaded texture asset across instances.

## Animation

This asset moves one of two ways — the **What's inside** list above tells you which files you got:

- **Rigged clip pack** (`models/melon_mini_rigged.fbx` + `animations/*.glb`): import the rigged
  model through Studio's **animation-aware importer** (Asset Manager → Import, or the Avatar
  importer for humanoid-style rigs) so the skeleton comes in intact. Each `animations/<clip>.glb`
  holds one loop-ready take — import them the same way and play them through an **Animator**.
- **Procedural mover** (`roblox/SquishyProceduralAnimator.lua`): drop in the included script
  (a Script or LocalScript depending on your needs) for that lively, squishy bit of life — no
  skeletal rig required. See `roblox_usage_notes` for the step-by-step.

## Moderation note

Roblox moderates uploaded assets. Most of our content is family-friendly and sails right through, but uploads are reviewed automatically and occasionally by hand — give it a moment after import, and make sure any names or decals you add follow Roblox community standards.

## 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

Stuck on an import or want to share a build? Email **hello@appalachaistudios.com** — we'd love to hear from you.

---

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