Ports/goldeneye-pc-port
1
0 Fork 1
mirror of https://github.com/jkdansereau/goldeneye-pc-port.git synced 2026-10-23 15:52:42 +02:00
Code Issues Packages Projects Releases Wiki Activity

Release notes: one line per paragraph and bullet (GitHub release pages render every newline as a line break)

Browse Source
This commit is contained in:
James Dansereau committed 2026-10-13 13:19:37 -04:00
1 parent 971ff2b2bd
commit af5e75ccbf
1 file changed
+27 -78
Download Patch File Download Diff File Expand all files Collapse all files
.github/release-notes.md
+27 -78
View File
@@ -6,32 +6,18 @@
</p>
> [!NOTE]
> **Updating?** Your progress and settings carry over. Unpack the new version
> into a new folder and copy your ROM, `ge007.eep` and `ge007.ini` into its
> `data/` folder. Leave the old `pcmodels-*` and `pccg-*` folders behind; the
> new version makes its own.
> **Updating?** Your progress and settings carry over. Unpack the new version into a new folder and copy your ROM, `ge007.eep` and `ge007.ini` into its `data/` folder. Leave the old `pcmodels-*` and `pccg-*` folders behind; the new version makes its own.
> [!NOTE]
> The downloads aren't code-signed. On Windows, if SmartScreen appears, click
> **More info**, then **Run anyway**. On macOS, see [Getting started](#getting-started).
> The downloads aren't code-signed. On Windows, if SmartScreen appears, click **More info**, then **Run anyway**. On macOS, see [Getting started](#getting-started).
## Highlights
- **Frame rates above 60.** Pick 90, 120, 144, 165 or 240, or **Auto** to
match your display (up to 240). The game still runs at its original speed;
the extra frames are blended between its ticks. A rework of f1zz1ec0ke's
#137.
- **macOS on Apple Silicon (experimental).** A new download for M1 and later
Macs, based on danturn's #95. Tested on one M3 Mac so far; reports are
welcome.
- **Original controls are now original (#145, #149).** With *Control style*
set to Original, your pad behaves as an N64 controller, and *Invert look*
works in every original style.
- **Fixes:** geometry vanishing up close (#150), the first launch opening on
the wrong monitor (#151), the end-credits crash on Linux and macOS (#152)
and a crash when a guard spawns with a hat (#153, #156).
- **Also:** an optional mission timer (#144), the file-select crest fixed
(#146), and a fix for a Windows blue screen on exit.
- **Frame rates above 60.** Pick 90, 120, 144, 165 or 240, or **Auto** to match your display (up to 240). The game still runs at its original speed; the extra frames are blended between its ticks. A rework of f1zz1ec0ke's #137.
- **macOS on Apple Silicon (experimental).** A new download for M1 and later Macs, based on danturn's #95. Tested on one M3 Mac so far; reports are welcome.
- **Original controls are now original (#145, #149).** With *Control style* set to Original, your pad behaves as an N64 controller, and *Invert look* works in every original style.
- **Fixes:** geometry vanishing up close (#150), the first launch opening on the wrong monitor (#151), the end-credits crash on Linux and macOS (#152) and a crash when a guard spawns with a hat (#153, #156).
- **Also:** an optional mission timer (#144), the file-select crest fixed (#146), and a fix for a Windows blue screen on exit.
## Downloads
@@ -41,25 +27,17 @@
| `goldeneye-pc-port-<version>-linux-x86_64.tar.gz` | Linux x86-64 (glibc 2.31+), including Steam Deck |
| `goldeneye-pc-port-<version>-macos-arm64.tar.gz` | macOS 14+ on Apple Silicon (experimental) |
Each download is ready to run: it carries its runtime libraries, a README,
the license texts and the one-time asset tool. **No ROM and no game assets
are included; you need your own US GoldenEye 007 ROM.**
Each download is ready to run: it carries its runtime libraries, a README, the license texts and the one-time asset tool. **No ROM and no game assets are included; you need your own US GoldenEye 007 ROM.**
## Getting started
1. Unpack the download.
2. Make a `data/` folder next to the executable and put your ROM in it as
`ge007.ntsc-final.z64`.
3. Start the game. The first start takes a few extra seconds while it prepares
the game files from your ROM. **F10** (controller: **Select**) opens the
options menu.
2. Make a `data/` folder next to the executable and put your ROM in it as `ge007.ntsc-final.z64`.
3. Start the game. The first start takes a few extra seconds while it prepares the game files from your ROM. **F10** (controller: **Select**) opens the options menu.
**Steam Deck:** do the steps on the Deck, then add the executable as a
non-Steam game.
**Steam Deck:** do the steps on the Deck, then add the executable as a non-Steam game.
**macOS:** the app isn't notarized, so run this once in Terminal before the
first launch, then start `./ge007.aarch64` from the folder. If the window ever
stays black on the first start, close it and start it again.
**macOS:** the app isn't notarized, so run this once in Terminal before the first launch, then start `./ge007.aarch64` from the folder. If the window ever stays black on the first start, close it and start it again.
```
xattr -dr com.apple.quarantine goldeneye-pc-port-<version>-macos-arm64
@@ -71,33 +49,19 @@ Or download it in Terminal, which skips that step:
curl -L https://github.com/jkdansereau/goldeneye-pc-port/releases/download/v<version>/goldeneye-pc-port-<version>-macos-arm64.tar.gz | tar xz
```
Without Terminal: after macOS blocks the first launch, open System Settings →
Privacy & Security and click **Open Anyway** next to the `ge007.aarch64`
message.
Without Terminal: after macOS blocks the first launch, open System Settings → Privacy & Security and click **Open Anyway** next to the `ge007.aarch64` message.
The [user guide](https://github.com/jkdansereau/goldeneye-pc-port/blob/v0.6.0/docs/user-guide.md)
covers controls, settings, emulator saves and troubleshooting.
The [user guide](https://github.com/jkdansereau/goldeneye-pc-port/blob/v0.6.0/docs/user-guide.md) covers controls, settings, emulator saves and troubleshooting.
## What's new
### Added
- **Frame rate cap:** Auto, 90, 120, 144, 165 and 240 join 30 and 60 (F10 →
*Video*). Auto is the default on fresh installs; an existing `ge007.ini`
keeps its value. Above 60 the extra frames are blended between game ticks
(no effect on a 60 Hz display), which adds one tick of latency; a fast camera turn or a big change on screen
shows a full frame instead. The *Original N64* display mode keeps 60.
- **macOS Apple Silicon download** (experimental), plus source builds with
Homebrew's GNU `gcc`.
- **Original control style as an N64 controller:** every press sends the real
N64 button in levels, menus, the watch and the tank. Default layout: South =
A, West = B, right trigger = Z, left trigger / RB = R, LB = L, right stick =
C-buttons. Each button can be moved per player in `ge007.ini`
(`Input.N64Pad.A = a`, ...), and `Input.N64StickFeel` picks the N64's linear
stick range.
- **Frame rate cap:** Auto, 90, 120, 144, 165 and 240 join 30 and 60 (F10 → *Video*). Auto is the default on fresh installs; an existing `ge007.ini` keeps its value. Above 60 the extra frames are blended between game ticks (no effect on a 60 Hz display), which adds one tick of latency; a fast camera turn or a big change on screen shows a full frame instead. The *Original N64* display mode keeps 60.
- **macOS Apple Silicon download** (experimental), plus source builds with Homebrew's GNU `gcc`.
- **Original control style as an N64 controller:** every press sends the real N64 button in levels, menus, the watch and the tank. Default layout: South = A, West = B, right trigger = Z, left trigger / RB = R, LB = L, right stick = C-buttons. Each button can be moved per player in `ge007.ini` (`Input.N64Pad.A = a`, ...), and `Input.N64StickFeel` picks the N64's linear stick range.
- **Mission timer** (#144): an optional always-visible timer, off by default.
- **`ge007.log`:** every run is logged next to the ini; the previous run is
kept as `ge007.prev.log`.
- **`ge007.log`:** every run is logged next to the ini; the previous run is kept as `ge007.prev.log`.
### Fixed
@@ -106,23 +70,18 @@ covers controls, settings, emulator saves and troubleshooting.
- A crash during the end credits on Linux and macOS (#152).
- A crash when a guard spawns wearing a hat (#153, #156).
- The file-select crest drawing on a dark square (#146).
- *Invert look* now works in every original control style and stays in sync
with the watch's *Look up/down* (#145).
- *Invert look* now works in every original control style and stays in sync with the watch's *Look up/down* (#145).
- A Windows blue screen (0x119) when the game exits, seen on an NVIDIA GPU.
- The Cradle catwalk shadow flicker, and stale pixels beside the widescreen
picture on front-end screens.
- Sound and text pointer checks that rejected valid pointers (#108, with
italoarruda).
- The Cradle catwalk shadow flicker, and stale pixels beside the widescreen picture on front-end screens.
- Sound and text pointer checks that rejected valid pointers (#108, with italoarruda).
- The Linux/macOS update check failing on a large response.
- F10 slider labels being cut off at HUD scale 150.
### Changed
- Windows: per-monitor DPI awareness, so fullscreen on a scaled 4K display is
native resolution.
- Windows: per-monitor DPI awareness, so fullscreen on a scaled 4K display is native resolution.
- F10 dropdowns stay inside the settings box.
- The crosshair look (colour, size, style) is no longer reset by the *Display
mode* presets.
- The crosshair look (colour, size, style) is no longer reset by the *Display mode* presets.
- The old front-end *Velocity* pointer mode is removed.
## Known issues
@@ -136,21 +95,15 @@ covers controls, settings, emulator saves and troubleshooting.
| PAL and JP ROMs aren't supported yet | Use the US (NTSC-U) ROM |
| Saves from v0.4.0 and earlier can hold fake unlocks from *All unlocked* | Keep a backup of `data/ge007.eep` from before you used it |
The full list is the
[known-issues table](https://github.com/jkdansereau/goldeneye-pc-port/blob/main/docs/ROADMAP.md#known-issues).
The full list is the [known-issues table](https://github.com/jkdansereau/goldeneye-pc-port/blob/main/docs/ROADMAP.md#known-issues).
## Tested on
The release downloads themselves, from a fresh folder with only the ROM: all
21 solo levels on Windows (at 120 fps), the Steam Deck (Desktop and Game
Mode, at 90), macOS on Apple Silicon, and a 2011 Linux laptop with Intel HD
3000 graphics (at 60).
The release downloads themselves, from a fresh folder with only the ROM: all 21 solo levels on Windows (at 120 fps), the Steam Deck (Desktop and Game Mode, at 90), macOS on Apple Silicon, and a 2011 Linux laptop with Intel HD 3000 graphics (at 60).
## Thanks
f1zz1ec0ke (#137, the frame-interpolation design this release reworks),
danturn (#95, macOS), Julio C. Rocha (#88, the first macOS groundwork),
italoarruda (#108), and everyone who reported the issues above.
f1zz1ec0ke (#137, the frame-interpolation design this release reworks), danturn (#95, macOS), Julio C. Rocha (#88, the first macOS groundwork), italoarruda (#108), and everyone who reported the issues above.
## Verify the download
@@ -163,8 +116,4 @@ gh attestation verify <file> --repo jkdansereau/goldeneye-pc-port # buil
---
Built on the [GoldenEye 007 decompilation](https://github.com/n64decomp/007)
and modelled on the [Perfect Dark PC port](https://github.com/fgsfdsfgs/perfect_dark).
A non-commercial fan project, not affiliated with any rights holder. Developed
with AI coding agents directed by one maintainer; see
[About the project](https://github.com/jkdansereau/goldeneye-pc-port/blob/v0.6.0/docs/about.md#how-it-was-made).
Built on the [GoldenEye 007 decompilation](https://github.com/n64decomp/007) and modelled on the [Perfect Dark PC port](https://github.com/fgsfdsfgs/perfect_dark). A non-commercial fan project, not affiliated with any rights holder. Developed with AI coding agents directed by one maintainer; see [About the project](https://github.com/jkdansereau/goldeneye-pc-port/blob/v0.6.0/docs/about.md#how-it-was-made).