ShadowSkyBlock

Il modulo isole della suite Shadow.

Tutto ciò che riguarda i soldi in un unico file, tenuto fuori da config.yml così non devi cercarlo tra impostazioni che non c'entrano.

ShadowSkyBlock non include un'economia propria. Le funzioni legate ai soldi richiedono un'economia: ShadowEconomy, oppure Vault con un plugin di economia. - ShadowEconomy viene usato direttamente ogni volta che è installato, con o

senza Vault.

- Altrimenti qualsiasi plugin di economia registrato in Vault: EssentialsX, CMI

e simili (vedi il manuale).

Senza nessuno dei due, tutto quello che c'è qui sotto (banca dell'isola, costi e ricompense in soldi di upgrade/missioni/perk) si disattiva da solo nei menu invece di generare errori. /island suite mostra quale economia è stata agganciata.

Questo file è in inglese. La sua versione italiana è esempi/it/generators.yml, accanto a questo nella cartella del plugin, e il plugin non la legge mai: per usare quella italiana, copiala al posto di questo file e usa /island admin reload. I messaggi e i menu seguono da soli "messages.language" in config.yml; questo file è contenuto che scrivi tu, quindi resta così com'è.

Il generatore di minerali dell'isola.

Quando lava e acqua si incontrano dentro un'isola, il blocco che normalmente sarebbe cobblestone viene sostituito con uno estratto da questa tabella. Ogni isola ha il suo livello di "prestigio": più è alto, più è ricca la tabella dei materiali. Il prestigio si compra dal menu del generatore (/island generator) e vale per tutti i membri dell'isola.

I numeri sotto "materials" sono PESI e non devono per forza fare 100: vengono normalizzati da soli. 50/30/20 e 5/3/2 danno lo stesso risultato. Il menu mostra sempre la percentuale reale che ha calcolato.

Come è pensata la progressione di questa tabella: ogni prestigio toglie 4 punti alla cobblestone, ne dà 2 al minerale sbloccato dal prestigio precedente, e fa entrare il nuovo minerale al 2%. Il costo in item di un prestigio chiede sempre il minerale del prestigio PRECEDENTE - mai quello che sta per sbloccare - così non ti viene mai chiesto un minerale che non hai ancora modo di ottenere.

Stabilisce come viene calcolato il "livello" di un'isola. Il livello compare nella scoreboard (%island_level%), nelle classifiche (/island top) e in /island level, e deriva dai punti che un'isola accumula.

Ogni volta che un membro piazza uno dei blocchi elencati qui sotto dentro la propria isola, l'isola guadagna i punti indicati; romperlo li toglie (mai sotto zero). I blocchi non elencati valgono 0 punti, quindi non spostano affatto il livello. Il livello in sé è semplicemente:

level = island_points / points-per-level (arrotondato per difetto)

NOTA: il conteggio continuo segue quello che i giocatori piazzano e rompono, blocco per blocco, dal momento in cui il plugin è attivo. Quello che c'era già prima non è incluso - ed è a questo che serve /island level: riconta i blocchi reali dell'isola e riscrive il totale (vedi "island.level" in config.yml per il suo cooldown, e auto-recalc-minutes per far ricontare ogni isola a intervalli regolari).

COME È COSTRUITA QUESTA TABELLA Tre fasce, ed è grazie a loro che il livello significa qualcosa:

1-2   ciò di cui è fatta un'isola - terra, sabbia, cobblestone, assi. È
      gratis e infinito, quindi vale un punto: un livello guadagnato così
      è un livello di vera costruzione, 100 blocchi alla volta.
3-10  ciò per cui qualcuno ha dovuto faticare - una fornace, un banco da lavoro, un
      viaggio nel Nether: pietra lavorata, vetro, quarzo, ossidiana.
20+   ciò che un'isola conserva invece di spendere: i blocchi di metallo, e in
      cima il beacon e la netherite, che sono il lavoro di una stagione.

