Il tuo primo progetto

Questa guida crea un plugin piccolo ma reale, così vedi ogni fase almeno una volta. Lo stesso percorso vale per ogni tipo di progetto.

#La richiesta

In Crea, scegli Plugin Bukkit/Spigot/Paper (Java) e scrivi:

A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

Nota cosa contiene: la piattaforma e la versione, ogni comando e cosa fa, le regole sui tempi, il salvataggio dei dati, i permessi e cosa deve essere configurabile. È questo che rende utilizzabile già il primo risultato.

#Cosa succede dopo

1. Codexe scrive i file in diretta: un pom.xml di Maven, la classe principale, le classi dei comandi e dei listener, plugin.yml e config.yml.
2. Il banner passa a Controllo del progetto… e poi a Build in corso…. Codexe compila il plugin.
3. Se il compilatore segnala un errore (per esempio un import sbagliato), vedrai Correzione di un problema…. Codexe ripara il codice e compila di nuovo. Questo non consuma i tuoi token.
4. Il progetto diventa Pronto.

#Guarda il risultato

• Apri plugin.yml e controlla che comandi e permessi corrispondano a quello che hai chiesto.
• Apri config.yml: il cooldown e i messaggi dovrebbero essere lì.
• Dai un'occhiata alla classe principale. Non serve capire ogni riga, ma puoi accorgerti delle mancanze evidenti.

#Cambia qualcosa

Nella chat del progetto, scrivi:

Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe modifica i file esistenti invece di ripartire da zero. Le richieste successive costano molto meno di un progetto nuovo, perché vengono riscritti solo i file interessati. Quando la modifica riguarda un progetto compilabile, Codexe lo verifica di nuovo.

#Compilalo e provalo

Premi Compila per eseguire una build nuova, poi Scarica il JAR. Metti il JAR nella cartella plugins/ del tuo server e riavvialo. Prova ogni comando, compresi i casi limite (muoversi durante l'attesa, il cooldown, un riavvio).

#Prossimi passi

• Come scrivere una buona richiesta
• Lavorare con l'AI
• Guida a Spigot e Paper