GeminiOrbFX

Interactive Orb Effects for Beat Saber triggered by TikTok Live events via Tikfinity.

Compatible with Beat Saber 1.40.8 and 1.43.0.

---

✨ Features

• Gameplay orbs triggered by follows, gifts and chat commands
• Built-in Tikfinity relay mode (no API key required)
• Streamer.bot / HTTP support
• Twitch support via Streamer.bot
• Chat command triggers
• Gift filtering (specific gifts / coin thresholds)
• Follow triggers
• Live preview for orb settings

---

📦 Installation

1. Download the correct zip for your Beat Saber version from the latest release
2. Extract GeminiOrbFX.dll and drop it into: Beat Saber/Plugins/
3. Launch the game

File	Beat Saber Version
GeminiOrbFX_1.43.0.zip	1.43.0
GeminiOrbFX_1.40.8.zip	1.40.8

---

🔌 Service Modes

📡 Tikfinity

• Built into the mod
• No API key required
• Open Tikfinity and connect to your TikTok Live
• Connect from the in-game TIKFINITY tab

---

🔧 Tikfinity Setup

1. Download and install Tikfinity
2. Open Tikfinity and connect it to your TikTok Live
3. In Beat Saber, open the TIKFINITY tab in the GeminiOrbFX menu
4. Press CONNECT
5. Configure your trigger in the Triggers subtab

---

🤖 Streamer.bot

• Works with:
  • Twitch
  • TikTok (via Tikfinity)
  • YouTube
• No API key required
• Uses simple HTTP endpoints

---

🌐 HTTP Endpoints

Base URL: http://127.0.0.1:6556/

Examples:

http://127.0.0.1:6556/orb?name=USERNAME
http://127.0.0.1:6556/orb?name=USERNAME&lane=2
http://127.0.0.1:6556/orb?name=USERNAME&speed=6.5
http://127.0.0.1:6556/orb?name=USERNAME&color=#FF00FF
http://127.0.0.1:6556/orb?name=USERNAME&color=cyan
http://127.0.0.1:6556/orb?name=USERNAME&h=0.83&s=0.85&v=0.85
http://127.0.0.1:6556/orb?name=USERNAME&hsv=0.83,0.85,0.85
http://127.0.0.1:6556/share

Parameters:

• name → username shown on orb
• lane → 0–3
• speed → orb speed
• color → hex or named color
• h,s,v → HSV values
• hsv → comma format

Share Sequence

GET /share — spawns a Follow → Share → Like → Comment sequence, 200ms apart.

---

⚡ Streamer.bot Preset

A ready-to-use preset is included in the latest release as GeminiOrbFX_Streamer_Bot_Presets.sb.

Just import it into Streamer.bot — no manual setup required.

---

🎮 In-Game Controls

• Main Menu — service mode, status, queue info

• Gameplay Setup — live status, queue + connection state

• Orb Controls — real-time preview, save to keep changes

---

📌 Version

v2.0.0 (Beat Saber 1.40.8 & 1.43.0)

---

❤️ Credits

Created by - Josh / GeminiJoshVR
Chief tester - Swifty / sw1ftyc1

---

🌐 Community

https://discord.gg/swiftyandjoshiesparadise

---

📬 Feedback

Open an issue on GitHub if needed.

---

📜 License

MIT License