Generate pixel art game assets (characters, animations, tilesets) directly from code using PixelLab MCP Server. Use when creating game assets, character sprites, animations, or tilesets for game development.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Instruções da origem · Visualização somente leitura
name
pixellab-mcp
description
Generate pixel art game assets (characters, animations, tilesets) directly from code using PixelLab MCP Server. Use when creating game assets, character sprites, animations, or tilesets for game development.
Generate pixel art game assets (characters, animations, tilesets) directly from code using the PixelLab MCP Server.
Overview
The PixelLab MCP Server provides tools for generating pixel art game assets programmatically. All creation operations are non-blocking - they return immediately with job IDs and process in the background (typically 2-5 minutes).
The MCP server is already configured and enabled. You can call these tools directly - they will be available in your tool list.
Non-Blocking Operations
CRITICAL CONCEPT: All creation tools return immediately with job IDs - they process in the background (2-5 minutes):
Submit request → Get job ID instantly
Process runs in background
Check status with corresponding get_* tool
Download when ready (UUID serves as access key)
No authentication needed for downloads - share download links freely
This means you should:
Submit creation requests
Continue with other work or check status periodically
Download assets when status indicates completion
Available Tools
Character Tools
create_character - Create a new character sprite
animate_character - Add animations to an existing character
get_character - Get character status and download URLs
list_characters - List all your characters
delete_character - Delete a character
Top-Down Tileset Tools
create_topdown_tileset - Create a top-down tileset (16 Wang tiles)
get_topdown_tileset - Get tileset status and download URLs
list_topdown_tilesets - List all your top-down tilesets
delete_topdown_tileset - Delete a tileset
Sidescroller Tileset Tools
create_sidescroller_tileset - Create a sidescroller tileset
get_sidescroller_tileset - Get tileset status and download URLs
list_sidescroller_tilesets - List all your sidescroller tilesets
delete_sidescroller_tileset - Delete a tileset
Isometric Tile Tools
create_isometric_tile - Create an isometric tile
get_isometric_tile - Get tile status and download URLs
list_isometric_tiles - List all your isometric tiles
delete_isometric_tile - Delete a tile
Character Creation Workflow
Basic Character Creation
# Create a character with 4 directions
character = create_character(
description="A brave knight with red armor and a sword",
n_directions=4, # or 8 for more directions
size=48, # Canvas size in pixels
proportions='{"type": "preset", "name": "heroic"}'
)
# Returns: { "character_id": "uuid", "status": "processing" }
# Create character first
character_id = create_character(...)["character_id"]
# Queue walk animation
animate_character(character_id, 'walk')
# Other animation templates:# - 'walk'# - 'running-8-frames'# - 'jumping-1'# - And more...
Checking Status
# Check if character is ready
status = get_character(character_id)
# Returns: { "status": "completed", "download_url": "...", ... }
Character Storage
Characters are stored permanently and can be reused
Characters created via MCP appear in web interfaces (Character Creator) if using same account
Use list_characters() to see all your characters
Tileset Creation
Top-Down Tilesets
Creates 16 Wang tiles for seamless terrain:
tileset = create_topdown_tileset(
lower_description="Grassy terrain with small rocks",
upper_description="Dirt path with stones"
)
# Returns: { "tileset_id": "uuid", "status": "processing" }
Use Cases:
Overworld maps
Strategy games
RPGs with top-down view
Seamless terrain generation
Chain tilesets for consistency:
# Create base tileset
base = create_topdown_tileset(...)
# Create related tileset using base for consistency
related = create_topdown_tileset(
lower_description="Sandy beach",
upper_description="Ocean water",
base_tile_id=base["tileset_id"] # Links to base for visual consistency
)
# 1. Create character
character = create_character(
description="A brave knight with red armor",
n_directions=8,
size=48,
proportions='{"type": "preset", "name": "heroic"}'
)
character_id = character["character_id"]
# 2. Queue animations
animate_character(character_id, 'walk')
animate_character(character_id, 'running-8-frames')
# 3. Check status (poll until ready)import time
whileTrue:
status = get_character(character_id)
if status["status"] == "completed":
print(f"Download: {status['download_url']}")
breakelif status["status"] == "failed":
print("Creation failed")
break
time.sleep(10) # Wait 10 seconds before checking again
Tileset Chain for Terrain
# Create base grass tileset
grass = create_topdown_tileset(
lower_description="Lush green grass",
upper_description="Grass with small flowers"
)
# Create dirt tileset linked to grass
dirt = create_topdown_tileset(
lower_description="Brown dirt path",
upper_description="Dirt with footprints",
base_tile_id=grass["tileset_id"]
)
# Create stone tileset linked to dirt
stone = create_topdown_tileset(
lower_description="Gray stone floor",
upper_description="Stone with cracks",
base_tile_id=dirt["tileset_id"]
)
Tool Parameters Reference
create_character
description (string, required) - Character description
n_directions (int, optional) - Number of directions (4 or 8, default: 4)
size (int, optional) - Canvas size in pixels (default: 48)
