Tutte le guide
Survival

RewardCrates

Casse premio con animazione di apertura, chiavi fisiche e virtuali, anteprima dei premi, ologrammi e particelle. Ogni cassa è un file nella cartella crates.

Acquistare la licenza Paper, Spigot, Bukkit 1.20 – 1.21 · Java 17+

Installazione

  1. Scarichi il file dall'area clienti e lo copi nella cartella plugins del server.
  2. Avvii il server una volta: viene creata la cartella del plugin con config.yml.
  3. Incolli la sua licenza alla voce license: e riavvii il server.

Comandi

Alias: /crates, /rc

ComandoPermessoDescrizione
/crate preview <crate>rewardcrates.previewMostra i premi di una cassa
/crate keys [player]rewardcrates.keysLe tue chiavi virtuali (o quelle di un altro giocatore)
/crate give <player|*> <crate> [amount] [physical|virtual]rewardcrates.adminDà chiavi a un giocatore o a tutti
/crate take <player> <crate> [amount]rewardcrates.adminToglie chiavi virtuali
/crate open <crate> <player>rewardcrates.adminApre una cassa per un giocatore, senza chiave
/crate set <crate>rewardcrates.adminTrasforma il blocco che guardi in una cassa
/crate removerewardcrates.adminToglie la cassa dal blocco che guardi
/crate listrewardcrates.adminElenco delle casse caricate
/crate reloadrewardcrates.adminRicarica configurazione, lingue e casse

Permessi

PermessoPredefinitoDescrizione
rewardcrates.usetrueAprire le casse con una chiave
rewardcrates.previewtrueVedere l'anteprima dei premi
rewardcrates.keystrueVedere le proprie chiavi virtuali
rewardcrates.keys.othersopVedere le chiavi virtuali degli altri
rewardcrates.bypass.cooldownopAprire senza attesa tra un'apertura e l'altra
rewardcrates.adminopTutti i comandi di gestione

Segnaposto (PlaceholderAPI)

SegnapostoDescrizione
%rewardcrates_keys_total%Chiavi virtuali in totale
%rewardcrates_keys_<crate>%Chiavi virtuali di una cassa (es. %rewardcrates_keys_mystic%)

Creare una cassa

  1. Copia crates/mystic.yml e rinominalo, ad esempio crates/legendary.yml: il nome del file è l'id della cassa.
  2. Modifica nome, chiave, animazione (ROULETTE, SHUFFLE o INSTANT), premi e probabilità.
  3. Scrivi /crate reload, guarda un blocco (ad esempio un baule) e scrivi /crate set legendary.
  4. Dai le chiavi con /crate give <player> legendary 1. Le chiavi virtuali funzionano anche per i giocatori offline.

Premi con comandi

Un premio può dare oggetti, eseguire comandi dalla console ({player} = chi apre) o entrambe le cose. Così puoi dare soldi, gradi o oggetti di altri plugin.

File di configurazione

config.yml
# Your license key (you received it privately from our discord bot).
license: "PASTE-YOUR-LICENSE-HERE"

# Message language: "en" (english) or "it" (italiano). Files are in /lang and can be edited freely.
language: en
# When true, each player sees the messages in their own game language (when a file for it exists).
use-client-language: true

settings:
  # What happens when the inventory is full: "drop" (items fall at the player's feet) or "deny" (opening is blocked).
  inventory-full: drop
  # Seconds a player must wait between two openings.
  open-cooldown: 3
  # Physical keys must be held in the main hand. When false, any key in the inventory works.
  require-key-in-hand: true
  # Shift + right-click opens several keys at once (no animation).
  mass-open: true
  mass-open-limit: 16
  # Left-click on a crate shows its rewards.
  preview-on-left-click: true
  # Players without a key are pushed back a little.
  knockback-without-key: true
  # Crate blocks can't be broken (use /crate remove).
  protect-crate-blocks: true
  # Every opening is written to /logs/openings.log
  log-openings: true

holograms:
  enabled: true
  # Height above the crate block.
  height: 1.25
  # Transparent background (false = dark background like a name tag).
  transparent-background: true

particles:
  enabled: true
  # How often particles are shown (20 ticks = 1 second).
  interval-ticks: 8
  # Particles are only shown when a player is this close.
  view-distance: 24

# Reward rarities. Use them in the crate files ("rarity: epic").
rarities:
  common:
    name: "&7Common"
    glass: LIGHT_GRAY_STAINED_GLASS_PANE
  uncommon:
    name: "&aUncommon"
    glass: LIME_STAINED_GLASS_PANE
  rare:
    name: "&9Rare"
    glass: LIGHT_BLUE_STAINED_GLASS_PANE
  epic:
    name: "&5Epic"
    glass: PURPLE_STAINED_GLASS_PANE
  legendary:
    name: "&6&lLegendary"
    glass: ORANGE_STAINED_GLASS_PANE
crates/mystic.yml
display-name: "<gradient:#B06AB3:#4568DC>&lMystic Crate</gradient>"

# Opening animation: ROULETTE (spinning row), SHUFFLE (rewards flicker in the centre) or INSTANT (no menu).
animation: ROULETTE

# Show the reward list on left-click / with /crate preview.
preview: true

key:
  material: TRIPWIRE_HOOK
  name: "<gradient:#B06AB3:#4568DC>Mystic Key</gradient>"
  lore:
    - "&7Right-click a &fMystic Crate &7to open it."
    - ""
    - "&8Do not lose this key."
  glow: true
  # custom-model-data: 1001

# Lines shown above the crate block.
hologram:
  - "<gradient:#B06AB3:#4568DC>&lMYSTIC CRATE</gradient>"
  - "&7Right-click with a key to open"
  - "&8Left-click to preview"

# Particle effect around the crate. Styles: RING, HELIX, NONE
particles:
  type: WITCH
  style: HELIX

# Sound names from https://minecraft.wiki/w/Sounds.json  ->  "name:volume:pitch"
sounds:
  open: "block.ender_chest.open:1:1"
  spin: "block.note_block.hat:0.6:1.6"
  win: "entity.player.levelup:1:1.2"

# Rarities that are announced to the whole server.
broadcast-rarities: [epic, legendary]

# Rewards. "chance" is a weight: the higher it is, the more often it comes out.
# The real percentage is shown in the preview.
rewards:
  diamonds:
    chance: 20
    rarity: rare
    display:
      material: DIAMOND
      amount: 6
      name: "&b6x Diamond"
    items:
      - material: DIAMOND
        amount: 6

  golden-apples:
    chance: 30
    rarity: uncommon
    display:
      material: GOLDEN_APPLE
      amount: 4
      name: "&e4x Golden Apple"
    items:
      - material: GOLDEN_APPLE
        amount: 4

  experience:
    chance: 35
    rarity: common
    display:
      material: EXPERIENCE_BOTTLE
      name: "&a500 Experience"
      lore:
        - "&7Instantly added to your level."
    commands:
      - "xp add {player} 500 points"

  netherite-sword:
    chance: 8
    rarity: epic
    display:
      material: NETHERITE_SWORD
      name: "&5Mystic Blade"
      glow: true
    items:
      - material: NETHERITE_SWORD
        name: "&5Mystic Blade"
        lore:
          - "&7Forged inside a Mystic Crate."
        enchantments:
          sharpness: 5
          unbreaking: 3
          looting: 3

  elytra:
    chance: 2
    rarity: legendary
    display:
      material: ELYTRA
      name: "&6&lElytra"
      glow: true
    items:
      - material: ELYTRA
    messages:
      - "&6You are one of the lucky few!"