What you're seeing
This section is for issues that occur during calibration, for information regarding puck detection issues during gameplay please see Puck Detection Issues and Camera Issues. Below are some specific problems that may occur during calibration and their related fixes.
Issues
Calibration won't progress - Red puck detected in the wrong spot
Calibration uses the red puck as the central reference point.
Steps
- Ensure the red puck is placed within a couple of centimeters of the center of the thumbprint/circle marked on the table.
- Remove all other red pucks from the camera's view before calibrating. Extra red pucks can confuse the system.
If you have positioned the red puck correctly and the system still won't progress, take a photo of the table from above and contact GXT.
Calibration won't progress - Blue pucks in the wrong spot
The blue pucks tell the system where the corners of the table and the foul line are. Misplacing them is the most common reason calibration fails.
- TV-end blue pucks: Place them in the two corners closest to the TV. The outer edge of each puck should be flush with the edge of the table (when viewed directly from above) and not overhanging.
- Foul-line blue pucks: Place them just over the foul line so the back edge of the puck lines up with the scoring side of the foul line, not overhanging it. The side of each puck should also be flush with the edge of the table.
- A very common mistake is placing the foul-line pucks on the 1-point line instead of the foul line. Double-check before retrying.
Camera Obstruction
The camera needs an unobstructed view of the full table. The camera feeds can be viewed by finding the relevant option in the Cameras tab.
- A common culprit is a TV on a movable wall bracket that has swung away from the wall, blocking the camera's view of pucks near the end of the table. Push it flat against the wall.
Dirty Camera Lens
A dirty or streaked camera lens degrades calibration accuracy and can cause the calibration to fail outright.
- Check the lens is clean and streak-free.
- Use a clean microfiber cloth only.
Incorrect lighting
The Neoshuffle camera depends on stable, even lighting across the table.
- Confirm the lightbar above the table is switched on. Detection reliability may drop significantly without it.
- Avoid harsh spotlights pointing directly at the table.
- Avoid laser lights, strobes, or disco balls anywhere they hit the table - they introduce moving brightness that interferes with detection.
Next Steps
Contact GXT if:
- The calibration view is blank or white (camera issue - resolve that first via Camera Issues)
- Calibration fails to save despite a stable internet connection
- Pucks still score incorrectly after two clean calibrations
Please provide:
- Affected lane ID (s)
- A photo of the camera feed while calibrating (if applicable)