Lootbox & Boss
Encounter System

The main menu shows the Lootbox Key icon in the center slot, an info button (hover lore) explaining the crate mechanics, and a buy button that opens a separate confirmation screen before the transaction is executed.

The snippet below is read directly from the actual configuration file at configs/DeluxeMenus/gui_menus/ - not manually written in this document, so it always stays in sync with the file actually used by the server.

lootbox_shop.yml - Boutique Menu

register_command: true
update_interval: 20

menu_title: '&#FF7A00&lINFERNAL &#FFD700&lLOOTBOX'

open_command:
  - lootbox

size: 27

items:

  border:
    material: BLACK_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 0-9
      - 17-26

  left_border:
    material: GRAY_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 18

  right_border:
    material: GRAY_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 26

  balance:

    material: SUNFLOWER
    slot: 10

    display_name: '&#FFD700&lYOUR BALANCE'

    lore:
      - ''
      - '&7Current Money'
      - ''
      - '&e$%vault_eco_balance_formatted%'
      - ''
      - '&8Updates automatically.'

  key:

    material: ominous_trial_key
    slot: 13

    enchantments:
      - DURABILITY;1

    item_flags:
      - HIDE_ENCHANTS

    display_name: '&#FF6A00&lINFERNAL LOOTBOX KEY'

    lore:
      - ''
      - '&7A physical key used to'
      - '&7open the Infernal Lootbox.'
      - ''
      - '&fPrice'
      - '&a$100'
      - ''
      - '&7Click &aPurchase &7to continue.'

  buy:

    material: LIME_CONCRETE
    slot: 15

    display_name: '&#55FF55&l▶ PURCHASE ◀'

    lore:
      - ''
      - '&7Buy one Infernal Lootbox Key'
      - ''
      - '&fCost'
      - '&a$100'
      - ''
      - '&aClick to continue.'

    left_click_commands:
      - '[sound] UI_BUTTON_CLICK'
      - '[openguimenu] lootbox_confirm'

  info:

    material: BOOK
    slot: 11

    display_name: '&#00D4FF&lLOOTBOX INFORMATION'

    lore:
      - ''
      - '&#FFD700Possible Rewards'
      - ''
      - '&a$5,000 Cash'
      - '&bDiamond Sword'
      - '&dEpic Armor'
      - '&6Boss Egg'
      - ''
      - '&7All rewards are random.'
      - '&7Use your key on the crate.'

  close:

    material: BARRIER
    slot: 16

    display_name: '&#FF5555&lCLOSE MENU'

    lore:
      - ''
      - '&7Return to the game.'

    left_click_commands:
      - '[sound] BLOCK_CHEST_CLOSE'
      - '[close]'

lootbox_confirm.yml - Confirmation & Balance Validation

register_command: true
update_interval: 20

menu_title: '&#FF5555&lCONFIRM PURCHASE'

open_command:
  - lootbox_confirm

size: 27

items:

  border:
    material: BLACK_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 0-9
      - 17-26

  side_left:
    material: GRAY_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 18

  side_right:
    material: GRAY_STAINED_GLASS_PANE
    display_name: " "
    slots:
      - 26

  balance:
    material: SUNFLOWER
    slot: 10
    display_name: '&#FFD700&lYOUR BALANCE'
    lore:
      - ''
      - '&e$%vault_eco_balance_formatted%'
      - ''
      - '&8Updated live.'

  key:
    material: ominous_trial_key
    slot: 13

    enchantments:
      - DURABILITY;1

    item_flags:
      - HIDE_ENCHANTS

    display_name: '&#FF6A00&lINFERNAL LOOTBOX KEY'

    lore:
      - ''
      - '&7You are about to purchase'
      - '&f1x Infernal Lootbox Key'
      - ''
      - '&fPrice'
      - '&a$100'
      - ''
      - '&7This purchase cannot be refunded.'

  confirm:
    material: LIME_CONCRETE
    slot: 15

    display_name: '&#55FF55&l✔ CONFIRM'

    lore:
      - ''
      - '&7Purchase one key'
      - ''
      - '&fCost'
      - '&a$100'
      - ''
      - '&aClick to confirm.'

    left_click_requirement:
      requirements:
        hasmoney:
          type: has money
          amount: 100

      deny_commands:
        - '[sound] ENTITY_VILLAGER_NO'
        - '[message] &#FF5555You do not have enough money.'
        - '[close]'

    left_click_commands:
      - '[player] eco take %player_name% 100'
      - '[console] crazycrates give physical Lootbox 1 %player_name%'
      - '[sound] ENTITY_PLAYER_LEVELUP'
      - '[message] &#55FF55Purchase successful!'
      - '[message] &7Your Lootbox Key has been added.'
      - '[close]'

  cancel:
    material: BARRIER
    slot: 11

    display_name: '&#FF5555&l✖ CANCEL'

    lore:
      - ''
      - '&7Return to Lootbox Shop.'

    left_click_commands:
      - '[sound] UI_BUTTON_CLICK'
      - '[openguimenu] lootbox_shop'

