Merge pull request #1 from themuffinator/copilot/update-nightly-script-and-building

nightly: unique release tags, external renderer libs, docs/fnquake3/ restructure

Author: themuffinator

.github/workflows/nightly.yml

@@ -97,12 +97,9 @@ jobs:
         run: |
           if not exist bin mkdir bin
 
-          make release ARCH=${{ matrix.arch }} USE_SDL=0 USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=vulkan CNAME=fnquake3-vulkan BUILD_SERVER=0
-          copy build\release-mingw32-${{ matrix.arch }}\fnquake3-vulkan*.exe bin\
-
-          make clean ARCH=${{ matrix.arch }}
-          make release ARCH=${{ matrix.arch }} USE_SDL=0 USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=opengl
+          make release ARCH=${{ matrix.arch }} USE_SDL=0 USE_RENDERER_DLOPEN=1 USE_OPENGL=1 USE_VULKAN=1
           copy build\release-mingw32-${{ matrix.arch }}\fnquake3*.exe bin\
+          copy build\release-mingw32-${{ matrix.arch }}\fnquake3*.dll bin\
 
       - uses: actions/upload-artifact@v4
         with:
@@ -125,15 +122,18 @@ jobs:
             platform: ARM64
             suffix: .arm64
             pkg_suffix: arm64
+            rend_arch: arm64
 
           - arch: x86
             platform: Win32
             pkg_suffix: x86
+            rend_arch: x86
 
           - arch: x64
             platform: x64
             suffix: .x64
             pkg_suffix: x86_64
+            rend_arch: x86_64
     steps:
       - uses: microsoft/setup-msbuild@v2
 
@@ -153,15 +153,15 @@ jobs:
           msbuild code\win32\msvc2017\fnquake3-ded.vcxproj -p:TargetName=fnquake3.ded,Configuration=Release,Platform=${{ matrix.platform }} -t:Clean
 
           msbuild code\win32\msvc2017\renderer.vcxproj -p:Configuration=Release,Platform=${{ matrix.platform }} /p:PlatformToolset=v143
-          msbuild code\win32\msvc2017\fnquake3.vcxproj -p:TargetName=fnquake3,Configuration=Release,Platform=${{ matrix.platform }},UseWasapi=USE_WASAPI=0 /p:PlatformToolset=v143
-          copy code\win32\msvc2017\output\fnquake3.exe bin\fnquake3${{ matrix.suffix }}.exe
+          copy code\win32\msvc2017\output\fnquake3_opengl_${{ matrix.rend_arch }}.dll bin\
           msbuild code\win32\msvc2017\renderer.vcxproj -p:Configuration=Release,Platform=${{ matrix.platform }} -t:Clean
-          msbuild code\win32\msvc2017\fnquake3.vcxproj -p:TargetName=fnquake3,Configuration=Release,Platform=${{ matrix.platform }},UseWasapi=USE_WASAPI=0 -t:Clean
 
           msbuild code\win32\msvc2017\renderervk.vcxproj -p:Configuration=Release,Platform=${{ matrix.platform }} /p:PlatformToolset=v143
-          msbuild code\win32\msvc2017\fnquake3.vcxproj -p:TargetName=fnquake3,Configuration=Release,Platform=${{ matrix.platform }},UseWasapi=USE_WASAPI=0 /p:PlatformToolset=v143
-          copy code\win32\msvc2017\output\fnquake3.exe bin\fnquake3-vulkan${{ matrix.suffix }}.exe
+          copy code\win32\msvc2017\output\fnquake3_vulkan_${{ matrix.rend_arch }}.dll bin\
           msbuild code\win32\msvc2017\renderervk.vcxproj -p:Configuration=Release,Platform=${{ matrix.platform }} -t:Clean
+
+          msbuild code\win32\msvc2017\fnquake3.vcxproj -p:TargetName=fnquake3,Configuration=Release,Platform=${{ matrix.platform }},UseWasapi=USE_WASAPI=0 /p:PlatformToolset=v143
+          copy code\win32\msvc2017\output\fnquake3.exe bin\fnquake3${{ matrix.suffix }}.exe
           msbuild code\win32\msvc2017\fnquake3.vcxproj -p:TargetName=fnquake3,Configuration=Release,Platform=${{ matrix.platform }},UseWasapi=USE_WASAPI=0 -t:Clean
 
       - uses: actions/upload-artifact@v4
@@ -209,9 +209,7 @@ jobs:
 
       - name: Build
         run: |
