GameLoop Starter

Bought a map asset pack but spent 3 hours manually placing every tree and rock? **Not anymore.** GameLoop Starter scans your map base image and uses template matching to automatically find every matching decoration position - generate them in one click, with outline collision, and the whole scene is instantly playable.

Two map routes, your choice: **import a full PNG base map** (auto boundary collision + POI markers + scene template export) or **slice a tileset into a 4-layer Tilemap** (Rule Tile auto-tiling + layer manager). Then the scene wizard wires up quests, dialogue, inventory, combat, and saves - delete the modules you don't need, zero overhead.

**Not a learning project. Not a code framework.** A production tool built to Asset Store standards: removable modules, event-driven, data-driven, zero third-party dependencies. Unity 6 Built-in 2D.

---

### Two Map Routes (v1.3 core addition) - use what you have

Most 2D tools only support tiles. GameLoop Starter gives you both: **Route 1 - Image Map** (for ready-made map PNGs)
- **Import a PNG base map and auto-stretch to world size** - no slicing, no tiling, displays exactly as the artist drew it
- **Auto boundary collision**: a closed ring hugging the map edge so the player can't walk off
- **Paint unwalkable areas**: lakes, walls, building interiors - paint to add collision, erase to remove
- **POI markers**: quest/teleport/shop/npc/gather/save/custom, 7 types with colors, readable by minimap and quest tracker
- **Export scene as template**: pack a finished scene into a Prefab, import into new scenes with one click

**Route 2 - Tilemap** (for tileset assets, fine control)
- **One-click tileset slicing**: select a grid-arranged tileset PNG + tile size, auto-cut into Tile assets and generate a Tile Palette - no manual dragging in Sprite Editor
- **4-layer skeleton**: Floor / Walls (with collider) / Decoration / Front (foreground occlusion, player gets hidden behind buildings)
- **Rule Tile auto-tiling**: select a sliced texture, auto-generate 4-neighbor adjacency tiles - grass-dirt, water-shore transitions connect automatically, built-in implementation with zero extra package dependencies
- **Layer manager**: per-layer collider toggle, sorting adjustment, add custom layers

### Decoration System (v1.3 greatly enhanced)

- **Template-match auto-locate (exclusive)**: pass a single sprite (e.g. a tree), the wizard scans the map base image and finds every matching position; check the ones you want and batch-generate decorations with outline collision - map and sprite assets from the same pack, aligned in one click
- **Batch auto-locate**: add multiple patterns at once (whole folder import supported), scan all, generate all
- **Area scatter**: specify count / range / min spacing, randomly brush a field of trees, grass, rocks, mix multiple patterns
- **Outline collision**: physics shape hugging the sprite alpha edge (same algorithm as Sprite Editor Generate), adjustable Detail and Alpha tolerance
- **Pixel snapping**: generated coordinates auto-align to pixel grid, no sub-pixel blur or seams

### Scene Wizard (8 entries)

| Entry | What happens when you click |
|---|---|
| **Quick scene** | Minimal / Standard / Full demo presets. **Idempotent design**: repeated clicks never duplicate objects |
| **Map** | Dual routes (see above) |
| **Characters** | Player (built-in J key melee) / NPC (static patrol schedule, quest shop affinity tags) / Enemy (HP hit-flash contact-damage loot-table optional-respawn) |
| **Interactables** | Gather node / Chest / Door (optional key) / Portal (target spawn point dropdown) / Sign |
| **Buildings** | Pure decoration or enterable building |
| **Decorations** | See Decoration System above |
| **Logic points** | Spawn / Save / Respawn points / Zone trigger (enter-exit events + BGM switch) |
| **Scene checklist** | All scene objects at a glance: select / lock / hide / delete + one-click integrity validation |

### Safety Rails

- **Global item ID dropdown** - auto-scans Item definitions in the project, impossible to fill wrong
- **Chest CSV batch import** - `itemID,quantity` one per line, comment lines auto-skipped
- **Auto Undo** - every generation registers undo, Ctrl+Z to revert
- **Hierarchy auto-grouping** - Environment / Characters / Interactables / Logic four groups, scene stays tidy
- **One-click scene validation** - missing spawn point, portal without target, instant health check