Design note: balance validation is handled via DeluxeMenus' built-in click_requirement (type has money) so failed-requirement logic and rejection messages stay consistent without any extra commands outside the provided plugins.

A CSGO-type crate with an active preview, active hologram, and 4 weighted rewards at 40/35/20/5. RequiredKeys is currently set to 0 in the configuration, but a physical key is still used in the purchase flow through DeluxeMenus.

The snippet below is read directly from configs/CrazyCrates/crates/Lootbox.yml - the actual crate configuration file used by the server, not a manual copy.

Crate:
  # https://docs.crazycrew.us/mods/crazycrates/faq/#5-what-are-the-crate-types


  # Make sure to check out the wiki for anything not explained here.

  # https://docs.crazycrew.us/mods/crazycrates/


  # See CosmicCrate.yml or CasinoCrate.yml to see how the Cosmic/Casino CrateType works.

  CrateType: CSGO
  # Starting amount of keys when the player 1st joins.

  StartingKeys: 0
  # The amount of keys required to use the crate.

  RequiredKeys: 0
  # Max amount of crates that can be opened at once using /crates mass-open

  Max-Mass-Open: 10
  # If the crate shows in the /crates.

  # If the type is QuickCrate/CrateOnTheGo/FireCracker, They will not work as they require a Physical Crate.

  InGUI: true
  # Slot the item is in the GUI.

  Slot: 11
  # Enables/Disables the Broadcasts message when they open a crate.

  OpeningBroadCast: true
  # Message that is broadcast when opening the crate.

  BroadCast: "%prefix%<bold><gold>%player%</bold><reset> <gray>is opening a <bold><green>RIVRS Crate.</bold>"
  # This section is related to commands opening when a crate is opened.

  opening-command:
    # If the commands should be sent or not.

    toggle: false
    # Available Placeholders: %prefix%, %player% (PlaceholderAPI included)

    commands:
      - "lootbox"
  sound:
    # The sound options when the animation is cycling.

    cycle-sound:
      # If sound should be enabled or not.

      toggle: true
      # The type of sound to use.

      # https://minecraft.wiki/w/Sounds.json#Java_Edition_values

      value: "block.note_block.xylophone"
      # The volume of the pitch.

      volume: 1.0
      # The speed of the sound.

      pitch: 1.0
    # The sound options when an item is clicked.

    click-sound:
      # If sound should be enabled or not.

      toggle: true
      # The type of sound to use. Custom sounds from texture packs are supported!

      # https://minecraft.wiki/w/Sounds.json#Java_Edition_values

      value: "ui.button.click"
      # The volume of the pitch.

      volume: 1.0
      # The speed of the sound.

      pitch: 1.0
    # The sound options when a crate ends.

    stop-sound:
      # If sound should be enabled or not.

      toggle: true
      # The type of sound to use. Custom sounds from texture packs are supported!

      # https://minecraft.wiki/w/Sounds.json#Java_Edition_values

      value: "entity.player.levelup"
      # The volume of the pitch.

      volume: 1.0
      # The speed of the sound.

      pitch: 1.0
  # A default message if the prize doesn't have any Messages

  # i.e. Messages: [] or the value isn't there.

  Prize-Message:
    - "<gray>You have won <red>%reward% <gray>from <red>%crate%."
  # A list of commands to run by default on every prize.

  # If you do not want these commands to run, set this to []

  Prize-Commands: []
  # Global Settings

  Settings:
    # This defines whether we should track how many times players opened this crate

    # True means track, False means don't track.

    Tracking-Crate-Opening: false
    # Handles settings related to the border

    Border:
      # Settings related to the glass border

      Glass-Border:
        Toggle: true "c"># Should the glass border be enabled?

    # Broadcast a message to the server

    Broadcast:
      # If the messages should be sent.

      Toggle: false
      # The messages to broadcast.

      Messages:
        - "<red>%player% won the prize <yellow>%reward%."
      # If the player has this permission, they don't get the broadcast.

      Permission: ""
    # Settings related to rewards.

    Rewards:
      # Should a yes/no popup be made, to ask if they want to keep the prize?

      Re-Roll-Spin: false
      # Should there be a limit to how many times they can re-roll?

      Permission:
        # Should this be enabled?

        Toggle: false
        # Should this persist restarts? i.e. writes to disk the amount of respins, and reads the amount of respins.

        Persist: false
        # This will define how many permissions will be registered to the server per crate.

        # i.e. crazycrates.respin.<crate_name>.1-20

        # It will simply register multiple permissions, so it shows up in things like LuckPerms.

        Max-Cap: 20
  # Item the crate is in the GUI

  Item: "diamond"
  # This allows use of the components list below.

  Hide-Flags: false
  # The types of components to hide.

  # https://jd.papermc.io/paper/io/papermc/paper/registry/keys/DataComponentTypeKeys.html, Grab the value from the description without minecraft:

  Components:
    - "enchantments"
  # The custom model data of the item, -1 is disabled.

  Custom-Model-Data: -1
  # The item model, Mojang introduced this in 1.21.4... this replaces custom model data!

  # Set this to blank for it to do nothing.

  Model:
    # The namespace i.e. nexo

    Namespace: ""
    # The id i.e. emerald_helmet

    Id: ""
  # Should the item glow?

  # Available Types: add_glow, remove_glow, none

  Glowing: "none"
  # Name of the item in the GUI.

  Name: "<bold><green>RIVRS Crate</bold>"
  # The lore of the item in the GUI.

  Lore:
    - "<gray>This crate contains strange objects."
    - "<gray>You have <gold>%keys% keys <gray>to open this crate with."
    - "<gray>You have opened this crate: <gold>%crate_opened% times"
    - "<gray>(<yellow>!<gray>) Right click to view rewards."
  Preview:
    # The name of the inventory for the preview menu.

    Name: "<green>RIVRS Crate Preview"
    # Turn on and off the preview for this crate.

    Toggle: true
    # How many rows should the preview be? You can use 1-6.

    Rows: 4
    # Settings related to the glass in the preview.

    Glass:
      # Turn the glass border in the preview on and off.

      Toggle: true
      # The name of the border item.

      Name: " "
      # The item that shows in the border. Can be glass or any other item.

      Item: "gray_stained_glass_pane"
      # The custom model data of the item, -1 is disabled.

      Custom-Model-Data: -1
      # The item model, Mojang introduced this in 1.21.4... this replaces custom model data!

      # Set this to blank for it to do nothing.

      Model:
        # The namespace i.e. nexo

        Namespace: ""
        # The id i.e. emerald_helmet

        Id: ""
  # Settings related to animations...

  Animation:
    # This is only when an animation starts.

    # Set this to empty if you don't want to change it.

    Name: "Rolling your prize..."
    # The glass animation settings.

    Glass-Frame:
      # Should the glass animation be enabled?

      Toggle: true
      # If the glass animation option is set to false above, We will use static items.

      # If this is empty, We will use nothing.

      Items:
        "1":
          # The name of the item to display.

          name: " "
          # The lore of the item to display.

          lore: [ ]
          # The material to display.

          material: "gold_ingot"
          # The amount to display.

          amount: 1
      # The random settings for the glass animation.

      Random:
        # Should the animation be random?

        Toggle: true
        # A list of items to use, If the list is empty. We will use glass panes internally.

        Items:
          "1":
            # The name of the item to display.

            name: " "
            # The lore of the item to display.

            lore: [ ]
            # The material to display.

            material: "gold_ingot"
            # The amount to display.

            amount: 1
          "2":
            # The name of the item to display.

            name: " "
            # The lore of the item to display.

            lore: [ ]
            # The material to display.

            material: "iron_ingot"
            # The amount to display.

            amount: 1
  # Settings related to physical keys.

  PhysicalKey:
    # Name of the Key.

    Name: "<bold><green>RIVRS crate Key</bold>"
    # Lore of the Key.

    Lore:
      - "<gray>A special Key"
      - "<gray>For a special RIVRS Lootbox."
    # The item the key is.

    Item: "ominous_trial_key"
    # The custom model data of the item, -1 is disabled.

    Custom-Model-Data: -1
    # The item model, Mojang introduced this in 1.21.4... this replaces custom model data!

    # Set this to blank for it to do nothing.

    Model:
      # The namespace i.e. nexo

      Namespace: ""
      # The id i.e. emerald_helmet

      Id: ""
    # Should the item glow?

    # Available Types: add_glow, remove_glow, none

    Glowing: "add_glow"
    # Settings related to item flags.

    flags:
      # A list of components to hide on the key! I've linked a more detailed explanation below!

      # https://docs.crazycrew.us/mods/crazycrates/faq/#2-hideitemflags-no-longer-works-what-do-i-use-now

      components: []
  # Settings for the holograms.

  Hologram:
    # Toggle on and off the holograms for the crates.

    Toggle: true
    # The height of the hologram above the crate.

    Height: 1.5
    # The distance the hologram can be seen.

    Range: 8
    # How often should the hologram update? -1 is disabled.

    Update-Interval: -1
    # The background color of the hologram. It uses hex colors. This only works with CMI/FancyHolograms

    # Set the color to transparent if you don't want any color.

    Color: "transparent"
    # Whether to apply text shadow (FancyHolograms only)

    TextShadow: false
    # The message that will be displayed above the crate.

    # Note: MiniMessage or Color Codes being supported is depending on the 'holograms' plugin.

    Message:
      - "§a§lRIVRS Crate"
  # All the prizes that can be obtained in the Crate.

  # These prizes do not require any extra configuration

  # They will give the prizes based on what's already below.

  # See the AdvancedExample.yml for a more advanced crate.

  Prizes:
    "1":
      DisplayName: "<green>$5,000"
      DisplayItem: "emerald"
      DisplayAmount: 1
      Weight: 40.0
      DisplayLore:
        - "<gray>Receive $5,000"
        - ""
        - "<gold>Chance: 40%"
      Commands:
        - "eco give %player% 5000"

    "2":
      DisplayName: "<white>Dirt x64"
      DisplayItem: "dirt"
      DisplayAmount: 64
      Weight: 35.0
      DisplayLore:
        - "<gray>64 Dirt Blocks"
        - ""
        - "<gold>Chance: 35%"
      Items:
        "1":
          material: "dirt"
          amount: 64

    "3":
      DisplayName: "<aqua>Sharpness V Sword"
      DisplayItem: "diamond_sword"
      DisplayAmount: 1
      DisplayEnchantments:
        - "sharpness:5"
      Weight: 20.0
      DisplayLore:
        - "<gray>Diamond Sword"
        - "<gray>Sharpness V"
        - ""
        - "<gold>Chance: 20%"
      Items:
        "1":
          material: "diamond_sword"
          enchantments:
            sharpness: 5

    "4":
      DisplayName: "<#ff6600>Boss Egg"
      DisplayItem: "dragon_egg"
      DisplayAmount: 1
      Weight: 5.0
      DisplayLore:
        - "<gray>Summons Ace Boss"
        - ""
        - "<gold>Chance: 5%"
      Commands:
        - "ia give %player% boss_egg 1"

