add readme and license

This commit is contained in:
2025-09-08 14:45:29 -05:00
parent 66ecf72f17
commit 9bd6747045
2 changed files with 71 additions and 0 deletions

55
README.md Normal file
View File

@@ -0,0 +1,55 @@
## Core Keeper Server
Very simple Docker image for conveniently running your own Core Keeper dedicated server. Uses [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) so it can get a little greedy with ram sometimes.
## How to use
1. [Install Docker](https://docs.docker.com/engine/install/)
2. Clone this repo to a convenient location
3. Enter the repo directory and create a worlds folder
```console
$ cd ck-server && mkdir worlds
```
4. Run the launch script to build the image locally and launch the container:
```console
$ ./docker-run.sh
```
OR you can run this command to skip the build:
```console
$ docker run -d --restart always -v $PWD/worlds:/root/.config/unity3d/Pugstorm/'Core Keeper'/DedicatedServer/worlds --name corekeeper git.crate.zip/crate/ck-server:latest
```
5. Run `docker logs corekeeper | grep GameID` to get the Game ID for your server (so you can join it). It will look something like this:
```console
$ docker logs corekeeper | grep GameID
No GameID found. Creating new GameID for the session.
GameID: wB4k6ZCB3Wrc41Q
```
The server might take a minute to start up on first run, as it pulls down some dependencies. Afterwards it should be pretty quick. As far as I know it will always use the same Game ID after the first launch -- so you don't have to check it every time.
## Quick Launch
If you want to keep things really simple, you can launch a server with this command:
```console
$ docker run -d --name corekeeper git.crate.zip/crate/ck-server:latest
```
However, **you will not be able to recover your save** once the container is removed, unless you dive into its volume and dig the file out.
## Using your own save
Drop the `0.world.gzip` file from your local save into the `worlds/` folder before you launch the server to use it. In the same way, you can take this file generated by the server and use it locally.
ALWAYS BACK UP YOUR SAVE FILES BEFORE MESSING AROUND WITH THEM!!
If you mess something up it's not my fault :)
Happy gaming!!