◎runetify.

KNOWLEDGE BASE & INTEGRATION GUIDES

Runetify Documentation

Version 0.2.8 • Complete Developer & Streamer Handbook

Table of Contents

01 Quick Start Guide

Download, account login, and your first live stream setup.

 02 TikTok Live Connector

Real-time chat, gift, like, follow, and share listener engine.

 03 Supported Games & Mods

Setup instructions for GTA SA, L4D2, GTA V, Minecraft, and RE4.

 04 OBS Overlay Studio

Vertical 9:16 & 16:9 canvas widgets, goal bars, and alerts.

 05 Triggers, Queues & Delays

Configuring gift-to-action rules, batch delays, and spawn safety.

 06 Usage Telemetry & Refund Rules

How the 14-day & 2-hour software usage rules are measured.

 07 Troubleshooting & FAQ

Antivirus exclusions, administrator rights, and mod repair.

1. Quick Start Guide

Runetify transforms your live TikTok streams into interactive gameplay sessions where viewers trigger in-game events, spawn vehicles or enemies, trigger chaos effects, and play custom sound alerts.

  1. Download & Install: Download the latest Runetify desktop client installer for Windows (64-bit). Run the setup installer.
  2. Sign In: Log in using your Google account. Runetify automatically provisions your persistent 6-character Overlay Code.
  3. Select Game: Select your game from the launcher dashboard (e.g., Grand Theft Auto: San Andreas or Left 4 Dead 2).
  4. Install Mod Engine: Click Install Mod. Runetify automatically validates your game directory, checks for runetify_info.json, and installs the required game hooks.
  5. Enter TikTok Username: Type your TikTok username (e.g., @yourstreamername) and click Connect.
  6. Add OBS Browser Source: Copy your personalized overlay link into OBS Studio or TikTok LIVE Studio.

2. TikTok Live Connector

The Runetify desktop app connects directly to TikTok's live event stream via WebSocket. No TikTok API application or developer approval is required:

  • Connection State: When your TikTok live is online, enter your handle without the @ prefix. Runetify establishes a direct bidirectional listener.
  • Event Types: Runetify listens for Gifts (Rose, Doughnut, Whale Diving, Galaxy, etc.), Likes (burst thresholds), Comments (command keywords), Follows, and Shares.
  • Offline Testing: Use the built-in Test Events panel in the desktop app to simulate any TikTok gift or chat event before going live.

3. Supported Games & Mod Setup

Grand Theft Auto: San Andreas (PC)

Requirements: GTA SA Version 1.0 US (Hoodlum executable recommended). Runs on modern Windows via SilentPatch.

  • Mod Installation: Runetify deploys its native CLEO plugin and command dispatcher into your game root. The installation automatically creates and verifies runetify_info.json.
  • Screen & Windowing: Press Alt + Enter to toggle between Borderless Windowed and Fullscreen modes. Borderless Windowed mode allows you to click between OBS, chat, and the game without minimizing or losing mouse cursor control.
  • Commands Supported: Over 300+ native actions including vehicle spawns (Hydra, Rhino, Infernus, NRG-500, Random Vehicles), weapon loads, weather controls, pedestrian riots, and instant teleports:
    • Teleport Grove Street → Coordinates: 2491.5, -1668.5, 13.5
    • Teleport Mount Chiliad → Coordinates: -2313.2, -1645.1, 483.7
    • Teleport Los Santos Airport → Coordinates: 1968.3, -2181.6, 13.5

Left 4 Dead 2

Requirements: Steam version of Left 4 Dead 2. Both Campaign and Versus modes supported.

  • SourceMod / VScript Integration: Runetify injects the automated game connector into your left4dead2/addons folder.
  • Persistent Revive Counter & Timer: Streamer revive counts and pause timer values are automatically saved into your local left4dead2/runetify_save.json file. When you restart the game or re-open the app, your counters and timers resume exactly where you left off.
  • Entity Limits & Distance Safeguards: Source engine caps maximum active entities to 32 (survivors + infected). Runetify monitors the survivor count (4 players = 28 infected headroom; solo = 31 headroom) and queues excess spawns. Tanks and Witch spawns are pinned to active navigation meshes so they do not cull or despawn unexpectedly.

Grand Theft Auto V

