h1-mod/README.md

129 lines
5.9 KiB
Markdown
Raw Permalink Normal View History

# H1-Mod Client
2022-06-02 05:56:36 -04:00
![license](https://img.shields.io/github/license/h1-mod/h1-mod.svg)
[![open bugs](https://img.shields.io/github/issues/h1-mod/h1-mod/bug?label=bugs)](https://github.com/h1-mod/h1-mod/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
[![Build](https://github.com/h1-mod/h1-mod/workflows/Build/badge.svg)](https://github.com/h1-mod/h1-mod/actions)
[![Build status](https://ci.appveyor.com/api/projects/status/0sh80kdnsvm53rno?svg=true)](https://ci.appveyor.com/project/h1-mod/h1-mod)
[![Discord](https://img.shields.io/discord/945420505157083208?color=%237289DA&label=members&logo=discord&logoColor=%23FFFFFF)](https://discord.gg/RzzXu5EVnh)
[![website](https://img.shields.io/badge/Repackers-_Website-blue)](https://rimmyscorner.com/)
2022-02-22 12:53:56 -05:00
2022-02-03 14:36:54 -05:00
<p align="center">
<img src="assets/github/banner-h1.png?raw=true" />
2022-02-03 14:36:54 -05:00
</p>
## Download
Clone the Git repository or download as ZIP.
- <u>**Download Release (EASIEST)**</u>
- Click on `Releases` at the top and navigate to the latest release
- Download `h1-mod.zip`
- If you plan on running a server, download `H1DedicatedConfigs.zip`
- <u>**Download ZIP**</u>
- Click on the three dots at the top of the repo ( `◘◘◘` )
- Click `Download ZIP`
- <u>**Clone the repository:**</u>
- Open a terminal or command prompt.
- Run the following command:
```
git clone https://git.rimmyscorner.com/Rim/h1-mod.git
```
## Installation
1. Place the executable `h1-mod.exe` in your `Call of Duty Modern Warfare Remastered` directory.
> **Note**: Default location is `C:\Program Files (x86)\Steam\steamapps\common\Call of Duty Modern Warfare Remastered`
2. Place the `localappdata\h1-mod` folder into your Local AppData. Place **ONLY** the `h1-mod` folder in, not `localappdata\h1-mod`. Your final path should look like `C:\Users\%USERPROFILE%\AppData\Local\h1-mod\*`
> **Note**: On Windows, press `Win + R`, type `%localappdata%`, click ok. Default location is `C:\Users\%USERPROFILE%\AppData\Local`
3. Launch `h1-mod.exe`.
4. You can change your name by using `/name PLAYERNAME` in-game.
5. If running a server, extract `H1DedicatedConfigs.zip` into your `Call of Duty Modern Warfare Remastered` folder.
## Repository Contents
- H1-Mod Client
- H1-Mod Dedicated Server Configuration Files
- All Necessary Files
## Added Features
- Removed H1-Mod Watermark
- No Auto-Update
- Changed Console Title
## Getting Game Files
- You can torrent the `Call of Duty Modern Warfare Remastered` game files from [here](https://git.rimmyscorner.com/Rim/cod-games-download/releases/download/v1.0.0/h1_full_game.zip).
- The DLC torrent is included.
## Installing Git (Optional)
If you don't have `git` installed on your machine, follow these steps:
1. Visit the [Git download page](https://git-scm.com/downloads).
2. Download the appropriate version for your operating system.
3. Run the installer.
- During the installation, you will be asked if you want to add Git to your system's PATH environment variable. Ensure you choose the option to do so. This allows you to use Git from the command line without specifying its full path.
4. After installation, open a terminal or command prompt and type `git --version` to ensure Git is correctly installed.
## Compile from Source Code
### Prerequisites
- [Visual Studio 2022](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&channel=Release&version=VS2022&source=VSLandingPage&cid=2030&passive=false)
- The required code libraries installed using [VSBuildTools](https://aka.ms/vs/17/release/vs_BuildTools.exe)
### Build
1. Clone the Git repository using `git clone https://git.rimmyscorner.com/Parasyn/h1-mod.git` (It is recommended to clone, however you can `Download ZIP` as all submodules have been localized).
2. Run `generate.bat` to initialize the submodules and build the VS .sln file.
3. Open the project in Visual Studio, change the top drop down lists to `Release`, `x64`. You can also modify (or leave same) the Visual Studio edition/path in the `build.bat` file and build the solution via the batch script.
4. Build the application.
<br>
## Disclaimer
This software has been created purely for the purposes of
academic research. It is not intended to be used to attack
other systems. Project maintainers are not responsible or
liable for misuse of the software. Use responsibly.
## Credits:
- [Dss0](https://github.com/Dss0/t7-server-config) - Dedicated Server Files & Tutorial
- [momo5502](https://github.com/momo5502) - Arxan/Steam research, original developer
## ***End README***
# <u>Legacy README.md</u>
### H1-Mod
2022-06-06 07:35:52 -04:00
A client for Call of Duty: Modern Warfare Remastered.
2022-05-17 22:26:04 -04:00
2022-03-09 19:52:55 -05:00
[This project is based on S1x.](https://github.com/XLabsProject/s1x-client)
2022-02-03 14:36:54 -05:00
### Compile from source
2022-02-03 14:36:54 -05:00
- Clone the Git repo. Do NOT download it as ZIP, that won't work.
2022-03-02 04:29:54 -05:00
- Update the submodules and run `premake5 vs2022` or simply use the delivered `generate.bat`.
2022-02-03 14:36:54 -05:00
- Build via solution file in `build\h1-mod.sln`.
### Premake arguments
| Argument | Description |
|:----------------------------|:-----------------------------------------------|
| `--copy-to=PATH` | Optional, copy the EXE to a custom folder after build, define the path here if wanted. |
| `--dev-build` | Enable development builds of the client. |
### Credits:
2022-02-23 12:53:20 -05:00
2022-03-08 07:36:43 -05:00
- [XLabsProject](https://github.com/XLabsProject) - codebase and iw6x/s1x research
2022-03-02 19:13:34 -05:00
- [quaK](https://github.com/Joelrau) - lots of insight and help
2022-03-02 19:35:23 -05:00
- [fed](https://github.com/fedddddd) - fixed DW/networking, work from [h2-mod](https://github.com/fedddddd/h2-mod)
2022-05-17 11:44:51 -04:00
- [Skull](https://github.com/skkuull) + [mjkzy](https://github.com/mjkzy) - porting code from s1x
2022-06-05 00:03:18 -04:00
- [momo5502](https://github.com/momo5502) - Arxan/Steam research, developer of XLabsProject :D
2022-02-03 14:36:54 -05:00
### Disclaimer
2022-02-03 14:36:54 -05:00
2022-03-02 19:13:34 -05:00
This software has been created purely for the purposes of academic research. It is not intended to be used to attack other systems. Project maintainers are not responsible or liable for misuse of the software. Use responsibly.