1.16.0

.github/workflows/codeql.yml

@@ -26,8 +26,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.26.8'
-
+          go-version: '1.27.1'
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v4
         with:
@@ -48,11 +47,11 @@ jobs:
             "./launcher-config-admin-agent|launcher/bin/config-admin-agent"
             "./battle-server-manager|battle-server-manager/battle-server-manager"
             "./tools/server-replay|tools/server-replay"
-            "./tools/scripts/cmd/copyBattleServerManagerResources.go|tools/scripts/copyBattleServerManagerResources"
-            "./tools/scripts/cmd/copyLauncherResources.go|tools/scripts/copyLauncherResources"
-            "./tools/scripts/cmd/copyServerResources.go|tools/scripts/copyServerResources"
-            "./tools/scripts/cmd/createServerResourcesFolder.go|tools/scripts/createServerResourcesFolder"
-            "./tools/scripts/cmd/generateGoreleaserConfig.go|tools/scripts/generateGoreleaserConfig"
+            "./tools/scripts/cmd/copyBattleServerManagerResources|tools/scripts/copyBattleServerManagerResources"
+            "./tools/scripts/cmd/copyLauncherResources|tools/scripts/copyLauncherResources"
+            "./tools/scripts/cmd/copyServerResources|tools/scripts/copyServerResources"
+            "./tools/scripts/cmd/createServerResourcesFolder|tools/scripts/createServerResourcesFolder"
+            "./tools/scripts/cmd/generateGoreleaserConfig|tools/scripts/generateGoreleaserConfig"
           )
           windows_targets=(
             "./tools/mock/battle-server/main_windows.go|tools/battle-server"

.github/workflows/releaser.yml

@@ -19,14 +19,14 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.26.8'
+          go-version: '1.27.1'
           cache-dependency-path: |
             go.work.sum
       - name: Set up Go legacy
         id: setup_go_legacy
         run: |
           dir="${{ vars.GOROOT_LEGACY }}"
-          version="1.26.8-1"
+          version="1.27.1-1"
           subdir="go-legacy-win7"
           curl -L https://github.com/thongtech/$subdir/releases/download/v$version/$subdir-$version.linux_amd64.tar.gz -o go.tar.gz
           sudo mkdir -p "$dir"
@@ -36,7 +36,7 @@ jobs:
       - name: Generate Goreleaser config
         shell: bash
         run: |
-          go run tools/scripts/cmd/generateGoreleaserConfig.go "${{ steps.setup_go_legacy.outputs.goroot }}"
+          go tool generateGoreleaserConfig "${{ steps.setup_go_legacy.outputs.goroot }}"
       - name: Import GPG key
         id: import_gpg
         uses: crazy-max/ghaction-import-gpg@v7

.gitignore

@@ -1,4 +1,3 @@
-.tools
 .task
 .env
 .idea/
@@ -12,5 +11,10 @@ build/**/*
 !build/battle-server-manager/
 !build/battle-server-manager/.gitkeep
 .goreleaser.yaml
+.tools
 tools/**/go.sum
-go.work.sum
+go.work.sum
+coverage
+cover_routes
+coverage_all
+userData/

DEVELOPMENT.md

@@ -1,7 +1,7 @@
 ### System requirements
 
 - OS requirements correspond to the server/launcher ones. Cross-compilation works on all systems out-the-box.
-- Go 1.26:
+- Go 1.27:
     * Officially from https://go.dev/dl/ if not running Windows or is 10 and higher (or equivalent).
     * Unofficially from either [thongtech/go-legacy-win7](https://github.com/thongtech/go-legacy-win7) or [XTLS/go-win7](https://github.com/XTLS/go-win7) if running Windows
       7-8.X (or equivalent). Regardless if you install the official version, you need to install this one too for
@@ -18,6 +18,24 @@ Copy `.env.example` to `.env` and set:
 * ```GOROOT_LEGACY``` to the legacy go installation path. Required for `task build` and
   `task release`.
 
+### Tools
+
+Helper tools live in `tools/scripts/cmd` (one directory per tool) and are registered as `tool`
+directives in `tools/scripts/go.mod`. There is no manual build step: `go` compiles and caches them
+automatically.
+
+Run any of them from the repository root:
+
+```
+go tool <name> [args]
+```
+
+Available tools: `copyBattleServerManagerResources`, `copyLauncherResources`, `copyServerResources`,
+`createGameMockCA`, `createGameStructure`, `createServerResourcesFolder`, `generateGoreleaserConfig`.
+
+List them with `go list tool`. They are normally invoked through `task`
+(e.g. `task debug:prepare-server` or `task tools:run PROGRAM=createGameMockCA ARGS=age2`).
+
 ### Debug
 
 It is recommended to use an IDE such as [GoLand](https://www.jetbrains.com/go/) (free for academia)
@@ -29,9 +47,9 @@ Depending on the module you want to debug, you will need to run the correspondin
 - server: ```task debug:prepare-server```
     - genCert: ```task debug:prepare-server-genCert```
 - launcher: ```task debug:prepare-launcher```
-    - config: ```task debug:build-config-admin-agent```
-    - config-admin-agent: ```task debug:build-config-admin```
-    - agent: ```task debug:build-config-all```
+    - config: ```task debug:build-config```
+    - config-admin-agent: ```task debug:build-config-admin-agent```
+    - agent: ```task debug:build-launcher-agent```
 - battle-server-manager: ```task debug:prepare-battle-server-manager```
 
 ### Build

README.md

@@ -165,7 +165,7 @@ system and configuration.
 - Solaris-based (Solaris and Illumos).
 - AIX.
 
-Note: For the full list see [minimum requirements for Go](https://go.dev/wiki/MinimumRequirements) 1.26.
+Note: For the full list see [minimum requirements for Go](https://go.dev/wiki/MinimumRequirements) 1.27.
 
 </details>
 

Taskfile.debug.unix.yml

@@ -4,12 +4,9 @@ tasks:
   prepare-launcher:
     platforms: [ linux, darwin ]
     internal: true
-    deps: [ ":build-server" ]
     method: checksum
     cmds:
       - task: prepare-server
-      - task: build-config-helper-amd64
-      - task: build-config-helper-arm64
   prepare-server:
     platforms: [ linux ]
     internal: true
@@ -37,6 +34,7 @@ tasks:
       - config-helper/**/*
     generates:
       - build/launcher/bin/config-helper_{{.GOARCH}}.exe
+      - build/battle-server-manager/bin/config-helper_{{.GOARCH}}.exe
     method: checksum
     cmds:
       - GOOS=windows GOARCH={{.GOARCH}} go build -o build/launcher/bin/config-helper_{{.GOARCH}}.exe ./config-helper

Taskfile.debug.yml

@@ -11,11 +11,15 @@ tasks:
       - build/server/resources/**/*
     method: checksum
     cmds:
-      - task: :tools:run
-        vars: { PROGRAM: 'createServerResourcesFolder' }
       - task: :tools:run
         vars: { PROGRAM: 'copyServerResources' }
   prepare-server:
+    deps:
+      - prepare-server-genCert
+      - build-genCert
+    cmds:
+      - build/server/bin/genCert{{exeExt}} -r
+  ensure-certificate:
     deps:
       - prepare-server-genCert
       - build-genCert
@@ -24,13 +28,14 @@ tasks:
       - server-genCert/**/*
     generates:
       - build/server/bin/genCert{{exeExt}}
+      - build/server/resources/certificates/**/*
     method: checksum
+    vars:
+      ARGS: '{{.ARGS | default ""}}'
     cmds:
-      - build/server/bin/genCert{{exeExt}} -r
+      - build/server/bin/genCert{{exeExt}} -i {{.ARGS}}
   prepare-launcher:
     deps:
-      - build-config-all
-      - prepare-server
       - prepare-battle-server-manager
       - build-server
       - build-launcher-agent
@@ -48,7 +53,7 @@ tasks:
       - task: :tools:run
         vars: { PROGRAM: 'copyLauncherResources' }
   prepare-battle-server-manager:
-    deps: [ prepare-server ]
+    deps: [ ensure-certificate ]
     sources:
       - common/**/*
       - battle-server-manager/**/*
@@ -78,7 +83,7 @@ tasks:
       - build/server/bin/genCert{{exeExt}}
     method: checksum
     cmds:
-      - go build -o build/server/bin/genCert ./server-genCert
+      - go build -o build/server/bin/genCert{{exeExt}} ./server-genCert
   build-battle-server-manager:
     sources:
       - common/**/*
@@ -132,6 +137,6 @@ tasks:
     cmds:
       - go build -o build/launcher/bin/config-admin-agent{{exeExt}} ./launcher-config-admin-agent
   build-config-all:
-    deps: [ build-config, build-config-admin, build-config-admin-agent ]
+    deps: [ build-config, build-config-admin-agent ]
 includes:
   os: ./Taskfile.debug.{{if eq OS "windows"}}other{{else}}unix{{end}}.yml

Taskfile.tools.yml

@@ -3,22 +3,8 @@
 version: '3'
 
 tasks:
-  build:
-    label: "Build {{.PROGRAM}}{{exeExt}}"
-    run: when_changed
-    internal: true
-    sources:
-      - tools/scripts/**/*
-    generates:
-      - .tools/{{.PROGRAM}}{{exeExt}}
-    method: checksum
-    cmds:
-      - go build -o ./.tools/{{.PROGRAM}}{{exeExt}} tools/scripts/cmd/{{.PROGRAM}}.go
   run:
-    deps:
-      - task: build
-        vars: { PROGRAM: '{{.PROGRAM}}' }
     cmds:
-      - ./.tools/{{.PROGRAM}}{{exeExt}} {{.ARGS | default ""}}
+      - go tool {{.PROGRAM}} {{.ARGS | default ""}}
 includes:
   mock: ./Taskfile.tools.mock.yml

Taskfile.yml

@@ -2,13 +2,13 @@
 # vim: set ts=2 sw=2 tw=0 fo=cnqoj
 version: '3'
 
-dotenv: [ '.env', '{{.ENV}}/.env.', '{{.HOME}}/.env' ]
+dotenv: [ '.env', '{{.ENV}}/.env', '{{.HOME}}/.env' ]
 
 tasks:
   build-goreleaser-cfg:
     internal: true
     cmds:
-      - go run tools/scripts/cmd/generateGoreleaserConfig.go "{{ .GOROOT_LEGACY }}"
+      - go tool generateGoreleaserConfig "{{ .GOROOT_LEGACY }}"
   build:
     deps:
       - build-goreleaser-cfg