TikTok Football Mechanics Prototype

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.