Guida completa a squadMAP

1. Panoramica

squadMAP è un'app di situational awareness per softair, airsoft e MilSim: mostra su una mappa condivisa la posizione dei compagni di squadra, gli obiettivi e le zone di gioco, e gestisce le regole della partita (eliminazioni, catture, punteggi) in modo automatico e verificabile.

L'app ha due profili:

• HQ: chi organizza (associazione, campo, organizzatore di eventi, team). Crea i match, i team, le zone e gli obiettivi, vede tutti gli operatori ed è l'unico ad avere il debrief. L'account HQ si registra dal sito: scopri squadMAP per HQ.
• Operatore: il giocatore sul campo. Usa l'app gratuitamente, vede la propria squadra, crea punti tattici e partecipa alle modalità di gioco.

Un operatore può essere collegato a un HQ (tramite il codice HQ di 6 caratteri) oppure indipendente: in questo caso gioca in match temporanei creati con amici, senza organizzazione alle spalle.

2. Primi passi

Installazione

squadMAP è disponibile per Android su Google Play.

Registrazione operatore

1. Apri l'app e scegli Registrati.
2. Inserisci nickname (il tuo nome di battaglia, unico), email e password (almeno 6 caratteri).
3. Se giochi con un'organizzazione, inserisci il codice HQ di 6 caratteri che ti ha dato: così vedrai i suoi eventi ed entrerai nel suo gruppo. È facoltativo.
4. Controlla la posta: clicca il link di conferma (valido 48 ore). Se non arriva, dalla schermata di login puoi richiederne uno nuovo.

Accesso

Accedi con email oppure nickname e password. L'accesso resta attivo finché non esci con ESFILTRA dalla dashboard; cambiando la password, le sessioni sugli altri dispositivi vengono chiuse.

3. Permessi e privacy

Al primo avvio l'app chiede i permessi uno alla volta, ognuno preceduto da una spiegazione di cosa viene raccolto e perché:

• Notifiche: allerte tattiche, catture, UAV, news.
• Bluetooth: rete mesh tra telefoni vicini e collegamento alle radio LoRa.
• Posizione: prima in primo piano, poi "Consenti sempre". La posizione anche a schermo spento è la funzione centrale dell'app: in partita il telefono sta in tasca o nel tattico, e la squadra deve continuare a vederti.

Senza questi permessi l'app non può funzionare e mostra una schermata con RIPROVA o LOGOUT. La tua posizione è visibile solo ai partecipanti del match (i compagni di squadra e l'HQ): dettagli nella Privacy Policy.

4. Le schermate

La barra in basso cambia in base al profilo:

Dashboard operatore

Mostra il tuo profilo (nickname modificabile, email, codice HQ), il match attivo, la selezione del team, i compagni rilevati, l'HQ di appartenenza, la gestione delle mappe offline, il modulo di feedback, il cambio password e l'eliminazione dell'account.

5. Entrare in un match

Un match è la sessione di gioco: tutti i partecipanti allo stesso match condividono mappa, punti e zone (ognuno secondo la visibilità della propria squadra).

Con il QR code

Il modo più rapido: dalla dashboard tocca SCANSIONA PER UNIRTI e inquadra il QR del match mostrato dall'HQ o da un compagno (CONDIVIDI MATCH (QR)).

Con il nome del match

Nel pannello MATCH della dashboard scegli UNISCITI o CREA MATCH e inserisci il nome: tutti devono usare lo stesso identico nome per ritrovarsi.

Operatore indipendente

Senza codice HQ il match è temporaneo e il nome si sceglie da una lista di parole (SCEGLI PAROLA MATCH, oppure RIGENERA per una parola casuale). Per giocare con un amico scegliete la stessa parola, oppure fatevi scansionare il QR. I match indipendenti vengono eliminati automaticamente dopo 72 ore.

Scegliere la squadra

