blizzless / blizzless-diiis

Fully-functional open-source server implementation for Diablo 3
GNU Affero General Public License v3.0
1.37k stars 352 forks source link
diablo diablo-3 diablo-servers diablo3 emulator gaming private-server server

DiIiS Project

DiIiS is a fully-functional open-source local server for Diablo III: Reaper of Souls.

Features

Restrictions

Installation

Supported Clients

Each version of the client includes changes to structures, opcodes and attributes.

The currently supported version of the client: 2.7.4.84161

Server Deploying

Prepare Database

Manual

  1. Install PostgreSQL 9.5.25.
  2. Create databases in PostgreSQL: diiis and worlds.
  3. Change you account and password in database.Account.config and database.Worlds.conifg.
  4. Restore worlds.backup to worlds database.

Or using docker

  1. Install docker
  2. Run docker-compose up inside db folder.

Compile and run

  1. Install .NET 7 SDK and runtime (just runtime, not asp.net or desktop)
  2. Go to the repo directory and compile the project using this command:
    dotnet publish ./src/DiIiS-NA/Blizzless.csproj --configuration Release --output ./publish
  3. [Skip this stage for local game] Copy the config.ini file to the publish folder (It overwrites the default settings):
    • Update the parameter entries with your IP record on the network: BindIP and PublicIP.
  4. Go to the publish folder, launch Blizzless executable, wait until server start - it creates a hierarchy.
  5. Create user account(s) using console: !account add Login Password Tag

Example:

!account add username@ YourPassword YourBattleTag

Creates an account with Login username@, password YourPassword and BattleTag YourBattleTag

!account add username@ YourPassword YourBattleTag owner

Creates an account with Login username@, password YourPassword and BattleTag YourBattleTag with rank owner

Example:

!account add username@ YourPassword YourBattleTag

Creates an account with Login username@, password YourPassword and BattleTag YourBattleTag

!account add username@ YourPassword YourBattleTag owner

Creates an account with Login username@, password YourPassword and BattleTag YourBattleTag with rank owner

Prepare Client

Do this for each client connecting to the server.

  1. Get supported client Diablo 3.

  2. Install certificate bnetserver.p12, password - 123 (the game verifies the CA root certificates).

  3. Setting up redirects client to your server:

    Method #1 - Hosts

    Add redirects to the hosts file (Windows - %WinDir%\System32\drivers\etc\hosts, Linux - /etc/hosts):
    127.0.0.1 us.actual.battle.net
    127.0.0.1 eu.actual.battle.net

    !After the modification the official Battle.Net application will not be able to connect to the server!

    Method #2 - Modify main executable file

      // Find null-terminated string enum and rewrite with HexEditor to your IP server.
      eu.actual.battle.net/
      us.actual.battle.net/
      cn.actual.battle.net/
      kr.actual.battle.net/
  4. Launch client (x64 or x86) with arguments "Diablo III64.exe" -launch

  5. Login to the game using your credentials.

  6. [Skip this stage for local game] After that, when creating a game (in client), indicate the creation of a public game. Other players, when connecting, must also indicate a public game, and at the start they will connect to you.

  7. You're in the game world!

Server Configuration

Global configuration

Using the configuration file you can easily override the global world parameters.

Command system

The command system allows you to get control of the game world if you have rights. A list of commands is available here.

Issues

Check the report form before submitting issue, this will help people save time!

System requirements

Entry-level Mid-range High-end
CPU Intel Core i5 or AMD Ryzen 5 Intel Core i7 or AMD Ryzen 7 Intel Core i9 or AMD Ryzen 9
Memory 4 GB RAM 16 GB RAM 64 GB RAM
Disk 500 MB 1 GB 1 GB

Screenshots

You can see more screenshots here