Skip to content

Configuration

Justin_SGD edited this page Feb 1, 2026 · 19 revisions

Configuration Overview

JuByteCase generates these files inside plugins/CaseOpening/:

  • config.yml – general settings (timing, sounds, rarities, particles)
  • cases.yml – cases and reward items
  • inventory.yml – GUI layout for all menus (choose case, preview, animation, editor, ...)
  • messages.yml – all messages & permissions keys
  • commands.yml – command registration
  • database.yml – database connection (H2Portable / MySQL / MariaDB)
  • rarities.yml – optional rarity system

Tip: Most case content can now be managed via /case edit and /case rarity.


config.yml (important keys)

CaseLog: true

# Animation timing
Delay: 0.025
AddedDelay: 0.05
ChestGeneralTime: 14

# Item pool limits
MaxItems: 30
MinItems: 2

# Sounds
ChestSound1: ENTITY_ENDER_DRAGON_FLAP
ChestSound2: UI_BUTTON_CLICK
WinSound: ENTITY_PLAYER_LEVELUP

ForceCloseChestAfterWin: false

Rarities:
  Enabled: false
  PreviewLore:
    - '&8&m----------------'
    - '&7Seltenheit: {rarity}'
    - '&7Chance: {chance}%'

CaseParticles:
  Enabled: true
  Particle: FLAME
  Count: 1.5
  Radius: 0.7
  Height: 1.0
  IntervalTicks: 1
  RotationStep: 0.12

Rarities

  • Rarities.Enabled toggles the rarity system
  • If enabled and a CaseItem has a rarity key, the item’s chance will be taken from rarities.yml
  • PreviewLore adds extra lines to preview items
    • placeholders: {rarity}, {chance}

CaseParticles

If enabled, particles are displayed around configured CaseBlocks.

  • Particle must be a valid Bukkit particle
  • IntervalTicks controls the update speed
  • Radius/Height/RotationStep shape the effect

rarities.yml

rarities:
  common:
    displayName: '&aGewöhnlich'
    chance: 70.0
  rare:
    displayName: '&9Selten'
    chance: 25.0
  legendary:
    displayName: '&6Legendär'
    chance: 5.0

Rarity keys (e.g. common) can be assigned to a CaseItem as rarity: common.


inventory.yml

inventory.yml controls all GUIs, including:

  • ChooseCase (case menu)
  • CasePreview (preview menu)
  • MyCases (hidden cases)
  • CaseAnimation (opening animation)
  • Case Editor inventories (/case edit)
  • Rarity Editor inventories (/case rarity)

Because this file can be large, the recommended workflow is:

  1. change titles / sizes / filler items
  2. then adjust item slots and icons per menu

messages.yml

Contains:

  • Prefix / general messages
  • Command usage & permission nodes
  • Announce/win messages
  • Log messages & pagination

Placeholders used in messages can include:

  • {player}
  • {case_amount}
  • {caseDisplayName}
  • {winItem} (Depends on message context.)

JuByteCase Wiki

Plugin Usage

Setup

API

Clone this wiki locally