Entrato nel match, scegli il tuo team in SELEZIONE TEAM. Finché non hai una squadra la mappa resta bloccata. L'HQ può impedire i cambi autonomi: in quel caso è l'HQ ad assegnarti o spostarti.

6. La mappa tattica

È il cuore dell'app. Il tuo segnale ha un cono che indica la direzione in cui è rivolto il telefono (bussola) e un cerchio che rappresenta la precisione del GPS.

Menu azioni

Il pulsante flottante apre il menu a ventaglio:

• SAT / TOPO: alterna vista satellitare e topografica.
• FILTRI: mostra o nasconde compagni, punti tattici e singole categorie.
• CATTURA: apre lo scanner QR unico (punti da conquistare, UAV, giocatori).
• IL MIO QR: il tuo QR personale, per eliminazioni e rianimazioni.
• LANDSCAPE / PORTRAIT: ruota l'interfaccia.
• MESH ON/OFF e LORA ON/OFF: reti alternative per quando manca la copertura (vedi Senza rete).

Schede di dettaglio

Toccando un compagno, un punto o una zona si apre una scheda con coordinate UTM, distanza da te, ultimo aggiornamento e, per le zone, tipo, forma, possesso e stato della cattura.

Indicatori

In alto compaiono OFFLINE quando manca la rete e FUORI ZONA quando sei fuori dall'area di gioco.

7. Punti tattici

I punti tattici sono marcatori condivisi con la tua squadra: posizioni nemiche, obiettivi, punti di raccolta, pericoli.

1. Tieni premuto sulla mappa nel punto desiderato: si apre Nuovo Punto Tattico.
2. Scegli la categoria: ogni categoria ha la sua icona della simbologia NATO (MIL-STD-2525 / APP-6).
3. Dai un titolo (viene proposto in automatico), sposta il segnaposto se serve e conferma.

Alcune categorie sono riservate all'HQ o ai caposquadra, e alcune ammettono un solo punto per match. Un operatore vede i punti della propria squadra e quelli globali dell'HQ, mai quelli delle squadre avversarie. Chi ha creato un punto può eliminarlo dalla sua scheda.

Punti speciali

• Punti conquistabili: hanno un QR, un raggio (ad esempio 50 m) e un valore in punti. Il primo operatore che scansiona il QR stando entro il raggio lo cattura e guadagna i punti.
• Punti UAV: scansionandoli si attiva la ricognizione per la squadra (vedi UAV).
• Beacon LoRa: una radio lasciata sul campo (una bandiera, un VIP) che trasmette la propria posizione. È visibile a tutte le squadre, anche a chi non ha una radio.

8. Team e ruoli

Ogni match ha di base quattro team (Alfa, Bravo, Charlie, Delta), ognuno con il suo colore; l'HQ può crearne altri. Ogni operatore ha un ruolo (soldato, caposquadra, capopattuglia) e una lettera tattica che lo identifica rapidamente sulla mappa e in radio.

Per ogni giocatore l'app tiene punti, uccisioni e morti, aggiornati da eliminazioni, rianimazioni e catture.

9. Eliminazioni e rianimazioni via QR

Ogni operatore ha il proprio QR (IL MIO QR). Le regole sono semplici e non si discutono:

• Eliminazione: un avversario scansiona il tuo QR → sei eliminato; a lui vanno +1 uccisione e +10 punti, a te +1 morte.
• Rianimazione: un compagno di squadra scansiona il QR di un compagno eliminato → torna in gioco; chi rianima guadagna +5 punti.

Scansionare un giocatore già eliminato, o un compagno non eliminato, non ha effetto: l'app lo segnala.

10. Modalità di gioco

Capture the Flag (CTF)

Le bandiere sono zone sulla mappa. Quando gli operatori di una squadra entrano nella zona parte la cattura, con un tempo stabilito dall'organizzazione; più operatori ci sono, più è veloce. Se entra anche una squadra avversaria la zona diventa CONTESA e la cattura va in pausa senza perdere il progresso. Allo scadere del tempo la bandiera passa alla squadra che la stava catturando. Inizio e fine della cattura arrivano a tutti come notifica.