The AceBoss is defined in MythicMobs with the Zombie type, 50 HP, 2 damage, an active BossBar, the ace_boss model via ModelEngine, and a full skill set: spawn intro, idle loop, random attack selector, phase 2/3, hurt reaction, and death skill.

Current implementation: the random skill selector is active via AceAttackSelector (FireSlash/Fireball/Dash/FlameWave), phase triggers are active at <70% and <40% health, and the death sequence is active via AceDeathSkill in plugins/MythicMobs/skills/AceSkills.yml.

The files below are read directly from configs/DeluxeMenus/ and configs/MythicMobs/ - not manually rewritten in this document.

boss_menu.yml - Boss Arena Entry Point

menu_title: '&cAce Boss Arena'
open_command:
  - bossmenu
size: 9
items:
  'start_boss':
    material: DIAMOND_SWORD
    slot: 4
    display_name: '&c&lStart 1v1 Battle'
    lore:
      - '&7Click to spawn Ace!'
    left_click_commands:
      - '[console] mm mobs spawn AceBoss %player_name%'
      - '[player] closemenu'

Ace.yml - Mob Definition

AceBoss:
  Type: ZOMBIE

  Display: '&4&l✦ ACE, LORD OF FLAMES ✦'

  Health: 50
  Damage: 2

  AIGoalSelectors:
    - clear
    - meleeattack
    - randomstroll
    - lookatplayers
    - float

  AITargetSelectors:
    - clear
    - players

  Options:

    AlwaysShowName: true

    PreventOtherDrops: true

    PreventRandomEquipment: true

    Silent: true

    KnockbackResistance: 1

    MovementSpeed: 0.32

    FollowRange: 40

    MaxCombatDistance: 35

    Despawn: false

    PreventSunburn: true

    PreventTransformation: true

    PreventMobKillDrops: true

  BossBar:

    Enabled: true

    Title: '&c☠ ACE - LORD OF FLAMES'

    Color: RED

    Style: SEGMENTED_10

    Range: 50

  Model:

    Engine: ModelEngine

    Model: ace_boss

    Invisible: true

    Hitbox: true

  Skills:

