zCrates | NullForums

Description Releases Discussion

zCrates brings a new level of customization to your Minecraft server's crate system. Built with cutting-edge technology and powered by JavaScript, create unique opening experiences that keep your players engaged and coming back for more.

Key Features
What Makes zCrates Special

JavaScript-Powered - Create custom animations and reward algorithms without touching Java code
Beautiful Animations - 4 built-in animations (instant, roulette, cascade, simple) with full customization
Smart Algorithms - Pity system, progressive luck, and weighted random distribution
Flexible Rewards - Items, commands, or both - with weight-based probability
Advanced Conditions - Permission, cooldown, and PlaceholderAPI support
️ Database Support - SQLite, MySQL, or MariaDB for persistent data
Beautiful GUI - Powered by zMenu for stunning inventory interfaces
Hot Reload - Update configurations without restarting your server

Reward Types
Create exciting rewards for your players:

ITEM - Give single items with custom enchantments and names
ITEMS - Award multiple items at once (perfect for armor sets!)
COMMAND - Execute any console command
COMMANDS - Run multiple commands together

All rewards support weight-based probability - a reward with weight 10 in a pool of 100 total weight = 10% chance!

Opening Conditions
Control who can open your crates:

PERMISSION - Require specific permissions
COOLDOWN - Set time restrictions (hourly, daily, etc.)
PLACEHOLDER - Advanced PlaceholderAPI comparisons (level, balance, world, etc.)

Mix multiple conditions together - all must pass for the crate to open!

Animation System
4 Built-in Animations:

instant - Quick reward reveal (500ms)
roulette - Classic spinning wheel (11100ms)
cascade - Progressive fill effect (3900ms)
simple - Basic display (600ms)

Want more? Create your own with JavaScript - full control over timing, effects, and display!

Key Management
Choose your key type:

VIRTUAL - Stored in database (no inventory clutter)
PHYSIC - Real items players can trade

️Display Options
6 Ways to Display Your Crates:

BLOCK - Classic block display
ENTITY - Animated mob display
MYTHIC_MOB - MythicMobs integration
ITEMS_ADDER - ItemsAdder custom items
ORAXEN - Oraxen custom items
NEXO - Nexo custom items

Showcase
Note: GIFs are sped up for demonstration purposes - actual animations run smoother in-game!

Virtual Crate Opening
Experience seamless crate openings with virtual keys - no inventory clutter, just pure excitement! Watch as the roulette animation reveals your reward.

Physical Crate Opening
Prefer tangible keys? Physical keys give players tradeable items they can hold, share, or collect before opening their crates.

Reroll System
Don't like your reward? The reroll feature lets players try their luck again for a chance at something better!

Block Display Placement
Place crates as interactive blocks anywhere in your world - perfect for spawn areas, shops, or event locations.

Entity Display Placement
Make your crates stand out with animated entity displays - floating, rotating, and eye-catching!

MythicMobs Display Placement
Integrate with MythicMobs for custom creature displays - turn your crates into unique, custom mob presentations!

Requirements

Server: Spigot or Paper 1.21+
Java: Version 21 or higher
Required: zMenu

Optional Integrations:

PlaceholderAPI - For PLACEHOLDER conditions
MythicMobs - For MYTHIC_MOB display
ItemsAdder - For custom item displays
Oraxen - For custom item displays
Nexo - For custom item displays

Quick Start

Download zCrates and install zMenu (required)
Place both JARs in your plugins/ folder
Restart your server
Edit configurations in plugins/zCrates/
Create your first crate and start rewarding players!

Configuration Example

YAML:

id: my_crate
animation: roulette
algorithm: weighted
display-name: "<gradient:gold:yellow>Epic Crate</gradient>"

key:
  type: VIRTUAL
  name: epic_key

conditions:
  - type: PERMISSION
    permission: "crates.epic"
  - type: COOLDOWN
    cooldown: 3600000  # 1 hour
  - type: PLACEHOLDER
    placeholder: "%player_level%"
    comparison: GREATER_THAN_OR_EQUALS
    result: "10"

rewards:
  - type: ITEM
    id: diamond_sword
    weight: 20.0
    display-item:
      material: DIAMOND_SWORD
      name: "<blue>Legendary Sword"
    item:
      material: DIAMOND_SWORD
      enchantments:
       - SHARPNESS:5
        - UNBREAKING:3

  - type: COMMAND
    id: vip_rank
    weight: 5.0
    display-item:
      material: GOLD_INGOT
      name: "<gold>VIP Rank"
    command: "lp user %player% parent set vip"

  - type: ITEMS
    id: armor_set
    weight: 10.0
    display-item:
      material: DIAMOND_CHESTPLATE
      name: "<aqua>Full Armor Set"
    items:
      - material: DIAMOND_HELMET
      - material: DIAMOND_CHESTPLATE
      - material: DIAMOND_LEGGINGS
      - material: DIAMOND_BOOTS

Commands

/zcrates Show plugin info
/zcrates reload Reload configurations
/zcrates place <crate> <type> <value> Place crate at location
/zcrates remove Remove crate at target
/zcrates purge Remove all crates in chunk
/zcrates givekeys <player> <crate> <amount> Give keys to player
/zcrates open <player> <crate> [force] Force crate opening

Customization
Create Custom Animations
Write your own animations in JavaScript:

JavaScript:

animations.register("my-animation", {
    phases: [
        {
            name: "spinning",
            duration: 3000,
            interval: 50,
            speedCurve: "EASE_OUT",
            onTick: (context, tickData) => {
                // Your animation logic
            }
        }
    ]
});

Create Custom Algorithms
Implement your own reward logic:

JavaScript:

algorithms.register("my-algorithm", (context) => {
    // Your reward selection logic
    return context.rewards().weightedRandom();
});

Why Choose zCrates?

Easy to Use - YAML configuration with clear examples

Highly Customizable - JavaScript support for unlimited possibilities

Performance - Built with Java 21 and optimized for large servers

Modern - MiniMessage support for beautiful text formatting

Reliable - Database persistence ensures data safety

Supported - Active development and updates

What's Included

4 reward types (ITEM, ITEMS, COMMAND, COMMANDS)

3 condition types (PERMISSION, COOLDOWN, PLACEHOLDER)

JavaScript animation system with 4 built-in animations

3 smart reward algorithms

Virtual and physical key support

6 display type integrations

Full database persistence

Beautiful GUI with zMenu

Hot reload system

MiniMessage formatting

PlaceholderAPI integration

Support & Links

Website: https://zcrates.groupez.dev/
Author: Traqueur_
Report Issues: GitHub Issues

Ready to elevate your server's crate experience?
Download now and start creating unforgettable moments for your players!

MC Plugin zCrates 1.1.3
A modern, JavaScript-powered Minecraft crate plugin with stunning animations and smart reward system

More files from shanruto

Share this resource

MC Plugin zCrates 1.1.3 A modern, JavaScript-powered Minecraft crate plugin with stunning animations and smart reward system

More files from shanruto

Share this resource

MC Plugin zCrates 1.1.3
A modern, JavaScript-powered Minecraft crate plugin with stunning animations and smart reward system