Warzone

La zona di gioco è un cerchio che si restringe a intervalli regolari (ad esempio 50 metri ogni 5 minuti). Chi resta fuori ha 60 secondi per rientrare; poi viene eliminato automaticamente. Ogni restringimento viene notificato.

UAV (ricognizione)

Le zone UAV compaiono e scompaiono a cicli (ad esempio visibili 2 minuti, nascoste 5). Scansionando il QR di un punto UAV, la tua squadra attiva la ricognizione: per tutta la finestra (15 minuti di base) le zone UAV restano visibili per il tuo team. Nel match può esserci una sola ricognizione attiva alla volta, e la stessa squadra deve attendere un periodo di ricarica (45 minuti di base) prima di riattivarla.

Punti conquistabili

Obiettivi a QR sparsi per il campo: il primo che li scansiona entro il raggio li conquista (vedi Punti tattici).

11. Zone e allerte

Oltre alle zone di gioco, l'HQ può disegnare zone di confine:

• Zona verde (sicura): uscirne fa scattare l'allerta "Uscita da Zona Sicura".
• Zona rossa (pericolosa o vietata): entrarci fa scattare l'allerta "Ingresso in Zona Pericolosa".

L'ALLERTA TATTICA arriva ai compagni di squadra e all'HQ. Una zona può essere visibile a tutti o solo a un team.

12. Giocare senza rete

I campi da gioco hanno spesso poca copertura. squadMAP ha tre livelli di protezione:

Mappe offline

Scarica in anticipo l'area di gioco: dalla dashboard (GESTIONE MAPPE OFFLINE → SCARICA AREA MAPPA), centrando e zoomando la mappa sull'area e confermando, oppure dalla scheda dell'evento (MAPPA OFFLINE). Dal gestore puoi vedere lo spazio occupato ed eliminare le aree che non servono più.

Invio differito

Quando la rete cade, posizioni ed eventi vengono accodati sul telefono e inviati automaticamente appena torna la connessione, così anche il debrief resta completo.

Mesh tra telefoni

Con MESH ON (Android) i telefoni vicini si scambiano le posizioni direttamente, senza rete dati.

Radio LoRa (Meshtastic)

Collegando via Bluetooth una radio Meshtastic (menu mappa → LORA OFF → scegli la radio), squadMAP invia la tua posizione via radio ogni 30 secondi, o dopo 25 metri di spostamento, e mostra i compagni ricevuti via radio, anche a chilometri di distanza e senza alcuna copertura. La configurazione passo per passo è nella sezione Radio LoRa.

13. Radio LoRa (Meshtastic): configurazione

squadMAP supporta la tecnologia LoRa (Long Range) tramite le radio open source Meshtastic. LoRa trasmette pacchetti piccoli a lunga distanza con consumi minimi: la squadra resta visibile sulla mappa anche senza copertura cellulare né Wi-Fi, senza costi di traffico, con portate che sul campo arrivano a diversi chilometri a seconda del terreno. Le radio si ritrasmettono i messaggi a vicenda (rete mesh), così la copertura cresce con il numero di radio in campo.

Con la radio collegata, squadMAP invia la tua posizione ogni 30 secondi (o dopo 25 metri di spostamento) e mostra i compagni di squadra ricevuti via radio. I beacon LoRa permettono inoltre di seguire sulla mappa bandiere mobili, VIP o obiettivi, visibili a tutte le squadre.

Cosa serve

• Un telefono Android con squadMAP.
• Una radio compatibile Meshtastic per ogni giocatore che vuole trasmettere, con antenna 868 MHz (banda europea).
• Firmware Meshtastic aggiornato (testato con la serie 2.7.x), installabile da flasher.meshtastic.org.
• L'app ufficiale Meshtastic per Android: serve una sola volta per configurare ogni radio, poi la radio si usa da squadMAP.

