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.

Chi vuole solo una mappa con la propria posizione e i propri punti, senza account e senza rete, può usare la modalità Lonewolf.

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.
5. Confermato l'account ricevi l'email di benvenuto con il tuo QR giocatore in allegato: stampalo e portalo in campo, serve per le rianimazioni.

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.

Modalità Lonewolf (senza account)

Per muoversi da soli sul campo: niente registrazione, niente internet, niente match. Vedi la tua posizione sulla mappa e segni i tuoi punti tattici. Nulla viene salvato online: tutto resta sul telefono.

1. Dalla schermata iniziale tocca LONEWOLF e concedi i permessi di posizione.
2. Sulla MAPPA vedi la tua posizione. Tieni premuto su un punto della mappa per aggiungere un punto tattico: nome, categoria e coordinate UTM, con il pin trascinabile. Toccando un punto puoi modificarlo o eliminarlo.
3. Dalla DASHBOARD tocca ESPORTA CSV: Android ti chiede una cartella (Download, Drive…) e ci salva il file squadmap-punti-AAAAMMGG.csv, con nome, categoria, latitudine, longitudine, coordinate UTM e data di ogni punto.
4. Per uscire tocca ESCI nella dashboard: i punti restano sul telefono e li ritrovi quando rientri in Lonewolf.

Internet serve solo in due casi: la prima volta, per scaricare le categorie di punti disponibili in Lonewolf, e per scaricare in anticipo le mappe offline dell'area (dalla dashboard). Dopo, funziona tutto senza rete.

In Lonewolf non ci sono compagni, squadre, match, QR, mesh, radio LoRa né debrief: per giocare con altri serve un account. Restano disponibili gli EVENTI (calendario e news, quando c'è rete) e i LOGS per segnalarci eventuali problemi.

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, perk attivati, 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:

Sulla MAPPA la barra è nascosta per lasciare tutto lo schermo alla mappa: tocca la maniglia con la freccia in basso al centro per farla comparire. Si richiude da sola dopo qualche secondo o appena tocchi la mappa.

Dashboard

È divisa in schede, uguali per operatori e HQ (cambia il contenuto):

• MATCH: scelta o creazione del match, QR del match, selezione del team, compagni rilevati, HQ di appartenenza e punteggi.
• OFFLINE: mappe offline e, per gli operatori Android, MESH E LORA per giocare senza rete.
• PROFILO: nickname modificabile, email, codice HQ, cambio password, I miei campi, feedback ed eliminazione dell'account.
• EVENTI: calendario dell'organizzazione e news di squadMAP (con un codice HQ).
• TESTER (solo account tester, in arancione): abbinamento dello smartwatch e LOGS con gli errori da condividere con noi.

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).

L'app non crea mai un match da sola: finché non sei in un match, la scheda MATCH della dashboard ti mostra quelli che esistono già e ti lascia sceglierne uno o crearne uno nuovo. Una volta dentro, tocca CAMBIA MATCH per tornare all'elenco.

I match della tua ASD

Con un codice HQ vedi i match attivi della tua associazione, creati dall'HQ o da un altro membro: tocca ENTRA su quello giusto (quello in cui sei è segnato IN CORSO). Per un match nuovo scrivi un nome, per esempio Torneo Cava Nord, e tocca CREA MATCH: il codice del match si ricava dal nome (TORNEO-CAVA-NORD) e gli altri membri lo trovano subito nell'elenco. L'HQ ha anche TERMINA su ogni match.

Con il QR code

Il QR del match (CONDIVIDI MATCH (QR) nell'app, o la locandina stampata dall'HQ dal BMS) si scansiona con l'icona 📷 nella scheda MATCH. Contiene un codice di invito firmato: con il QR entra nel match anche un giocatore di un'altra ASD o senza codice HQ, mentre conoscere solo il nome del match non basta. Chi entra con il QR ritrova poi il match anche senza riscansionarlo.

Chi può entrare

I match di un HQ sono riservati ai suoi operatori (stesso codice HQ) e a chi ha il loro QR. Quelli aperti a tutte le ASD accolgono chiunque abbia un codice HQ. Se non puoi entrare, l'app ti mostra il motivo, per esempio «Match riservato a un'altra ASD» o, se non hai un codice HQ, «Match riservato alle ASD».

