| description |
|---|
also Formally known as project "Lorule" |
Welcome to Hades, A Dark Ages inspired project.
For Server Developers, Please see the Getting Started Developer Guide
Depending on what you want to do, develop for Hades or simply run and host a game using Hades as an end user, Before you can do either, You will need to install some stuff first.
so before you start, see the table below and see what actions require what, and be sure you have everything you need before going any further. if you are not sure what to install from the table below then i suggest you install and download everything that way you won't run into any problems later.
| Action | Prerequisite | References / URL |
|---|---|---|
| Build and Compile Hades | Visual Studio 2019 | Download |
| Build and Compile Hades | .NET 5.0.1 SDK | Download |
| Running the Server | .NET 5.0.1 Runtime | Download |
| Hades Client | .NET Framework 4.7.2 Developer pack | Download |
| Hades World Editor | .NET Framework 4.7.2 Developer pack | Download |
| Action | Prerequisite | Reference / URL |
|---|---|---|
| Writing Server Scripts | VS Code | Download |
| Writing Game Content | Text Editor | Download |
You will also need to download a client. Download the game client
- Download and Install Hades Download (Release)
- Download both database.zip And Lorule.GameServer.zip from the project's GitHub Page here.
- Install all Prerequisites in the table above, for "Running the Server"
- Extract all contents of database.zip and Lorule.GameServer.zip somewhere on your computer that will be the host computer (most likely this will be the computer you are using now)
- navigate to where you extracted the Lorule.GameServer.zip archive and browse the folder and find the configuration file. it is called
LoruleConfig.json - Open the configuration file in some type of text editor, i recommend Notepad++ Download if you have not got a handy text editor yet. Notepad shipped with windows will do, but we all know it's garbage!
- Modify the
LoruleConfig.jsonfile with the path's inside thelocalessection. below is a part of the configuration file that you must edit correctly. and when editing this file. you must use double slashes for path\\separators. do not use any single\backslash in this configuration file for any paths. - Modify the configuration file inside the Locales section, you will see two properties and i will explain each in the next section below.
"Content" Section
Configuration - "Editor" Section
- Navigate to the folder
- Double click on the file
- The game server should now be started. if you are prompted by windows firewall, click allow.
- You should now see a running console and it should look like this (as shown below)
So you should be up and running now with the game server and you now you probably want to connect to your running server, to achieve this, you should need to use a client. so let's start with what you will need.
You will need a supported Client to connect to the Game Server.
Below you can download the client is 6 parts, Alternatively if you rather, you can download the entire thing
that is available here (google drive)
once the client is installed, and extracted to your computer. You should be able to see the following contents inside (as shown below)
The Hades.exe client has been hard-coded and it will allow you to
connect to localhost also known as 127.0.0.1
if when you setup the IP Address in the LoruleConfig.json file, if you have modified it to not use 127.0.0.1 and instead used your public IP Address, then it should work with both, but if it does not connect, then i assume you have NOT or incorrect setup NAT forwarding.
if you have not setup NAT forwarding, then it's best to set the IPAddress in the config file to 127.0.0.1
until you have done so**.**
- First, open the windows
cmdterminal and type/ipconfig - look for the active
ethadapter in use. an example of what mine looks like below is show below
- Find the correct
IPv4Address, this will be important, as you can see above. Mine is 192.168.1.110 so whatever yours is, is going to be your INTERNAL IP when setting up NAT forwarding. - open a browser and connect to your default gateway Address, as above mine is 192.168.1.1 (yours will likely be different)
- Look for a section called NAT Forwarding, or Port Fowarding or Virtual Servers, the terminology will be different from device to device, so you will have to work this out yourself from here, but somewhere in there will be a place with a similar looking table like the one shown below
- Add in your IPv4 Address you found using
/ipconfig - Set External and Internal Ports to 2610 - 2615
- Set the Protocol to TCP or both TCP or UPD if that's the only option in there.
- type into google "what is my ip" and update the LoruleConfig.json and set the IPAddress to your IP Address that google tells you. (Your Public IP Address)
- you should not have the router setup to allow you to connect to yourself, from your Public IP, others to connect to you, and vise versa.
- if you have trouble setting this up, Feel free to seek help on the project discord
Hades - A Dark Ages Server & Client Project Copyright (C) 2020
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
- Darkages, Dark Ages and all associated logos and designs are trademarks or registered trademarks of Kru Interactive, NEXON America Inc, NEXON Co. Ltd.
- All other trademarks are the property of their respective owners. This project is not affiliated with Kru Interactive, NEXON Co. Ltd, NEXON America Inc or any of their family of sites.