Regola d'oro: tutte le radio della stessa squadra devono avere identici regione, preset e canale primario (nome e chiave). Basta una differenza e le radio non si sentono.

Attenzione: avvita sempre l'antenna prima di accendere la radio. Trasmettere senza antenna può danneggiare il modulo radio. Una radio accetta un solo telefono alla volta via Bluetooth.

Passo 1 — Collegare la radio all'app Meshtastic

1. Nell'app Meshtastic tocca l'icona della radio (o +) e scegli la tua radio dalla lista Bluetooth.
2. Inserisci il PIN: sulle radio con display compare sullo schermo; su quelle senza display è fisso, di fabbrica 123456 (lo cambierai al passo 6).

Passo 2 — Nome del nodo

In Impostazioni → Utente:

Passo 3 — Impostazioni LoRa

In Impostazioni → Configurazione radio → LoRa (la radio si riavvia dopo il salvataggio):

Passo 4 — Il canale privato della squadra

È il passaggio più importante. squadMAP trasmette le posizioni sul primo canale con chiave privata e accetta posizioni solo da canali privati. Il canale di fabbrica usa una chiave pubblica: se la radio non ha un canale privato non trasmette, e squadMAP lo segnala con la voce LORA ON in giallo e un avviso nel pannello Radio LoRa.

In Impostazioni → Canali → canale 0 (Primario):

Non tenere il canale pubblico di fabbrica (LongFast) come secondario: la radio passerebbe al telefono il traffico delle altre radio Meshtastic della zona, sprecando tempo di trasmissione. L'unico canale secondario ammesso è MATCH, se usi i beacon.

Una squadra = un canale. Due squadre sullo stesso canale si scambiano i dati: la mappa li nasconde, ma viaggiano comunque.

Copiare il canale sulle altre radio della squadra

1. Sulla radio configurata: Canali → Condividi per ottenere il QR code.
2. Su ogni altra radio: scansiona il QR e scegli Sostituisci (non "Aggiungi"), così il canale primario diventa identico.

Il QR del canale contiene la chiave: non fotografarlo e non condividerlo in chat pubbliche, altrimenti chiunque può ascoltare le posizioni della squadra.

Passo 5 — Ruolo, alimentazione e moduli

Passo 6 — Bluetooth

In Configurazione radio → Bluetooth: Abilitato ON, modalità di pairing PIN casuale (radio con display) oppure PIN fisso diverso da 123456 (radio senza display).

Passo 7 — Collegare la radio a squadMAP

1. Nell'app Meshtastic tocca Disconnetti. Chiudere l'app non basta: il servizio in background tiene occupata la radio. Nel dubbio, Impostazioni Android → App → Meshtastic → Arresto forzato.
2. In squadMAP apri la Mappa, poi il menu, e tocca LORA OFF: si apre il pannello Radio LoRa e parte la ricerca.
3. Tocca la tua radio e inserisci il PIN di pairing (solo la prima volta).
4. Lo stato diventa CONNESSA · <nome della radio> e nel menu compare LORA ON.

Se la radio si disconnette, squadMAP si ricollega da solo. Chiudendo squadMAP dalle app recenti il collegamento termina.

Beacon LoRa: bandiere, VIP e obiettivi tracciati

Un beacon è una radio lasciata sul campo, fissa o trasportata, che trasmette la propria posizione. squadMAP la mostra a tutte le squadre con l'icona della categoria Beacon, anche a chi non ha una radio: i telefoni che la ricevono inoltrano la posizione al server.

1. Canale MATCH, comune a tutte le squadre

1. Su una radio crea un canale secondario MATCH con chiave generata a 256 bit e precisione della posizione al massimo. Con precisione ridotta Meshtastic arrotonda le coordinate di centinaia di metri.
2. Aggiungilo come secondario su tutte le radio di tutte le squadre: QR e poi Aggiungi (non "Sostituisci"), così il canale della squadra resta invariato.

2. Configurare la radio beacon

