QuentinGruber / h1z1-server

Library used to emulate h1z1 game servers
https://h1emu.com
GNU General Public License v3.0
97 stars 56 forks source link
h1z1

h1z1-server npm version GitHub license

Discord

Table of Contents

Description

Based on the work of jseidelin on soe-network, h1z1-server is a library that emulates an H1Z1: Just Survive server.

Motivation

A redditor said : "It's just matter of effort and to have enough people of with interest towards having such private servers to the respected game. I highly doubt that H1Z1 (Just Survive) is one of those."

So we will see :)

Thanks list

Documentations

Setup H1Z1

How to download it

Using our Launcher

Download the latest version of h1emu-launcher

Using our custom implementation of DepotDownloader

Download the latest version of H1DepotDownloader

Using DepotDownloader

Use DepotDownloader ( only work if you've bought h1z1 )

AppID : 295110 DepotID : 295111 ManifestID : 1930886153446950288

How to use DepotDownloader : https://youtu.be/44HBxzC_RTg

cmd : .\DepotDownloader.exe -app 295110 -depot 295111 -manifest 1930886153446950288 -username username -password 1234

H1Z1 Dependencies

Like all games H1Z1 has C/C++ & DirectX dependencies.

You may already have them but just in case

You can download them all here

Setup ClientConfig.ini

On the H1Z1 game folder there is a file name "ClientConfig.ini".

Add sessionid=0 at the beginning of this file.

And change the Server value to the address of your server , probably localhost:PORT

Launch the game

If you have followed the step just above this one, this step is no longer necessary, and you can start the game by double clicking on H1Z1.exe.

Execute this command in CMD/Powershell ( you have to be in your h1z1 game folder ) :

.\H1Z1.exe sessionid=0 server=localhost:1115

Enable Debug log

Since v0.2.3 of h1z1-server the npm package debug is used to make debug logs.

examples :

Demo

Setting up a Development Environment

To set up a simple development environment for working on the H1Z1 server, follow these steps:

  1. Clone the repository:
git clone https://github.com/QuentinGruber/h1z1-server.git
cd h1z1-server
  1. Install the dependencies:
npm install
  1. Start the development server:
npm run start-dev
  1. Make your changes and test them using the provided scripts and commands.

Usage Examples

Example 1: Starting the Server

To start the H1Z1 server, run the following command:

npx -p h1z1-server h1z1-server-demo-2016

Example 2: Connecting to the Server

To connect to the server, launch the H1Z1 game and configure the ClientConfig.ini file as described in the Setup H1Z1 section.

Troubleshooting

Common Issues

Issue 1: Server Not Starting

If the server is not starting, make sure you have installed all the necessary dependencies and followed the setup instructions correctly.

Issue 2: Client Not Connecting

If the client is not connecting to the server, double-check the ClientConfig.ini file and ensure that the server address is correct.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to contribute to this project.

License

This project is licensed under the terms of the GNU General Public License v3.0. See the LICENSE file for details.