-          make ${{ matrix.rule }} -j$(nproc) ARCH=${{ matrix.arch }} COMPILE_ARCH=${{ matrix.arch }} CC=gcc DESTDIR=bin ${{ matrix.use_sdl }} USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=vulkan CNAME=fnquake3-vulkan BUILD_SERVER=0
-          make clean ARCH=${{ matrix.arch }}
-          make ${{ matrix.rule }} -j$(nproc) ARCH=${{ matrix.arch }} COMPILE_ARCH=${{ matrix.arch }} CC=gcc DESTDIR=bin ${{ matrix.use_sdl }} USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=opengl
+          make ${{ matrix.rule }} -j$(nproc) ARCH=${{ matrix.arch }} COMPILE_ARCH=${{ matrix.arch }} CC=gcc DESTDIR=bin ${{ matrix.use_sdl }} USE_RENDERER_DLOPEN=1 USE_OPENGL=1 USE_VULKAN=1
 
       - uses: actions/upload-artifact@v4
         with:
@@ -241,9 +239,7 @@ jobs:
 
       - name: Build
         run: |
-          make install -j$(nproc) ARCH=aarch64 COMPILE_ARCH=aarch64 CC=gcc DESTDIR=bin USE_SDL=0 USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=vulkan CNAME=fnquake3-vulkan BUILD_SERVER=0
-          make clean ARCH=aarch64
-          make install -j$(nproc) ARCH=aarch64 COMPILE_ARCH=aarch64 CC=gcc DESTDIR=bin USE_SDL=0 USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=opengl
+          make install -j$(nproc) ARCH=aarch64 COMPILE_ARCH=aarch64 CC=gcc DESTDIR=bin USE_SDL=0 USE_RENDERER_DLOPEN=1 USE_OPENGL=1 USE_VULKAN=1
 
       - uses: actions/upload-artifact@v4
         with:
@@ -274,9 +270,7 @@ jobs:
 
       - name: Build
         run: |
-          gmake install -j$(sysctl -n hw.logicalcpu) ARCH=${{ matrix.arch }} CC=clang DESTDIR=bin INSTALL=ginstall USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=vulkan CNAME=fnquake3-vulkan BUILD_SERVER=0 STRIP=echo
-          gmake clean ARCH=${{ matrix.arch }}
-          gmake install -j$(sysctl -n hw.logicalcpu) ARCH=${{ matrix.arch }} CC=clang DESTDIR=bin INSTALL=ginstall USE_RENDERER_DLOPEN=0 RENDERER_DEFAULT=opengl STRIP=echo
+          gmake install -j$(sysctl -n hw.logicalcpu) ARCH=${{ matrix.arch }} CC=clang DESTDIR=bin INSTALL=ginstall USE_RENDERER_DLOPEN=1 USE_OPENGL=1 USE_VULKAN=1 STRIP=echo
 
       - uses: actions/upload-artifact@v4
         with:
@@ -327,12 +321,10 @@ jobs:
             "${FROM_ARGS[@]}" \
             --output .tmp/nightly-release-notes.md
 
