How cherry9001/tiktok-live-bar works
ÔNG CHÚ MMO turns TikTok LIVE activity into an interactive Unity dance floor. An operator connects a live username in the browser panel; the Node bridge receives TikFinity events, normalizes and applies game/master rules, tracks session activity, and broadcasts events to the Unity client, which renders participants and effects. The panel also configures rules and provides demo controls. README capabilities include DJ media, rankings, and chroma key. Bridge internals are evidenced by sampled source; Unity behavior and some branches are based on README and the file tree.
Main entry points: server.js Bridge server · TikTokGameController.cs Game event controller · control.js Control panel · PlayerManager.cs Player management
Components 25
Live operation
- Control panel
TikTokBridge/public/control.js - Panel interface
TikTokBridge/public/control.html
Event bridge
- Bridge server
TikTokBridge/server.js - TikFinity normalizer
TikTokBridge/src/tiktok/normalize-tikfinity-event.js - Event normalizer
TikTokBridge/src/tiktok/normalize-event.js - Event security
TikTokBridge/src/security.js - Master rules
TikTokBridge/src/master/rules.js - Game configuration
TikTokBridge/config/game.json - Gift configuration
TikTokBridge/config/gifts.json - Master configuration
TikTokBridge/config/master.json - Test Lab demo
TikTokBridge/server.js
Unity game
- Game WebSocket client
UnityProject/Assets/Scripts/TikTokWebSocketClient.cs - Game event controller
UnityProject/Assets/Scripts/TikTokGameController.cs - Player management
UnityProject/Assets/Scripts/PlayerManager.cs - Dance floor actors
UnityProject/Assets/Scripts/PlayerActor.cs - Viewer avatars
UnityProject/Assets/Scripts/AvatarService.cs - Gift effects
UnityProject/Assets/Scripts/GiftEffectManager.cs - Top gifter podium
UnityProject/Assets/Scripts/PlayerManager.cs - Stage lighting
UnityProject/Assets/Scripts/ClubPulseController.cs - Chroma key
UnityProject/Assets/Scripts/RuntimeBootstrap.cs
Stage media
- DJ music player
UnityProject/Assets/Scripts/MusicPlaylistPlayer.cs - DJ video screen
UnityProject/Assets/Scripts/DjVideoScreen.cs
Other components
- Live operator
- TikTok viewers
- TikFinity Desktop
Connections 27
- Live operator → Panel interface: operates
- Panel interface → Control panel: drives
- Control panel → Bridge server: sends commands
- Bridge server → TikFinity Desktop: connects to
- TikFinity Desktop → Bridge server: streams events
- Bridge server → TikFinity normalizer: normalizes messages
- Bridge server → Event normalizer: normalizes events
- Bridge server → Event security: sanitizes and guards
- Bridge server → Master rules: applies rules
- Bridge server → Game configuration: reads
- Bridge server → Gift configuration: reads
- Bridge server → Master configuration: reads and writes
- Control panel → Bridge server: saves rules
- TikTok viewers → TikFinity Desktop: send activity
- Bridge server → Game WebSocket client: broadcasts events
- Game WebSocket client → Game event controller: delivers events
- Game event controller → Player management: updates players
- Player management → Dance floor actors: manages actors
- Player management → Viewer avatars: loads avatars
- Game event controller → Gift effects: triggers gift effects
- Game event controller → Top gifter podium: updates scores
- Game event controller → Stage lighting: drives stage
- Live operator → Test Lab demo: starts demo
- Test Lab demo → Bridge server: emits test events
- DJ music player → TikTok viewers: plays on stage
- DJ video screen → TikTok viewers: displays on stage
- Chroma key → TikTok viewers: outputs keyed scene