136 lines
5.1 KiB
Markdown
136 lines
5.1 KiB
Markdown
|
|
|
|
|
|
|
|
# DiIiS Project
|
|
|
|
DiIiS is a fully-functional open-source local server for [Diablo III: Reaper of Souls](https://eu.diablo3.blizzard.com).
|
|
|
|
## Features
|
|
|
|
- Implemented account creation system, authorization and lobby.
|
|
- Implemented Necromancer class mechanics.
|
|
- Fully implemented chat system and friends.
|
|
- Fully implemented clan system.
|
|
- Implemented basic DRLG (dungeon generator).
|
|
- Implemented item generator with in-game affixes.
|
|
- Implemented the basic mechanics of almost all active abilities for all classes.
|
|
- Implemented a system of set items.
|
|
- Implemented all main scripts for all story quests 5 acts.
|
|
- Implemented basic scripts and generator for "Adventure Mode".
|
|
- Implemented the basis for the "Challenge Nephalem Rifts" mode.
|
|
- Implemented artificial intelligence for 80% of minions.
|
|
- Implemented personal artificial intelligence for 40% of all monsters.
|
|
- Implemented personal artificial intelligence for half of the Bosses.
|
|
- Implemented LAN
|
|
|
|
## Restrictions
|
|
|
|
- Donate Store implementation is removed.
|
|
|
|
# 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](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads).
|
|
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](https://docs.docker.com/get-docker/)
|
|
2. Run `docker-compose up` inside [db](db) folder.
|
|
|
|
### Compile and run
|
|
1. Install [.NET 7 SDK and runtime](https://dotnet.microsoft.com/en-us/download/dotnet/7.0) (just runtime, not asp.net or desktop)
|
|
2. Go to the repo directory and compile the project using this command:
|
|
```shell
|
|
dotnet publish ./src/DiIiS-NA/Blizzless.csproj --configuration Release --output ./publish
|
|
```
|
|
3. __Skip this stage for local game__ Copy the [config.ini](https://github.com/blizzless/blizzless-diiis/blob/community/src/DiIiS-NA/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`
|
|
|
|
## Prepare Client
|
|
|
|
Do this for each client connecting to the server.
|
|
|
|
1. Get [supported client](#supported-clients) Diablo 3.
|
|
|
|
2. Install certificate [bnetserver.p12](src/DiIiS-NA/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**
|
|
|
|
```c
|
|
// 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](docs/game-world-settings.md).
|
|
|
|
## 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](docs/commands-list.md).
|
|
|
|
# Issues
|
|
|
|
Check the [report form](docs/report-form.md) 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](SCREENSHOTS.md)
|
|
|
|
|
|
|