Aggiungi o togli quello che vuoi: un blocco che vale 0 si lascia semplicemente fuori.

Il pannello laterale con le statistiche dell'isola.

Questo file è distribuito in inglese. La versione italiana è esempi/it/missions.yml, accanto a questo nella cartella del plugin, e il plugin non la legge mai: per usare quella italiana, copiala al posto di questo file e usa /island admin reload. I messaggi e i menu seguono da soli "messages.language" in config.yml; questo file è contenuto che scrivi tu, quindi resta così com'è.

Le missioni mostrate nel menu "Missioni" (raggiungibile dal pannello di controllo, /island panel, o da /island missions). Aggiungine, rimuovine o modificane quante vuoi: il menu si adatta da solo.

Ogni missione ha:

display:   material/name/lore mostrati nel menu. Nome e lore sono testo
           che un giocatore legge, scritto proprio qui: questo file è in
           inglese (vedi l'inizio del file per quello italiano).
scope:     chi porta avanti il progresso:
             PLAYER - ogni giocatore ha il suo progresso separato
             ISLAND - il progresso è condiviso da tutti i membri dell'isola
objective: cosa bisogna fare.
  type:    uno dei tanti tipi disponibili (elenco completo più sotto).
  material: facoltativo - se presente filtra per quel blocco/item
            (type: BREAK_BLOCK + material: STONE = solo pietra).
            Se lo ometti, l'evento conta qualunque sia il materiale.
            Per HARVEST_CROP e PLANT_SEED è il BLOCCO della coltura
            (WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART...), per
            FILL_BUCKET/EMPTY_BUCKET il secchio (WATER_BUCKET,
            LAVA_BUCKET), per CRAFT_ITEM/SMELT_ITEM il risultato.
  custom-name: facoltativo, SOLO per type: CUSTOM_ITEM_OBTAIN - chiede un
            item con esattamente questo nome (da qualsiasi plugin di item,
            Oraxen per esempio) invece di un qualsiasi materiale vanilla.
  amount:  quante volte va fatto - o quanto deve accumularsi, per i
            tipi "cumulativi" elencati più sotto - per completarla.
period:    quando la missione ricomincia (default PERMANENT):
             PERMANENT - fatta una volta, resta fatta
             DAILY     - ricomincia ogni giorno a mezzanotte
             WEEKLY    - ricomincia ogni lunedì
             MONTHLY   - ricomincia il primo giorno del mese
           (mezzanotte del fuso orario in config.yml, missions.timezone)
levels:    facoltativo, per una missione PERMANENT a più passi: una lista di
           voci { amount, rewards }, una per livello. Ogni livello paga le
           sue ricompense quando viene raggiunto; la missione finisce dopo l'ultimo.
           Con "levels" l'"amount" dell'obiettivo viene ignorato.
rewards:   ricompense date UNA volta al completamento. Ogni ricompensa ha un
           "type":
             MONEY   - { type: MONEY, amount: 500 }        (richiede ShadowEconomy, o Vault con un plugin di economia)
             COMMAND - { type: COMMAND, command: "..." }   (eseguito dalla console, %player% sostituito)
             MESSAGE - { type: MESSAGE, text: "..." }
             ITEM    - { type: ITEM, material: DIAMOND, amount: 3 }
           Ogni ricompensa può avere anche "description": la riga che il menu
           mostra per lei (necessaria per le ricompense COMMAND, che non sanno
           descriversi da sole).

Tipi di obiettivo disponibili (type):

BREAK_BLOCK, PLACE_BLOCK, PLANT_SEED, HARVEST_CROP, FISH_CATCH,
CRAFT_ITEM, SMELT_ITEM, ENCHANT_ITEM, TAME_ANIMAL, BREED_ANIMAL,
SHEAR_SHEEP, FILL_BUCKET, EMPTY_BUCKET, EAT_FOOD, KILL_MOB, KILL_PLAYER,
DIE, JUMP, SHOOT_ARROW, HIT_ARROW_TARGET, OPEN_CONTAINER, RIDE_ENTITY,
SLEEP_IN_BED, PURCHASE_UPGRADE, INVITE_MEMBER, CUSTOM_ITEM_OBTAIN
- "cumulativi" (amount somma il valore reale, non sempre +1):
DEAL_DAMAGE, TAKE_DAMAGE (punti di danno), WALK_DISTANCE, SWIM_DISTANCE,
ELYTRA_DISTANCE (blocchi percorsi), GAIN_EXPERIENCE (punti esperienza),
LEVEL_UP (livelli guadagnati), DEPOSIT_BANK_MONEY (monete depositate)

Le missioni qui sotto sono una prima stagione completa: partono dal primo giorno (un generatore di cobblestone, un piccone di legno, i primi raccolti) e guidano un giocatore attraverso tutta l'isola - agricoltura, miniera, mob, pesca, la banca, i potenziamenti. Le ricompense crescono con l'impegno. Tienile, tagliale o riscrivile.

Questo file è in inglese. La sua versione italiana è esempi/it/player_upgrades.yml, accanto a questo nella cartella del plugin, e il plugin non la legge mai: per usare quella italiana, copiala al posto di questo file e usa /island admin reload. I messaggi e i menu seguono da soli "messages.language" in config.yml; questo file è contenuto che scrivi tu, quindi resta così com'è.

Perk personali (boost temporanei). A differenza degli upgrade dell'isola, questi appartengono al singolo giocatore che li ha comprati - o a cui sono stati regalati - e gli altri membri della stessa isola NON li ottengono a meno che non comprino o ricevano i propri. Puoi comprarne uno per te (cost-self), per tutti i membri della tua isola in una volta (cost-team, di solito più caro), o regalarne uno a un giocatore specifico (stesso prezzo di cost-self).

Ogni perk ha:

display:           materiale/nome/lore mostrati nel menu. Nome e lore
                   sono testo che un giocatore legge, scritto proprio qui:
                   questo file è in inglese (vedi l'inizio del file per
                   quello italiano).
effect:            un PotionEffectType di Minecraft (JUMP_BOOST, SPEED,
                   HASTE, REGENERATION, FIRE_RESISTANCE, WATER_BREATHING,
                   NIGHT_VISION, SATURATION, LUCK, STRENGTH, RESISTANCE,
                   SLOW_FALLING, DOLPHINS_GRACE, ABSORPTION, e così via)
amplifier:         il livello dell'effetto (0 = livello I, 1 = livello II, ...)
duration-seconds:  quanto dura (86400 = un giorno)
cost-self / cost-team: stesso formato di upgrades.yml -> cost

I perk qui sotto coprono tutta la giornata di un giocatore skyblock: spostarsi (salto, velocità, caduta lenta), lavorare (rapidità, visione notturna, respirazione subacquea, grazia del delfino), combattere (forza, resistenza, rigenerazione, assorbimento) e vivere (saturazione, resistenza al fuoco, fortuna). I prezzi salgono in base a quanto il perk cambia il gioco.

I ruoli che puoi dare ai membri dell'isola. Il proprietario dell'isola ha SEMPRE tutti i permessi, quindi non serve (e non si può) elencarli qui.

Ogni ruolo ha:

display-name: il nome mostrato nei menu e nei messaggi. È testo che un giocatore
               legge, quindi i ruoli qui sotto prendono il loro dal file di
               lingua (roles.<role>.display-name in lang/<language>.yml),
               nella lingua del server. Scrivine uno qui per usare il tuo
               al suo posto: vince, in ogni lingua. Un ruolo che aggiungi
               tu ne ha bisogno, altrimenti mostra il suo id. I codici colore con
               "&" funzionano (&e = giallo).
priority:      solo l'ordine nei menu (più alto = più in alto)
permissions:   cosa può fare questo ruolo, tra:
  BREAK_BLOCKS      - rompere blocchi
  PLACE_BLOCKS      - piazzare blocchi
  USE_BUCKET        - usare secchi (acqua/lava/latte)
  USE_CONTAINERS    - aprire casse/barili/fornaci/altri contenitori
  USE_DOORS         - aprire porte/botole/cancelli
  INTERACT_REDSTONE - usare leve/pulsanti/piastre a pressione
  PVP               - colpire altri giocatori sull'isola
  DAMAGE_ANIMALS    - colpire animali/mob passivi sull'isola
  INTERACT_ENTITIES - interagire con le entità (villager, pannelli...)
  INVITE_MEMBERS    - invitare nuovi membri
  KICK_MEMBERS      - cacciare membri
  MANAGE_ROLES      - cambiare il ruolo di un altro membro
  MANAGE_UPGRADES   - comprare e gestire i potenziamenti dell'isola
  MANAGE_SETTINGS   - cambiare le regole dell'isola (griefing dei mob, spawn,
                       PvP, fuoco, ora, meteo...)
  SET_HOME          - spostare il punto di teletrasporto dell'isola
  DELETE_ISLAND     - eliminare l'isola

