Let's get youPLAYING

Installation.

Windows

1. Download JT7 Launcher. It's the app that installs Project Playtime, starts it, and downloads every mod update for you, including updates to itself.
2. Open JT7Launcher.exe. Windows will probably warn you about it, and your antivirus might flag some game files. Both are false alarms. Click More info, then Run anyway, and read About the virus warnings below to see why.
3. Click the Project Playtime Rewrite tile to start the download. A progress bar on the tile shows how much of the game has downloaded. You can leave the launcher running in the background. If your internet drops or you close the launcher, just click the tile again and the download picks up from where it stopped.
4. Once the download finishes, it installs on its own and grabs the newest mod update. Wait until it says “Project Playtime Rewrite is installed. Click it to play.”
5. Windows will ask if the launcher can make changes. Click Yes. This sets up the network your games run on so your friends can join you. If you clicked No by accident, right-click the tile and pick Set up multiplayer network.
6. Click the tile to play. Always start the game from the launcher, because that's how you get updates and the right network settings.

iPhone and iPad

1. On your PC, install Sideloadly. It needs iTunes and iCloud from apple.com, not the Microsoft Store versions. Download the newest Madeira .ipa from Madeira's releases page.
2. Plug in your iPhone or iPad. In the Apple Devices app, or iTunes, pick your device and turn on Show this device when on Wi-Fi. In iTunes it's called Sync with this device over Wi-Fi. Then click Apply. That lets your PC reach it without the cable.
3. Drop the .ipa into Sideloadly and sign in with your Apple ID. Open Advanced options and make sure Automatically refresh is on, then press Start. From now on Sideloadly signs Madeira again on its own before the 7 days run out, as long as your PC is on with Sideloadly running in the tray and your device is on the same Wi-Fi. If Madeira ever won't open, plug in and press Start again.
4. On the device, turn on Settings › Privacy & Security › Developer Mode, which restarts it, then trust your Apple ID under Settings › General › VPN & Device Management.
5. Open Madeira, go to Settings, tap Enable JIT and follow its setup. You're ready when JIT and Memory+ both show a green check. While you're there, set the pointer mode to Relative, so swiping the screen turns the camera.
6. On your PC, open the Apple Devices app, or iTunes, pick your device and go to Files › Madeira. Drag in the whole C:\Games\Project Playtime folder, about 26 GB. Then unzip the iPhone & iPad download from the button above and drag in the three files inside it.
7. On the device, open the Files app and go to On My iPhone (or On My iPad) › Madeira. Move Project Playtime into wine › drive_c › Games, making the Games folder if it isn't there, and move JT7-iPhone.bat and JT7-Update.exe into Project Playtime, next to Playtime_Multiplayer.exe. The updater checks the JT7 site every time you start the game and installs new updates on its own. Rename JT7-Madeira-controls.json to madeira-control-presets.json and leave it in the main Madeira folder. Skip that last part if you've made your own Madeira touch layouts, because it replaces them.
8. In Madeira's library, tap + and pick Games › Project Playtime › JT7-iPhone.bat. Tap the new game to name it, and for Resolution pick the This screen's shape size around 720p. It fills your iPhone or iPad with no black bars. Go one size lower if it runs slowly.
9. Tap the game to play. If the main menu shows the JT7 logo and the bot game buttons, the mod is working. A Bluetooth controller works best, and on an iPad a keyboard and mouse work too. For touch, open the Session menu and pick Controller layout, then JT7 Survivor or JT7 Monster, the iPad one on an iPad. Madeira labels buttons by key: Space jumps, Ctrl crouches, Shift runs, E uses, R rolls, G is the monster's power, T switches the view, Tab is the scoreboard and Esc pauses.
10. For multiplayer, install Tailscale from the App Store, sign in and connect. Your device can join friends' lobbies. Hosting from an iPhone or iPad isn't ready yet.

If something goes wrong, turn on extended logging in Madeira's Settings and send me that log and Playtime_Multiplayer/Binaries/Win64/ue4ss/UE4SS.log from the game folder.

Android

Snapdragon phones run it best because the game uses graphics made for their chips. Phones with MediaTek, Exynos or Google Tensor chips use a slower graphics mode, so expect lower frame rates. Phones with less than 8 GB of RAM usually close the game when it runs out of memory. Android is still in testing, so these may change.

1. Download JT7 for Android. It's about 170 MB. Open the file when it finishes. If your phone asks, allow installing apps from your browser, then tap Install. Android may warn that the app was made for an older version of Android. That's expected, because the part that runs Windows games needs it. Tap More details, then Install anyway.
2. Open JT7. The first time it sets itself up, which takes about a minute.
3. Tap Install to download the game. It's 13.5 GB, so use Wi-Fi and keep the app open. If it stops, tap Install again and it picks up where it left off.
4. For multiplayer, tap Set up multiplayer. It sends you to the free Tailscale app and copies the JT7 key. In Tailscale, open settings at the top right, tap Accounts, then the three-dot menu, pick Use an auth key, paste it and connect.
5. Tap Play. The left stick moves, swipe the right side to look, and the two big buttons are your left and right hands. Hold a hand button and drag to aim. As the monster, switch to the JT7 Monster controls from the game's side menu.

JT7 for Android is built on the open source Winlator app. Download its source code.

Mac

You need macOS 14.6 or newer and about 30 GB free. Apple Silicon Macs run it best.

1. Download JT7 for Mac. It's about 570 MB. Double-click the zip to unpack it, then drag JT7 into your Applications folder.
2. Open JT7. If your Mac offers to install Rosetta, click Install.
3. Your Mac will say Apple could not verify JT7, because it isn't from the App Store. Click Done, open System Settings, go to Privacy & Security, scroll down and click Open Anyway next to JT7, then enter your password. If it says JT7 is damaged instead, open Terminal and run this, then open it again: xattr -drs com.apple.quarantine /Applications/JT7.app
4. The JT7 Launcher window opens, just like on Windows. Click the Project Playtime Rewrite tile to download and install the game. If the download stops, click the tile again and it picks up where it left off.
5. For multiplayer, install the standalone Tailscale app and open it once. Then right-click the tile and pick Set up multiplayer network. If your Mac asks to allow a VPN configuration, click Allow.
6. From now on, open JT7 from Applications or Launchpad to play. It updates the game and itself every time.

Linux and Steam Deck

1. Open Terminal. On a Steam Deck, switch to Desktop Mode and open Konsole. Paste this line and press Enter: curl -fsSL https://jt7.jt7launcher.workers.dev/files/jt7-launcher.sh -o ~/jt7-launcher.sh && bash ~/jt7-launcher.sh If you used the Linux button instead, run bash ~/Downloads/jt7-launcher.sh. You don't need to install anything else, because the launcher gets what it needs.
2. It downloads and installs the game into ~/Games/JT7, so you need about 30 GB free. If the download stops, run it again and it picks up where it left off. If something goes wrong, send me ~/Games/JT7/state/game.log and the game's ue4ss/UE4SS.log.
3. When it asks about the multiplayer network, type y and enter your password. This lets your friends join your games.
4. After the first time, open JT7 Launcher from your app menu to play. It updates the game and itself every time.

Updates.

If something goes wrong.

Still stuck? Send me a screenshot of the launcher window.