##################################################

# SPAWN

##################################################

  - model{mid=ace_boss} @self ~onSpawn
  - skill{s=AceSpawnIntro} @self ~onSpawn

##################################################

# IDLE

##################################################


  - skill{s=AceIdleLoop} @self ~onTimer:20

##################################################

# BASIC ATTACK

##################################################


  - skill{s=AceAttackSelector} @target ~onTimer:60

##################################################

# PHASE SYSTEM

##################################################


  - skill{s=AcePhase2} @self ~onDamaged ?health{h=<0.7}

  - skill{s=AcePhase3} @self ~onDamaged ?health{h=<0.4}

  # - skill{s=AceUltimatePhase} @self ~onDamaged ?health{h=<0.15}


##################################################

# DEATH

##################################################


  - skill{s=AceDeathSkill} @self ~onDeath

##################################################

# HURT

##################################################


  - skill{s=AceHurtReaction} @self ~onDamaged

AceSkills.yml - Skill List

########################################################

################## ACE BOSS SKILLS #####################

########################################################

# Model animations available: walk, idle, attack1, attack2, attack3, attack4

# walk/idle are handled automatically by ModelEngine's built-in state machine

# based on mob movement. Only attack1-4 are manually triggered here.

########################################################


########################################################

# SPAWN

########################################################