Operatore indipendente

Senza codice HQ l'elenco mostra i match a cui stai già partecipando. CREA MATCH PERSONALE crea un match temporaneo con un nome casuale preso da una lista di parole: per giocare con un amico fategli scansionare il QR del match. I match indipendenti vengono eliminati automaticamente dopo 24 ore.

Scegliere la squadra

Entrato nel match, scegli il tuo team in SELEZIONE TEAM. Finché non hai una squadra puoi consultare la mappa, ma tracking e condivisione sono disattivati: la tua posizione non viene inviata, MESH e LORA restano spenti e non puoi creare punti. Un avviso sulla mappa te lo ricorda; toccalo per tornare alla dashboard. L'HQ può impedire i cambi autonomi: in quel caso è l'HQ ad assegnarti o spostarti, e al posto dei team vedi in rosso «Cambio team gestito dall'HQ».

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, che si chiude toccando di nuovo il pulsante o la mappa:

• COLPITO (tasto rosso in alto a sinistra): tienilo premuto quando vieni colpito. La schermata di colpito mostra il tuo QR per la rianimazione e quanti compagni sono ancora in gioco (ad esempio 2/4 COMPAGNI IN GIOCO).
• GPS ACCURACY: ON / OFF: posizione aggiornata ogni 2 secondi alla massima precisione, utile per orientarsi e muoversi al bordo della warzone. Consuma più batteria; spento di default, la scelta resta salvata.
• CATTURA: apre lo scanner QR unico (punti da conquistare, perk UAV/EMP/Medikit, giocatori).
• SAT / TOPO: alterna vista satellitare e topografica.
• CAMPO EVENTO / MIO CAMPO / CAMPO OFF: sceglie quale piantina del campo mostrare sopra la mappa (compare solo se ce n'è almeno una, vedi Mappa del campo).
• FILTRI: mostra o nasconde compagni, punti tattici e singole categorie.
• AREA: scarica per l'uso offline l'area di mappa che stai guardando (vedi Mappe offline).
• LANDSCAPE / PORTRAIT: ruota l'interfaccia.

MESH e LORA sono nella dashboard, scheda OFFLINE (vedi Senza rete); I MIEI CAMPI nella scheda PROFILO (in Lonewolf restano nel menu della mappa).

Pulsante GPS

Il pulsante in basso a destra centra la mappa su di te e la fa seguire la tua posizione: diventa verde finché il follow è attivo. Toccalo di nuovo per fermarlo; basta anche spostare o zoomare la mappa con le dita. Per l'HQ inquadra invece tutta l'area tattica.

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. Mappa del campo

Un campo è la piantina del terreno di gioco (immagine PNG o JPG) sovrapposta alla mappa satellitare o topografica, con opacità regolabile. Resta agganciata alla mappa anche quando zoomi.

Il campo dell'evento

L'HQ crea i propri campi dall'app (GESTISCI) o dal BMS (Campi): sono solo del suo HQ, ma una volta collegato a un match il campo lo vede chiunque partecipi.

Se l'HQ ha collegato un campo al match, lo vedi subito, attivo di default. Viene salvato sul telefono, quindi funziona anche senza rete; se l'HQ lo cambia o lo toglie, l'app si aggiorna da sola (entro un paio di minuti con la mappa aperta) e cancella la vecchia immagine.

I miei campi

Dalla dashboard, scheda PROFILO → GESTISCI I MIEI CAMPI (in Lonewolf dal menu della mappa), puoi di salvare piantine tue: dai un nome, scegli l'immagine dal telefono e posizionala. Restano solo sul tuo telefono, non vengono mai inviate al server. Tocca un campo per mostrarlo; con le icone puoi regolarne la posizione, sostituire l'immagine o eliminarlo.

Posizionare la piantina

• Angoli azzurri: trascinali per ridimensionare l'immagine; resta proporzionata e l'angolo opposto sta fermo.
• Due dita sull'immagine: ruotala attorno al centro. Due dita fuori dall'immagine zoomano la mappa come sempre.
• Punto rosso: sposta tutta l'immagine.
• ALPHA: il cursore in basso regola la trasparenza.
• Il pulsante mirino centra la mappa sulla tua posizione, il cestino elimina il campo.

La mappa si apre sulla tua posizione: conviene posizionare la piantina stando sul campo, allineandola a strade, edifici e sentieri visibili sotto.

8. 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 squadra nel match: il nuovo sostituisce quello precedente della tua squadra, mai quello degli avversari. Un operatore vede i punti della propria squadra e quelli globali dell'HQ, mai quelli delle squadre avversarie.

Dalla scheda di un punto, chi l'ha creato e i compagni della stessa squadra possono modificarlo (nome, categoria e posizione, trascinando il pin o scrivendo le coordinate UTM) o eliminarlo. I punti piazzati dall'HQ li modifica e li elimina solo l'HQ. La modifica richiede la rete.

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. Serve avere una squadra e non essere colpiti.
• Perk (UAV, EMP, Medikit): scansionando il loro QR la squadra attiva il perk (vedi UAV, EMP e Medikit).
• 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.

9. 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.

10. Eliminazioni e rianimazioni

Le regole sono semplici e non si discutono:

• Eliminazione: quando sei colpito tieni premuto il tasto rosso COLPITO in mappa: sei eliminato subito (+1 morte) e smetti di contare nelle bandiere. Non serve che un avversario ti scansioni.
• Rianimazione: un compagno di squadra scansiona il QR di un compagno eliminato → torna in gioco; chi rianima guadagna +5 punti.
• Rianimazioni limitate: l'organizzazione può fissare quante volte ogni giocatore può essere rianimato nel match (anche dal Medikit). Finite quelle, al colpo successivo sei fuori gioco fino a fine partita.

Scansionare un avversario o un compagno non eliminato non ha effetto: l'app lo segnala. Per scansionare servono una squadra e una posizione GPS nota, entro 50 m dal giocatore.

Punto medico (match senza warzone): se tutta la squadra è colpita e nessuno può rianimare, tocca MOSTRA PUNTO MEDICO. Compare un'area di 20 m a circa 50 m dalla squadra, lontano dal nemico più vicino, e parte la navigazione. Se l'area è irraggiungibile o fuori campo, CAMBIA PUNTO la sposta. Quando tutti i colpiti sono dentro parte il timer stabilito dall'organizzazione (2 minuti di base): se qualcuno esce riparte da capo, allo scadere tutta la squadra torna in gioco. Chi è uscito dal match o ha il telefono spento non serve (e non viene rianimato). A fine partita il punto medico sparisce.

Quando sei colpito, la mappa si copre e mostra direttamente il tuo QR, pronto per il compagno che ti rianima. Finché non vieni rianimato non puoi eliminare, catturare né attivare UAV, ma la tua posizione continua a essere condivisa: se sei in un punto pericoloso puoi metterti al sicuro e i compagni vedono dove sei. Chi è eliminato dalla warzone resta fuori fino a fine partita e non può essere rianimato.

11. 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 fisso stabilito dall'organizzazione: più operatori non la rendono più veloce. Se entra anche una squadra avversaria vince la maggioranza: cattura chi ha più operatori in zona, sempre con lo stesso tempo, e chi è in minoranza riceve l'avviso che non ha la superiorità. Con lo stesso numero la zona diventa CONTESA e la cattura va in pausa senza perdere il progresso. Una bandiera avversaria va prima neutralizzata (torna di nessuno) e poi conquistata: servono due tempi pieni. Alla conquista la squadra guadagna punti (100 di base), divisi tra gli operatori presenti in zona. Inizio, neutralizzazione e conquista arrivano come notifica. Sotto un EMP avversario la mappa è spenta, ma la cattura prosegue se sei in zona.

Team deathmatch

L'organizzazione fissa un numero di morti (ad esempio 20): ogni volta che premi COLPITO la tua squadra ne conta una. La prima squadra che arriva al limite perde e la partita finisce da sola: vince la squadra con meno morti (a parità, più punti) e a tutti arriva la notifica con la vincitrice. Nella dashboard, scheda MATCH, vedi le morti di ogni squadra sul limite (ad esempio 7/20 morti).

Warzone

La zona di gioco è un cerchio che si restringe a intervalli regolari (ad esempio 50 metri ogni 5 minuti; il raggio è sempre un multiplo di quel passo). Arrivato all'ultimo anello si stringe ancora a metà, a un quinto e a un decimo (50 → 25 → 10 → 5 m) e lì resta: la partita finisce quando rimane in gioco una sola squadra, non quando il cerchio si chiude. Tra un restringimento e l'altro il cerchio resta fermo e in mappa vedi già, tratteggiato, il prossimo: allo scadere il cerchio scivola fino a quello in un minuto (durata scelta dall'organizzazione), senza scatti. Chi resta fuori ha 60 secondi per rientrare (tempo scelto dall'organizzazione nel setup del match), con un banner rosso e il conto alla rovescia in mappa; poi viene eliminato automaticamente. Ogni restringimento viene notificato quando inizia.

UAV (ricognizione)

Scansionando il QR di un punto UAV (dal tasto CATTURA, entro il suo raggio, di base 50 m) la tua squadra attiva la ricognizione. Per tutta la finestra (15 minuti di base) il tuo team vede sulla mappa:

• gli avversari ancora in gioco (non colpiti), con l'icona nemico;
• tutti i punti del match, anche quelli delle altre squadre;
• le zone UAV sempre visibili: senza ricognizione compaiono e scompaiono a cicli (ad esempio visibili 2 minuti, nascoste 5).

Tutte le squadre ricevono una notifica quando una squadra attiva l'UAV. Nel match può esserci una sola ricognizione attiva alla volta: finché non scade, nessun'altra squadra può attivarla. Dopo l'attivazione la stessa squadra attende un periodo di ricarica (45 minuti di base, contati dall'inizio della ricognizione) prima di riattivarla. Sulla mappa i badge UAV mostrano il tempo rimasto della ricognizione, la ricarica di ogni squadra e diventano verdi (PRONTO) quando la tua squadra può riattivarla. Il punto UAV non si consuma: resta sul campo per tutto il match. Per attivarlo servono una squadra, non essere colpiti e una posizione GPS, e devi trovarti dentro la sua zona: tutti i perk si attivano solo nell'area designata dall'HQ. Se l'HQ disattiva la zona, il perk è spento: il QR non si attiva finché la zona non torna attiva.

