TT Interactive

Mac quick-start · macOS

Mac Quick Start Guide

Choose your Mac, extract the ready-made server, and get TikTok LIVE gifts working in Minecraft. Both packages include the matching Temurin Java 25 runtime, Paper 26.3 build 249, TT Interactive, ServerTap, and the TikFinity profile.

Windows quick-start Mac quick-start

Not sure? If your Mac has an M-series chip, choose Apple Silicon. If it has an Intel processor, choose Intel.

Ready-made package

Mac quick-start

You do not need to install Java, Paper, TT Interactive, or ServerTap separately.

  1. 1 Extract the ZIP in Finder

    Open the downloaded ZIP and move the extracted server folder somewhere you can keep it, such as Documents. Do not run the server from inside the ZIP.

  2. 2 Open the server once

    In Finder, Control-click Start Server.command, choose Open, then confirm Open if macOS asks. Wait for Paper to report Done.

  3. 3 Join from Minecraft Java

    Open Multiplayer, add the server address 127.0.0.1, and join while the server window stays open.

  4. 4 Connect the TikFinity Web App

    Open the TikFinity Web App and set the Minecraft connection to 127.0.0.1:4567.

    To import the profile, open Actions (or Setup, then Actions & Events).

    1. Click the small arrow on the right of New Action and choose Import Actions. Screenshots: arrow, menu
    2. Upload the profile file from the TikFinity Profile folder in your download. Screenshot: upload
    3. Press Next through the tabs, then Save and Start Import. Screenshots: Next, Save, Start Import
    4. The [TTI] actions now show in your list. Screenshot: done

    Keep the Web App open while you stream.

  5. 5 Add the local overlay

    Add http://localhost:8686/overlay as a browser source in your streaming app.

Updating TT Interactive later: Stop the server, Control-click Update TT Interactive.command, choose Open and follow the prompts. It updates everything and keeps your worlds and settings. Installed before 1.0.99? Download the current Mac ZIP once first.

Want to assemble the server yourself? Open the Mac manual setup guide.

Mac quick-start questions

Which Mac download do I need?

Choose Apple Silicon if your Mac has an M-series chip. Choose Intel only if it has an Intel processor.

Do I need to install Java or Paper?

No. Both packages include the matching Java runtime, Paper, TT Interactive, ServerTap and the TikFinity profile.

How do I connect TikFinity on a Mac?

Open the TikFinity Web App. Open Actions (or Setup, then Actions & Events), click the small arrow on the right of New Action, choose Import Actions, and upload the bundled profile. Then set the Minecraft connection to 127.0.0.1:4567.

How do I update an existing Mac install?

Stop the server first. Control-click Update TT Interactive.command, choose Open, and follow the prompts. One run updates the plugin, the TikFinity profile, ServerTap, Paper (only to the exact stable build the download ships, never a downgrade), and Java when the new Paper needs it. If this Mac install is older than 1.0.99, download the current Mac ZIP once so Paper and Java can update. After that, updates are automatic.