====== Information ======

  * Void Client ((https://github.com/GregHib/void-client))

===== Prerequisites =====

  * [[windows:10|Windows 10 (21H2)]]
  * [[programs;windows;git|Git]]
  * [[servers;windows;games;void_localhost|Void]]

====== Dependencies ======

===== Java =====

==== 17 ====

  * https://learn.microsoft.com/en-us/java/openjdk/overview

  * https://aka.ms/download-jdk/microsoft-jdk-17-windows-x64.msi
  * Last tested: ''microsoft-jdk-17.0.18-windows-x64.msi''

  * :!: All secondary features manually-marked unavailable

=== 32-bit ===

  * https://adoptium.net/temurin
  * OpenGL/DirectX renderers require 32-bit JVM ([[https://github.com/GregHib/void/discussions/927|#927]])

  MKDIR "%UserProfile%\Projects\Void-Client\ext" & DEL /Q "%Temp%\OpenJDK17U-jre_x86-32_windows_hotspot.zip" & RMDIR /S /Q "%UserProfile%\Projects\Void-Client\ext\jre-17" & MKDIR "%UserProfile%\Projects\Void-Client\ext\jre-17" && "%SystemRoot%\System32\curl.exe" --output "%Temp%\OpenJDK17U-jre_x86-32_windows_hotspot.zip" --location "https://api.adoptium.net/v3/binary/latest/17/ga/windows/x32/jre/hotspot/normal/eclipse" --progress-bar && "%SystemRoot%\System32\tar.exe" -xvf "%Temp%\OpenJDK17U-jre_x86-32_windows_hotspot.zip" --strip-components="1" -C "%UserProfile%\Projects\Void-Client\ext\jre-17" "jdk-17*/*" && DEL /Q "%Temp%\OpenJDK17U-jre_x86-32_windows_hotspot.zip" & "%UserProfile%\Projects\Void-Client\ext\jre-17\bin\java.exe" -version

====== Download Source ======

  * https://github.com/GregHib/void-client/commits/main/

  "%ProgramFiles%\Git\bin\git.exe" clone --branch "main" --depth "1" --recurse-submodules "https://github.com/GregHib/void-client.git" "%UserProfile%\Projects\Void-Client\src"

====== Build ======

  CD "%UserProfile%\Projects\Void-Client\src" & SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.18.8-hotspot" && "%UserProfile%\Projects\Void-Client\src\gradlew.bat" "clean" --no-daemon && SET "JAVA_HOME="

  CD "%UserProfile%\Projects\Void-Client\src" & SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.18.8-hotspot" && "%UserProfile%\Projects\Void-Client\src\gradlew.bat" "classes" --no-daemon && SET "JAVA_HOME="

====== Scripts ======

  MKDIR "%UserProfile%\Projects\Void-Client\scripts"

  "%SystemRoot%\explorer.exe" "%UserProfile%\Projects\Void-Client\scripts"

===== Client Start =====

  "%SystemRoot%\System32\notepad.exe" "%UserProfile%\Projects\Void-Client\scripts\client-start.bat"

<code>
@echo off

CD "%Temp%"

START "" /D "%Temp%" "%UserProfile%\Projects\Void-Client\ext\jre-17\bin\javaw.exe" -XX:"+UseSerialGC" -cp "%UserProfile%\Projects\Void-Client\src\libs\clientlibs.jar";"%UserProfile%\Projects\Void-Client\src\client\resources";"%UserProfile%\Projects\Void-Client\src\client\build\classes\java\main" "Loader" --address "127.0.0.1"

:: End</code>

  "%UserProfile%\Projects\Void-Client\scripts\client-start.bat"

===== Client Update =====

  "%SystemRoot%\System32\notepad.exe" "%UserProfile%\Projects\Void-Client\scripts\client-update.bat"

<code>
@echo off

TITLE Void Client Updater
CD "%Temp%"

"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\Void-Client\src" reset --hard "origin/main"
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\Void-Client\src" pull origin "main" --rebase

CD "%UserProfile%\Projects\Void-Client\src"

SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.18.8-hotspot"

CALL "%UserProfile%\Projects\Void-Client\src\gradlew.bat" "clean" --no-daemon
CALL "%UserProfile%\Projects\Void-Client\src\gradlew.bat" "classes" --no-daemon

SET "JAVA_HOME="
CD "%Temp%"

RMDIR /S /Q "%SystemRoot%\.jagex_cache_32"

"%SystemRoot%\System32\timeout.exe" /T "2"
"%SystemRoot%\System32\msg.exe" %USERNAME% /TIME:"2" "Void Client update complete"

:: End</code>

  "%UserProfile%\Projects\Void-Client\scripts\client-update.bat"

====== Extras ======

===== Icon =====

==== GIMP ====

  * Convert source ''icon-256.png'' to ''icon-256.ico''
  * Expects [[windows:10#gimp|GIMP]]
  * ''Ctrl-Shift-E'' (Export As)
  * 32 bpp, 8-bit alpha, no palette
  * ''[x]'' Compressed (PNG)

  MKDIR "%UserProfile%\Projects\Void-Client\ext"

  "%LocalAppData%\Programs\GIMP 3\bin\gimp-3.exe" "%UserProfile%\Projects\Void-Client\src\client\resources\icon-256.png"

<code>..\..\..\ext\icon-256.ico</code>

===== Firewall =====

==== Block ====

  * [[#section17|32-bit javaw.exe]]

  "%SystemRoot%\System32\netsh.exe" advfirewall firewall add rule name="Void Client (javaw.exe)" dir="in" action="block" profile="any" program="%UserProfile%\Projects\Void-Client\ext\jre-17\bin\javaw.exe" & "%SystemRoot%\System32\netsh.exe" advfirewall firewall add rule name="Void Client (javaw.exe)" dir="out" action="block" profile="any" program="%UserProfile%\Projects\Void-Client\ext\jre-17\bin\javaw.exe"

=== Delete Rule ===

****

  "%SystemRoot%\System32\netsh.exe" advfirewall firewall delete rule name="Void Client (javaw.exe)"

====== Launcher Shortcuts ======

===== Desktop =====

==== Client ====

  "%UserProfile%\Projects\Void-Client\scripts\client-start.bat"

  Void

=== Icon ===

****

  "%UserProfile%\Projects\Void-Client\ext\icon-256.ico"

===== Start Menu =====

****

  MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\Void" & "%SystemRoot%\explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\Void"

==== Client ====

  "%UserProfile%\Projects\Void-Client\scripts\client-start.bat"

  Void (localhost)

=== Icon ===

****

  "%UserProfile%\Projects\Void-Client\ext\icon-256.ico"

==== Update ====

  "%UserProfile%\Projects\Void-Client\scripts\client-update.bat"

  Client Updater

==== Install Notes ====

  "https://wiki.realmofespionage.xyz/games;windows;void_runescape_634"

  Install Notes (Client)