Nucleus Co-op Handler Generator

A web-based tool designed to streamline the creation of handlers for Nucleus Co-op. This tool allows users to search for games, automatically gathers technical information from PCGamingWiki and Steam, and generates a JavaScript handler file ready for use.

Features

• Smart Search: Instantly search for games using PCGamingWiki's database.
• Automatic Data Retrieval:
  • Fetches game executable names.
  • Detects Save Game paths.
  • Retrieves Steam App IDs.
  • Fetches game cover art and descriptions from Steam.
• Configurable Handlers:
  • Select injection methods (EasyHook, Stealth, RemoteLoad, Startup).
  • Toggle Goldberg Emulator support (with automatic Steam ID).
  • Toggle Epic Online Services (EOS) fix.
  • Custom descriptions.
• Live Preview: View the generated JavaScript code in real-time.
• One-Click Export: Download the .js handler file directly.

How It Works

1. Search: Enter the name of the game you want to split-screen.
2. Select: Choose the correct game from the dropdown list.
3. Review & Edit: The tool will populate fields based on wiki data. Review the executable name, save paths, and options.
4. Download: Click "Download Handler" to get your file. Place it in your Nucleus Co-op handlers directory.

Technical Details

The application uses:

• React & Vite for a fast, modern frontend.
• TypeScript for type safety.
• PCGamingWiki API to scrape technical game data (executables, paths).
• Steam Store API to enrich metadata.
• CORS Proxy to handle cross-origin requests from the browser.

Development Setup

To run this project locally:

1. Clone the repository.
2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Build for production:

   npm run build

Documentation

For a detailed analysis of the Nucleus Co-op handler configuration options used in this tool, please refer to AGENTS.md.

Credits

• Built for the Nucleus Co-op community.
• Data provided by PCGamingWiki.