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 supports mouse, touch, keyboard, and TV remote input across desktop, mobile, tablet, and full-screen table mode. This page documents every button, shortcut, and gesture available in the app.
Main Action Buttons
The bottom action bar contains all primary controls for the table. In Full-Screen Table mode on mobile, most of these buttons move into the Opciones modal to maximize playing area.
| Button (ES) | Button (EN) | Function |
|---|
| Tirar | Shoot | Fires the cue ball with real physics; counts as one attempt. A valid carambola (3+ cushions) adds a point. |
| Demostración | Demo | Animates the reference master route on the table. Does not count as an attempt or add to the score. Only available when a play is selected. |
| Repetir tiro | Repeat Shot | Restores ball positions to exactly where they were just before the last shot. |
| Ver replay | Watch Replay | Replays the last shot’s full ball motion. Available after each shot. |
| Guía: OFF / Guía: ON | Guide | Toggles the predictive yellow aim line ON/OFF. Label shows current state: Guía: OFF when disabled, Guía: ON when active. |
| Modo libre | Free Mode | Toggles Free Mode ON/OFF. Label shows state: Modo libre: ON or Modo libre: OFF. |
| Ubicar bolas | Place Balls | Toggles ball-placement drag mode ON/OFF. Label shows state: Ubicar bolas: ON/OFF. |
| Nueva posición | New Position | Randomizes all three ball positions on the table. |
| Mesa completa | Full Table | Activates full-screen table mode for fingers or TV remote play. |
| Videotutorial | Video | Opens the video tutorial modal, synchronized to the start position of the selected play. |
| Instrucciones | Instructions | Opens the step-by-step shot guidance modal (select play → observe → aim → adjust → shoot). |
| Reiniciar | Reset Score | Resets Points, Attempts, and Bandas (Cushions) to 0. Ball positions are not changed. |
Keyboard Shortcuts
Keyboard shortcuts work in the main view and in Full-Screen Table mode on desktop. While any modal is open, Enter does not fire the shot.
| Key | Action |
|---|
| Space or Enter | Shoot (Tirar) |
| Escape | Exit Full-Screen Table mode (Mesa completa) |
| F | Toggle Full-Screen Table mode on/off |
| Arrow Left / Right | Adjust cue direction (TV remote mode) |
| Arrow Up / Down | Adjust power (TV remote mode) |
| OK / Enter | Shoot — also the TV remote OK button |
| T | Load the next practice play in sequence |
| U | Toggle ball-placement mode (Ubicar bolas) |
Touch and Mobile Gestures
The app is a full PWA optimized for Android and iOS.
- Aim the cue — Drag the cue handle (the small circle at the far end of the stick) to rotate the cue around the white ball.
- Set power — Pull the cue handle away from the white ball. The further you pull, the higher the power percentage shown in the Potencia badge near the cue.
- Accumulate power across multiple drags — On mobile, power carries over between drag gestures. Lift your finger at 60%, re-touch, and drag further to continue increasing power without resetting. You can also reduce power by moving the cue handle back toward the white ball.
- Set spin (effect) — Tap or drag the blue effect dot on the cue ball image to set the spin contact point.
- Drag balls (Place Balls mode) — When Ubicar bolas is ON, tap and drag any ball to reposition it anywhere on the cloth.
Full-Screen Table Mode
Press Mesa completa or the F key to enter Full-Screen Table mode. The app attempts native fullscreen; if the browser or host (e.g., Google Sites) restricts the Fullscreen API, the table expands via CSS to maximize available space.
Mobile Layout (Android / iOS)
| Element | Position |
|---|
| Tirar (large circular button) | Fixed, bottom-right |
| Effect ball (large, interactive) | Fixed, bottom-left |
| Opciones button | Top-left |
| Salir button | Top-right |
Desktop and TV Layout
In Full-Screen Table mode on wider screens, a compact sidebar appears on the right with the play selector and key controls — Tirar, Repetir tiro, Guía, Modo libre, Ubicar bolas, and exit — without covering the playing surface.
TV Remote Navigation
The Entrenador supports TV remote controls and keyboard-only navigation through full arrow-key and OK/Enter bindings. An on-screen hint reads: Control remoto: ◀ ▶ apunta · ▲ ▼ potencia · OK tira · Atrás sale.
| Remote Button | Action |
|---|
| ◀ Arrow Left | Rotate cue left |
| ▶ Arrow Right | Rotate cue right |
| ▲ Arrow Up | Increase power |
| ▼ Arrow Down | Decrease power |
| OK / Enter | Shoot (Tirar) |
| Back / Escape | Exit Full-Screen Table mode |
In Full-Screen Table mode on mobile, the Guía dinámica: contacto real entre bolas (dynamic deflection guide) panel is hidden to maximize the playing area. The deflection guide is fully visible on desktop, tablet, and TV screens. To use the deflection guide on mobile, exit Full-Screen Table mode first.