game-character-gen

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"