Skip to main content

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.

The Entrenador de Carambola Guiada layers three distinct visual systems on top of the billiard table to help you understand and reproduce three-cushion patterns. Each layer serves a different purpose — reference, prediction, and assisted alignment — and they work together without interfering with the real physics of the shot.

​
Master Guide (Green Band)

When you select a play from the dropdown, the table immediately displays a persistent luminous green band that traces the exact calibrated route extracted from the video reference. This is the Guía principal — the gold-standard line you are training to match. Key characteristics of the master guide:
  • Appears as soon as a play is selected; you do not need to press any button
  • Remains fully visible throughout the shot, during ball travel, and through replay
  • Does not disappear when Tirar is pressed — it stays as a fixed reference while the balls roll
  • Rendered as a green luminous band drawn underneath the yellow dashed predictive line, so both layers are readable simultaneously
  • Extracted directly from recorrido_guia.webp (image 2 of each play), not generated by an algorithm — it represents exactly what appears in the tutorial video
The master guide is the foundation of practice. Even when you shoot off-line, the green band remains so you can immediately see how far you deviated.

​
Predictive Yellow Line

The yellow dashed line is a real-time physics preview of where the cue ball will travel if you fire right now with the current direction, power, and effect setting. How it updates:
  • Recalculated every frame as you move the cue, adjust power, or drag the effect dot
  • Uses the same physics engine as the real shot — identical friction, restitution, spin coefficients, and sub-step collision resolution
  • Follows the cue ball through all cushion contacts until the ball stops or the simulation step budget is exhausted
  • When your aim deviates from the master route, the yellow line diverges from the green band and shows the free-physics prediction for your actual setup
  • Toggle visibility on and off with the Guía button in the action bar
The yellow line is the most honest feedback tool in the app: it shows you not what you should do, but what your current setup will actually produce.

​
Magnetic Assist (Smart Snap)

When the yellow predictive line drifts close to the green master route, the guide system activates a smart magnetic snap that aligns the yellow line precisely to the reference trajectory. Conditions for snap activation:
  1. The projected trajectory is geometrically near the master route
  2. The cue direction is compatible (not pointing the wrong way)
  3. Balls are in the base position for the selected play
  4. The first object ball matches the play’s required first contact
When all conditions are met, the yellow guide locks onto the green band and the two lines visually merge. Pressing Tirar in this state executes the master route with real physics corrections — the shot is not scripted; the engine applies the calibrated direction and power but still simulates cloth friction, spin decay, and cushion restitution normally. Disengaging the snap:
  • Moving the cue manually beyond the snap tolerance
  • Changing power or effect setting
  • Repositioning any ball with Ubicar bolas
Any of these actions returns the trainer to free physics prediction mode immediately.

​
Deflection Guide Panel

Below the table (hidden on mobile to maximise playing area) is the Guía dinámica: contacto real entre bolas panel. This interactive panel shows a real-time ball-to-ball contact diagram. Thickness buttons let you explore how the cue ball deflects at different contact ratios:
ButtonContact Fraction
FinoThin contact
1/4 de bolaQuarter ball
1/2 bolaHalf ball
3/4 de bolaThree-quarter ball
LlenaFull ball
Click Efecto to load the reference contact point and effect value for the currently selected play — this synchronises the mini-diagram with the blue dot position used in the tutorial video for that exact carambola. The readout text above the diagram updates with a description of how the cue ball deflects at the chosen thickness, including the influence of any spin applied.

​
Neon Illumination

When the predictive guide anticipates a valid three-cushion carom (3 or more cushion contacts followed by a close on the second object ball), the guide line illuminates in neon cyan/violet. This is a pre-shot signal — the illumination fires on the prediction, before you even press Tirar. The cue ball simultaneously receives a bright halo to help you locate the striker on a busy table. Illumination also triggers when the predictive line coincides with or closely approaches the green master route for the selected play, reinforcing that your current setup is aligned with the reference. The glow is intentionally brief and non-intrusive — it confirms your aim without distracting your focus for the next shot.
The green master band is always visible as your reference, even after a missed shot. If your yellow line and the ball trail diverge from the green route, you can immediately diagnose whether the error was in direction, power, or effect — without needing to press Demostración or watch the video again.

Build docs developers (and LLMs) love

Get started for freeTalk to us