Introduction to Regenesis

Regenesis is a next-generation GTA V multiplayer client designed for high performance, developer-friendly development, and production-ready deployment.

Key Features

  • High Performance: Optimized for 128-256+ players and 60-100+ FPS
  • Multi-Language Support: JavaScript/TypeScript, Lua, Python, C++, C#
  • Developer-Friendly: Hot reloading, clean API, comprehensive documentation
  • Production-Ready: Security features, error handling, monitoring
  • Separate Client: Doesn't interfere with original GTA V installation

Architecture

Regenesis uses a custom client architecture that hooks into GTA V memory, uses a custom network stack, and supports multiple scripting runtimes.

Installation

Client Installation

  1. Download the Regenesis client from the download page
  2. Run the installer for your platform
  3. Follow the on-screen instructions
  4. Launch Regenesis and authenticate with your Rockstar Social Club account

System Requirements

Minimum

  • OS: Windows 10, Linux (Ubuntu 20.04+), macOS 11.0+
  • CPU: Intel Core i5-3470 / AMD FX-6300
  • RAM: 8 GB
  • GPU: NVIDIA GTX 660 / AMD HD 7870
  • Storage: 5 GB free space
  • GTA V: Legitimate copy required

Recommended

  • OS: Windows 11, Linux (Ubuntu 22.04+), macOS 12.0+
  • CPU: Intel Core i7-8700K / AMD Ryzen 5 3600
  • RAM: 16 GB
  • GPU: NVIDIA GTX 1060 / AMD RX 580
  • Storage: 10 GB free space

Quick Start

Creating Your First Script

Let's create a simple "Hello World" script in JavaScript:

// client/main.js
console.log('Hello from Regenesis!');

// Register a command
api.registerCommand('hello', () => {
    api.showNotification('Hello, World!');
});

Running Your Script

  1. Create a resource folder in your server's resources directory
  2. Add your script files
  3. Create a resource.toml manifest file
  4. Load the resource on your server

Scripting

Regenesis supports multiple scripting languages:

JavaScript/TypeScript

// Using the Client API
const position = api.getPlayerPosition();
api.setPlayerPosition(position.x, position.y, position.z + 10);
api.showNotification('Teleported up!');

Lua

-- Using the Client API
local position = api.getPlayerPosition()
api.setPlayerPosition(position.x, position.y, position.z + 10)
api.showNotification('Teleported up!')

Python

# Using the Client API
position = api.getPlayerPosition()
api.setPlayerPosition(position['x'], position['y'], position['z'] + 10)
api.showNotification('Teleported up!')

API Reference

Player API

getPlayerPosition()

Returns the current player position.

const pos = api.getPlayerPosition();
// Returns: { x: number, y: number, z: number }

setPlayerPosition(x, y, z)

Sets the player position.

api.setPlayerPosition(0, 0, 72);

UI API

showNotification(message, type, duration)

Shows a notification to the player.

api.showNotification('Welcome to Regenesis!', 'info', 5000);

Troubleshooting

Common Issues

Client Won't Start

  • Ensure GTA V is installed and up to date
  • Check that you have a legitimate copy of GTA V
  • Verify your Rockstar Social Club account is linked

Authentication Failed

  • Verify your Rockstar Social Club credentials
  • Check your internet connection
  • Ensure 2-step verification is properly configured

Performance Issues

  • Update your graphics drivers
  • Close unnecessary background applications
  • Check server performance and player count