@sprite-foundry/fantasy-heroes-48 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — Unreleased
+
+### Added
+
+- 8 hero archetypes: Fighter, Ranger, Mage, Rogue, Cleric, Barbarian, Paladin, Monk
+- 8 directions per variant (front, front_left, left, back_left, back, back_right, right, front_right)
+- 3 layers per direction: albedo, normal map, depth map
+- 192 total sprite assets (8 variants × 8 directions × 3 layers)
+- Pack-level index (`pack.json`) and per-variant manifests
+- Contact sheet previews per variant
+- Asset verification script (`npm run verify`)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCP Tool Shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/fantasy-heroes-sprite-pack/readme.png" width="400" alt="Fantasy Heroes" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/fantasy-heroes-sprite-pack/actions"><img src="https://github.com/mcp-tool-shop-org/fantasy-heroes-sprite-pack/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://www.npmjs.com/package/@sprite-foundry/fantasy-heroes-48"><img src="https://img.shields.io/npm/v/@sprite-foundry/fantasy-heroes-48" alt="npm version" /></a>
+  <a href="https://github.com/mcp-tool-shop-org/fantasy-heroes-sprite-pack/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License" /></a>
+  <a href="https://mcp-tool-shop-org.github.io/fantasy-heroes-sprite-pack/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page" /></a>
+</p>
+
+A 48px, 8-direction pixel-art hero party pack with albedo, normal, and depth maps for engine-agnostic game use.
+
+![Fantasy Heroes Banner](previews/banner.png)
+
+## What's Included
+
+8 hero archetypes forming a complete adventuring party:
+
+![Variant Lineup](previews/lineup.png)
+
+| Variant | Role | Silhouette |
+|---------|------|------------|
+| Fighter | Frontline all-rounder | Sword + shield, balanced armored frame |
+| Ranger | Ranged striker | Bow, cloak, lighter silhouette |
+| Mage | Caster | Staff, robe, high magical silhouette |
+| Rogue | Flanker | Hood, light armor, daggers, low agile posture |
+| Cleric | Healer/support | Flanged mace, buckler with sun emblem, vestments |
+| Barbarian | Heavy damage | Huge weapon, broad upper body, fur/leather mass |
+| Paladin | Elite tank | Full plate, kite shield, warhammer, cape |
+| Monk | Fast specialist | Unarmored, wraps, bo staff, disciplined silhouette |
+
+Each variant ships with three map layers:
+
+- **Albedo** — base color sprites (transparent PNG)
+- **Normal** — normal maps for dynamic lighting
+- **Depth** — depth maps for parallax and elevation effects
+
+## Install
+
+```bash
+npm install @sprite-foundry/fantasy-heroes-48
+```
+
+## Folder Structure
+
+```
+assets/
+  fighter/
+    albedo/    8 directional PNGs (front, front_left, left, back_left, back, back_right, right, front_right)
+    normal/    8 matching normal maps
+    depth/     8 matching depth maps
+    preview/   contact sheet
+    manifest.json
+  ranger/
+  mage/
+  rogue/
+  cleric/
+  barbarian/
+  paladin/
+  monk/
+pack.json          pack-level index
+previews/          banner and lineup sheets
+```
+
+## Manifest Format
+
+Each variant has a `manifest.json`:
+
+```json
+{
+  "slug": "fighter",
+  "name": "Fighter",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}
+```
+
+The pack-level `pack.json` indexes all variants with paths to each manifest.
+
+## Engine Compatibility
+
+These are plain PNG files with JSON metadata. They work with any engine or framework that can load images:
+
+- Phaser
+- PixiJS
+- Godot
+- RPG Maker
+- Unity (2D)
+- Custom engines
+
+No engine-specific format or runtime dependency.
+
+## Specs
+
+- **Tile size:** 48 x 48 px
+- **Directions:** 8 (front, front_left, left, back_left, back, back_right, right, front_right)
+- **Format:** transparent PNG
+- **Maps:** albedo + normal + depth
+- **Animation:** static poses (v1)
+- **Perspective:** top-down
+
+## Extending the Pack
+
+Want to generate additional hero variants that match this pack's art style and export contract?
+
+This pack was produced with [Sprite Foundry](https://github.com/mcp-tool-shop-org/sprite-foundry), an open-source ComfyUI + SDXL pixel-art generation pipeline. The foundry repo contains everything you need:
+
+- **Generation pipeline** — `pipeline/foundry_gen.py` drives ComfyUI with per-subject configs
+- **Subject configs** — `pipeline/chars/hero_*.json` define the exact prompts, seeds, silhouette rules, and reject conditions for every variant in this pack
+- **Batch manifest** — `pipeline/manifests/fantasy_heroes_03.json` maps all 8 configs to the export structure
+- **Export CLI** — `foundry export <run_id>` produces deterministic packs with checksums
+- **ControlNet tuning** — humanoid depth strength 0.60, end% 0.85 (documented in the manifest)
+
+To add a new variant:
+
+1. Create a subject config in `pipeline/chars/` following the existing hero configs
+2. Register: `python -m foundry.cli subject-add <id> --name "Name"`
+3. Generate: `python -m pipeline.foundry_gen --config pipeline/chars/<config>.json`
+4. Review, accept, produce maps, accept finish, export
+5. Copy the exported pack into the matching `assets/<slug>/` directory
+
+The [Sprite Foundry README](https://github.com/mcp-tool-shop-org/sprite-foundry#readme) has the full pipeline walkthrough.
+
+## Security
+
+This package contains **only static PNG images and JSON metadata**. There is no executable code, no install hooks, no network access, and no telemetry. Assets are read-only by design.
+
+See [SECURITY.md](SECURITY.md) for the full security policy.
+
+## License
+
+MIT — use in commercial and non-commercial projects.
+
+## Credits
+
+Generated with [Sprite Foundry](https://github.com/mcp-tool-shop-org/sprite-foundry) using ComfyUI + SDXL pixel-art pipeline.
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/assets/barbarian/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "barbarian",
+  "name": "Barbarian",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/cleric/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "cleric",
+  "name": "Cleric",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/fighter/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "fighter",
+  "name": "Fighter",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/mage/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "mage",
+  "name": "Mage",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/monk/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "monk",
+  "name": "Monk",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/paladin/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "paladin",
+  "name": "Paladin",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/ranger/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "ranger",
+  "name": "Ranger",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/assets/rogue/manifest.json

@@ -0,0 +1,13 @@
+{
+  "slug": "rogue",
+  "name": "Rogue",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": {
+    "albedo": "albedo/{direction}.png",
+    "normal": "normal/{direction}.png",
+    "depth": "depth/{direction}.png"
+  },
+  "preview": "preview/contact_sheet.png"
+}

package/pack.json

@@ -0,0 +1,18 @@
+{
+  "name": "Fantasy Heroes",
+  "slug": "fantasy-heroes-03",
+  "version": "1.0.0",
+  "tileSize": 48,
+  "directions": ["front", "front_left", "left", "back_left", "back", "back_right", "right", "front_right"],
+  "layers": ["albedo", "normal", "depth"],
+  "variants": [
+    { "slug": "fighter",   "name": "Fighter",   "role": "frontline all-rounder", "path": "assets/fighter/manifest.json" },
+    { "slug": "ranger",    "name": "Ranger",    "role": "ranged striker",        "path": "assets/ranger/manifest.json" },
+    { "slug": "mage",      "name": "Mage",      "role": "caster",               "path": "assets/mage/manifest.json" },
+    { "slug": "rogue",     "name": "Rogue",     "role": "flanker",              "path": "assets/rogue/manifest.json" },
+    { "slug": "cleric",    "name": "Cleric",    "role": "healer/support",       "path": "assets/cleric/manifest.json" },
+    { "slug": "barbarian", "name": "Barbarian", "role": "heavy damage",         "path": "assets/barbarian/manifest.json" },
+    { "slug": "paladin",   "name": "Paladin",   "role": "elite tank",           "path": "assets/paladin/manifest.json" },
+    { "slug": "monk",      "name": "Monk",      "role": "fast specialist",      "path": "assets/monk/manifest.json" }
+  ]
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@sprite-foundry/fantasy-heroes-48",
+  "version": "1.0.0",
+  "description": "Fantasy Heroes — Pack 03 | 8 hero archetypes × 8 directions × 3 layers | 48px pixel-art sprite pack",
+  "author": "mcp-tool-shop",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-tool-shop-org/fantasy-heroes-sprite-pack"
+  },
+  "homepage": "https://mcp-tool-shop-org.github.io/fantasy-heroes-sprite-pack/",
+  "keywords": [
+    "sprites",
+    "pixel-art",
+    "fantasy",
+    "heroes",
+    "party",
+    "game-assets",
+    "48px",
+    "normal-maps",
+    "depth-maps",
+    "8-direction",
+    "rpg",
+    "dungeon-crawler",
+    "tactics"
+  ],
+  "scripts": {
+    "verify": "node -e \"const fs=require('fs');const p=require('./pack.json');let ok=true;for(const v of p.variants){const m=JSON.parse(fs.readFileSync(v.path,'utf8'));for(const d of m.directions){for(const[l,pat]of Object.entries(m.layers)){const f=v.path.replace('manifest.json','')+pat.replace('{direction}',d);if(!fs.existsSync(f)){console.error('MISSING:',f);ok=false}}}}if(ok){console.log('All assets verified')}else{process.exit(1)}\""
+  },
+  "files": [
+    "assets/",
+    "previews/",
+    "pack.json",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}