v0.7.0

CHANGES SINCE v0.6.0

• Widescreen: Settings > Graphics > Aspect ratio > Expand (widescreen) draws the rink as wide as the
  window (16:9, 21:9 or wider). Players near the sides stay visible, and the off-screen player arrows
  only appear for players outside the wide view.
• Menus and the HUD stay 4:3 in the middle of the screen. At very wide ratios, the corners of the
  arena can show black at the far sides where the game has no scenery.

W.G. 3D Hockey: Recompiled v0.7.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and choose Choose ROM... in the launcher (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, run wg3d.exe and pick Start game.

SETTINGS MENU
Esc, or a controller's Back (View) button, opens the settings menu over the paused game. Settings
in the launcher opens the same menu. Tabs: General, Controls, Graphics, Sound.
Up/down picks a setting, left/right changes it, Enter (A) selects, Esc (B) goes back,
Q/E (LB/RB) switches tabs. The mouse works too. Changes apply at once and are saved.
Controls > Bindings: choose a slot, press Enter (A), then press the key or controller input to use;
Del (X) clears a slot.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
All of this can be changed in the settings menu (Controls) or in controls.json (below).
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak (all four by default),
pause_when_unfocused (true/false)
controls.json keyboard_port (1-4, 0 = off), deadzone (percent), pads (per port, part of a controller's
name to put on that port), and the keyboard and gamepad bindings: up to two keys or
controller inputs per N64 button and stick direction, e.g. "A": ["X", "Space"] or
"Z": ["lefttrigger"] (controller inputs: a b x y start leftshoulder rightshoulder dpup
dpdown dpleft dpright leftstick rightstick, lefttrigger righttrigger, leftx- leftx+
lefty- lefty+ rightx- rightx+ righty- righty+)
sound.json master_volume (0-100), mute_when_unfocused (true/false)
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. The settings menu edits them; to edit them by hand, close the
game first.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• High frame rate is not supported yet.
• Widescreen (Settings > Graphics > Aspect ratio > Expand) widens the rink only; menus and the HUD stay
  4:3 in the middle, and at very wide ratios the corners of the arena can show black where the game
  has no scenery.

LICENSE
GPL-3.0 (LICENSE.txt). wg3d.exe contains this project's code (GPL-3.0), N64ModernRuntime (GPL-3.0) and
other open-source libraries; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.7.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.6.0

CHANGES SINCE v0.5.0

• A launcher: Start game, Choose ROM..., Settings and Quit, with the ROM's status. It replaces the
  first-run message boxes.
• A settings menu: press Esc, or a controller's Back (View) button, in game. It opens over the paused
  game and has General, Controls, Graphics and Sound tabs. Every setting in the JSON files can be changed
  there, including rebinding keys and controller inputs. Changes apply at once and are saved.
• The menus work with a keyboard, a controller or the mouse. Button hints match the device you used
  last: keyboard, Xbox, PlayStation or Nintendo layout.
• New option: pause the game while its window isn't in front (General > Pause when unfocused).

W.G. 3D Hockey: Recompiled v0.6.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and choose Choose ROM... in the launcher (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, run wg3d.exe and pick Start game.

SETTINGS MENU
Esc, or a controller's Back (View) button, opens the settings menu over the paused game. Settings
in the launcher opens the same menu. Tabs: General, Controls, Graphics, Sound.
Up/down picks a setting, left/right changes it, Enter (A) selects, Esc (B) goes back,
Q/E (LB/RB) switches tabs. The mouse works too. Changes apply at once and are saved.
Controls > Bindings: choose a slot, press Enter (A), then press the key or controller input to use;
Del (X) clears a slot.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
All of this can be changed in the settings menu (Controls) or in controls.json (below).
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak (all four by default),
pause_when_unfocused (true/false)
controls.json keyboard_port (1-4, 0 = off), deadzone (percent), pads (per port, part of a controller's
name to put on that port), and the keyboard and gamepad bindings: up to two keys or
controller inputs per N64 button and stick direction, e.g. "A": ["X", "Space"] or
"Z": ["lefttrigger"] (controller inputs: a b x y start leftshoulder rightshoulder dpup
dpdown dpleft dpright leftstick rightstick, lefttrigger righttrigger, leftx- leftx+
lefty- lefty+ rightx- rightx+ righty- righty+)
sound.json master_volume (0-100), mute_when_unfocused (true/false)
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. The settings menu edits them; to edit them by hand, close the
game first.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• Widescreen and high frame rate are not supported yet.

LICENSE
GPL-3.0 (LICENSE.txt). wg3d.exe contains this project's code (GPL-3.0), N64ModernRuntime (GPL-3.0) and
other open-source libraries; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.6.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.5.0

CHANGES SINCE v0.4.0

• Remappable controls: controls.json lets you bind up to two keys and two gamepad inputs to each N64
  button and stick direction, move the keyboard to another port (or turn it off), set the stick deadzone,
  and put a particular controller on a particular port. It's created with the old layout on first run.
• Sound settings: sound.json has a master volume and an option to mute the game while its window isn't
  in front.
• New installs get a Controller Pak in every port (existing general.json files keep their values).

W.G. 3D Hockey: Recompiled v0.5.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and pick your ROM in the file dialog (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, just run wg3d.exe.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
All of this can be changed in controls.json (below).
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak (all four by default)
controls.json keyboard_port (1-4, 0 = off), deadzone (percent), pads (per port, part of a controller's
name to put on that port), and the keyboard and gamepad bindings: up to two keys or
controller inputs per N64 button and stick direction, e.g. "A": ["X", "Space"] or
"Z": ["lefttrigger"] (controller inputs: a b x y start leftshoulder rightshoulder dpup
dpdown dpleft dpright leftstick rightstick, lefttrigger righttrigger, leftx- leftx+
lefty- lefty+ rightx- rightx+ righty- righty+)
sound.json master_volume (0-100), mute_when_unfocused (true/false)
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. Edit them while the game is closed.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• No in-game settings menu or control remapping yet.
• Widescreen and high frame rate are not supported yet.

LICENSE
GPL-3.0 (LICENSE.txt). wg3d.exe contains this project's code (GPL-3.0), N64ModernRuntime (GPL-3.0) and
other open-source libraries; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.5.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.4.0

CHANGES SINCE v0.3.0

• Correctness pass: every game mode and system was checked (menus, exhibition, seasons, playoffs and both
  Stanley Cup endings, overtime, penalties, fights, passwords, initials, Controller Pak saves), most of it
  against the ares emulator. The checklist is docs/correctness.md in the repository.
• Fixed: with a full Controller Pak (16 notes), starting a pak season overwrote the pak's first note, which
  could be another game's save. The game now says the pak is full and lets you delete notes.
• Fixed: closing the game could occasionally crash and leave a crash report.
• Bug reports: the GitHub issue form asks for wg3d.log and any crash report.

W.G. 3D Hockey: Recompiled v0.4.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and pick your ROM in the file dialog (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, just run wg3d.exe.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. Edit them while the game is closed.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• No in-game settings menu or control remapping yet.
• Widescreen and high frame rate are not supported yet.

LICENSE
GPL-3.0 (LICENSE.txt). wg3d.exe contains this project's code (GPL-3.0), N64ModernRuntime (GPL-3.0) and
other open-source libraries; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.4.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.3.0

CHANGES SINCE v0.2.0

• License: this project's own code is now GPL-3.0-only (it was MIT up to v0.2.0). The release files
  (README.txt, LICENSE.txt, THIRD-PARTY-NOTICES.txt) say so.
• No gameplay changes.
• Development: CMake applies the runtime patches (patches/runtime/) when it configures, so a fresh clone
  builds without manual steps; tools/package_release.py builds this zip; the verify scripts are now
  tools/verify_recompile.py and tools/verify_boot.py; docs/ROADMAP.md lays out the plan to v1.0.0.

W.G. 3D Hockey: Recompiled v0.3.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and pick your ROM in the file dialog (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, just run wg3d.exe.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. Edit them while the game is closed.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• No in-game settings menu or control remapping yet.
• Widescreen and high frame rate are not supported yet.

LICENSE
GPL-3.0 (LICENSE.txt). wg3d.exe contains this project's code (GPL-3.0), N64ModernRuntime (GPL-3.0) and
other open-source libraries; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.3.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.2.0

CHANGES SINCE v0.1.0

• Fresh clones build again: the dead-code ignore list the build needs (syms/dead_ignore.txt) is now in the repo.
• No console window: output goes to %APPDATA%\WG3DRecomp\logs\wg3d.log, crash reports are saved next to it
  and pointed to by a dialog. wg3d.exe --console still shows the log in a console.
• Alt+Enter / F11 toggle borderless fullscreen (remembered in graphics.json).
• First run asks for the ROM with a file picker.
• App icon and version information.
• Development: scenario test harness (10x speed, sessions in parallel), coverage and frame-pacing tools,
  FPU flush-to-zero on game threads.

W.G. 3D Hockey: Recompiled v0.2.0
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Run wg3d.exe and pick your ROM in the file dialog (or drag the ROM onto wg3d.exe, or run
wg3d.exe path\to\your\rom.z64). The ROM is checked and copied to %APPDATA%\WG3DRecomp.
After that, just run wg3d.exe.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.
Alt+Enter or F11: toggle fullscreen (remembered).

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
logs\wg3d.log log of the last run (the two before it are kept as wg3d.1.log and wg3d.2.log);
crash reports are saved next to it as crash--.txt
The files are created on first run. Edit them while the game is closed.
wg3d.exe --console also shows the log in a console window.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub (attach the log or crash report).
• No in-game settings menu or control remapping yet.
• Widescreen and high frame rate are not supported yet.

LICENSE
This project's code is MIT (LICENSE.txt). wg3d.exe also contains N64ModernRuntime (GPL-3.0) and other
open-source libraries, so the exe as a whole is distributed under the GPL-3.0; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.2.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.

v0.1.0

W.G. 3D Hockey: Recompiled v0.1.0 (pre-release)
https://github.com/geno55/wg3d-recomp

A native Windows port of Wayne Gretzky's 3D Hockey (N64), made by static recompilation with
N64Recomp, N64ModernRuntime and RT64. Unofficial fan project.

NO GAME DATA IS INCLUDED. You need your own ROM of the USA V1.0 release
(sha1 400aa84811f1f2f6c62c756b43b54d534d5a5ec8 as .z64; .v64 and .n64 dumps work too).

REQUIREMENTS
Windows 10 or 11 (64-bit), a GPU with Direct3D 12 or Vulkan.

FIRST RUN
Drag your ROM onto wg3d.exe, or run: wg3d.exe path\to\your\rom.z64
The ROM is checked and copied to %APPDATA%\WG3DRecomp. After that, just run wg3d.exe.

CONTROLS
Keyboard (port 1): arrows/WASD = stick, X = A, C = B, Z/Left Shift = Z, Enter = Start,
Q/E = L/R, I/J/K/L = C buttons, T/F/G/H = D-pad.
Gamepads (Xbox layout) take ports 1-4 in the order they are connected.

SETTINGS AND SAVES (%APPDATA%\WG3DRecomp)
graphics.json resolution (Original/Original2x/Auto), antialiasing (None/MSAA2X/MSAA4X/MSAA8X),
window_mode (Windowed/Fullscreen), graphics_api (Auto/D3D12/Vulkan), and more
general.json pak_port_1..4: which ports have a Controller Pak
window.json window size and position (remembered automatically)
saves\controllerpak_port\ Controller Pak saves
The files are created on first run. Edit them while the game is closed.

KNOWN LIMITATIONS

• A correctness pass is in progress; report problems on GitHub.
• A console window with log output opens alongside the game.
• No in-game settings menu or control remapping yet.
• Widescreen and high frame rate are not supported yet.

LICENSE
This project's code is MIT (LICENSE.txt). wg3d.exe also contains N64ModernRuntime (GPL-3.0) and other
open-source libraries, so the exe as a whole is distributed under the GPL-3.0; see THIRD-PARTY-NOTICES.txt.
Source: https://github.com/geno55/wg3d-recomp (tag v0.1.0).

wg3d.pdb lets crash reports name the function that crashed; keep it next to wg3d.exe.
The msvcp140/vcruntime140 DLLs are the Microsoft Visual C++ runtime, included so no separate install is needed.