Aggiungi o rimuovi ruoli liberamente: il menu dei ruoli si adatta a quello che c'è in questo file.

Cosa va nella cassa iniziale di una nuova isola. Vale sia per la generazione integrata (IslandGenerator, quando non usi le schematic) sia per QUALSIASI schematic scelta dal menu: una volta incollata la schematic, il plugin cerca la PRIMA cassa vicino al punto di spawn dell'isola e la riempie con questi item (una schematic fatta per lo skyblock di solito ha già una cassa vuota all'interno, in attesa di essere riempita).

Ogni voce è un materiale di Minecraft più una quantità.

Questo file è in inglese. La sua versione italiana è esempi/it/upgrades.yml, accanto a questo nella cartella del plugin, e il plugin non la legge mai: per usare quella italiana, copiala al posto di questo file e usa /island admin reload. I messaggi e i menu seguono da soli "messages.language" in config.yml; questo file è contenuto che scrivi tu, quindi resta così com'è.

Upgrade che un giocatore può comprare dal menu "Upgrade" (raggiungibile dal pannello di controllo, /island panel, o da /island upgrades). Aggiungine, togline o cambiane quanti vuoi, e dai a ognuno QUANTI LIVELLI vuoi: il menu si adatta da solo sia al numero di upgrade sia al numero di livelli di ciascuno.

