Procedural Fakemon Engine

Mathematical Monster Generation meets Retro Aesthetics

This project is a sophisticated Procedural Fakemon Engine that blends mathematical precision with retro pixel-art aesthetics. It doesn’t just "draw" sprites—it calculates them. By combining Signed Distance Fields (SDF) for organic forms, Inverse Kinematics (IK) for natural posing, and type-specific shaders, it generates unique creatures and high-quality trading cards on the fly.

✨ Core Features

• SDF-Driven Geometry: Bodies and heads are generated using mathematical distance fields, ensuring smooth, organic silhouettes for every creature.
• Advanced IK System: Limbs are calculated using 2-joint mathematical chains. The engine supports both Plantigrade (human-like) and Digitigrade (animal-like) structures, with limb segments following the Golden Ratio.
• 3D Lighting & Shaders: A custom rendering pipeline provides Directional Lighting and material-specific shaders. Whether it’s the crystalline facets of an Ice-type or the grainy texture of a Grass-type’s fur, each sprite feels alive.
• Stat-Based Mimicry: A creature’s facial expressions are not random—they are tied to its RPG stats. High Attack? It looks fierce. High Initiative? It looks alert.
• TCG Module: Instantly generate and export full Trading Cards featuring procedurally generated names, abilities, and detailed stat spreads in a beautiful layout.

🛠 Technical Architecture

The engine is built on a modular Python framework designed for speed and flexibility:

1. Core Initialization: Handles CLI arguments, constants, and the PIL (Pillow) integration for high-performance pixel manipulation.
2. SDF Geometry Engine: Functions for generating complex body and head shapes using distance-field mathematics.
3. IK Skeleton System: Mathematical joint chains for organic arm and leg positioning based on Fibonacci-derived angles.
4. Asset Modules: Procedural generation of wings, weapons, and stat-driven facial expressions.
5. Advanced Renderer: Implements directional lighting, material shaders (Ice, Steel, Fur/Leaf), and cel-shading passes.
6. Trading Card Module: Generates TCG-style terminal frames and handles high-resolution PNG card exports.
7. Interactive Loop: A terminal-based UI for infinite seed-surfing, real-time generation, and selective exporting.

🎮 Controls

• [ENTER] – Surf to the next seed / Generate a new Fakemon.
• [T] – Toggle Trading Card Mode to view full stats and lore. If in this mode, all exports via[E] Key are like an trading cards. The Card Language is still in german at the moment and needs to be updated to other languages.
• [E] – Export PNG. (Saves the Monster or the full Card, depending on the current view).
• [Q] – Exit the engine.

Credits & Inspiration

This project was heavily inspired by pokeget. While pokeget is a fantastic utility for fetching and displaying existing sprites in the terminal, this engine takes the concept a step further:

Instead of fetching static data, Procedural Fakemon Engine uses mathematical algorithms to dream up entirely new creatures, pose them via Inverse Kinematics, and render them with dynamic shaders—all within the same terminal aesthetic that fans of pokeget know and love