snicolast/starwarstrilogynative기술 문서

Sega's 1998 arcade game, running natively on PC and Mac.
Not an emulator: the original code, recompiled to C++, with a modern Vulkan renderer.

• True widescreen, not stretched: 16:9, 21:9, 32:9 or 48:9 for three monitors.
• Ray-traced sun shadows and ambient occlusion, haze, bloom, light shafts and HDR lighting.
• New looks, made for this port:
  • New explosions in Yavin: billowing fireballs, sparks, burning debris and TIE fighters breaking into pieces of themselves, with a louder, deeper sound panned to where they are (OPTIONS > GRAPHICS > EXPLOSIONS: ARCADE for the original ones).
  • Space redrawn with a deep star field and the Milky Way; the Death Star as in the films, with thousands of lights in its trenches.
  • Lightsabers, lasers and explosions light what is around them; Vader's suit shines; Boba Fett's desert has wind ripples.
• Sharp and smooth: MSAA or NVIDIA DLAA, HD text, and the 3D drawn between the game's frames at 120 / 144 Hz and above.
• Arcade sound, Digital Sound Board music and voices included, with surround and headphone modes.
• Mouse, gamepad (gyro too), light gun or flight stick, with aim assist and force feedback as rumble.
• Quality presets from laptops to RTX cards, and achievements and stats in Records.

New game modes made for this port, already waiting under Play > Extra modes:

• Dogfight: your X-wing against squadrons of TIE fighters, with random encounters and objectives, so no two flights are the same.

More content will follow in future updates.

You need your own swtrilgy.zip, the Rev. A set (Sega Model 3 Step 2.1, files like epr-21379a.17). Nothing from it is in this repository, and other versions will not work. It must include epr-21119.ic8 (the force feedback board), which some older sets lack: without it the game stops at FAILED FEEDBACK LEVER INITIALIZE. build.bat says which chips are missing.

You need Windows 10/11 (64-bit) and a GPU with a Vulkan 1.3 driver (most from 2016 on). DLAA needs an NVIDIA RTX; on other cards it switches itself off, and the game builds the same on any GPU.

Install it with NicoLauncher, a free app that downloads, builds, updates and starts the game for you. No Visual Studio, nothing to set up by hand.

1. Download NicoLauncher-setup.exe and run it.
2. In the launcher, open Star Wars Trilogy, press Install and choose your swtrilgy.zip when it asks.
3. Press Play.

On a Mac with Apple silicon, see docs/MACOS.md (maintained by contributors).

With NicoLauncher: it tells you when there is something new. Press Update.

Without it: when there is a new version, the main menu says what is new and offers UPDATE NOW. Or run update.bat yourself: it downloads the changed files from GitHub (no git needed) and rebuilds. Your ROM, settings and records are kept; files you edited are backed up to out\update_backup\.

F11 or Alt+Enter toggles fullscreen. Everything else is in Options.

• Mouse / light gun: the sight goes where you point (Sinden, Gun4IR and other guns seen as a mouse work as is). OPTIONS > CONTROLS can make the mouse move the flight lever instead.
• Flight sticks (T.Flight HOTAS, Extreme 3D...) are the cabinet's lever: buttons 1 fire, 2 second trigger, 3 EVENT, 4 coin, 5 start. Plug the stick in its PC mode.
• Invert in duels (OPTIONS > CONTROLS) turns the aim round in the lightsaber duels only.

• Other recompiled arcade games: The Lost World and Sega Rally 2 (both also in the main menu under More recomps).
• How it works: the PowerPC to C++ recompiler and the hardware.

If you enjoy the port and want to help with the time and tools behind it, you can buy me a coffee. Entirely optional: it supports the work on this project, not the game, which belongs to Sega.

The code in this repository is under the MIT License, with additional terms. The libraries and fonts in third_party/ keep their own licenses. The gamepad button pictures in res/pad/ are Controller Input Icons by ElDuderino (CC0). The game itself (ROM, code, data, music and voices) is not included and stays the property of its owners: you need your own copy of swtrilgy.zip.

No prebuilt downloads. The license does not allow anyone to share a compiled build of this port, a ROM, or anything made from one. I have never published any of them: everyone builds the game themselves from their own swtrilgy.zip. Any ready-to-play download you find elsewhere is not from me, breaks the license, and is at your own risk.

_{A fan project for personal use, not affiliated with or endorsed by Sega or Lucasfilm. Star Wars is a trademark of Lucasfilm Ltd.}