This project provides an AI for winning Dark Souls PvP matches, targeting players interested in automated gameplay or AI research. It aims to automate PvP combat, offering a potential advantage through sophisticated decision-making.

How It Works

The AI utilizes a neural network approach, specifically the Fast Artificial Neural Network (FANN) library, to process game state inputs and determine optimal actions. Inputs for the defense network include enemy distance, relative angle, and velocity, while the attack network considers factors like stamina, poise, and AI/enemy HP. This method allows the AI to learn and adapt to various combat scenarios.

Quick Start & Requirements

• Install: Download Vjoy and configure a controller. Install Cheat Engine and the provided DARKSOULS.CT table to lock camera rotation. Compile the C# source code with FANN and add FANN and vJoyInterface DLLs.
• Prerequisites: Vjoy, Cheat Engine, FANN library, C# compiler.
• Setup: Requires manual configuration of Vjoy and Cheat Engine, plus compilation of the C# code.
• Resources: Pre-trained neural networks are available in the latest release. The GUI can be run via Eclipse or a .jar file.

Highlighted Details

• AI decision-making based on neural networks for defense and attack.
• Utilizes memory scanning and manipulation via Cheat Engine for camera control.
• Supports different map configurations for camera rotation.
• Includes a GUI for running the AI.

Maintenance & Community

The project acknowledges contributions from eur0pa, OrdinaryMagician, and Birdulon. The README emphasizes testing the latest commit to master. No community links (Discord, Slack, etc.) are provided.

Licensing & Compatibility

The project mentions using libraries like VJOY (http://vjoystick.sourceforge.net) and FANN (http://leenissen.dk), but does not explicitly state a license for the project itself. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The AI is still under development with numerous "TODO" items, including fixing specific combat mechanics like backstabs, parrying, and spear combat. Some functionalities, like weapon attack speed analysis and dynamic range, are noted as incomplete or requiring improvement. Camera locking is map-dependent.