This guide explains how to connect your Minecraft server to TIKTORY and allow TikTok events to control your Minecraft minigames in real time.

🔧 Requirements

Before starting, make sure you have:

• A Java Edition Minecraft server compatible with Bukkit/Spigot plugins
  (e.g. PaperMC, Spigot, Bukkit)
• Java 21 or newer
• Access to:
  • Your server file system
  • Your server console / logs
• A TIKTORY account with an active PRO subscription
  (required to unlock Game Integrations)

If you don’t have a Minecraft server yet, start here:
👉 Setting Up a PaperMC Server

🧩 Full Setup Process

Follow these steps in order:

1. Set up a compatible Minecraft server
2. Install the TIKTORY Core plugin
3. Retrieve your server API key
4. Connect Minecraft to TIKTORY
5. Install the minigame modules
6. Create your TikTok → Minecraft game integrations

📘 Setup Articles

Once completed, your Minecraft server will react live to TikTok events like gifts, follows, and likes using your installed minigames.

Troubleshooting

Common problems and how to solve them.

Connection Test Fails

Check that:

• Your Minecraft server is running
• TIKTORY_Core loaded without errors
• Host, port, and API key are correct
• Port 8808 is open and not blocked by firewall/router

The TIKTORY Core plugin might automatically choose a different port if 8808 is already taken. See the config.yml file for the currently used port.

Minigame Modules Not Showing

Check that:

• The .jar files are inside:
  plugins/TIKTORY_Core/modules/
• You restarted the server
• No errors appear in console or logs

TikTok Actions Not Triggering

Verify that:

• Your TikTok account is connected in TIKTORY
• You are currently live
• The correct integration is enabled
• The rule conditions match your events (gift value, type, etc.)