0x0funky/agent-sprite-forge / skills/generate2dmap
generate2dmap
VerifiedPlan and build 2D game maps and scenes - top-down and side-scrolling levels, tilemaps, prop packs, parallax backgrounds and HD-2D battle or story plates - with collision, navigation and reachability checks, environment motion, a playable HTML preview and export to Tiled, Godot 4 or LDtk. Map art (terrain, tiles, props, plates, parallax layers) is image generation by default, through generate2dmedia route_media.py (the API when a key is configured, else the local Codex or Grok CLI); map data (layout, collision, exits, spawns) is written as data. Use for any map, level, room, scene, background, terrain or prop-kit request. Not for characters, creatures, items or FX (generate2dsprite), character animation (video2dsprite), code-drawn tiles or maps (codeart2d, only on request) or calling an image or video API by itself (generate2dmedia).
references/schemas/host.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/0x0funky/agent-sprite-forge/main/shared/schemas/host.schema.json",
"title": "Agent Sprite Forge host contracts",
"description": "What a host (such as Agent Game Forge) reads from the Forge without knowing every tool's files: the asset index of forge_index.py scan and the progress lines a tool appends to its --progress-file. Version 1; objects stay open.",
"$defs": {
"asset_index_v1": {
"description": "forge_index.py scan <dir>: everything the Forge made under one folder. root is the scanned folder (absolute, POSIX); every other path is relative to it and stays inside it (indexPath: no '..' segment; a document path that leads outside is left out with a warning). masters come from master.json; sets from set_plan.json and set_state.json (read under the set's set_state.lock), per action with its status, take count, chosen take or window, the agent's accept, and the package of the chosen take (packageTake, packageTag) with its animation.json, poster, the package's reviewStatus and the verify result. When the recorded package holds another take or window than the chosen one (after a retake, or an accept of another take or window) package, packageTake, packageTag, manifest, poster, reviewStatus and verify are null and that package is previousPackage: never import it as the action's clip. fx come from fx.json, route A (pixelfx) or B (the image route); plates from plate.json; maps from map bundles (generate2dmap.map_bundle.v1 or v2). warnings name documents that could not be read, paths left out and a set lock that stayed held.",
"type": "object",
"required": ["schema", "tool", "createdAt", "root", "masters", "sets", "fx", "plates", "maps", "warnings"],
"properties": {
"schema": {
"const": "forge.asset_index.v1"
},
"tool": {
"$ref": "common.schema.json#/$defs/toolInfo"
},
"createdAt": {
"$ref": "common.schema.json#/$defs/timestamp"
},
"root": {
"type": "string",
"minLength": 1
},
"masters": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "name", "path", "metadata", "image", "class", "finish", "facing", "status"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"path": {
"$ref": "#/$defs/indexPath"
},
"metadata": {
"$ref": "#/$defs/indexPath"
},
"image": {
"$ref": "#/$defs/indexPath"
},
"cutout": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"class": {
"type": "string"
},
"finish": {
"type": "string"
},
"facing": {
"type": "string"
},
"route": {
"type": ["string", "null"]
},
"status": {
"const": "approved"
}
}
}
},
"sets": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "name", "path", "plan", "state", "finish", "status", "actions"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"path": {
"$ref": "#/$defs/indexPath"
},
"plan": {
"$ref": "#/$defs/indexPath"
},
"state": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"class": {
"type": "string"
},
"finish": {
"enum": ["hd", "pixel", "hibit"]
},
"targetHeight": {
"type": ["integer", "null"]
},
"master": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"status": {
"enum": ["planned", "complete", "complete-with-warnings", "incomplete"]
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "action", "view", "kind", "status", "takes", "chosen", "accepted", "package", "packageTake", "packageTag", "manifest", "reviewStatus", "previousPackage"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"action": {
"type": "string",
"minLength": 1
},
"view": {
"type": "string",
"minLength": 1
},
"kind": {
"enum": ["loop", "oneshot"]
},
"status": {
"type": "string",
"minLength": 1
},
"takes": {
"type": "integer",
"minimum": 0
},
"chosen": {
"anyOf": [
{
"type": "object",
"required": ["take"],
"properties": {
"take": {
"type": "integer",
"minimum": 1
},
"window": {
"anyOf": [
{
"type": "array",
"items": {
"type": "integer",
"minimum": 0
},
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"tag": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"accepted": {
"anyOf": [
{
"type": "object",
"required": ["take"],
"properties": {
"take": {
"type": "integer",
"minimum": 1
},
"window": {
"anyOf": [
{
"type": "array",
"items": {
"type": "integer",
"minimum": 0
},
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"at": {
"anyOf": [
{
"$ref": "common.schema.json#/$defs/timestamp"
},
{
"type": "null"
}
]
}
}
},
{
"type": "null"
}
]
},
"package": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"packageTake": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
]
},
"packageTag": {
"type": ["string", "null"]
},
"manifest": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"poster": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"reviewStatus": {
"type": ["string", "null"]
},
"verify": {
"type": ["string", "null"]
},
"previousPackage": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
}
},
"if": {
"properties": {
"package": {
"type": "string"
}
},
"required": ["package"]
},
"then": {
"properties": {
"packageTake": {
"type": "integer"
},
"packageTag": {
"type": "string"
}
}
},
"else": {
"properties": {
"packageTake": {
"type": "null"
},
"packageTag": {
"type": "null"
},
"manifest": {
"type": "null"
},
"poster": {
"type": "null"
},
"reviewStatus": {
"type": "null"
},
"verify": {
"type": "null"
}
}
}
}
}
}
}
},
"fx": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "name", "path", "metadata", "route", "routeName", "frames", "frameSize", "sheet", "status"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"path": {
"$ref": "#/$defs/indexPath"
},
"metadata": {
"$ref": "#/$defs/indexPath"
},
"route": {
"enum": ["A", "B"]
},
"routeName": {
"enum": ["pixelfx", "image"]
},
"effect": {
"type": ["string", "null"]
},
"frames": {
"type": "integer",
"minimum": 1
},
"frameSize": {
"$ref": "common.schema.json#/$defs/size2"
},
"frameMs": {
"type": ["number", "null"]
},
"loop": {
"type": ["boolean", "null"]
},
"sheet": {
"$ref": "#/$defs/indexPath"
},
"sheetJson": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"preview": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"credits": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"status": {
"$ref": "common.schema.json#/$defs/qaStatus"
}
}
}
},
"plates": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "name", "path", "metadata", "image", "size", "colors", "status"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"path": {
"$ref": "#/$defs/indexPath"
},
"metadata": {
"$ref": "#/$defs/indexPath"
},
"image": {
"$ref": "#/$defs/indexPath"
},
"preview": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"palette": {
"anyOf": [
{
"$ref": "#/$defs/indexPath"
},
{
"type": "null"
}
]
},
"size": {
"$ref": "common.schema.json#/$defs/size2"
},
"colors": {
"type": "integer",
"minimum": 1
},
"status": {
"$ref": "common.schema.json#/$defs/qaStatus"
}
}
}
},
"maps": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "name", "path", "schemaVersion"],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"path": {
"$ref": "#/$defs/indexPath"
},
"schemaVersion": {
"enum": ["generate2dmap.map_bundle.v1", "generate2dmap.map_bundle.v2"]
},
"world": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"layers": {
"type": "integer",
"minimum": 0
},
"objects": {
"type": "integer",
"minimum": 0
}
}
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"progress_line_v1": {
"description": "One line of a --progress-file (forge_core.Progress; FORGE_PROGRESS_FILE when no flag is given): a stage change of one tool run, appended and flushed while it runs, never written to stdout. t is the UTC time; tool the CLI (master_still, sprite_set, finish_frames, engine_export); stage its stage name (start, prompt, take, job, generate, evaluate, post, load, palette, downscale, colour-lock, quantize, qa, finish, package, verify, residue, encode, decode, publish, done, error); done and total are counts within the stage or null; message is short ASCII text or null. The last line of a run is done or error.",
"type": "object",
"required": ["t", "tool", "stage", "done", "total", "message"],
"properties": {
"t": {
"$ref": "common.schema.json#/$defs/timestamp"
},
"tool": {
"type": "string",
"minLength": 1
},
"stage": {
"type": "string",
"minLength": 1
},
"done": {
"type": ["integer", "null"],
"minimum": 0
},
"total": {
"type": ["integer", "null"],
"minimum": 0
},
"message": {
"type": ["string", "null"]
}
}
},
"indexPath": {
"description": "A path in the asset index: a common relPath relative to the index root that never leaves it (no '..' segment). forge_index.py resolves every document path and leaves out one that leads outside root (a '..' or a link); a host still checks containment before it reads a file.",
"allOf": [
{
"$ref": "common.schema.json#/$defs/relPath"
}
],
"not": {
"pattern": "(^|/)\\.\\.(/|$)"
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |