Big compatibility update on this one.

• Rebuilt and verified Kits Crates+ for Spigot 1.21.1 through the latest current Spigot release
• Confirmed the plugin is still building cleanly on the older 1.21.1 API target for backward compatibility
• Also verified clean compile support against the newest available Spigot API/release line
• No planned regressions to current 1.21.x functionality
• This update is mainly to keep the plugin safe and current across the newer Spigot versions without dropping support for the earlier 1.21 builds

Recommended:

• 1.21.1+ supported
• Latest Spigot release supported
• Use the proper Java version for your server version when updating
  

Important runtime note:

• 1.21.x needs Java 21+
• 26.1.x needs Java 25+ per Spigot’s March 24 / April 9, 2026 release post

Added the ability to hide and change messaging when receiving kits right inside of the GUI.

Over 40 bug fixes collected from generalized users.

Full clarity and transparency on the block arsenal wiki.
https://blockarsenal.com/wiki/kits-crates-plus

Kits Crates+ 0.3.4.4 RELEASE
Big one. I went through this update and focused on making the plugin way cleaner to use in-game, fixing crate roll logic, and making command-based rewards actually display properly.

NEW / IMPROVED

• Added in-game crate header name editing directly from the crate editor (Crate Settings button).
• Added cleaner editor UX across crate/kit/container editors:
• Visible chance values on entries.
• Quick chance editing with Shift + Left/Right (- / + 5%).
• Better action entry guidance text so users understand exactly how to set icons.
• Added full custom preview/spin icon support for action rewards (commands/sounds/particles).
• You can drag/drop an item with custom name, lore, model data, etc. onto action entries.
• Added crate preview system controls:
• Global preview toggle in KCP settings GUI.
• Per-crate preview toggle in crate access/settings GUI.
• Per-kit preview override in kit settings GUI.
• Added optional first-join kit support (config + GUI workflow support).
• Added easier one-time-use and first-join controls in kit settings GUI.
• Added all targeting support for admin commands:
• /crate give <player|all> ...
• /crate givekey <player|all> ...
• /crate giveblock <player|all> ...
• /kit <id> all
• Added MiniMessage fallback control (keep MM by default, optional legacy-safe fallback mode).
• Improved example content bootstrap behavior so deleted example kits/crates don’t keep respawning unless explicitly enabled.

FIXES

• Fixed crate spin/reel pool so non-item rewards are now included in spin visuals.
• Fixed mixed crates (items + command/sound/particle outcomes) only showing item spins.
• Fixed barrier-only spin behavior in action-heavy crates by improving display-pool fallback logic.
• Fixed nested container/action display handling using configured engine depth.
• Fixed preview presentation to be informational and cleaner (no raw chance spam).
• Fixed custom action icon carryover so custom metadata is preserved through:
• Preview display
• Spin animation/winner display
• Physical reveal display at the end

EXTRA POLISH

• Prefix hover/click messaging formatting was cleaned up to be professional and minimal.
• The hover/click behavior stays on the plugin prefix instead of cluttering normal message text.

Just a quick update on using commands, particles, and effects within Crates as rewards as a solo reward.

Small Update:

The logic and process of using Commands inside of Crates is now fixed.
Usage now:

• Put command ACTION in main/root container: runs every crate open.
• Put command ACTION inside a nested container: it is rolled with nested container logic/chance. This will allow you to put a command in as one of the rolled items. If you, for example, put in a diamond and a golden apple and a nested container with a command in a crate, as the three options, and it's a tier one crate, it will no longer run the command every single time you open the crate. It will now run either the diamond if you roll it, the golden apple if you roll it, or the command if you roll it.
• Command-only crate now works when command is at root/main container.

World Guard behavior now works as intended and World Guard should not block players interacting with corpses if they have the permission to interact with corpses for region flags: build, place, or place blocks, or break blocks.

Other boring background bug fixes and performance upgrades that you will not care about.

0.3.3
✨ Added
Chat & Compatibility

• Improved chat prompt compatibility hooks for Paper and fork variants (including ArcLight-style chat event behavior) for more reliable chat-input editors.
  
  
• PlaceholderAPI soft-support for action commands:
  
  • %player%, %x%, %y%, %z%, %world%, and other supported placeholders when PlaceholderAPI is installed.
    
• Command selector normalization:
  
  • Uppercase selectors (@P, @A, @E, etc.) are now automatically normalized and supported.
    

Text Formatting System

• Configurable MiniMessage support:
  
  textFormatting:
  miniMessageEnabled: true
  
  • true (default): Full MiniMessage support with gradients.
    
    
  • false: Legacy-safe fallback mode.
    
• Fallback mode behavior:
  
  • MiniMessage tags are stripped.
    
    
  • Legacy & color codes continue to render correctly.
    
• Added MiniMessage toggle in /kcp settings GUI.
  
  
• Reload-safe formatting:
  
  • /kit reload and /crate reload now correctly re-apply MiniMessage/legacy mode behavior.
    

Crate Editor & UX

• Multi-page reward pool editing for larger crates.
  
  
• Visible item chances directly in editor icons and lore.
  
  
• Quick chance editing keybinds:
  
  • Shift + Left Click → -5
    
    
  • Shift + Right Click → +5
    
• Explicit delete behavior using Q (drop key) to prevent accidental removals.
  
  
• GUI-based crate display name editor (used in headers and placeholders).
  

Kit System Improvements

• Unified visible-chance + quick-edit keybind behavior across kit container and nested editors.
  
  
• One-time kit claim support:
  
  • Data model
    
    
  • Persistent storage
    
    
  • Enforcement logic
    