-      - name: Recreate nightly release
+      - name: Create nightly release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          gh release delete "${FNQ3_RELEASE_TAG}" --cleanup-tag --yes || true
-          git push origin ":refs/tags/${FNQ3_RELEASE_TAG}" || true
           gh release create "${FNQ3_RELEASE_TAG}" \
             .install/packages/*.zip \
             .install/release-manifest.json \

.install/README.html

@@ -223,7 +223,7 @@ <h1>FnQuake3</h1>
       <div class="buttons">
         <a class="button button-primary" href="../README.md">Project README</a>
         <a class="button button-secondary" href="../BUILD.md">Build Guide</a>
-        <a class="button button-secondary" href="../docs/TECHNICAL.md">Technical Notes</a>
+        <a class="button button-secondary" href="../docs/fnquake3/TECHNICAL.md">Technical Notes</a>
       </div>
       <div class="grid">
         <article class="card">
@@ -269,7 +269,7 @@ <h2>Documentation</h2>
         <li><a href="../BUILD.md">BUILD.md</a> walks through platform-specific build steps.</li>
         <li><a href="../docs/ASPECT_CORRECTION.md">docs/ASPECT_CORRECTION.md</a> explains the HUD, menu, and cinematic presentation options.</li>
         <li><a href="../docs/CONSOLE.md">docs/CONSOLE.md</a> covers console scaling, interaction, completion, and appearance.</li>
-        <li><a href="../docs/TECHNICAL.md">docs/TECHNICAL.md</a> covers repository layout, versioning, and release flow.</li>
+        <li><a href="../docs/fnquake3/TECHNICAL.md">docs/fnquake3/TECHNICAL.md</a> covers repository layout, versioning, and release flow.</li>
         <li><a href="../LICENSE">LICENSE</a> and <a href="../COPYING.txt">COPYING.txt</a> ship with the package.</li>
       </ul>
       <p class="footer">This page is generated from the repository templates so the packaged docs stay aligned with the current build metadata.</p>

AGENTS.md

@@ -16,18 +16,18 @@ FnQuake3 is a modernized Quake III Arena engine branch. Every change should prot
 - Keep release packaging deterministic. `.install/` is the staged distribution area, not a scratchpad.
 - Use `.tmp/` for temporary outputs, investigation notes, and disposable staging work.
 - Do not ship documentation that mixes end-user guidance with maintainer detail. Keep the user surface in `README.md` and deeper material in linked technical docs.
-- When versioning changes are required, update the canonical metadata in [`version/fnq3_version.h`](/e:/Repositories/FnQuake3/version/fnq3_version.h) first.
+- When versioning changes are required, update the canonical metadata in `version/fnq3_version.h` first.
 
 ## Local References
 
-- [`README.md`](/e:/Repositories/FnQuake3/README.md): end-user overview.
-- [`BUILD.md`](/e:/Repositories/FnQuake3/BUILD.md): platform-specific build instructions.
-- [`docs/TECHNICAL.md`](/e:/Repositories/FnQuake3/docs/TECHNICAL.md): maintainer-facing project, release, and repo notes.
-- [`version/fnq3_version.h`](/e:/Repositories/FnQuake3/version/fnq3_version.h): single source of truth for project version metadata.
-- [`scripts/version.py`](/e:/Repositories/FnQuake3/scripts/version.py): version/channel helper for humans and CI.
-- [`scripts/generate_docs.py`](/e:/Repositories/FnQuake3/scripts/generate_docs.py): refreshes `README.md` and `.install/README.html` from templates.
-- [`scripts/release.py`](/e:/Repositories/FnQuake3/scripts/release.py): stages artifacts through `.install/` and produces release archives plus manifests.
-- [`.github/workflows/build.yml`](/e:/Repositories/FnQuake3/.github/workflows/build.yml): CI build, nightly packaging, and tagged release flow.
+- `README.md`: end-user overview.
+- `BUILD.md`: platform-specific build instructions.
+- `docs/fnquake3/TECHNICAL.md`: maintainer-facing project, release, and repo notes.
+- `version/fnq3_version.h`: single source of truth for project version metadata.
+- `scripts/version.py`: version/channel helper for humans and CI.
+- `scripts/generate_docs.py`: refreshes `README.md` and `.install/README.html` from templates.
+- `scripts/release.py`: stages artifacts through `.install/` and produces release archives plus manifests.
+- `.github/workflows/nightly.yml`: nightly packaging and release flow.
 
 ## Directory Map
 
@@ -40,7 +40,7 @@ FnQuake3 is a modernized Quake III Arena engine branch. Every change should prot
 
 ## Release Workflow
 
-1. Update [`version/fnq3_version.h`](/e:/Repositories/FnQuake3/version/fnq3_version.h) for the next tagged release.
+1. Update `version/fnq3_version.h` for the next tagged release.
 2. Run `python scripts/generate_docs.py` to refresh user-facing docs.
 3. Build platform artifacts.
 4. Run `python scripts/release.py --channel nightly` or `python scripts/release.py --channel release --ref-name <tag>` against the downloaded artifact directory.
@@ -50,4 +50,4 @@ FnQuake3 is a modernized Quake III Arena engine branch. Every change should prot
 
 - If a change touches runtime identity strings, keep compatibility-sensitive behavior unchanged unless the user explicitly wants a compatibility break.
 - If you have to choose between a cleaner abstraction and a safer compatibility-preserving patch, default to the compatibility-preserving patch and document the tradeoff.
-- When release packaging changes, ensure `.install/README.html` remains valid and the package still includes `README.md`, `BUILD.md`, `LICENSE`, and `docs/TECHNICAL.md`.
+- When release packaging changes, ensure `.install/README.html` remains valid and the package still includes `LICENSE` and `docs/fnquake3/TECHNICAL.md`.

README.md

@@ -6,7 +6,7 @@ Fappin' Quake III, shortened to FnQuake3 or FnQ3.
 
 <p>
   <a href="BUILD.md"><img alt="Build Guide" src="https://img.shields.io/badge/Build-Guide-1f2937?style=for-the-badge"></a>
-  <a href="docs/TECHNICAL.md"><img alt="Technical Notes" src="https://img.shields.io/badge/Technical-Notes-0f766e?style=for-the-badge"></a>
+  <a href="docs/fnquake3/TECHNICAL.md"><img alt="Technical Notes" src="https://img.shields.io/badge/Technical-Notes-0f766e?style=for-the-badge"></a>
   <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-GPL--2.0-c2410c?style=for-the-badge"></a>
 </p>
 
@@ -53,7 +53,7 @@ FnQuake3 is a modernized Quake III Arena engine project built around a simple go
 - [Visuals Guide](docs/VISUALS.md) for player highlighting and the current visual presentation controls.
 - [Aspect Correction Guide](docs/ASPECT_CORRECTION.md) for HUD, menu, and cinematic presentation options.
 - [Console Guide](docs/CONSOLE.md) for console scaling, interaction, completion, and appearance.
-- [Technical Notes](docs/TECHNICAL.md) for maintainers, release flow, and repo conventions.
+- [Technical Notes](docs/fnquake3/TECHNICAL.md) for maintainers, release flow, and repo conventions.
 - [Agent Guide](AGENTS.md) for automation rules and local repository references.
 
 ## Project Priorities