-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
61 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,63 @@ | ||
[](https://hub.docker.com/r/wopox1337/hlds) | ||
[](https://hub.docker.com/r/wopox1337/hlds) | ||
[](https://github.com/hlds-docker/hlds/actions/workflows/CI.yml) | ||
[](https://app.codacy.com/gh/hlds-docker/hlds/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) | ||
[](https://github.com/hldsdocker/hlds/actions/workflows/CI.yml) | ||
[](https://app.codacy.com/gh/hldsdocker/hlds/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) | ||
|
||
<img src="https://raw.githubusercontent.com/docker-library/docs/c350af05d3fac7b5c3f6327ac82fe4d990d8729c/docker/logo.png" alt="Docker logo" width=200px><img src="https://camo.githubusercontent.com/09985a1c32a1b82696b28766ab6f05d0d28df0139b5d9ee2a88c740c3d9cc21b/68747470733a2f2f7669676e657474652e77696b69612e6e6f636f6f6b69652e6e65742f68616c662d6c6966652f696d616765732f642f64632f4c616d6264615f6c6f676f2e7376672f7265766973696f6e2f6c61746573742f7363616c652d746f2d77696474682d646f776e2f3235303f63623d323031303033323731373435343626706174682d7072656669783d656e" alt="Half-Life logo" width=200> | ||
<p align="center"> | ||
<img src="https://avatars.githubusercontent.com/u/165314416" alt="Half-Life Docker logo" width=200> | ||
</p> | ||
|
||
This Docker image contains the dedicated server of the Half-Life game. | ||
## About | ||
Automated builder of Docker images for Half-Life Dedicated Server (HLDS). | ||
|
||
[DepotsDownloader](https://github.com/SteamRE/DepotDownloader/) is used to download HLDS. It has advantages over [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD), has a minimum of dependencies, [easy installation](https://github.com/hldsdocker/hlds/blob/67b4583a400a210b87198b923be6c6fa128bc0d4/Dockerfile#L23-L26), doesn't have the [issues](https://developer.valvesoftware.com/wiki/SteamCMD#Only_the_HLDS_Engine_is_Downloaded) that SteamCMD users are experiencing. | ||
|
||
The base image is [Debian](https://hub.docker.com/_/debian). | ||
|
||
### Images | ||
| Image | Tags | Pulls | Image size | | ||
| - | - | - | - | | ||
| HLDS valve | [`public`, `steam_legacy`](https://hub.docker.com/r/hldsdocker/valve/tags) | [](https://hub.docker.com/r/hldsdocker/valve) | [](https://hub.docker.com/r/hldsdocker/valve) | | ||
| HLDS cstrike | [`public`, `steam_legacy`](https://hub.docker.com/r/hldsdocker/cstrike/tags) | [](https://hub.docker.com/r/hldsdocker/cstrike) | [](https://hub.docker.com/r/hldsdocker/cstrike) | | ||
|
||
### Tags | ||
| Name | Description | | ||
| - | - | | ||
| `public` | Latest depots update | | ||
| `steam_legacy` | Pre-25th Anniversary Build | | ||
|
||
### How it works | ||
At [00:00 on Sunday](https://github.com/hldsdocker/hlds/blob/67b4583a400a210b87198b923be6c6fa128bc0d4/.github/workflows/CI.yml#L12C3-L13C24) using [GitHub Actions](https://github.com/hldsdocker/hlds/actions), all images are automatically [rebuilt and published](https://github.com/hldsdocker/hlds/blob/67b4583a400a210b87198b923be6c6fa128bc0d4/.github/workflows/CI.yml#L54-L66) to Docker Hub (https://hub.docker.com/u/hldsdocker). | ||
|
||
The description for Docker Hub repositories (of each mod) is dynamically generated [using CI](.github\workflows\dockerhub-description.yml) from the [template](.github/.teamplate-README.md). | ||
|
||
## Technical Definitions | ||
### Depots | ||
A depot is a logical grouping of files which are all delivered to a customer as a single group. | ||
|
||
| Content files | URL | | ||
| - | - | | ||
| Base Goldsrc Shared Content | https://steamdb.info/depot/1/ | | ||
| Counter-Strike Base Content | https://steamdb.info/depot/11/ | | ||
| Condition Zero Base Content | https://steamdb.info/depot/81/ | | ||
|
||
[Read more about depots](https://partner.steamgames.com/doc/store/application/depots) in Steamworks documentation. | ||
|
||
### Branches | ||
An application can have multiple branches. Other than the "public" branch, there can be other branches. Other branches are often used for storing an older version of the game for people to downgrade to, or for testing new patches/content. These can often be found in the "Betas" tab in the app's properties in the Steam client. Some branches might require a password, and they won't be visible in the drop-down list until the correct password is entered. | ||
|
||
A list of possible branches and depots can be found here: | ||
| Game | Depots link | | ||
| - | - | | ||
| valve | https://steamdb.info/app/70/depots/ | | ||
| cstrike | https://steamdb.info/app/10/depots/ | | ||
| сzero | https://steamdb.info/app/80/depots/ | | ||
|
||
|
||
[Read more about branches](https://partner.steamgames.com/doc/store/application/branches) in Steamworks documentation. | ||
|
||
## Secrets for GitHub Actions | ||
| Key | Description | | ||
| - | - | | ||
| `DOCKER_USERNAME` | DockerHub user account | | ||
| `DOCKER_PASSWORD` | DockerHub user password | | ||
|
||
[Read more about secrets in GitHub Actions](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions) |