• New kit settings GUI options:
  
  • One-time claim toggle
    
    
  • First-join auto-kit assignment
    
    
  • First-join auto-kit disable control
    

Crate Block / Key / Hologram System

• Expanded crate block and key settings GUI with clearer controls.
  
  
• Per-crate hologram customization:
  
  • Enable/disable toggle
    
    
  • Custom hologram text prompt
    
    
  • Placeholder support within hologram text
    
• Per-crate default uses configuration.
  
  
• Per-crate deplete effect controls.
  

Crate Preview (Beta)

• Added crate preview GUI (optional beta feature).
  
  
• New command:
  
  /crate preview <id> [player]
  
  
• Optional left-click block preview behavior.
  

Changed

• /crate usage/help updated to include preview command.
  
  
• Prefix hover behavior polished:
  
  • Hover now cleanly displays credits/title/link info.
    
    
  • Removed unwanted server-IP suffix from normal chat messages (hover-only metadata retained).
    

Fixed

• Fixed actionbar fallback behavior that could spam chat while opening crates.
  
  
• Improved chat-input stability across Paper forks and ArcLight-style implementations.
  

Notes

• This update improves cross-fork compatibility, editor reliability, and overall UX consistency across crates and kits.
  
  
• MiniMessage formatting can now be safely toggled without breaking legacy color setups.
  
  
• Crate preview is currently marked as beta and may receive further refinement.
  

Main functionality: added the ability for users to create a first join kit which includes everything that the kits can run which is commands, particles, effects, as well as giving items in specific slots, and this is for players who have joined the server for the first time.

Added support for ArcLight.

Added support for paper variants.

Current Build — “Polish + Systems Expansion”

To sum it up - The Release is SICK - Test it out!

• Block Crates added (world placed): physical crate blocks that can be placed in the world (not just GUI crates).
• Counters on Block Crates: optional uses/availability counter display on/above the crate so players immediately understand the state.
• Keys added: optional key requirement for crate openings (clean UX, key templates, configurable behavior).
• Reveal Styles + Reveal Effects: expanded reveal system so the “reward moment” is customizable (style + theme/effects).
• Pages of animations/effects: large library of opening/reveal animations + effect options to pick from (not one hardcoded flow).
• Crate open FX expanded: improved sound/particle control during opening + on win (plus ambient FX for world crates where enabled).
• Layered containers supported: nested/contained reward pools so crates can be layered (not flat loot tables only).
• Editor polish pass: clearer indicators, cleaner flow, faster iteration (edit → test → adjust).
• Protected opening sessions reinforced: openings remain “safe” from accidental interruption mid-animation.

Quality / Defaults Update

• Better defaults: sensible default reveal style/theme + opening feel out of the box (so it looks good even before customizing).
• Picker libraries added: curated sound/particle selections so staff aren’t guessing enum names.
• Theme Packs added (kits menu): built-in /kits menu theme packs for fast UI consistency (apply without rebuilding menus from scratch).
• Config + messages cleanup: clearer settings + more consistent wording (where applicable).

Initial Release — “Kits + Crates Baseline”

• GUI-first kit editor: create/edit kits in-game (icons, names, contents, permissions).
• Crate reward pools: per-entry % chance rewards + clear reward structure.
• Animated crate openings: premium-feel opening flow with protected sessions.
• Reward Actions: optional actions per reward entry (commands / sounds / particles).
• Editor UX: indicators and layout designed for fast iteration.
• 1.21.x focus: built for modern Paper/Spigot servers.

Crate Reveal System Overhaul

• RevealStyle enum expanded from 6 → 33 styles
  
  
• Backward-friendly parsing with legacy aliases (old configs still work)
  

CrateRewardShowcase Choreography Upgrade

• Per-display metadata tracking
  (spawn tick, initial offsets, random seeds)
  
  
• Style-specific motion logic
  (ring, line, ground, stack, spiral, explosion, etc.)
  
  
• Style-specific scale & rotation behavior
  (pop-in scaling, pulse effects, extra tilt/roll)
  

Ground Reveal Improvements

• Ground-based styles now:
  
  • Detect solid blocks beneath spawn
    
    
  • Play block crack / dust particles
    
    
  • No blocks are damaged or broken
    

New GUI: RevealStylePicker

• Paged style selection
  
  
• Clear “Selected” indicator
  
  
• Click-to-apply, then auto-returns to the previous editor GUI
  

CrateEditor GUI UX Improvements

• PickCount simplified
  
  • Left-click: -1
    
    
  • Right-click: +1
    
    
  • Shift-click: ±5
    
• Dedicated Reveal Style button
  
  • No longer hidden behind shift-click tier logic
    

New Reveal Styles Added (Highlights)

• Orbit & Motion: ORBIT, DOUBLE_ORBIT, SATELLITES, PENDULUM
  
  
• Shapes: FIGURE_EIGHT, HEART
  
  
• Front Showcase: FRONT_LINE, FRONT_POP, FRONT_FLY_IN
  
  
• Ground Impact: GROUND_BREAK, EARTH_SHATTER
  
  
• Vertical Drama: STACK_DROP, UPDRAFT, RAIN_DOWN
  
  
• Big Effects: VORTEX_IN, SPIRAL_OUT, EXPLOSION_OUT_IN
  
  
• Lock-In Displays: CROWN_RING, HALO, CROSS_LOCK
  
  
• Visual Emphasis: SCALE_PULSE
  
  
• Chaos: BURST