game-character-gen

name

game-character-gen

description

Generate professional game character designs via OpenAI Images API. Create diverse characters for RPGs, video games, tabletop games, and interactive media. Use when user needs character concept art, character portraits, game sprites, or character sheets with specific attributes like race, class, profession, equipment, and visual style (e.g., "create an elven ranger", "design a cyberpunk hacker", "generate fantasy warrior character").

Game Character Generator

Generate detailed character concepts for games with precise control over race, class, equipment, and visual style.

Setup

• Needs env: OPENAI_API_KEY

Quick Start

Generate a basic character:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "elf" \
  --class "ranger"

Generate with specific details:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "dragonborn" \
  --class "paladin" \
  --gender "female" \
  --equipment "plate armor, divine shield" \
  --style "epic fantasy painting"

Generate a batch of characters:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "human" "dwarf" "tiefling" \
  --class "warrior" "mage" "rogue" \
  --style "dark fantasy" "anime" "realistic"

Character Parameters

Race (Fantasy)

• human - Human (various ethnicities)
• elf - High elf, wood elf, dark elf (drow)
• dwarf - Mountain dwarf, hill dwarf
• halfling - Lightfoot, stout halfling
• gnome - Rock gnome, forest gnome
• half-elf - Half-elf heritage
• half-orc - Half-orc heritage
• dragonborn - Dragonborn (various draconic lineages)
• tiefling - Tiefling (infernal heritage)
• goliath - Goliath (giant heritage)
• aasimar - Aasimar (celestial heritage)
• goblin - Goblin
• hobgoblin - Hobgoblin
• bugbear - Bugbear
• kenku - Kenku (bird-like)
• tabaxi - Tabaxi (feline)
• lizardfolk - Lizardfolk
• firbolg - Firbolg
• genasi - Genasi (elemental: air, earth, fire, water)

Class (Fantasy)

• warrior - Fighter, barbarian, knight
• mage - Wizard, sorcerer, warlock
• cleric - Cleric, priest, paladin
• rogue - Rogue, assassin, thief
• ranger - Ranger, hunter, scout
• bard - Bard, entertainer
• monk - Monk, martial artist
• druid - Druid, shaman
• artificer - Artificer, engineer
• inquisitor - Inquisitor, investigator

Race (Sci-Fi / Cyberpunk)

• human-augmented - Cybernetically enhanced human
• android - Synthetic android
• clone - Clone soldier
• alien-humanoid - Various alien species
• cyborg - Heavily modified cyborg
• bio-engineered - Genetically modified

Class (Sci-Fi / Cyberpunk)

• hacker - Netrunner, hacker
• soldier - Mercenary, corporate soldier
• tech-specialist - Engineer, technician
• medic - Combat medic
• scout - Reconnaissance specialist
• pilot - Starship pilot
• assassin - Corporate assassin
• detective - Investigator

Equipment

Common equipment keywords (comma-separated):

• leather armor / chainmail / plate armor / cybernetic implants
• sword and shield / greatsword / daggers / quarterstaff
• crossbow / longbow / pistol / plasma rifle / laser pistol
• spellbook / arcane focus / holy symbol / tech gauntlet
• cloak / hooded cape / tactical vest / exosuit
• backpack / tool belt / medical kit / hacking deck

Style

Artistic styles for character render:

• epic fantasy painting - Rich oil painting, cinematic
• realistic portrait - Photorealistic character portrait
• anime studio - Anime/manga style
• concept art - Game concept art quality
• illustration - Detailed illustration
• comic book - Bold comic style
• pixel art - Retro pixel character
• dark fantasy - Grim dark aesthetic
• low poly - Low poly 3D model look
• cel shaded - Cel shading anime style
• watercolor - Soft watercolor style
• vintage fantasy - Classic fantasy art

Gender / Expression

• male, female, non-binary, androgynous
• young, middle-aged, elderly
• stoic, determined, mysterious, playful, grim, noble

Advanced Options

Custom prompt for full control:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --prompt "A rugged dwarven warrior with braided red beard, wearing ornate mithral plate armor decorated with runic engravings. He wields a massive warhammer with lightning crackling along the head. Battle-hardened expression, scars visible on face. Epic fantasy oil painting style, cinematic lighting, detailed textures."

Include character sheet:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "human" \
  --class "mage" \
  --style "concept art" \
  --sheet

Parameters

• --race - Character race/species (repeatable for batch)
• --class - Character class/profession (repeatable for batch)
• --gender - Gender identity
• --equipment - Equipment and gear description
• --style - Artistic style (repeatable for batch)
• --prompt - Full custom prompt (overrides other options)
• --count - Number of variants per character (default: 1)
• --sheet - Generate character sheet JSON with stats
• --out-dir - Output directory (default: ~/Projects/tmp/game-character-gen-*)
• --size - Image size: 1024x1024, 1792x1024, 1024x1792 (default: 1024x1024)
• --quality - high/standard (default: high)
• --model - OpenAI image model (default: gpt-image-1.5)
• --api-key - OpenAI API key (or use OPENAI_API_KEY env)

Character Sheet Format

When using --sheet, generates character_sheet.json with:

{
  "name": "Generated Character",
  "race": "human",
  "class": "mage",
  "gender": "male",
  "equipment": ["staff", "robes"],
  "stats": {
    "strength": 8,
    "dexterity": 14,
    "constitution": 10,
    "intelligence": 18,
    "wisdom": 12,
    "charisma": 10
  },
  "image_file": "01-mage.png"
}

Output

• *.png - Character images
• character_sheet.json - Character data (if --sheet)
• prompts.json - All prompts used
• index.html - Character gallery

Examples

D&D party:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "human" "elf" "dwarf" "half-orc" \
  --class "paladin" "ranger" "cleric" "barbarian" \
  --style "epic fantasy painting"

Cyberpunk crew:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "human-augmented" "android" "clone" "cyborg" \
  --class "hacker" "soldier" "tech-specialist" "assassin" \
  --style "cyberpunk neon" \
  --equipment "hacking deck" "plasma rifle" "tool belt" "monowire"

Children's book characters:

python3 ~/Projects/agent-scripts/skills/game-character-gen/scripts/generate.py \
  --race "human" "elf" "gnome" "fairy" \
  --class "adventurer" "wizard" "explorer" "healer" \
  --style "whimsical illustration" "watercolor"