
Whack-a-mole style event game
TAP IN TIME
User Manual · English • Deutsch • Français • Español
TAP IN TIME — User Manual
Welcome. This guide shows you how to run and manage your TAP IN TIME reflex game. Everything needed is already on the USB stick — no installation and no technical knowledge required. Just plug it into a Windows computer and follow the steps below.
1. Running the game
The USB stick contains the game and its own copy of everything it needs to run. You do not install anything.
- Plug the USB stick into a free USB port on any Windows computer.
- Open the USB stick in File Explorer (This PC → your USB drive).
- Double-click start_game.bat. The game opens in full screen after a few seconds.
- Play using the physical buttons, the touchscreen, or number keys 1–9.
- To close the game, press the Esc key. Press F at any time to switch between full screen and window.
2. How the game works
TAP IN TIME is a “whack-a-style” reflex game on a 3×3 grid of nine targets. It draws a crowd and runs by itself, unattended.
- Attract screen: when idle, the machine loops music, the leaderboard and the rules to pull players in.
- Choose a scene: if theme choice is on, a player presses a button to pick one of nine themes (mole, egg, bug, space, gem, ghost, fire, balloon, zombie), then presses again to start. Otherwise any press starts the game.
- Countdown: a 3-2-1 countdown, then “GO!”
- Play: targets pop up around the grid. Hit each one before it disappears. Faster reactions score more points.
- Time’s up: the round lasts for the set game time, then the final score counts up on screen.
- Leaderboard & contact capture: a top score lets the player enter their initials, and (if enabled) their name and e-mail for a prize draw. The all-time and daily leaderboard is then shown before the machine returns to the attract screen.
3. Reaching the admin panel
All settings are behind a hidden gesture so players cannot reach them by accident. There is no password.
4. What the admin settings do
In the Settings panel, use the − and + buttons on each row to change a value:
| Setting | Range | What it does |
|---|---|---|
| Scene | 9 themes | Sets the visual theme (mole, egg, bug, space, gem, ghost, fire, balloon, zombie). |
| Game time | 10–120 sec | How long one round lasts. Default is around 25–30 seconds. |
| Difficulty | Easy / Normal / Hard | How fast targets appear and how long they stay up. |
| Game speed | 1–10 | Fine-tunes the overall pace on top of the difficulty setting. |
| Countdown time | 5–60 sec | How long the on-screen input timers wait (e.g. the prize-draw entry screen) before timing out. |
| Music volume | 0–10 | Volume of the background music. |
| SFX volume | 0–10 | Volume of the sound effects (clicks, hits, countdown). |
| Language | EN / NL / DE / FR / ES | On-screen language for players: English, Dutch, German, French, Spanish. |
Below the sliders are four on/off switches (tap to toggle ON/OFF):
| Switch | State | What it does |
|---|---|---|
| Theme choice | ON / OFF | When ON, players can pick their own scene on the attract screen. When OFF, any press starts the game with your chosen scene. |
| Attract audio | ON / OFF | Turns the idle background music on or off. |
| Branding | ON / OFF | Shows your own sponsor/logo images on the attract screen (place image files in the “branding” folder). |
| Capture e-mail | ON / OFF | When ON, high-scoring players are asked for their name and e-mail for a prize draw — this is how you collect contacts. |
At the bottom of the panel are the action buttons:
- View analytics — opens the statistics screen (see below).
- Reset high scores — clears the leaderboard. Tap once, then tap again to confirm.
- Test ESP32 — checks that the physical button controller is connected and working.
- Close — saves your settings and returns to the game.
The analytics screen
Tap View analytics to see how the machine is performing:
- Total games started — the running total (with its own Reset button).
- Games today — today’s total, plus a bar graph of plays per hour.
- % left initials — how many finishers typed their initials.
- % entered e-mail — how many of those asked gave their e-mail address.
- Tap Back to return to Settings, or Close to exit.
5. Retrieving stored information
Everything the machine records is saved as ordinary files in the same folder as the game, right on the USB stick. Nothing is sent online — your data stays with you.
| File on the USB stick | What it contains |
|---|---|
| whackamole_raffle.csv | Your leads. Every captured contact: date/time, name, e-mail, score and rank. This is the file you want for follow-up and prize draws. |
| whackamole_play_log.csv | Every game played: date/time, score, hits, misses, accuracy, best reaction time and rank. |
| whackamole_highscores.json | The current leaderboard (all-time and daily best scores). |
| whackamole_analytics.json | The behind-the-scenes totals shown on the analytics screen. |
How to open your data
- Close the game (press Esc).
- Open the USB stick in File Explorer.
- Copy whackamole_raffle.csv (and the play log, if you want it) to your computer.
- Double-click the file to open it in Excel, Numbers or Google Sheets. The columns are labelled for you.
TAP IN TIME — Benutzerhandbuch
Willkommen. Diese Anleitung zeigt Ihnen, wie Sie Ihr TAP IN TIME Reaktionsspiel starten und verwalten. Alles Nötige befindet sich bereits auf dem USB-Stick — keine Installation und kein technisches Wissen erforderlich. Stecken Sie ihn einfach in einen Windows-Computer und folgen Sie den Schritten unten.
1. Das Spiel starten
Der USB-Stick enthält das Spiel und alles, was es zum Laufen braucht. Sie müssen nichts installieren.
- Stecken Sie den USB-Stick in einen freien USB-Anschluss eines beliebigen Windows-Computers.
- Öffnen Sie den USB-Stick im Datei-Explorer (Dieser PC → Ihr USB-Laufwerk).
- Doppelklicken Sie auf start_game.bat. Nach wenigen Sekunden startet das Spiel im Vollbild.
- Spielen Sie mit den physischen Tasten, dem Touchscreen oder den Zifferntasten 1–9.
- Zum Beenden drücken Sie die Esc-Taste. Mit F wechseln Sie jederzeit zwischen Vollbild und Fenster.
2. So funktioniert das Spiel
TAP IN TIME ist ein „Whack-a-Style“-Reaktionsspiel auf einem 3×3-Raster mit neun Zielen. Es zieht Publikum an und läuft von allein, ohne Aufsicht.
- Anzeigebildschirm: im Ruhezustand laufen Musik, Bestenliste und Spielregeln in Schleife, um Spieler anzulocken.
- Motiv wählen: ist die Themenauswahl aktiv, drückt der Spieler eine Taste, um eines von neun Themen zu wählen (Maulwurf, Ei, Käfer, Weltraum, Edelstein, Geist, Feuer, Ballon, Zombie), und drückt erneut zum Starten. Sonst startet jeder Tastendruck das Spiel.
- Countdown: ein 3-2-1-Countdown, dann „GO!“
- Spielen: Ziele tauchen im Raster auf. Treffen Sie jedes, bevor es verschwindet. Schnellere Reaktionen bringen mehr Punkte.
- Zeit abgelaufen: die Runde dauert die eingestellte Spielzeit, danach zählt der Endstand auf dem Bildschirm hoch.
- Bestenliste & Kontakterfassung: bei einem Spitzenwert gibt der Spieler seine Initialen ein und (falls aktiviert) Name und E-Mail für ein Gewinnspiel. Danach wird die Bestenliste (aller Zeiten und des Tages) gezeigt, bevor die Maschine zum Anzeigebildschirm zurückkehrt.
3. Das Admin-Menü öffnen
Alle Einstellungen sind hinter einer versteckten Geste, damit Spieler nicht versehentlich hineingelangen. Es gibt kein Passwort.
4. Was die Admin-Einstellungen bewirken
Verwenden Sie im Einstellungsmenü die Schaltflächen − und + in jeder Zeile, um einen Wert zu ändern:
| Einstellung | Bereich | Wirkung |
|---|---|---|
| Motiv (Scene) | 9 Themen | Legt das visuelle Thema fest (Maulwurf, Ei, Käfer, Weltraum, Edelstein, Geist, Feuer, Ballon, Zombie). |
| Spielzeit | 10–120 Sek. | Wie lange eine Runde dauert. Standard ist etwa 25–30 Sekunden. |
| Schwierigkeit | Easy / Normal / Hard | Wie schnell Ziele erscheinen und wie lange sie oben bleiben. |
| Spielgeschwindigkeit | 1–10 | Feinabstimmung des Gesamttempos zusätzlich zur Schwierigkeit. |
| Countdown-Zeit | 5–60 Sek. | Wie lange die Eingabe-Timer auf dem Bildschirm (z. B. das Gewinnspiel-Formular) warten, bevor sie ablaufen. |
| Musiklautstärke | 0–10 | Lautstärke der Hintergrundmusik. |
| SFX-Lautstärke | 0–10 | Lautstärke der Soundeffekte (Klicks, Treffer, Countdown). |
| Sprache | EN / NL / DE / FR / ES | Bildschirmsprache für Spieler: Englisch, Niederländisch, Deutsch, Französisch, Spanisch. |
Unter den Reglern befinden sich vier Ein/Aus-Schalter (zum Umschalten antippen):
| Schalter | Zustand | Wirkung |
|---|---|---|
| Themenauswahl | EIN / AUS | Bei EIN können Spieler ihr Motiv selbst wählen. Bei AUS startet jeder Tastendruck das Spiel mit dem von Ihnen gewählten Motiv. |
| Attract-Audio | EIN / AUS | Schaltet die Hintergrundmusik im Ruhezustand ein oder aus. |
| Branding | EIN / AUS | Zeigt Ihre eigenen Sponsoren-/Logo-Bilder auf dem Anzeigebildschirm (Bilddateien in den Ordner „branding“ legen). |
| E-Mail erfassen | EIN / AUS | Bei EIN werden Spieler mit hoher Punktzahl nach Name und E-Mail für ein Gewinnspiel gefragt — so sammeln Sie Kontakte. |
Am unteren Rand des Menüs befinden sich die Aktionsschaltflächen:
- View analytics (Statistik) — öffnet den Statistikbildschirm (siehe unten).
- Reset high scores (Bestenliste zurücksetzen) — löscht die Bestenliste. Einmal tippen, dann zur Bestätigung erneut tippen.
- Test ESP32 — prüft, ob die Tasten-Steuerung angeschlossen ist und funktioniert.
- Close (Schließen) — speichert Ihre Einstellungen und kehrt zum Spiel zurück.
Der Statistikbildschirm
Tippen Sie auf View analytics, um zu sehen, wie die Maschine läuft:
- Gestartete Spiele insgesamt — die laufende Gesamtzahl (mit eigener Reset-Taste).
- Spiele heute — die heutige Summe plus ein Balkendiagramm der Spiele pro Stunde.
- % Initialen eingegeben — wie viele Spieler ihre Initialen eingaben.
- % E-Mail eingegeben — wie viele der Gefragten ihre E-Mail-Adresse angaben.
- Tippen Sie auf Back (Zurück) für die Einstellungen oder Close zum Beenden.
5. Gespeicherte Daten abrufen
Alles, was die Maschine aufzeichnet, wird als gewöhnliche Datei im selben Ordner wie das Spiel gespeichert — direkt auf dem USB-Stick. Nichts wird online gesendet — Ihre Daten bleiben bei Ihnen.
| Datei auf dem USB-Stick | Inhalt |
|---|---|
| whackamole_raffle.csv | Ihre Kontakte. Jeder erfasste Kontakt: Datum/Uhrzeit, Name, E-Mail, Punktzahl und Rang. Diese Datei brauchen Sie für Nachfassaktionen und Gewinnspiele. |
| whackamole_play_log.csv | Jedes gespielte Spiel: Datum/Uhrzeit, Punktzahl, Treffer, Fehlversuche, Genauigkeit, beste Reaktionszeit und Rang. |
| whackamole_highscores.json | Die aktuelle Bestenliste (Bestwerte aller Zeiten und des Tages). |
| whackamole_analytics.json | Die Hintergrund-Summen, die auf dem Statistikbildschirm angezeigt werden. |
So öffnen Sie Ihre Daten
- Beenden Sie das Spiel (Taste Esc).
- Öffnen Sie den USB-Stick im Datei-Explorer.
- Kopieren Sie whackamole_raffle.csv (und bei Bedarf das Spielprotokoll) auf Ihren Computer.
- Doppelklicken Sie die Datei, um sie in Excel, Numbers oder Google Sheets zu öffnen. Die Spalten sind beschriftet.
TAP IN TIME — Manuel d’utilisation
Bienvenue. Ce guide vous montre comment lancer et gérer votre jeu de réflexes TAP IN TIME. Tout le nécessaire se trouve déjà sur la clé USB — aucune installation ni connaissance technique requise. Branchez-la simplement sur un ordinateur Windows et suivez les étapes ci-dessous.
1. Lancer le jeu
La clé USB contient le jeu et sa propre copie de tout ce dont il a besoin pour fonctionner. Vous n’installez rien.
- Branchez la clé USB sur un port USB libre de n’importe quel ordinateur Windows.
- Ouvrez la clé USB dans l’Explorateur de fichiers (Ce PC → votre lecteur USB).
- Double-cliquez sur start_game.bat. Le jeu s’ouvre en plein écran après quelques secondes.
- Jouez avec les boutons physiques, l’écran tactile ou les touches numériques 1–9.
- Pour fermer le jeu, appuyez sur la touche Échap. Appuyez sur F à tout moment pour basculer entre plein écran et fenêtre.
2. Comment fonctionne le jeu
TAP IN TIME est un jeu de réflexes de type « tape-taupe » sur une grille 3×3 de neuf cibles. Il attire la foule et fonctionne seul, sans surveillance.
- Écran d’attente : au repos, la machine fait défiler la musique, le classement et les règles pour attirer les joueurs.
- Choisir une scène : si le choix du thème est activé, le joueur appuie sur un bouton pour choisir l’un des neuf thèmes (taupe, œuf, insecte, espace, gemme, fantôme, feu, ballon, zombie), puis appuie à nouveau pour démarrer. Sinon, n’importe quelle pression lance le jeu.
- Compte à rebours : un décompte 3-2-1, puis « GO ! »
- Jouer : des cibles apparaissent sur la grille. Frappez chacune avant qu’elle ne disparaisse. Des réactions plus rapides rapportent plus de points.
- Temps écoulé : la partie dure le temps de jeu défini, puis le score final s’affiche en montant à l’écran.
- Classement & collecte de contacts : un bon score permet au joueur de saisir ses initiales et (si activé) son nom et son e-mail pour un tirage au sort. Le classement (de tous les temps et du jour) s’affiche ensuite avant le retour à l’écran d’attente.
3. Accéder au panneau d’administration
Tous les réglages sont cachés derrière un geste secret afin que les joueurs n’y accèdent pas par accident. Il n’y a pas de mot de passe.
4. À quoi servent les réglages d’administration
Dans le panneau Réglages, utilisez les boutons − et + de chaque ligne pour modifier une valeur :
| Réglage | Plage | Effet |
|---|---|---|
| Scène | 9 thèmes | Définit le thème visuel (taupe, œuf, insecte, espace, gemme, fantôme, feu, ballon, zombie). |
| Temps de jeu | 10–120 s | Durée d’une partie. La valeur par défaut est d’environ 25–30 secondes. |
| Difficulté | Easy / Normal / Hard | Vitesse d’apparition des cibles et durée pendant laquelle elles restent visibles. |
| Vitesse du jeu | 1–10 | Ajuste le rythme global en plus du réglage de difficulté. |
| Temps du compte à rebours | 5–60 s | Durée d’attente des minuteries de saisie à l’écran (ex. le formulaire de tirage) avant expiration. |
| Volume musique | 0–10 | Volume de la musique de fond. |
| Volume SFX | 0–10 | Volume des effets sonores (clics, coups, décompte). |
| Langue | EN / NL / DE / FR / ES | Langue à l’écran pour les joueurs : anglais, néerlandais, allemand, français, espagnol. |
Sous les curseurs se trouvent quatre interrupteurs marche/arrêt (touchez pour basculer ON/OFF) :
| Interrupteur | État | Effet |
|---|---|---|
| Choix du thème | ON / OFF | Sur ON, les joueurs choisissent leur scène sur l’écran d’attente. Sur OFF, n’importe quelle pression lance le jeu avec la scène que vous avez choisie. |
| Audio d’attente | ON / OFF | Active ou désactive la musique de fond au repos. |
| Branding | ON / OFF | Affiche vos propres images sponsor/logo sur l’écran d’attente (placez les fichiers image dans le dossier « branding »). |
| Capturer l’e-mail | ON / OFF | Sur ON, les joueurs à bon score sont invités à donner leur nom et leur e-mail pour un tirage — c’est ainsi que vous collectez des contacts. |
En bas du panneau se trouvent les boutons d’action :
- View analytics (Statistiques) — ouvre l’écran des statistiques (voir ci-dessous).
- Reset high scores (Réinitialiser le classement) — efface le classement. Touchez une fois, puis à nouveau pour confirmer.
- Test ESP32 — vérifie que le contrôleur des boutons physiques est connecté et fonctionne.
- Close (Fermer) — enregistre vos réglages et revient au jeu.
L’écran des statistiques
Touchez View analytics pour voir les performances de la machine :
- Total des parties lancées — le cumul en cours (avec son propre bouton de remise à zéro).
- Parties aujourd’hui — le total du jour, plus un graphique des parties par heure.
- % ayant saisi les initiales — combien de joueurs ont tapé leurs initiales.
- % ayant saisi l’e-mail — combien, parmi ceux sollicités, ont donné leur adresse e-mail.
- Touchez Back (Retour) pour les Réglages, ou Close pour quitter.
5. Récupérer les informations enregistrées
Tout ce que la machine enregistre est sauvegardé sous forme de fichiers ordinaires dans le même dossier que le jeu, directement sur la clé USB. Rien n’est envoyé en ligne — vos données restent chez vous.
| Fichier sur la clé USB | Contenu |
|---|---|
| whackamole_raffle.csv | Vos contacts. Chaque contact collecté : date/heure, nom, e-mail, score et rang. C’est le fichier utile pour vos relances et tirages au sort. |
| whackamole_play_log.csv | Chaque partie jouée : date/heure, score, coups réussis, manqués, précision, meilleur temps de réaction et rang. |
| whackamole_highscores.json | Le classement actuel (meilleurs scores de tous les temps et du jour). |
| whackamole_analytics.json | Les totaux internes affichés sur l’écran des statistiques. |
Comment ouvrir vos données
- Fermez le jeu (touche Échap).
- Ouvrez la clé USB dans l’Explorateur de fichiers.
- Copiez whackamole_raffle.csv (et le journal des parties, si vous le souhaitez) sur votre ordinateur.
- Double-cliquez sur le fichier pour l’ouvrir dans Excel, Numbers ou Google Sheets. Les colonnes sont déjà nommées.
TAP IN TIME — Manual de usuario
Bienvenido. Esta guía le muestra cómo iniciar y gestionar su juego de reflejos TAP IN TIME. Todo lo necesario ya está en la memoria USB — sin instalación ni conocimientos técnicos. Solo conéctela a un ordenador con Windows y siga los pasos de abajo.
1. Iniciar el juego
La memoria USB contiene el juego y su propia copia de todo lo que necesita para funcionar. No instala nada.
- Conecte la memoria USB a un puerto USB libre de cualquier ordenador con Windows.
- Abra la memoria USB en el Explorador de archivos (Este equipo → su unidad USB).
- Haga doble clic en start_game.bat. El juego se abre a pantalla completa tras unos segundos.
- Juegue con los botones físicos, la pantalla táctil o las teclas numéricas 1–9.
- Para cerrar el juego, pulse la tecla Esc. Pulse F en cualquier momento para cambiar entre pantalla completa y ventana.
2. Cómo funciona el juego
TAP IN TIME es un juego de reflejos tipo « golpea al topo » en una cuadrícula 3×3 de nueve objetivos. Atrae público y funciona solo, sin supervisión.
- Pantalla de atracción: en reposo, la máquina reproduce en bucle música, la clasificación y las reglas para atraer jugadores.
- Elegir una escena: si la elección de tema está activada, el jugador pulsa un botón para elegir uno de los nueve temas (topo, huevo, insecto, espacio, gema, fantasma, fuego, globo, zombi) y pulsa de nuevo para empezar. Si no, cualquier pulsación inicia el juego.
- Cuenta atrás: una cuenta de 3-2-1 y luego « ¡GO! »
- Jugar: los objetivos aparecen en la cuadrícula. Golpee cada uno antes de que desaparezca. Las reacciones más rápidas dan más puntos.
- Se acabó el tiempo: la ronda dura el tiempo de juego configurado y luego la puntuación final se muestra ascendiendo en pantalla.
- Clasificación y captación de contactos: una buena puntuación permite al jugador introducir sus iniciales y (si está activado) su nombre y correo para un sorteo. Después se muestra la clasificación (histórica y del día) antes de volver a la pantalla de atracción.
3. Acceder al panel de administración
Todos los ajustes están tras un gesto oculto para que los jugadores no accedan por accidente. No hay contraseña.
4. Qué hacen los ajustes de administración
En el panel de Ajustes, use los botones − y + de cada fila para cambiar un valor:
| Ajuste | Rango | Qué hace |
|---|---|---|
| Escena | 9 temas | Define el tema visual (topo, huevo, insecto, espacio, gema, fantasma, fuego, globo, zombi). |
| Tiempo de juego | 10–120 s | Cuánto dura una ronda. El valor predeterminado es de unos 25–30 segundos. |
| Dificultad | Easy / Normal / Hard | Con qué rapidez aparecen los objetivos y cuánto permanecen visibles. |
| Velocidad del juego | 1–10 | Ajusta el ritmo general además del ajuste de dificultad. |
| Tiempo de cuenta atrás | 5–60 s | Cuánto esperan los temporizadores de entrada en pantalla (p. ej. el formulario del sorteo) antes de expirar. |
| Volumen de música | 0–10 | Volumen de la música de fondo. |
| Volumen SFX | 0–10 | Volumen de los efectos de sonido (clics, golpes, cuenta atrás). |
| Idioma | EN / NL / DE / FR / ES | Idioma en pantalla para los jugadores: inglés, neerlandés, alemán, francés, español. |
Debajo de los controles hay cuatro interruptores de encendido/apagado (toque para cambiar ON/OFF):
| Interruptor | Estado | Qué hace |
|---|---|---|
| Elección de tema | ON / OFF | En ON, los jugadores eligen su escena en la pantalla de atracción. En OFF, cualquier pulsación inicia el juego con la escena que usted elija. |
| Audio de atracción | ON / OFF | Enciende o apaga la música de fondo en reposo. |
| Branding | ON / OFF | Muestra sus propias imágenes de patrocinador/logotipo en la pantalla de atracción (coloque los archivos de imagen en la carpeta « branding »). |
| Capturar correo | ON / OFF | En ON, a los jugadores con buena puntuación se les pide su nombre y correo para un sorteo — así recopila contactos. |
En la parte inferior del panel están los botones de acción:
- View analytics (Estadísticas) — abre la pantalla de estadísticas (véase abajo).
- Reset high scores (Reiniciar clasificación) — borra la clasificación. Toque una vez y toque de nuevo para confirmar.
- Test ESP32 — comprueba que el controlador de los botones físicos está conectado y funciona.
- Close (Cerrar) — guarda sus ajustes y vuelve al juego.
La pantalla de estadísticas
Toque View analytics para ver el rendimiento de la máquina:
- Total de partidas iniciadas — el acumulado (con su propio botón de reinicio).
- Partidas de hoy — el total del día, más un gráfico de barras de partidas por hora.
- % que dejó iniciales — cuántos jugadores escribieron sus iniciales.
- % que introdujo correo — cuántos, de los preguntados, dieron su dirección de correo.
- Toque Back (Atrás) para volver a Ajustes, o Close para salir.
5. Recuperar la información guardada
Todo lo que la máquina registra se guarda como archivos normales en la misma carpeta que el juego, directamente en la memoria USB. Nada se envía a internet — sus datos se quedan con usted.
| Archivo en la memoria USB | Qué contiene |
|---|---|
| whackamole_raffle.csv | Sus contactos. Cada contacto captado: fecha/hora, nombre, correo, puntuación y posición. Este es el archivo que necesita para seguimiento y sorteos. |
| whackamole_play_log.csv | Cada partida jugada: fecha/hora, puntuación, aciertos, fallos, precisión, mejor tiempo de reacción y posición. |
| whackamole_highscores.json | La clasificación actual (mejores puntuaciones históricas y del día). |
| whackamole_analytics.json | Los totales internos que se muestran en la pantalla de estadísticas. |
Cómo abrir sus datos
- Cierre el juego (tecla Esc).
- Abra la memoria USB en el Explorador de archivos.
- Copie whackamole_raffle.csv (y el registro de partidas, si lo desea) a su ordenador.
- Haga doble clic en el archivo para abrirlo en Excel, Numbers o Google Sheets. Las columnas ya están etiquetadas.
Made for Arcade · [email protected]