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.

This page walks you through everything you need to execute your first guided three-cushion carambola — from opening the app to reading the scoreboard — in under five minutes. No installation, account, or prior setup is required.
1

Open the trainer

Visit https://losyoguis.github.io/149tresbandas/ in any modern browser (Chrome, Firefox, Safari, or Edge). The app loads directly from GitHub Pages with no installation or account required.If you prefer to run it locally, open index.html from a cloned or downloaded copy of the repository — see Installation for details. The app is fully self-contained and works immediately.
2

Select a play

Use the Selecciona la carambola dropdown at the top of the screen to choose a play numbered 001–149.
  • Plays 001–079 and 081–149 are active (148 total).
  • Play 080 is listed but disabled — no reference images exist for it.
As soon as you select a play, the balls snap to the reference starting position and the master guide (a luminous green band) appears on the table, tracing the exact route from the video tutorial. The cue is pre-aimed and the power is set to 5% so you have full control over the force.
3

Watch the reference

Before shooting, study the play using one of two reference tools:
  • Click Videotutorial to open the video modal, which automatically jumps to the timestamp for the selected play. Watch the shot in the video, then close the modal to return to the table.
  • Click Demostración to watch the reference trajectory animate directly on the table canvas. The cue ball follows the exact master route. Demostración does not count toward your score — it is purely for study.
Both options are available at any time before or after shooting.
4

Set your effect

Drag the blue dot on the effect ball control (displayed at the bottom-left of the table area) to choose your spin:
Dot positionEffect applied
CenterNo spin (plain ball)
TopTop spin — cue ball runs forward after contact
BottomBack spin / draw — cue ball reverses after contact
Left or RightLateral english — modifies cushion rebound angle
The effect dot position is reflected immediately in the predictive yellow line and in the deflection guide panel.
5

Aim

Drag the cue handle (the circle at the end of the cue stick) to rotate the cue and point it at the target ball. On a touchscreen, use a single finger on the cue handle; on desktop, click and drag.The yellow predictive line updates in real time as you move the cue, showing the projected physical path of the cue ball given your current aim, power, and effect. What you see in the yellow line is exactly what the ball will do when you shoot.The deflection guide panel (below the scoreboard) shows the contact angle and thickness for your current aim — use it to fine-tune whether you are hitting the target ball full, ¾, ½, or ¼.
6

Set power

Pull the cue handle further away from the cue ball to increase power. The power badge near the cue displays the current percentage.
  • Power range: 5% – 160%
  • Most plays work well in the 40%–90% range
  • Plays with long three-cushion routes may need 100%–160%
  • On mobile, you can load power in stages — lift your finger and pull again to continue increasing without resetting
The yellow predictive line updates as power changes, so you can see the longer or shorter route before committing to the shot.
7

Shoot

Press Tirar, or use the keyboard shortcut Space or Enter, to fire the shot.The white ball launches with real physics: cushion rebound depends on approach angle, velocity, and spin; ball collisions include throw, follow, and draw transfer. After the ball stops, check the scoreboard:
CounterWhat it tracks
PuntosSuccessful three-cushion carambolas
IntentosTotal shots fired
BandasCushions hit on the last shot
If the cue ball completes a valid three-cushion carambola, the table illuminates to celebrate the result. Use Repetir tiro to reset to the same starting position and try again, or pick a new play from the dropdown.
Start with play 001 and gradually increase power from 5% upward, shot by shot. Watching how the trajectory opens or closes with each power increment is the fastest way to develop an intuition for how speed, cushion angle, and spin interact on a three-cushion table.
Tirar always uses real physics — the ball goes where your cue, power, and effect send it. If you want to see the exact reference route for the selected play without affecting your score, use Demostración. It animates the master trajectory on the table but does not increment Puntos or Intentos.

Build docs developers (and LLMs) love