AceSpawnIntro:
  Cooldown: 99999
  Skills:
    - state{s=idle} @self
    - sound{s=entity.wither.spawn;v=1;p=1} @PlayersInRadius{r=40}
    - delay 10
    - effect:particles{p=flame;amount=250;hS=1;vS=2} @self
    - delay 10
    - effect:particles{p=lava;amount=60;hS=1;vS=1} @self
    - delay 20
    - effect:explosion @self
    - message{msg="&4&lACE &7» &cWho dares disturb my eternal flame?"} @PlayersInRadius{r=40}

########################################################

# IDLE

########################################################


AceIdleLoop:
  Skills:
    - state{s=idle} @self

########################################################

# HURT

########################################################


AceHurtReaction:
  Cooldown: 20
  Skills:
    - sound{s=entity.blaze.hurt} @self
    - effect:particles{p=ash;amount=20} @self

########################################################

# ATTACK SELECTOR

########################################################


AceAttackSelector:
  Skills:
    - randomskill{
        skills=
        AceFireSlash,
        AceFireball,
        AceDash,
        AceFlameWave
      }

########################################################

# FIRE SLASH (attack1)

########################################################


AceFireSlash:
  Cooldown: 60
  Skills:
    - state{s=attack1} @self
    - sound{s=entity.player.attack.sweep} @self
    - delay 8
    - effect:particles{p=sweep_attack;amount=1} @self
    - effect:particles{p=flame;amount=60;hS=1.5;vS=.3} @Forward{f=2}
    - damage{a=14} @PlayersInRadius{r=3}
    - ignite{ticks=80} @PlayersInRadius{r=3}

