Entrenador de Carambola Guiada is a browser-based Progressive Web App (PWA) designed to help players master three-cushion carambola billiards. This page covers what the trainer includes, how its core components work together, the two available play modes, and how to access and install the app on any device.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/losyoguis/149tresbandas/llms.txt
Use this file to discover all available pages before exploring further.
What the Trainer Is
Entrenador de Carambola Guiada is a pure HTML/CSS/JavaScript application that runs entirely in the browser — no account, no download, and no backend required. It ships with 148 guided plays (numbered 001–079 and 081–149) drawn from a professional video tutorial series, each one backed by reference images, a master guide route, and a real physics engine. The app is designed around a single principle: Tirar always fires real physics. The white ball responds to your cue angle, power, and spin exactly as it would on a real table. The master guide (green band) and the predictive yellow line help you understand the ideal trajectory before you shoot — but they do not force the ball along that path. If you want to watch the exact reference route animate without affecting your score, use Demostración.Play 080 is not available in the trainer because no reference images exist for it. The play selector shows all 148 active plays numbered 001–079 and 081–149. Play 080 appears in the selector as a disabled option so the numbering gap is visible and clearly intentional — it is not a technical error.
Key Components
The trainer is built around a set of interactive components that work together on a single screen.| Component | Description |
|---|---|
| Billiard table canvas | A full-width responsive canvas rendering the three-cushion table with diamond markers, three balls, and all animated trajectories. |
| Cue stick control | Drag the cue handle (circle) to aim at the cue ball. The further you pull the handle back, the more power is loaded (5%–160%). |
| Effect (spin) dot | A draggable blue dot on the effect ball (bottom-left of the table). Moving it sets top spin, back spin, or lateral (left/right) english on the cue ball. |
| Master guide (green band) | A persistent luminous green band that appears automatically when a play is selected. It traces the exact reference route from the video tutorial and remains visible throughout the shot for comparison. |
| Predictive yellow line | A dynamic yellow line that updates in real time as you adjust the cue, power, or effect. It predicts the cue ball’s actual physical path using the same physics engine as the shot itself. |
| Deflection guide panel | A side panel showing the real contact angle between the cue ball and the target ball for the current aim. Thickness options include Efecto (spin from play image), Fino, ¼ ball, ½ ball, ¾ ball, and Full. |
| Scoreboard | Tracks Points, Attempts, and Cushions hit across your session. A Reiniciar button resets the counters without moving the balls. |
| Video tutorial modal | Opens a video modal that jumps directly to the timestamp of the selected play, letting you study the reference shot before attempting it. |
| Instructions modal | A step-by-step walkthrough (opened with the Instrucciones button) that guides you through selecting a play, memorizing the route, setting effect, aiming, adjusting power, and shooting. |
Play Modes
Practice mode activates when you choose a play from the Selecciona la carambola dropdown. The master guide (green band) appears immediately, the balls are placed in the play’s reference position, and the cue is set to 5% power so you must consciously dial in the force yourself. Every press of Tirar counts toward your Attempts total; a successful three-cushion carambola adds a Point. Free mode (activated with Modo libre or Ubicar bolas) lets you place the three balls anywhere on the table and shoot with full physical freedom. Free mode is ideal for working on your own systems without being tied to a specific reference play. Points and attempts still accumulate, and the illumination effect activates whenever the predictive guide shows a 3-or-more-cushion trajectory.PWA — Install and Use Offline
The trainer is a fully compliant Progressive Web App. After the first load, all assets are cached by the service worker and the app works completely offline.| Platform | How to install |
|---|---|
| Android (Chrome) | Menu → Add to Home Screen or Install app |
| iOS (Safari) | Share → Add to Home Screen |
| Desktop (Chrome/Edge) | Address bar install icon, or browser menu → Install |
Deployment
The trainer is designed for zero-configuration hosting. It runs directly fromindex.html, deploys to GitHub Pages in three steps (see Installation), and can be embedded in Google Sites via Insert → Embed → URL. A .nojekyll file is included to prevent GitHub’s Jekyll processor from interfering with the assets/ folder.
Where to Go Next
Quickstart
Open the trainer, select your first play, and fire your first guided carambola in under five minutes.
Practice Mode Guide
Deep dive into practice mode: the master guide, the smart magnet, play selection, and scoring.
Physics Engine
How the professional physics engine handles cushion rebound, spin decay, throw, and ball collisions.
Guide System
The master guide, predictive yellow line, deflection panel, and smart magnet explained in detail.