From c3bd4eb6d0b7791ffc368a311da11b4563abba23 Mon Sep 17 00:00:00 2001
From: Lachee <lachlan.h@hotmail.com>
Date: Mon, 22 Sep 2025 13:44:40 +1000
Subject: [PATCH] Updated Readme

---
 README.md | 34 +++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 153ac44..b7bb9bc 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,23 @@
-# Unity Docker Images
+# Unity Runners for Gitea
 
+Gitea [Act Runner]() images with Unity3D installed and additional modules for packaging, building, and testing your Unity3D projects and games.
+
+Built on the work done by [GameCI](https://game.ci/docs/docker/docker-images/), these images are designed to run your build scripts directly in the container.
+
+## Why?
+The [`game-ci/unity-builder`](https://game.ci/docs/github/builder) action builds your project inside a Docker container. However with the way Gitea works, this causes issues as you end up with docker-in-docker containers which are not entirely stable, have issues with caching, and annoying to manage with files.
+
+Using this image, you are directly able to launch your runner scripts inside the same container that Unity is in. 
+
+> [!TIP]
+> You can use either the `jobs.<name>.container.image` to override the job's current container image, or you can directly add a label to your runner such as:
+> ```yaml
+>   - unity-6000.0.35f1-android:docker://lachee/unity-runner:6000.0.35f1-android-runner
+>   - unity-6000.0.35f1-webgl:docker://lachee/unity-runner:6000.0.35f1-webgl-runner
+> ```
+> There is a included script that will automate your labels as a cron job.
+
+## Images
 A table of available Docker images for Unity CI/CD:
 
 <!-- table -->
@@ -8,8 +26,8 @@ A table of available Docker images for Unity CI/CD:
 |6000.0.35f1|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-runner)<br>📦 15.66 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-android-runner)<br>📦 12.02 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-ios-runner)<br>📦 10.47 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-linux-il2cpp-runner)<br>📦 10.37 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-mac-mono-runner)<br>📦 10.70 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-webgl-runner)<br>📦 11.60 GB|[🐳 View](https://docker.lakes.house/repo/unityci/editor/tag/ubuntu-6000.0.35f1-windows-mono-runner)<br>📦 11.07 GB|
 <!-- /table -->
 
-# Included Software
-**Tools**
+## Included Software
+### Tools
 - Unity3D (as `unity-editor`)
 - Blender `3.4`
 - CMake
@@ -19,22 +37,24 @@ A table of available Docker images for Unity CI/CD:
 - Make
 - Zip & Unzip
 
-**Language and Runtime**
+### Language and Runtime
 - Bash `5.1.16(1)-release`
 - Node.js `20.19.5`
 - Python3 `3.10.12`
 - lib-sqlite3
 - libssl
 
-**Package Management**
+### Package Management
 - NPM `11.6.0`
 - PNPM `10.17.0`
 - pip3 `22.0.2`
 
 
-**SDKs**
+### SDKs
 - AWS CLI
 - Azure SDK
 
-# Usage
+## How
+...
+TODO
 ...
\ No newline at end of file