🛠️ GameNative Config Tools

Complete configuration management for your GameNative emulator.

Built with Next.js, TypeScript, and Tailwind CSS for a modern, type-safe, and responsive experience.

🔗 Quick Links

Tool	Description
🏠 Main Site	Central hub for all tools
🔄 Config Converter	Convert raw text to JSON
✏️ Config Editor	Edit configurations visually
🔍 Config Browser	Browse community configs

📑 Table of Contents

• The Problem
• The Solution
• Features
• Getting Started
• Detailed Usage
• Technical Details
• Community & Support
• License

---

🚨 The Problem

GameNative/Winlator users share game configurations (FPS, drivers, environment variables) in community databases, but there's a disconnect:

• Database: Perfect settings in raw text format
• App: Manual entry required, one setting at a time
• Result: Typos, frustration, and wasted time

Stop typing. Start playing.

✅ The Solution

Three complementary web tools to streamline your GameNative configuration workflow:

Tool	Purpose
🔄 Config Converter	Converts raw text from community reports into clean, importable JSON files
✏️ Config Editor	Visual editor for fine-tuning configurations across 10 organized categories
🔍 Config Browser	Search community configurations with intelligent caching and filtering

---

✨ Features

🔄 Config Converter

• Intelligent Parsing: Handles dense raw text where keys and values are packed without spacing
• Smart Type Inference: Auto-converts true/false to booleans and numeric strings to numbers
• Complex Data Handling: Detects and parses nested JSON in fields like extraData and sessionMetadata
• Data Normalization: Fixes property naming inconsistencies (e.g., lc all → lc_all)
• Junk Filtration: Strips useless runtime metadata (e.g., avg fps, session length)
• Android-Ready: Outputs the exact structure required by GameNative Import/Export

✏️ Config Editor

• Visual Interface: Intuitive, organized UI for all configuration settings
• 10 Organized Categories: General, Graphics, Emulation, Controller, Wine, Components, Environment, Drives, Advanced, and Hidden
• Real-Time Validation: Visual feedback and smart defaults ensure valid configurations
• Import/Export: Load existing configs, modify, and export updated versions
• Cross-Tool Integration: Seamlessly switch between Converter and Editor

🔍 Config Browser

• Local Filter Snapshots: Pre-generated JSON files for instant autocomplete suggestions
• Smart Autocomplete: Client-side fuzzy matching with debounced search
• Efficient Queries: Separate count and data queries to minimize database load
• Rich Preview: View ratings, FPS, device specs, notes, and app versions
• Seamless Integration: Load directly into Editor or download as JSON

---

🚀 Getting Started

Quick Start Guide

1. Find a configuration:

   • Visit GameNative Compatibility List or Config Browser
   • Select a game report and click "View Config"
   • Copy all the text

2. Convert to JSON:

   • Open Config Converter
   • Paste the text and click "Download Clean Config"

3. Optional - Edit settings:

   • Open Config Editor
   • Paste JSON, make changes, and export

4. Import to GameNative:

   • Transfer config.json to your Android device
   • In GameNative, press on any game → 3 dots → Import Config

📖 Detailed Usage

Converting Raw Configs

Step-by-Step

1. Get Raw Data

   • Navigate to a GameNative/Winlator config database
   • Click "View" on a config report
   • Copy all the text

2. Convert to JSON

   • Open Config Converter
   • Paste the raw text
   • Click "Download Clean Config"

3. Import to App

   • Transfer config.json to Android
   • GameNative → Select game → 3 dots → Import Config

Editing Existing Configs

Step-by-Step

1. Load Config

   • Open Config Editor
   • Paste JSON (from GameNative export or Converter)
   • Click "Load Config"

2. Make Changes

   • Navigate tabs: General, Graphics, Emulation, etc.
   • Adjust settings as needed

3. Export and Import

   • Click "Export JSON"
   • Transfer to Android and import via GameNative

---

🧩 Technical Details

Implementation Overview

Built to support the Import/Export JSON Schema from GameNative Android source code.

Config Converter

Lookahead Parser:

• Iterates through raw text line by line
• Uses KNOWN_KEYS set to differentiate keys from values
• Nests controller buttons into controllerEmulationBindings object

Config Editor

Structured Interface:

• 10 logical categories mirroring in-app "Edit Container" style
• Dynamic form controls based on configuration schema
• Special handling for CPU affinity grids, environment variables, and drive mappings
• Real-time synchronization between related fields (GPU name ↔ renderer)

Config Browser

Performance-Optimized Architecture:

The browser balances performance with database efficiency through:

• Local snapshots: Pre-generated JSON for instant autocomplete
• Client-side filtering: Fuzzy matching without database queries
• Debounced input: 250ms delay prevents excessive API calls
• Efficient queries: Separate count/data queries with proper joins
• Request cancellation: AbortController cancels outdated requests
• Seamless integration: Direct Config Editor loading and JSON export with proper metadata structure

---

🌍 Community & Support

These tools support the incredible work of GameNative developers and community. Find the official project here:

• 🌐 Official Website: GameNative.app
• 📦 Source Code: GameNative GitHub
• 💬 Discord: Join the Community

⚠️ Compatibility Note

These tools generate JSON files compatible with GameNative builds that include Import/Export PR (#232). Update to the latest release if the Import button is unavailable.

---

📄 License

MIT License - see LICENSE for details.

---

Not affiliated with official GameNative development. Built by the community, for the community.