Se l'HQ mette il punto UAV dentro una zona UAV, gli operatori non lo vedono sulla mappa (né sull'orologio, neanche durante la ricognizione): la zona indica dove cercare, il QR va trovato sul campo. Dal BMS lo strumento Perk (sulla mappa del match, scegli il perk: oggi l'UAV) crea insieme l'area di ricerca e il QR da stampare: il QR si nasconde in un punto qualsiasi dell'area e si attiva ovunque al suo interno. Conviene un'area di 50-100 m.

EMP e Medikit

Altri due perk a QR, che l'HQ nasconde in campo come l'UAV (una zona viola indica dove cercare):

• EMP: spegne la mappa delle altre squadre per 5 minuti (di base, lo decide l'organizzazione): vedono un velo grigio con la scritta EMP avversario in volo e il tempo che manca (con una warzone attiva invece la mappa diventa scura ma restano visibili la propria posizione e la warzone), sull'orologio il radar lascia il posto a una schermata grigia EMP ATTIVO con il conto alla rovescia, e la loro ricognizione UAV si ferma. I pulsanti e lo scanner restano attivi. La tua squadra non è toccata. Chi è colpito può rispondere subito con la sua EMP: più EMP possono essere in corso insieme, ognuna con la ricarica della propria squadra.
• Medikit: rianima subito tutti i compagni colpiti della tua squadra, ovunque siano (non chi è fuori gioco per la warzone). Se non c'è nessuno da rianimare il QR non si consuma.

Ogni perk ha una ricarica per squadra (30 minuti di base): sulla mappa vedi i badge con il tempo che manca e PRONTO quando è di nuovo disponibile. Tutte le squadre ricevono una notifica quando un perk viene attivato.

Punti conquistabili

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

12. 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.

Quando l'HQ attiva, modifica o elimina una zona, la mappa si aggiorna subito. Se l'app è aperta, anche in background, arriva una notifica; ad app chiusa nessuna notifica: le zone si aggiornano alla riapertura.

13. Giocare senza rete

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

Se ti muovi da solo, la modalità Lonewolf funziona interamente offline e senza account: posizione e punti tattici restano sul telefono.

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

Dalla dashboard, scheda OFFLINE → MESH E LORA, tocca MESH OFF per accenderla (Android): i telefoni vicini si scambiano le posizioni direttamente, senza rete dati. Mesh e radio restano attive anche quando lasci la dashboard.

Radio LoRa (Meshtastic)

Collegando via Bluetooth una radio Meshtastic (dashboard, scheda OFFLINE → 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. Funziona anche aprendo l'app già senza rete, purché sia stata aperta almeno una volta con la rete con match e squadra selezionati (vedi Radio LoRa). La configurazione passo per passo è nella sezione Radio LoRa.

14. 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 Dashboard, scheda OFFLINE, 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 nella scheda OFFLINE compare LORA ON.

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

Prima di andare dove manca la rete

Con la radio collegata condividi la tua posizione e vedi quella dei compagni anche senza alcuna rete, pure aprendo squadMAP quando sei già senza copertura. Serve però una preparazione con la rete:

1. Accedi e apri squadMAP almeno una volta con la rete, con il match e la squadra già selezionati: il telefono salva match, squadre, punti tattici e beacon.
2. Scarica la mappa offline dell'area di gioco (vedi Giocare senza rete).

Sul campo, senza rete, resti collegato con il tuo account e la mappa funziona. Lascia squadMAP aperta o in background, senza chiuderla dalle app recenti. Via radio non viaggia il nome del giocatore: se il compagno non è già comparso sulla mappa con la rete durante questa sessione dell'app, compare come Operatore (con la sua squadra). Le tue posizioni restano sul telefono e vengono inviate al server appena torna la rete.

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 (BMS o pannello HQ)

Dal BMS, anche dal telefono: apri il match, Mappa punti e zone → Punto, tocca la posizione iniziale, lascia Visibile a: Tutte le squadre, categoria Beacon, un titolo e, in Beacon LoRa, l'ID nodo della radio. Usa l'ID nodo, non il nome della radio, che può cambiare.

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
• squadMAP aperta almeno una volta con la rete, con match e squadra selezionati, e mappa offline scaricata
• 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

15. Smartwatch Amazfit

Con l'app squadMAP per Amazfit hai la squadra al polso: un radar centrato su di te con i compagni e i punti tattici, che ruota nella direzione in cui guardi. Il telefono resta in tasca.

Cosa serve

• Uno smartwatch Amazfit con Zepp OS 3 o successivo e schermo rotondo (ad esempio T-Rex 3, T-Rex Ultra, Balance, Active 2).
• L'app Zepp sul telefono, con l'orologio collegato, e l'app squadMAP con un account operatore. L'abbinamento non è disponibile per gli account HQ.

Installazione e abbinamento

1. Nell'app Zepp apri lo store delle app dell'orologio, cerca SquadMap e installala.
2. In squadMAP vai in DASHBOARD → TESTER → OROLOGIO → ABBINA OROLOGIO (per ora lo smartwatch è riservato agli account tester): compare un codice di 6 cifre, valido 5 minuti.
3. Nell'app Zepp apri le impostazioni dell'app SquadMap dell'orologio e inserisci il codice.
4. Apri SquadMap sull'orologio: in pochi secondi compaiono il nome del match e i compagni.

L'abbinamento dura 30 giorni. Se cambi password l'orologio viene scollegato e serve un nuovo codice; dalle impostazioni dell'app nell'app Zepp puoi anche scollegarlo tu.

Il radar

• Tu sei la freccia bianca al centro. I compagni hanno la stessa icona di ruolo della mappa del telefono, con la lettera tattica; i punti tattici hanno l'icona della loro categoria.
• Un compagno con ? non aggiorna la posizione da più di un minuto; con la X è stato colpito, e l'orologio vibra quando succede. Chi è fuori scala resta sul bordo del radar, nella sua direzione.
• SU / GIÙ: zoom da 50 a 1000 m. SELECT: alterni tra direzione di marcia in alto e nord in alto.
• In basso: scala, origine della direzione (BUSSOLA da fermo, GPS in movimento, NORD) e secondi dall'ultimo aggiornamento. Se compare CALIBRA, calibra la bussola dell'orologio muovendolo a otto.

Segnare un punto dal polso

Tieni premuto sullo schermo: si apre PUNTO QUI con le stesse categorie che puoi usare sul telefono. Scegli con SU / GIÙ e conferma con SELECT o toccando la voce: il punto viene creato nella posizione GPS dell'orologio ed è subito visibile alla squadra, come se l'avessi messo dalla mappa.

Da sapere

• L'orologio riceve i dati attraverso il telefono ogni 5 secondi: serve che il telefono abbia rete. La rete mesh e le radio LoRa non arrivano all'orologio.
• Quando lo schermo si spegne l'app si chiude, e al risveglio si riapre da sola sul radar.
• Le notifiche di squadMAP (catture, warzone, allerte) arrivano comunque sull'orologio come notifiche del telefono, se le hai abilitate nell'app Zepp.

16. Notifiche e news

Le notifiche push avvisano di allerte tattiche, catture di bandiere e punti, perk attivati (UAV, EMP, Medikit), 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.

17. Per l'HQ

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

• Mappa di comando: tutti gli operatori di tutti i team, zone e punti. In alto il banner Head Quarter: toccalo per vedere il nome del match. A destra, il riepilogo delle squadre con operatori in mappa, punti e uccisioni: tocca l'intestazione per vedere i nomi con la lettera tattica, tocca una squadra per nasconderla o mostrarla in mappa. Dalla scheda di un operatore, Segui tiene la mappa centrata su di lui. Il pannello EVENTI riporta dal vivo uccisioni, rianimazioni, bandiere, perk, uscite dai confini e fine partita.
• Tab TEAMS: crea squadre con nome e colore, assegna e sposta gli operatori; toccando un operatore ne cambi anche ruolo (soldato, caposquadra, capopattuglia) e punti, uccisioni e morti.
• Dashboard HQ, a schede come quella degli operatori: in MATCH codice HQ da copiare e condividere, scelta o creazione del match, consenso ai cambi squadra autonomi, aperto a tutte le ASD, TERMINA / RIATTIVA MATCH e, a match terminato, ARCHIVIA, e punteggi; in PROFILO il collegamento delle API eventi e soci; in EVENTI il calendario con + MATCH.
• Creazione e gestione match (GESTISCI): titolo, identificativo, briefing, coordinate; zone disegnate sulla mappa o inserite in coordinate UTM, attivabili subito o in seguito, ed eliminabili. Il tipo zona Perk crea insieme l'area di ricerca e il QR di un perk UAV, EMP o Medikit, da mostrare e stampare dall'app, come lo strumento Perk del BMS.
• Campi: in GESTISCI scegli il campo del match o ne crei uno nuovo (nome, immagine, posizionamento come in Mappa del campo); puoi regolarlo, sostituirne l'immagine o eliminarlo. I campi si riusano tra i match.

BMS – Battle Management System

Il BMS (squadmap.it/bms) è il pannello web dell'HQ, pensato anche per il telefono: lavora sugli stessi dati dell'app e ogni modifica arriva subito agli operatori.

Chi può entrare: gli HQ con email confermata, con la stessa email (o nickname) e password dell'app; gli operatori non possono entrare e giocano dall'app. Per provarlo c'è la demo completa, con operatori simulati: accedi con utente demo e password demo. Ogni HQ vede solo i propri match, quelli dei suoi operatori e i membri con il suo codice HQ.

Cosa si fa dal BMS:

• Membri: elenco e ricerca degli operatori con il tuo codice HQ; modifica di nickname, email e password (con la nuova password l'operatore rifà l'accesso nell'app), rimozione dal gruppo (l'account resta attivo e può rientrare con il codice; se è in partita in un tuo match riservato, l'app lo fa uscire e gli mostra il motivo) e QR giocatore da stampare.
• Ogni match ha le schede Dettagli, Squadre e Mappa; dai Dettagli apri anche il QR di ingresso, il debrief (replay dei movimenti ed eventi di gioco: eliminazioni, rianimazioni, catture, ingressi e uscite dalle zone) e l'export Excel.
• Eventi: crea un match (nasce con 4 squadre e aperto a tutte le ASD, opzione che puoi togliere), cambia titolo, regole, campo e centro sulla mappa, scarica il QR di ingresso, apri il debrief e l'export Excel. Termina chiude la partita per tutti (push "Partita finita"): il match resta nell'app come terminato e si può riattivare. Archivia un match terminato per nasconderlo dall'app e conservarlo: i match non archiviati più vecchi di 2 mesi vengono eliminati in automatico. Solo un match archiviato si può eliminare definitivamente, con squadre, punti, zone e debrief.
• Squadre: come il tab TEAMS dell'app. Rinomini le squadre, scegli il colore, le aggiungi o elimini; sotto ogni squadra vedi gli operatori con la lettera tattica, più la sezione Senza team. Tocca un operatore e scegli la squadra (o Nessuno): riceve una nuova lettera e perde i punti tattici creati per la squadra precedente. Nello stesso pannello imposti il ruolo (soldato, caposquadra, capopattuglia) e correggi punti, uccisioni e morti: le correzioni si sommano a quelli segnati in gioco nel frattempo.
• Mappa: la mappa del match, dal vivo e da modificare nello stesso posto. Si aggiorna da sola ogni 5 secondi con la posizione di ogni operatore (colore della squadra, lettera tattica, colpito o fuori gioco; sbiadito se non si aggiorna da 5 minuti), i punti (anche quelli messi dagli operatori), le zone con lo stato delle bandiere e il registro eventi; le zone disattivate restano sbiadite e tratteggiate. Tocca un punto o una zona per la scheda (come nell'app) e Modifica per cambiarlo. Squadre elenca gli operatori per squadra: tocca il nome di una squadra per nasconderla o mostrarla sulla mappa, tocca un operatore per seguirlo (la mappa lo tiene al centro finché non la sposti o tocchi Segui … ✕); Tutti inquadra l'intero campo. Il menu Realtime apre la mappa dei match attivi (direttamente se ce n'è uno solo).
• Aggiungere punti e zone: tocca Punto, Cerchio o Area e poi la mappa (per l'area un tocco per vertice e Fine); il pannello che si apre imposta nome, categoria, squadra, cattura via QR, beacon LoRa, tipo di zona (bandiera CTF con il suo tempo di cattura, warzone, zona sicura o vietata). Perk crea insieme l'area di ricerca e il QR da stampare del perk scelto (UAV, EMP o Medikit). Punti, centri e vertici si trascinano; mentre disegni un'area Togli ultimo annulla l'ultimo vertice, e su un'area esistente trascini i punti piccoli a metà lato per aggiungere vertici o fai doppio tocco su un vertice per toglierlo. Elimina chiede un secondo tocco di conferma. Gli operatori ricevono subito le modifiche; mentre il pannello è aperto l'aggiornamento dal vivo non tocca l'oggetto che stai modificando.

Il BMS mostra solo i dati dell'HQ e dei suoi operatori. È incluso nell'account HQ e il suo indirizzo arriva via email all'attivazione dell'account. I campi con la piantina si creano e si posizionano dall'app, in GESTISCI.

18. Account e dati

• Profilo: nickname modificabile dalla dashboard; la password si cambia da Cambia Password (almeno 6 caratteri, 10 per gli account HQ).
• Password dimenticata: tocca Password dimenticata? nella schermata di accesso dell'app o del BMS, oppure apri squadmap.it/password. Ricevi un link valido un'ora per sceglierne una nuova; poi nell'app rifai l'accesso.
• Feedback: dalla dashboard puoi inviarci segnalazioni e suggerimenti.
• Pulizia automatica: quando in un match nessuno aggiorna la posizione da più di 2 ore, gli operatori inattivi vengono rimossi; i match temporanei degli indipendenti si eliminano dopo 24 ore.
• Eliminazione account: dalla dashboard, sezione ZONA PERICOLOSA → ELIMINA ACCOUNT. Un HQ che ha ancora dei match deve prima eliminarli.

19. Problemi comuni

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