Ogni upgrade ha:

display:  materiale/nome/lore mostrati nel menu. Nome e lore sono testo che un
          giocatore legge, scritto proprio qui: questo file è in inglese
          (vedi l'inizio del file per quello italiano).
type:     cosa fa quando sale di livello. Valori possibili:
            RADIUS         - allarga di "amount" blocchi il raggio protetto dell'isola
            MEMBER_LIMIT   - alza di "amount" il limite di membri
            BLOCK_LIMIT    - alza di "amount" quanti blocchi dei "materials"
                             elencati può contenere l'isola. Richiede:
                               materials:  [ PISTON, STICKY_PISTON ]
                               base-limit: 64        (quanti ne ha un'isola all'inizio)
                             Un blocco che nessun upgrade elenca non ha alcun tetto.
                             Il conteggio parte dal giorno in cui il tetto esiste:
                             quello che era già sull'isola non viene contato.
            CROP_BOOST     - le coltivazioni crescono più in fretta: "amount" è la
                             percentuale in più (100 = veloci il doppio, 50 = una volta
                             e mezza). Funziona su ogni coltivazione con fasi di crescita.
            XP_BOOST       - i membri guadagnano "amount"% di esperienza in più mentre
                             sono sulla propria isola
            MOB_DROP_BOOST - i mob uccisi da un membro sull'isola droppano
                             "amount"% in più (100 = drop doppi)
            SPAWNER_BOOST  - gli spawner dell'isola generano più in fretta: "amount" è
                             la percentuale in più (100 = il doppio delle volte,
                             200 = il triplo). Vale sia per gli spawner vanilla
                             sia per gli stack di ShadowSpawners.
levels:   una voce per livello (1, 2, 3, ...). Ogni livello ha:
  amount: quanto aggiunge QUEL livello - non un totale progressivo scritto a mano: se
          il livello 1 dà +10 e il livello 2 dà +15, un giocatore che arriva
          al livello 2 ha ricevuto +25 in tutto
  cost:   cosa serve per comprare quel livello. "money" richiede un'economia:
          ShadowEconomy, oppure Vault con un plugin di economia. "items" può
          chiedere anche un item CUSTOM (da qualsiasi plugin, Oraxen per
          esempio) aggiungendo "custom-name" con il nome esatto mostrato
          sull'item.
  duration: FACOLTATIVO. Rende il livello temporaneo: "2h", "90m", "3d",
          "1h30m" o un semplice numero di secondi. Quando scade, l'upgrade
          torna al livello 0 e si può comprare di nuovo - un
          "boost" più che un acquisto permanente. Comprare il livello successivo
          mentre uno è ancora attivo fa ripartire il tempo. Se lo ometti,
          il livello è per sempre.
  rewards: ricompense EXTRA date al raggiungimento di quel livello, oltre
           all'effetto stesso. Stesso formato di missions.yml.
Non esiste un livello "dopo l'ultimo": quando un giocatore ha comprato il
livello più alto definito qui, l'upgrade risulta al massimo.

COSA OTTIENE LA VERSIONE FREE

Gli upgrade funzionano senza licenza, fino a un tetto: i primi upgrade di questo file sono attivi e ognuno si può comprare fino a un certo livello. I numeri esatti vengono stampati in console all'avvio, e anche ciò che resta escluso viene indicato lì - un limite di cui nessuno ti parla sembra un bug. Il menu mostra comunque i livelli oltre il tetto, così un giocatore vede dove porta la strada; è l'acquisto che si ferma. Una chiave di licenza toglie entrambi i tetti.

Ogni messaggio che legge un giocatore, modificabile senza toccare il codice.

La lingua del plugin: l'inglese è il default, e lang/it.yml contiene l'italiano (imposta "messages.language: it" in config.yml per usarlo). Tradurre il plugin significa copiare questo file e riscrivere i valori - mai le chiavi.

Codici colore di Minecraft: & seguito da un carattere (&a = verde, &c = rosso).

Come appaiono i menu del plugin: la dimensione di ogni menu, e lo slot e il materiale di ogni voce. Cambiali per fare tuoi i menu senza toccare una riga di codice. Ogni menu riempie gli slot vuoti con "filler" per un bordo pulito: lascialo così, o cambialo per adattarlo al tuo stile.

TITOLI, NOMI E LORE NON SONO IN QUESTO FILE

Sono testo che legge un giocatore, quindi stanno nel file di lingua (lang/<language>.yml, quello scelto da "messages.language" in config.yml) sotto lo stesso percorso, e i menu cambiano lingua insieme al resto del

plugin:
  menus.island-panel.title                -> il titolo di "island-panel"
  menus.island-panel.items.members.name   -> il nome della sua voce "members"
  menus.island-panel.items.members.lore   -> la sua lore
  menus.common.back.name                  -> i pulsanti sotto "common"

Per usare invece un testo tuo, scrivi "title", "name" o "lore" proprio qui, sotto quel menu o quella voce, come fa "filler" qui sotto: quello che scrivi in questo file vince sul file di lingua, in ogni lingua. "lore: []" significa nessuna lore.

Tutto il resto in questo file - chiavi, slot, materiali - resta in inglese.

Ogni menu è disegnato dentro una cornice di vetro colorato, con il contenuto al centro: i colori vengono da una palette integrata, uno per menu. Per sceglierli tu, aggiungi "frame" e "accent" (due pannelli di vetro colorato) sotto quel menu:

frame: LIME_STAINED_GLASS_PANE
accent: GREEN_STAINED_GLASS_PANE