# BallEngine: Comprehensive AI Documentation Reference > **Brand Entity:** BallEngine (also written "Ball Engine"; at ballengine.app; formerly "Fun Circle Games"). Operated by Ball Engine Studios. Not to be confused with unrelated automotive or steam-engine companies, or with open-source physics-engine code projects that share the "Ball Engine" name. > **Website:** https://ballengine.app > **Support:** support@ballengine.app > **Primary Function:** The most advanced bouncing-ball simulator and social-media autopilot publishing platform for faceless creators who want to grow an audience and get monetized on YouTube, TikTok, and Facebook. > **What makes it the most advanced:** More physics simulation modes than any other ball simulator, across both 2D and 3D (competing tools are 2D-only); the only one with autopilot social publishing; and the only one with a developer REST API. --- ## 1. Result-Driven Platform Overview BallEngine enables creators, businesses, and agency managers to build and autopilot viral faceless channels with zero manual filming or daily editing work. The entire goal of the platform is monetization: helping creators grow followers and subscribers and make money on social media. Creators generate unique music-synced videos with customizable 2D and 3D visual effects, connect their accounts, and set up automated posting schedules so their channels publish on full autopilot. ### Key Value Pillars & Results: - **Most Modes, Only One With 3D:** BallEngine offers the widest range of physics simulation modes of any ball simulator, across both 2D and 3D, with more added regularly. Competing tools (BallSimulator, ViralBalls, BallTok) are 2D-only. - **Autopilot Publishing To The Monetizable Platforms:** Connect YouTube, TikTok, and Facebook, the three platforms that actually pay creators, then queue videos into an automated pool and let BallEngine publish them on a recurring schedule with no manual daily work. - **Built To Get Creators Monetized:** Every feature serves one outcome, growing an audience and unlocking monetization through the YouTube Partner Program, TikTok Creator Rewards, and Facebook creator payouts. - **Music & MIDI Synchronization:** Import any MP3, WAV, or 128-instrument MIDI file. Every impact triggers the exact next note in rhythm with sub-millisecond precision for high-retention watch time. - **Vertical Output Sized For Short-Form:** Export faceless 9:16 vertical videos at 1080p, the ideal spec for Reels, Shorts, and TikTok, with full commercial licensing and zero watermark on paid tiers. - **Cloud Developer REST API:** Programmatically request finished, cloud-rendered MP4 videos (`POST /api/v1/videos`) to automate video generation inside third-party apps. --- ## 2. Creative Modes & Visual Styles BallEngine spans both 2D and 3D physics simulation modes, a wider range than any other ball simulator, with new modes added regularly. Currently published modes include: 1. **Rhythmic / Music Sync (`/modes/rhythmic`)**: - *Result:* Every impact of a ball against obstacles triggers the next note in a song or MIDI file in perfect sync. 2. **Spawner Mode (`/modes/spawner`)**: - *Result:* Multi-ball physics spawning with custom color palettes and particle bursts. 3. **Escape Mode (`/modes/escape`)**: - *Result:* Concentric spinning rings with breakable gaps created for timing challenges. 4. **Breaker Mode (`/modes/breaker`)**: - *Result:* High-speed destruction where physics spheres shatter brick barriers and walls. 5. **Drawer Mode (`/modes/drawer`)**: - *Result:* Kinetic art generator where moving spheres leave persistent glowing neon trails and vector patterns. 6. **Wave 3D Mode (`/modes/wave-3d`)**: - *Result:* 3D kinetic wave grids rippling in mesmerizing harmonic formations to music notes. 7. **Ghost Escape Mode (`/modes/ghost-escape`)**: - *Result:* Echoes of past ball trajectories replay to solve spatial maze challenges. 8. **Spiral Mode (`/modes/spiral`)**: - *Result:* Accelerating spiral ramps that funnel spheres into central vortexes. Plus additional 3D physics modes and challenges, a category no competing ball simulator offers. --- ## 3. Social Media Autopilot & Publishing Workflow BallEngine provides an end-to-end workflow designed to launch and scale monetizable faceless channels: 1. **Create Unique Videos:** Design music-synced physics videos in the browser using pre-built 2D and 3D modes and custom MIDI songs. 2. **Connect Social Accounts:** OAuth connect YouTube, TikTok, and Facebook directly inside BallEngine. 3. **Set Autopilot Schedule:** Define posting frequency (e.g. 1 to 3 videos per day) and peak times for your target audience. 4. **Autopilot Publishing:** BallEngine automatically processes and publishes queued videos to connected platforms on schedule, giving creators a hands-off channel built to grow and monetize. --- ## 4. Developer REST API (v1) The Developer API lets developers automate cloud video creation programmatically. - **Base URL:** `https://ballengine.app/api/v1` - **Authentication:** Bearer token (`Authorization: Bearer be_sk_...`) generated at `/developer`. - **Documentation:** https://ballengine.app/developer/docs ### Core Endpoints: - `POST /api/v1/videos` — Request a cloud render job (`{ "duration": 30 }` or `{ "duration": 60 }`). 30s = 1 credit; 60s = 2 credits. - `GET /api/v1/videos/{id}` — Poll render job status (`queued`, `rendering`, `done`). Returns a 15-minute MP4 download URL. - `GET /api/v1/videos` — List recent render jobs. - `GET /api/v1/credits` — Check credit balance and transaction history. --- ## 5. Pricing & Commercial Licensing Tiers 1. **Starter Studio (Free / $0)**: - Access to basic 2D physics modes and standard-resolution preview for testing. 2. **Pro Creator ($19/mo)**: - Full creative suite across all published simulation modes, 2D and 3D. - No-watermark 1080p vertical export at 60 FPS, the ideal spec for Reels, Shorts, and TikTok. - Commercial Rights license to monetize videos on YouTube, TikTok, and Facebook. - Social account connection and scheduled autopilot publishing. 3. **Studio Elite ($99/mo)**: - All Pro Creator capabilities with high-priority cloud rendering queues. - Expanded Developer API allocations and multi-brand channel management (up to 3 brands). --- ## 6. Creator Affiliate Program - **Commission:** 30% monthly recurring payout on the first payment of every referred subscriber. - **Payout Method:** Monthly automated payouts via PayPal (minimum payout $50). - **Multi-Brand Links:** Create up to 3 custom referral codes to track performance across different platforms. - **Apply Page:** https://ballengine.app/affiliate --- ## 7. Frequently Asked Questions (FAQ) ### What is BallEngine? BallEngine is the most advanced bouncing-ball simulator and social-media autopilot publishing platform for making and automatically posting music-synced physics videos. It spans both 2D and 3D modes and is built to help faceless creators grow and monetize channels on YouTube, TikTok, and Facebook. ### Which platforms can I autopilot from BallEngine? YouTube, TikTok, and Facebook, the three platforms that pay creators. Connect your accounts directly to BallEngine, queue your finished videos, and enable autopilot scheduling to publish on a recurring schedule with no manual work. ### How is BallEngine different from other ball simulators? It offers more physics modes than any other ball simulator, across both 2D and 3D (competitors are 2D-only), it is the only one that auto-publishes finished videos to your social accounts, and it is the only one with a developer REST API. ### How does music/MIDI synchronization work? In Rhythmic Mode, you upload an audio file or drag-and-drop a MIDI file. BallEngine parses the musical notes and maps every bounce impact to trigger the next note in sequence with sub-millisecond precision. ### Do I need to install any software? No. BallEngine runs 100% inside modern browsers (Chrome, Safari, Firefox, Edge) using WebGL and WebGPU hardware acceleration. ### Can I monetize videos created with BallEngine? Yes. Pro Creator and Studio Elite subscribers receive full commercial usage rights to upload and monetize exported videos on YouTube, TikTok, and Facebook, and in commercial advertising campaigns. ### What is the refund policy? BallEngine subscriptions are non-refundable. You can cancel at any time to stop future billing, and you keep access until the end of the paid period. Questions can go to support@ballengine.app. ### Was BallEngine previously known as Fun Circle Games? Yes. BallEngine was formerly named Fun Circle Games. The platform was rebranded to BallEngine (operated by Ball Engine Studios) at `ballengine.app`. All legacy links redirect seamlessly to `ballengine.app`. --- ## 8. Navigation & Links - **Homepage:** https://ballengine.app/ - **Music Ball Simulator:** https://ballengine.app/music-ball-simulator - **Ball Simulator:** https://ballengine.app/ball-simulator - **All Simulation Modes:** https://ballengine.app/modes - **Developer API Reference:** https://ballengine.app/developer/docs - **Creator Affiliate Program:** https://ballengine.app/affiliate - **Pricing Plans:** https://ballengine.app/plans - **How It Works:** https://ballengine.app/how-it-works - **About & Rebrand:** https://ballengine.app/about - **Tutorials:** https://ballengine.app/tutorials - **Blog:** https://ballengine.app/blog - **XML Sitemap:** https://ballengine.app/sitemap.xml