########################################################

# FIREBALL (attack2)

########################################################


AceFireball:
  Cooldown: 120
  Skills:
    - state{s=attack2} @self
    - sound{s=entity.blaze.shoot} @self
    - delay 15
    - projectile{
        bulletType=FIREBALL;
        velocity=1.5;
        gravity=0;
        onTick=AceFireTrail;
        onHit=AceExplosion
      }

AceFireTrail:
  Skills:
    - effect:particles{p=flame;amount=5} @origin

AceExplosion:
  Skills:
    - effect:explosion
    - effect:particles{p=explosion_emitter;amount=1}
    - effect:particles{p=flame;amount=100}
    - effect:particles{p=lava;amount=40}
    - damage{a=18}
    - ignite{ticks=100}

########################################################

# DASH (attack3)

########################################################


AceDash:
  Cooldown: 140
  Skills:
    - state{s=attack3} @self
    - sound{s=entity.blaze.shoot} @self
    - effect:particles{p=smoke;amount=50} @self
    - leap{velocity=2} @target
    - delay 5
    - effect:particles{p=flame;amount=80} @self
    - damage{a=10} @PlayersInRadius{r=2}

########################################################

# FLAME WAVE (attack4)

########################################################


AceFlameWave:
  Cooldown: 160
  Skills:
    - state{s=attack4} @self
    - delay 20
    - sound{s=entity.generic.explode} @self
    - effect:particles{p=flame;amount=200;hS=6;vS=.2} @self
    - damage{a=15} @PlayersInRadius{r=6}
    - ignite{ticks=120} @PlayersInRadius{r=6}

########################################################

# PHASE 2

########################################################


AcePhase2:
  Cooldown: 99999
  Skills:
    - message{msg="&6ACE &7» &cFeel the flames!"} @PlayersInRadius{r=40}
    - potion{type=SPEED;duration=999999;level=1} @self
    - potion{type=STRENGTH;duration=999999;level=1} @self
    - effect:particles{p=flame;amount=300;hS=2;vS=2} @self

########################################################

# PHASE 3

########################################################


AcePhase3:
  Cooldown: 99999
  Skills:
    - message{msg="&4ACE &7» &4YOU WILL ALL BURN!"} @PlayersInRadius{r=40}
    - effect:particles{p=lava;amount=250;hS=3;vS=2} @self
    - potion{type=SPEED;duration=999999;level=2} @self
    - potion{type=STRENGTH;duration=999999;level=2} @self

########################################################

# ULTIMATE (attack4 reused for max impact)

########################################################


AceUltimatePhase:
  Cooldown: 99999
  Skills:
    - message{msg="&c&lACE IS UNLEASHING INFERNO!!"} @PlayersInRadius{r=60}
    - state{s=attack4} @self
    - delay 30
    - effect:particles{p=explosion_emitter;amount=10} @self
    - effect:particles{p=flame;amount=500;hS=8;vS=3} @self
    - damage{a=30} @PlayersInRadius{r=8}
    - ignite{ticks=200} @PlayersInRadius{r=8}

########################################################

# DEATH

########################################################


AceDeathSkill:
  Skills:
    - sound{s=entity.wither.death} @self
    - delay 20
    - effect:particles{p=ash;amount=200} @self
    - effect:particles{p=smoke;amount=200} @self
    - delay 20
    - effect:explosion @self

AceItems.yml - Reward Drops

flame_fragment:
  Id: blaze_powder
  Display: '&6Flame Fragment'
  Lore:
  - '&7Material used for crafting.'

common_flame_essence:
  Id: magma_cream
  Display: '&fCommon Flame Essence'

rare_flame_essence:
  Id: magma_cream
  Display: '&bRare Flame Essence'