### Combat Loop

J-key melee (directional hitbox + cooldown + Gizmos visualization) killable enemies (HP / hit-flash / death fade / contact damage / invincibility frames) loot table (probability + quantity range, referenced by enemy/chest/gather) audio hooks (BGM/SFX two channels)

### Complete Core Loop (play out of the box)

**Dialogue -> Accept quest -> Gather/Combat -> Turn in quest -> Reward -> Save**

Dialogue (multi-node branching + typewriter) Quests (5 objective types + quest chains) Inventory (4 item types + auto-stack) Save (JSON + multiple slots + forward-compatible) Shop / Equipment / Gold / Day-Night / Achievements / Collection / Affinity / Minimap - **all removable modules, zero overhead when not mounted**.

---

### 3-Step Quick Start

1. Import the unitypackage, open StarterScene (blank starting point, only a camera)
2. Menu **GameLoopStarter -> Scene Wizard** -> click Quick Scene - Standard
3. Press Play - dialogue, accept quest, gather, open chest, hit dummy, save, all working

### Default Controls

`WASD` move `E` interact `J` attack `I` inventory `U` equipment `1-5` hotbar `M` achievements `C` collection `F5/F9` save/load `F1` force recover `ESC` close panel

---

### For you if...

- Want to make a 2D top-down RPG (Zelda/Stardew Valley style) without rewriting the foundations like quests, inventory, saves
- Bought a ready-made map asset pack (whole map PNG or tileset) and want to turn it into a playable scene fast
- Can replace Sprites (swap color blocks for your art) but don't want to write system-level code

### Not for you if...

- Need 3D, side-scroller, URP/HDRP (this is Built-in 2D top-down)
- Expect finished enemy chase AI, skill trees, crafting systems (skeleton provides event interfaces and placeholders, deep gameplay is yours to add)
- Want polished art (everything is graybox placeholders, **this is a feature**: swap in your sprites and it's your game)

### Honest Limitations

- Enemies are stationary killable targets (fight back = contact damage, no pursuit/pathfinding)
- Template matching works best with same-asset-pack patterns (highest hit rate when map and sprite share the same source)
- Legacy Input Manager (works out of the box, Input System not integrated)
- UI is UGUI minimal style (one set, you can reskin)
- Audio system is hooks (BGM/SFX channels), no audio assets included

### AI Disclosure

Built with AI-assisted development tools; core architecture, design decisions and testing done by hand.

---

### Package Contents

- Full C# source (65+ scripts, well-commented)
- 4 Prefabs + StarterScene blank starting scene
- 11 sample SOs (item/quest/achievement/shop data)
- Scene wizard + one-click assembler editor tools (including full dual-map-route toolchain)
- README quick-start documentation

### Requirements

Unity 6 (6000.0.x) Built-in 2D Legacy Input Manager No third-party dependencies Compatible with 2022.3 LTS (code-level, wizard UI targets Unity 6)

---

### Version History

**v1.3.0** - Dual map routes: Image Map (PNG base map + auto boundary + collision painter + POI markers + scene template) and Tilemap (tileset one-click slice + 4-layer skeleton + Rule Tile auto-tiling + layer manager); decoration system enhanced: template-match auto-locate (single + batch), area scatter, outline collision, pixel snapping
**v1.2.0** - Combat loop: killable enemies (HP/hit-flash/death-fade/contact-damage), J-key melee, loot tables, audio hooks; chest multi-item + CSV import, global item dropdown, Undo + Hierarchy grouping, scene checklist lock/hide
**v1.1.0** - Scene wizard 8 entries (quick scene presets / character management / building / decoration / logic points / scene checklist)
**v1.0.0** - Core loop: dialogue/quest/inventory/save/shop/equipment/gold/day-night/achievement/collection

---

### Related Assets

- [Hot Reload Live (Unity)](https://gutian2000.itch.io/hot-reload-live-unity) - edit code without restarting Play, cuts the debug loop from 3 minutes to 10 seconds