- C++ 73.7%
- Python 12.5%
- Go 11.6%
- HTML 0.6%
- CSS 0.5%
- Other 1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
README: 0.2.12 notes, 0.2.11 moved to the patch notes, What's new link. STATE.md: last release 0.2.12, upstream merge base 5ee6f76. Co-Authored-By: Claude Opus 5.5 <[email protected]> |
||
| .github/assets | ||
| .gitlab/issue_templates | ||
| port | ||
| re/recomp | ||
| server | ||
| tools | ||
| .gitignore | ||
| BUILDING.md | ||
| FIGHTING_LOUNGE.md | ||
| README.md | ||
| ttt2_setup.zip | ||
Install • What's new • Patch notes • Report a bug • Suggest an idea • Build from source
Note
Antivirus and "Windows protected your PC" warnings.
ttt2_setup.exeis not code-signed (signing certificates cost money), so Windows SmartScreen and some antivirus programs may warn about it or flag it on heuristics. It also unpacks and rebuilds the game's files on your PC, which some engines dislike; on VirusTotal it's typically 2 or 3 engines out of about 70. These are false positives: I can assure you nothing in it is malicious. If Windows says "Windows protected your PC", click More info, then Run anyway. All of the source code is right here in this repo, so if that would make you feel more comfortable, you're always welcome to build it yourself. Thanks for giving it a try!
TTT2 Recomp by ThatCaliKid760 is a patched build of the native PC static recompilation of Tekken Tag Tournament 2 (Xbox 360), with fixes and quality-of-life improvements for online play. It's not an emulator: the game's own code runs natively on your PC.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Features
| 🌐 Online play | Ranked and Player Match over Steam, rollback netcode, community servers with leaderboards, teams and replays, ranked rematch, rage-quit penalties |
| 🎮 Every controller | Xbox, DualShock 4, DualSense and keyboard, with button prompts and the Controller Setup picture that follow the controller you use |
| 🖥️ PC graphics | Up to 4K at 60 fps, windowed / borderless / fullscreen, FSR 1, SMAA / FXAA, presets, V-Sync, render scale |
| 🎙️ Voice and text chat | Open mic or push-to-talk, per-player mute, text chat in lobbies |
| 🕹️ Classic Offline | An arcade-style mode where you unlock 37 fighters one ARCADE clear at a time |
| 🔄 Built-in updates | The game tells you when a new version is out and installs it for you |
Steam must be running in the background for online play.
Install
- Download ttt2_setup.zip, unzip it and run
ttt2_setup.exe(or pick a version on the Releases page, which also has the bare.exe). The installer isn't code-signed, so Windows or your antivirus may warn about it. If Windows says "Windows protected your PC", click More info, then Run anyway. - Point it at your own Tekken Tag Tournament 2 (USA, Europe) Xbox 360 disc image and Title Update 3.
- Launch the game from your Desktop or Start menu.
Important
You need your own copy of the game. This project contains no game files; the installer builds them on your PC from your disc image.
Custom music (TEKKEN TUNES)
TEKKEN TUNES (on the main menu) can play your own music files in place of the game's music, as on the Xbox 360.
- Put your music in
%LOCALAPPDATA%\TTT2Recomp\music(create the folder if it isn't there). Subfolders are fine. - Open TEKKEN TUNES, pick a slot (a stage, for example) and press L1/R1 until ORIGINAL MUSIC LIBRARY shows. Each subfolder is a group there, and the songs in it are listed by file name. Files directly in
musicare in the group "(root)". - Pick a song. The game saves your choice and plays the file whenever that music comes up. A short song starts over when it ends.
- Formats:
.mp3,.ogg(Vorbis),.flacand.wav. - Up to 1000 songs. The game reads at most 1000 songs. If you have more, only the first 1000 by folder and file name are listed.
- If you rename, move or delete a file you picked, the game skips it instead of playing it.
- The music follows the game's BGM volume.
Settings, in the [Tunes] section of %LOCALAPPDATA%\TTT2Recomp\settings.ini:
| Key | Default | Meaning |
|---|---|---|
Enabled |
1 |
0 turns custom music off |
Folder |
empty | another music folder (empty means %LOCALAPPDATA%\TTT2Recomp\music) |
Gain |
1.0 |
extra volume for your music, 0 to 4 |
Trace |
0 |
1 writes every music-player message to the log, for bug reports |
What's new in 0.2.12
- Online PAIR PLAY (2v2, beta). A new ONLINE MODE row for four players on four PCs, using the game's own PAIR PLAY screens. From the original port's 0.2.0.
- Rematch menu after Player Match. In a room you create, the end of a match offers REMATCH, STAGE SELECT, CHARACTER SELECT or RETURN TO ROOM. Turn it off with REMATCH MENU in the room. Fighting Lounge cabinet matches keep their own end menu.
- More picture options on GRAPHICS SETTINGS: DEPTH OF FIELD, BLOOM, LIGHT SHAFTS, WEATHER EFFECTS and LOW LATENCY. QUICK START on EXTRA SETTINGS skips the logos and the intro movie.
- Installer: Add DLC. Adds DLC music and movies from your Xbox 360 DLC files. The installer also checks its files with SHA-256.
- Steadier rollback, fewer sound dropouts, faster on low-end PCs, and logs that handle non-English folder names.
- 0.2.12 only plays online with 0.2.12. Older versions show OTHER VERSION; update with the in-game updater. Community server hosts: add
ttt2-fork-12-rollbacktoaccepted_protocols.
All patch notes
0.2.11
- TEKKEN TUNES plays your own music. Put
.mp3,.ogg,.flacor.wavfiles in%LOCALAPPDATA%\TTT2Recomp\music, then pick them per stage in TEKKEN TUNES (L1/R1 to ORIGINAL MUSIC LIBRARY), like on the Xbox 360. See Custom music. - Fighting Lounge: the lounge survives its host leaving. Another player takes over as host and everyone stays in the room.
- Fighting Lounge: a cabinet match never falls back to a stranger. If the cabinet opponent can't be reached, the search finds nobody and you're walked back to the lounge instead of being matched with someone else.
0.2.10
- The updater checks GitLab and GitHub. It asks both at the same time and offers the newer version, so updates keep working if one of them is down. (From this version on; 0.2.9 finds 0.2.10 on GitLab as usual.)
- Fighting Lounge cabinet matches get there and back. When both players pressed Ready, the game stopped on QUICK MATCH's BEGIN SEARCH page, and after the match it got stuck on the results menu. Both are fixed: it now walks to the search, you pick your fighters, and it brings you back to the lounge afterwards. Tested with three copies of the game on one PC; a match between two PCs over Steam is next.
- The installer download is a .zip now. Unzip it and run
ttt2_setup.exe. The bare.exeis still on the release page, and the in-game updater keeps using it.
0.2.9
- Classic Offline: the character-select cursor can no longer get stuck. With only a few fighters unlocked, moving the cursor along a row or column of locked fighters could make it search forever and freeze the screen. Now it stays on the fighter you were on.
- Antivirus / SmartScreen note on the release page and in the Install section: the installer isn't code-signed, so if Windows says "Windows protected your PC", click More info, then Run anyway.
0.2.8
- Controller vibration really works now. 0.2.7 wired the rumble up, but the game itself never asked for it: it reads the console's "Vibration" profile setting when you sign in, and the port answered it as off. Now it answers on, so Xbox / XInput and PS4 / PS5 controllers rumble in matches (#12).
- New Options > EXTRA SETTINGS page (it replaces the VOICE CHAT row): VIBRATION on / off at the top, then the voice chat settings as before.
- More freeze diagnostics for #13:
log.txtnow lists which threads use the CPU (and which DLL they belong to) every few seconds, whichd3d11.dll/dxgi.dllthe game loaded (a DXVK copy shows up as such), and the thread dump names DLLs. If the game freezes or crawls on you, grab the log and attach it to a bug report.
0.2.7
- Controller vibration was wired up for Xbox / XInput and PS4 / PS5 controllers (#12). It turned out the game still never asked for rumble; 0.2.8 fixes that.
- Better freeze reports. If the game stops swapping frames, waits a long time on a lock, or a file read takes ages,
log.txtnow says which thread was waiting on what (#13). - Antivirus note in the Install section: a couple of engines flag the unsigned installer on heuristics (#18).
0.2.6
-
Fighting Lounge is still in alpha testing and being built. Here is concept art of what I'm aiming for and no it does not look like this yet.
This build adds a first, simple 3D blockout of the courtyard and its cabinets. It is local only for now: other players don't walk around in it yet. Both seated players still have to press ready before a cabinet match starts.
-
Controller Setup shows your controller: the big controller picture switches to a PS4 or PS5 controller, or a keyboard and mouse with your bound keys lit up, following whatever you last pressed (or your button prompt setting). Xbox shows the game's original picture.
-
Unlock all Customize items: Options > UNLOCK ALL ITEMS asks YES / NO and makes every Customize item free to equip. Your save isn't changed, so choosing it again locks them back to what you own.
-
Voice chat panel (RS / R3 / F7) only opens in Online Mode's menus and the online lobby, not in the offline menus anymore. It also no longer opens while you're setting keys in Controller Setup (#8).
-
F8 no longer mutes everyone in voice chat, so it won't clash with clip / recording shortcuts. You can still mute players one at a time from the voice panel.
-
Controller Setup > KEYBOARD: the keyboard works again right after you choose a key (#6).
0.2.5
- Fighting Lounge (beta, work in progress): ONLINE MODE > FIGHTING LOUNGE. A shared lounge with LOUNGE CHAT for everyone in it and 20 cabinets (01-20). Xbox A (PlayStation Cross, keyboard A) sits down, joins a full cabinet's queue, or readies up; Xbox X (PlayStation Square, keyboard Z) leaves. When both seated players are ready, the game takes them to an unranked Player Match against each other; the winner stays and the next in line takes the other seat. The cabinet match itself is still being tested: please report what happens. Everyone needs 0.2.5. The 3D lounge with your fighters as avatars is in the works (see
FIGHTING_LOUNGE.md). - VS BATTLE with an Xbox and a PlayStation controller: a PlayStation pad that becomes player 2 now counts, so VS BATTLE is no longer grayed out.
- Keyboard as its own player: Options > Game Options > KEYBOARD PLAYER. PLAYER 1 (default) adds the keys to player 1's controller as before; SEPARATE makes the keyboard a player of its own, so a keyboard and one controller can play VS BATTLE.
- Fixed: online matches stuck on "syncing" (0.2.4 was pulled for this). The ONLINE CROWDS option is gone: on most stages it crashed the game while the match loaded, leaving both players waiting.
- GAME CHAT takes up to 80 characters; longer messages go out as several.
0.2.3
- Ranked rematch: after a ranked match both players are asked REMATCH?: yes with Xbox Y (PlayStation Triangle, keyboard X) or a left-click on the note, no with Xbox X (PlayStation Square, keyboard Z) or a right-click. If both say yes you play the same opponent once more, as in TEKKEN 8.
- Rage-quit penalties (community servers): leaving a ranked match early counts as a loss, earns a strike and locks you out of ranked matchmaking for 5 minutes (15 for the second strike, an hour from the third; a strike is forgiven every 24 hours). The opponent's quit rate shows when a ranked match is found.
- Classic Offline: on the main menu, put the cursor on OFFLINE MODE and press Xbox X (PlayStation Square, keyboard Z). You start with 22 fighters; every ARCADE clear unlocks the next one. Progress is kept per profile, and the option disappears once all 37 are unlocked. The normal Offline Mode keeps the full roster.
- The player card shows your Steam avatar (it was see-through).
- The ONLINE MODE menu notes that Steam must be running for online play.
- Select Profile shows RENAME (Xbox Y, PlayStation Triangle, keyboard X) and DELETE (Xbox X, PlayStation Square, keyboard Z) in the bottom bar; the icons follow the controller you use.
- Keyboard keys are the defaults; with your own in Controller Setup, use the keys you set for Y and X.
- Rematch and quit reports need 0.2.3 on both sides; server owners need the new
ttt2-serverfor the penalties.
0.2.2
- Delete profiles: on Select Profile, press Xbox X (PlayStation Square, keyboard Z) on a profile and confirm. Its save data goes to the Recycle Bin, so it can be restored.
- Display Settings no longer shows 3D MODE / 3D DEPTH.
- Motion blur has one switch again: the game's own in Display Settings (the copy in Graphics Settings is gone).
- The online menu no longer shows "SEARCH FOR Xbox LIVE PARTY" (it did nothing).
0.2.1
- Ranked Match works on Steam again (0.2.0 grayed it out unless a community server was picked). Team and Leaderboards still need a server.
0.2.0
- From upstream 0.1.7: rollback netcode (Options > Game Options > ONLINE NETCODE), community servers with Ranked Match, leaderboards, teams, Tekken Channel replays and ghosts, Steam Friend Invite (Y in a Player Match room), pair play online, rooms no longer vanishing after a few matches, shaders prepared by the installer (no first-time stutter), texture mipmaps, laptops on the dedicated GPU, and 640x360 / 960x540 resolutions.
- Graphics Settings: presets (LOW to ULTRA), FSR 1 upscaling with FSR modes, SMAA anti-aliasing, motion blur and shadows on/off. The page scrolls.
- Fix: the voice chat panel's player list no longer reshuffles, so mute hits the player you picked.
0.1.9
- Update notifications: when you pick your profile, the game checks for a newer version and shows your build number in the top right. If an update is out, click the notification to download it, then click again to install (right-click dismisses it).
- Voice chat in the lobby: press the right stick: Xbox RS, PlayStation R3 (keyboard F7) in the menus or an online lobby to change voice mode and volume and to mute players without leaving the lobby. The lobby's button bar shows the shortcut for your controller.
- Steam profiles: in that panel, select a player and press Xbox X (PlayStation Square, keyboard Z) to open their Steam profile.
- The mouse cursor hides when you're not using the mouse.
- Fix: with FXAA or sharpening on, the picture could be cut off at large render scales.
0.1.8
- Graphics Settings: V-Sync, render scale (supersampling), FXAA, anisotropic filtering, sharpening, brightness, FPS counter.
- Voice Chat: open mic or push-to-talk in online lobbies and matches, voice volume, mute players.
- Updates: check for and install new versions from inside the game (Options > Updates).
- Fix: Discord Join now works for friends-only sessions.
0.1.7 (+ hotfix)
- PS4 / PS5 controllers: native DualShock 4 and DualSense support.
- Button prompts switch between PlayStation, Xbox and keyboard icons across all menus and in-game UI (menu setting).
- Discord Join: join a friend's open lobby straight from Discord, no lobby search needed.
- Text chat in online custom lobbies, for players without a microphone.
- Installer update mode: updates an existing install and keeps your progress.
- Fix: custom character portraits no longer show as a black box.
Reporting bugs
Found a crash, a graphics glitch or something online that doesn't work?
(Needs a free GitLab account.)
Please include:
- your version (shown in the top right when you pick your profile),
- what happened and how to make it happen again,
- your log file: press Win+R, type
%LOCALAPPDATA%\TTT2Recompand attachlog.txt. It's replaced every time the game starts, so grab it before launching again.
Suggestions
Got an idea for a feature, a mode or something that could work better? Open an issue with the Idea template. Everyone can upvote it with 👍 and comment, so the most wanted ideas rise to the top.
Credits
This project is built on shihabal3amri/tekken-tag-tournament-2-pc, the original native Windows port by static recompilation. All credit for the port itself goes to that project and the tools it builds on (XenonRecomp, with Unleashed Recompiled and Xenia as references).
Legal
Unofficial fan project, not affiliated with or endorsed by Bandai Namco or Microsoft. Tekken and all related characters and content are the property of their respective owners.