Requirements: Story Mode with ScriptHookV and Community Script Hook V .NET installed.

  • Mod Installation: Deploys RunetifyGtaV.asi into your GTA V directory.
  • Features: Chaos effects, vehicle gravity modifiers, wanted level overrides, invincibility timers, and pedestrian ragdoll triggers.

Minecraft (Java Edition)

Requirements: Forge / Fabric 1.20+ with the Runetify WebSocket companion mod.

  • Features: Mob spawning (Creepers, Wardens, Withs), inventory shuffles, lightning strikes, potion effect cascades, and custom block placement.

4. OBS Overlay Studio

Runetify provides high-performance web overlays rendered via hardware-accelerated canvas at 60 FPS.

https://runetify.app/widget/overlay/YOUR_OVERLAY_CODE
  • TikTok Live Studio (Vertical 9:16): Set your OBS or TikTok Studio Browser Source dimensions to 1080 x 1920. Enable "Shutdown source when not visible" to conserve GPU resources.
  • Standard Landscape (16:9): Set your Browser Source dimensions to 1920 x 1080 for Twitch, Kick, or YouTube broadcasts.
  • Customization Options: In the Runetify desktop app, click Overlay Studio to configure goal bars, sound effects, animated avatar gift notifications, trigger queues, and font colors.

5. Triggers, Queues & Spawn Safety

When high volumes of gifts arrive during viral TikTok streams, spawning hundreds of entities simultaneously can crash game engines. Runetify includes advanced queue throttling:

  • Configurable Spawn Delays: Every multi-spawn command (e.g., 50 viewer-spawned enemies or vehicles) is dispatched through a staggered interval (default: 100ms per entity). This prevents game memory crashes and maintains smooth streaming frame rates.
  • Action Cooldowns: Set minimum cooldowns per trigger (e.g., 5 seconds between screen flips) to prevent spamming disruptive visual effects.
  • Sound Effects Studio: Attach custom .mp3 or .wav sound alerts to any gift trigger with independent volume mixing.

6. Application Usage Telemetry & Refund Policy

Runetify maintains a strict, transparent refund policy modeled after industry benchmarks (such as Valve's Steam platform):

The 14-Day & 2-Hour Usage Rule

You are eligible for a full, no-questions-asked refund if and only if:

  1. Your refund request is submitted within 14 calendar days of the subscription date; AND
  2. Your total application usage across all devices is less than 2 hours (120 minutes).

If you have used the Runetify desktop application or connected streaming overlay for 2 hours or more, or if your purchase is older than 14 days, the order is finalized and ineligible for a refund.

How Application Usage Is Accurately Tracked

Runetify tracks genuine broadcast usage through automated telemetry under strict creator-friendly conditions:

  • Live Connection Only: Usage time is strictly recorded only while your desktop application is actively connected to a live TikTok stream (LIVE state). Offline app testing, mod installations, button configurations, sound testing, and idle app runtime do not count towards the 2-hour limit.
  • Low-Frequency Milestones: While connected live, your client reports elapsed broadcast time in 30-minute milestones. When you disconnect, the remaining session seconds are flushed once.
  • Zero Inactive Overhead: You are never penalized for keeping the desktop application open, testing offline features, or setting up ahead of time.
  • Admin Audit Trail: Support specialists inspect the cryptographic audit trail upon any refund request, ensuring fair, indisputable transaction reviews for both creators and payment processors.

Review our complete legal terms at Refund Policy and Terms of Service.

7. Troubleshooting & FAQ

Why does my game crash when spawning 50+ enemies or vehicles?

Spawning massive quantities of 3D entities in a single frame overflows the engine's memory pool. In the Runetify Action Editor, ensure the Spawn Delay is set to at least 100ms per spawn so the game can allocate entity slots progressively.

Windows Defender or Antivirus flags the Runetify Mod files

Runetify injects native memory hooks (CLEO, SourceMod, ASI loaders) into game processes to listen for live streaming commands. Because game memory injection mimics cheat engine techniques, some heuristic antivirus scanners may produce false positives. Add the Runetify install directory and your game folder to your antivirus whitelist.

How do I reset my mod installation?

Navigate to your game tab in Runetify and click Uninstall Mod. Runetify reads runetify_info.json to safely remove only the injected files without corrupting your base game. Once uninstalled, click Install Mod to deploy a clean configuration.

How do I contact technical support?

Reach out to our engineering support team at support@runetify.app or visit our Support Center. We typically respond within 24 business hours.