Gen 3 ADV OU Battle Simulator

A fast Gen 3 ADV OU battle simulator for AI training, combining Pokémon Showdown's battle rules with an optimized Zig-based engine.

Overview

This project aims to replace Showdown simulation calls with a faster Zig backend (engine) while maintaining parity with Showdown's Gen 3 OU behavior. The goal is to significantly improve throughput for AI self-play training.

Components

• pokemon-showdown/: Reference simulator and test harness
• engine/: Optimized simulator core (Gen 3 port in progress under src/lib/gen3)

Quick Start

# Build Showdown
cd pokemon-showdown && npm install && npm run build

# Build engine
cd engine && npm install && npm run compile

# Build engine native addon
cd engine && node src/bin/install-pkmn-engine

Status

• Showdown and engine build and run on Linux x86_64
• Gen 3 module scaffold with ~10k lines of Zig implemented
• Core battle mechanics partially implemented

Documentation

• AGENTS.md - Detailed development status and guidelines
• ADV_GEN3_MIGRATION_PLAN.md - Migration strategy

Requirements

• Node.js >= 16.0.0
• npm
• Zig 0.16.0+ (bundled in engine/build/bin/zig/)