TikTok Football Mechanics Prototype

About the project

Project Description I’m looking for a JavaScript / Three.js developer to build a 3D football battle overlay for TikTok LIVE, designed to run directly inside OBS as a Browser Source in a 9:16 portrait format. This is an MVP/prototype, so simulated/test gift events are completely acceptable. A full TikTok API integration is not required for this first version. Core Gameplay & Features - Two distinct 3D football-style characters - Compact 3D football arena/pitch - Automatic kickoff and continuous match loop - Automatic ball movement and goal detection - Real-time score updates - Idle, movement, and celebration animations - Simulated gift events through on-screen test buttons and keyboard hotkeys - Gift events influence gameplay and/or score - Automatic player/ball reset after each goal - Match continues automatically and indefinitely - Responsive 9:16 portrait layout suitable for OBS Browser Source Technology - JavaScript - Three.js or another suitable web-friendly 3D framework - HTML/CSS - OBS Browser Source - Local/offline execution Deliverables - Complete project/source folder - 3D character models and textures, or suitable placeholders - All required assets - Clearly licensed third-party libraries/assets - Clean and commented source code - Windows setup and launch instructions - Working local build that can run on a fresh Windows machine Acceptance Criteria When I launch the project in OBS as a Browser Source: 1. A 9:16 portrait 3D football arena appears. 2. Two characters are visible and animated. 3. The match starts automatically. 4. Goals are detected automatically and the score updates immediately. 5. A test gift button/keyboard hotkey triggers the configured gameplay or scoring effect. 6. Characters perform the appropriate animation. 7. Players and ball reset correctly after a goal. 8. The match continues automatically without manual intervention. The priority is a smooth, visually appealing and reliable prototype that demonstrates the core TikTok LIVE football battle concept. Full TikTok API/live gift integration and advanced UI can be added in a later phase.

Skills required