# WavesPolizia **Sistema polizia completo per server Minecraft RP realistico stile USA** ## 📋 Caratteristiche - **MDC (Mobile Data Computer)**: Sistema completo di gestione dati con multe, arresti e ricercati - **Sistema Radio**: Comunicazione multi-canale per forze dell'ordine - **ID Polizia**: Identificativi automatici stile LAPD (7A15, 7L15, ecc.) - **Comandi RP**: Interazioni realistiche per roleplay - **Storage YAML**: Salvataggio persistente dei dati (MySQL opzionale in futuro) ## 🔧 Requisiti - Java 17+ - Paper/Spigot 1.19.4 ## 📦 Installazione 1. Scarica il file `.jar` dalla sezione releases 2. Posiziona il file nella cartella `plugins/` del server 3. Avvia il server per generare i file di configurazione 4. Modifica `config.yml` secondo le tue esigenze 5. Usa `/police reload` per ricaricare la configurazione ## ⚙️ Comandi ### MDC (Mobile Data Computer) ``` /mdc check - Visualizza dati giocatore /mdc fine <$> - Aggiungi multa /mdc arrest - Arresta giocatore /mdc wanted - Toggle stato ricercato ``` ### Sistema Radio ``` /radio channel - Entra in un canale radio /radio send - Invia messaggio radio /radio - Invia messaggio (shortcut) /radio leave - Esci dalla radio ``` ### Amministrazione ``` /police reload - Ricarica configurazione /police reset - Resetta dati giocatore /police id [player] [ID] - Visualizza/assegna ID polizia ``` ### RP ``` /stop - Ferma un giocatore (RP) ``` ## 🔐 Permessi - `wavespolice.mdc` - Accesso al sistema MDC - `wavespolice.radio` - Accesso alla radio polizia - `wavespolice.use` - Comandi base polizia - `wavespolice.admin` - Comandi amministrativi ## 📁 Struttura Progetto ``` src/main/java/it/wavesrp/wavespolizia/ ├── WavesPolizia.java # Classe principale ├── commands/ # Gestori comandi │ ├── MDCCommand.java │ ├── RadioCommand.java │ ├── PoliceCommand.java │ └── StopCommand.java ├── managers/ # Logica business │ ├── MDCManager.java │ ├── RadioManager.java │ └── PoliceIDManager.java ├── models/ # Modelli dati │ ├── PlayerData.java │ └── RadioChannel.java └── storage/ # Persistenza dati ├── DataStorage.java └── YAMLStorage.java ``` ## 🎮 Esempi d'Uso ### Scenario 1: Controllo di routine ``` Agente: /stop Giovanni Giovanni: [riceve notifica di fermo] Agente: /mdc check Giovanni Agente: /mdc fine Giovanni 500 ``` ### Scenario 2: Comunicazione radio ``` Agente1: /radio channel PATROL Agente1: /radio Unità 7A15, in posizione Agente2: /radio channel PATROL Agente2: /radio Ricevuto 7A15, tutto tranquillo ``` ### Scenario 3: Ricerca e arresto ``` Dispatch: /mdc wanted Giovanni [Broadcast a tutte le unità] Agente: /radio Target localizzato, procedo all'arresto Agente: /mdc arrest Giovanni ``` ## 🔄 Espansioni Future Il plugin è progettato per future implementazioni: - Sistema tribunale - Integrazione banca/economia - Database MySQL - Meccaniche prigione avanzate - Sistema licenze e documenti - Integrazione veicoli ## 📝 Licenza Progetto privato per WavesRP Server ## 🤝 Supporto Per bug, suggerimenti o richieste di funzionalità, contatta il team di sviluppo.