Pillars of Fortune - Minecraft Plugin

Benvenuto in Pillars of Fortune, un plugin per minigame modulare e altamente configurabile per server Spigot/Paper (1.20+). Questo plugin ricrea la famosa modalità di gioco in cui i giocatori spawnano su pilastri isolati e devono sopravvivere ricevendo oggetti casuali.

📥 Installazione

1. Scarica il file .jar del plugin (dopo averlo compilato con mvn package).
2. Inseriscilo nella cartella plugins/ del tuo server.
3. Avvia o riavvia il server.
4. I file di configurazione verranno generati automaticamente nella cartella plugins/PillarsOfFortune/.

🎮 Comandi

Comando	Descrizione	Permesso
/pof create <id> <template>	Crea una nuova arena usando un template specifico.	pof.admin
/pof join <id>	Unisciti a una partita esistente.	Nessuno (default)
/pof leave	Abbandona la partita corrente.	Nessuno (default)
/pof reload	Ricarica i file di configurazione (arenas.yml, loot.yml).	pof.admin

⚙️ Configurazione

Il plugin è progettato per essere interamente configurabile. Ecco i file principali:

1. arenas.yml (Template Arene)

Qui definisci i "modelli" per le tue arene. Puoi creare diversi template (es. default_sky, hardcore, mega_mode).

templates:
  default_sky:
    generation:
      world_environment: "NORMAL" # NORMAL, NETHER, THE_END
      void_world: true           # Genera un mondo vuoto
    pillars:
      count: 12                  # Numero di pilastri
      distribution: "CIRCLE"     # Disposizione
      distance_from_center: 35   # Raggio dal centro
      height: 40                 # Altezza dei pilastri
      material: 
        type: "QUARTZ_PILLAR"    # Materiale del pilastro
    base:
      radius: 3                  # Raggio della piattaforma
      material: "GLASS"          # Materiale della piattaforma
    cage:
      enabled: true              # Gabbia di vetro pre-partita
      material: "BARRIER"        # Materiale gabbia

2. loot.yml (Sistema di Loot)

Il loot è diviso in "Fasi" (Tiers) basate sul tempo trascorso in partita.

settings:
  drop_interval_ticks: 100 # Intervallo di drop (100 ticks = 5 secondi)

tiers:
  early_game:
    start_second: 0        # Attivo dall'inizio
    items:
      - material: "OAK_PLANKS"
        amount: 5
        chance: 50.0       # 50% di probabilità
        
  mid_game:
    start_second: 120      # Attivo dopo 2 minuti (120s)
    items:
      - material: "IRON_SWORD"
        chance: 10.0

🕹️ Come Giocare

1. Creazione: Un admin crea l'arena: /pof create arena1 default_sky.
2. Join: I giocatori entrano: /pof join arena1.
3. Attesa: I giocatori aspettano nelle gabbie sui loro pilastri.
4. Start: Quando si raggiunge il numero minimo di giocatori (default 2), inizia il countdown.
5. Partita:
   • Le gabbie spariscono.
   • Ogni 5 secondi (configurabile) ricevi oggetti casuali nel tuo inventario.
   • Usa i blocchi per costruire e le armi per combattere.
   • Attento a non cadere nel vuoto!
6. Vittoria: L'ultimo giocatore rimasto vince.

🛠️ Compilazione (Sviluppatori)

Il progetto usa Maven. Per compilare:

mvn clean package

Il file jar si troverà in target/PillarsOfFortune-1.0-SNAPSHOT.jar.