Come ai passi 1–6, con queste differenze:

Annota l'ID nodo della radio (app Meshtastic → info nodo, formato !2ba44038).

3. Registrare il beacon nel match (pannello HQ)

Dal pannello web HQ: Punti Tattici → Aggiungi, scegli il match, lascia il team vuoto (visibile a tutti), categoria Beacon, un titolo (es. Bandiera), la posizione iniziale e, in Beacon LoRa, l'ID nodo della radio (non il nome, che può cambiare). Dal primo aggiornamento ricevuto il pannello mostra anche il nome della radio.

4. Verifica sul campo

Tocca il marker del beacon: la scheda mostra Beacon LoRa con ID e nome della radio e l'ultimo aggiornamento, in giallo se più vecchio di 5 minuti. Chi ha una radio vede il beacon subito; gli altri entro una ventina di secondi, se almeno un telefono con radio ha rete. Il beacon deve appartenere al match attivo nell'app.

Checklist per ogni radio

• Antenna 868 MHz montata, firmware 2.7.x
• Regione EU_868 e preset MEDIUM_FAST, uguali su tutte le radio
• Canale primario con il nome della squadra e chiave generata a 256 bit, uguali su tutte le radio della squadra
• Nessun canale pubblico tra i canali
• MQTT OFF, Wi-Fi OFF, ruolo CLIENT, rebroadcast LOCAL_ONLY, risparmio energetico OFF
• Bluetooth ON con PIN noto e diverso da 123456
• App Meshtastic disconnessa; squadMAP mostra CONNESSA senza avvisi
• Con i beacon: canale secondario MATCH su tutte le radio; beacon con intervallo 60–120 s e posizione fissa se senza GPS

Problemi comuni con LoRa

14. Notifiche e news

Le notifiche push avvisano di allerte tattiche, catture di bandiere e punti, attivazioni UAV, restringimenti della warzone e nuove news. Le news di squadMAP (novità, eventi) compaiono nel tab NEWS o in cima al tab EVENTI, con un indicatore dei messaggi non letti.

Eventi dell'organizzazione

Se il tuo HQ ha collegato il proprio calendario, nel tab EVENTI trovi gli eventi con locandina, ordine operativo, briefing e coordinate (con NAVIGA VERSO IL CAMPO). Puoi confermare la presenza e scaricare la mappa offline dell'area operativa.

15. Per l'HQ

L'account HQ si registra dal sito, nella pagina squadMAP per HQ. Nell'app l'HQ ha:

• Mappa in modalità HQ – visione globale: tutti gli operatori di tutti i team, zone e punti.
• Tab TEAMS: crea squadre con nome e colore, assegna e sposta gli operatori.
• Dashboard HQ: codice HQ da copiare e condividere, stato dell'account, match attivo, consenso ai cambi squadra autonomi, collegamento delle API eventi e soci.
• Creazione e gestione match: titolo, identificativo, briefing, coordinate; zone disegnate sulla mappa o inserite in coordinate UTM, attivabili subito o in seguito.

Con la stessa email e password l'HQ accede anche al pannello web, dove prepara match, team, zone e punti dal computer, genera i QR dei punti, rivede la partita con il debrief (replay dei movimenti) ed esporta i punti in Excel. Il pannello mostra solo i match dell'HQ e dei suoi operatori.

16. Account e dati

• Profilo: nickname modificabile dalla dashboard; la password si cambia da Cambia Password.
• Feedback: dalla dashboard puoi inviarci segnalazioni e suggerimenti.
• Pulizia automatica: un operatore inattivo da più di 2 ore viene rimosso dal match; i match temporanei degli indipendenti si eliminano dopo 72 ore.
• Eliminazione account: dalla dashboard, sezione ZONA PERICOLOSA → ELIMINA ACCOUNT. Un HQ che ha ancora dei match deve prima eliminarli.

17. Problemi comuni

Non trovi la risposta? Scrivici a feedback@squadmap.it.