epic_flame_essence:
  Id: magma_cream
  Display: '&5Epic Flame Essence'

RIVRSBridge acts as a bridge between the Minecraft server and external web services. Based on plugins/RIVRSBridge/config.yml, the active endpoint is https://rivrs.ourprojects.id/dashboard/index.php?action=update with a 10-second snapshot interval and the economy/lootbox/boss-kills features enabled.

Capabilities & Design Goals

Read directly from configs/RIVRSBridge/:

config.yml

# ================================
# RIVRSBridge - Professional Config
# Paper 1.21.x Data Reporter
# ================================

# ------------------------------------------------------------
# connection-settings
# - Mengatur URL endpoint dan timeout jaringan.
# ------------------------------------------------------------
connection-settings:
  # Endpoint PHP yang akan menerima POST JSON.
  # Contoh: https://domain.tld/dashboard/index.php?action=update
  api:
    endpoint: "https://rivrs.ourprojects.id/dashboard/index.php?action=update" "c"># <-- Ganti ke endpoint Anda

  timeouts:
    # Timeout koneksi ke server (connect). Jika web mati atau lambat, request akan gagal cepat.
    connect-timeout-ms: 60000 "c"># 5 detik

    # Guard timeout untuk read/response. Di HttpClient Java, guard ini biasanya diterapkan via request timeout.
    # Tujuannya: mencegah request menggantung.
    read-timeout-ms: 60000 "c"># 5 detik

    # Timeout total untuk sebuah request HTTP.
    # Recommended: sedikit lebih besar dari connect-timeout.
    request-timeout-ms: 65000 "c"># 8 detik


# ------------------------------------------------------------
# monitoring-intervals
# - Mengatur seberapa sering server mengirim snapshot.
# ------------------------------------------------------------
monitoring-intervals:
  # Interval pengiriman snapshot ke endpoint.
  # Semakin kecil: data lebih realtime, namun makin banyak request.
  # Recommended untuk produksi: 10-60 detik.
  snapshot-interval-seconds: 10 "c"># Kirim setiap 10 detik


# ------------------------------------------------------------
# features-enabled
# - Mengaktifkan/nonaktifkan fitur pengumpulan data.
# ------------------------------------------------------------
features-enabled:
  # Mengaktifkan logging debug internal.
  # Jika true, akan lebih banyak log dari ReporterService.
  debug: false

  # Mengaktifkan integrasi ekonomi via Vault.
  vault-economy:
    enabled: true

  # Mengaktifkan pengumpulan data lootbox.
  # Catatan: Implementasi event lootbox tergantung API plugin lootbox (contoh: CrazyCrates).
  lootbox:
    enabled: true

  # Mengaktifkan pengumpulan data boss kills via MythicMobs.
  boss-kills:
    enabled: true


# ------------------------------------------------------------
# security-settings
# - Keamanan untuk akses endpoint eksternal.
# ------------------------------------------------------------
security-settings:
  # API Key yang akan dikirim via header HTTP:
  #   X-API-KEY: <api-key>
  api-key: "Asdd220805!?" "c"># <-- Ganti dengan API key Anda

  retry:
    # Max percobaan pengiriman snapshot.
    # Requirement: maksimal 3 kali.
    max-attempts: 1

    initial-backoff-ms: 250000

messages.yml

# messages.yml
# RIVRSBridge — Pesan pemain & sistem (Custom Plugin)

errors:
  insufficient_funds: "&cTransaksi gagal: saldo tidak mencukupi."
  endpoint_unreachable: "&8[RIVRSBridge] &7Endpoint tidak dapat dijangkau, snapshot dilewati."
  invalid_response: "&8[RIVRSBridge] &7Respons endpoint tidak valid."

reward:
  received: "&aKamu menerima reward: %reward_name%"
  boss_drop: "&6Ace menjatuhkan %item_name%!"

boss:
  spawn_announce: "&4&lAce &7has entered the arena!"
  death_announce: "&4&lAce &7has been defeated!"

system:
  startup: "&8[RIVRSBridge] &7Bridge aktif — snapshot tiap %interval% detik."
  shutdown: "&8[RIVRSBridge] &7Bridge dinonaktifkan."