QEventBox | Quantum Time-Based Event System with Integrated Shop & Rewards*⏰ -----
Find the Box. Claim the Loot.
A dynamic solution for server events, custom currency, and player engagement.
------------------------------------------------
QEventBox is a robust Spigot/Paper Minecraft plugin designed to enhance server events by introducing time-based, random event crates, a dedicated point currency, and a fully customizable in-game shop GUI. Perfect for survival, mini-game, or specialized event servers looking for a dynamic player engagement system.
The Next Level Event Flow: Find the Box. Claim the Loot.
------------------------------------------------
------------------------------------------------
Key Features
We focus on automation and engagement to deliver a seamless event experience with minimal administrative overhead.
✅ Full Event Automation: Event crates automatically spawn and vanish based on configurable schedules and amounts, eliminating manual effort.
✨ Chance Rewards System: Define custom drop percentages for every reward line (e.g., 50% chance).
Multi-World Support: Crate spawning is supported across multiple configured worlds.
⭐ Standalone Point System: Introduces an isolated currency (Event Points / custom named, e.g., QCoin) that is completely separate from existing server economies (Vault/Essentials).
️ In-Game Shop GUI: Players can exchange their earned Event Points for configurable rewards via a beautiful and easy-to-use GUI.
️ Advanced Region Control: Use the dedicated /qwand tool to visually set Min/Max X/Z/Y boundaries for spawning zones across multiple worlds.
Dynamic Notifications: Automatic broadcast messages when crates appear, reach half-life, or expire, keeping players informed in real-time.
⚙️ Flexible Rewards: Rewards are highly configurable and can include Event Points, physical Items, or execution of server Commands.
------------------------------------------------
Installation
Get QEventBox up and running in a few simple steps.
• Ensure your server is running Spigot / Paper 1.21.8+ (or compatible versions).
• Download the QEventBox.jar file.
• Place the JAR file into your server's plugins/ folder.
• Start the server to generate the configuration files (config.yml and the gui/ folder).
• Configure the crates, spawn times, rewards, and the shop GUI to your liking.
• Use /qeventbox reload or restart your server to apply changes.
------------------------------------------------
⚙️ Configuration Example (v1.1)
The plugin offers extensive configuration options to fit your server's unique needs.
Code (Text):
region:
world:
- world # World1
- world_nether # List of world names where crates will spawn.
min-x: -500 # Minimum X boundary for random crate spawning.
max-x: 500 # Maximum X boundary for random crate spawning.
min-z: -500 # Minimum Z boundary for random crate spawning.
max-z: 500 # Maximum Z boundary for random crate spawning.
min-y: 60 # Minimum Y level for crates to spawn (to avoid caves/void).
max-y: 256 # Maximum Y level for crates to spawn (to avoid high spawns).
crate:
lifetime-seconds: 120 # Duration (in seconds) before an unclaimed crate disappears.
# Base64 texture string for the custom player head crate.
texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNmYwMDk5MWFlNzljYWMzNGUzNTgzNTdjMTNkYjY5Y2E2ZmVkODJiOGE1OWE5MjE4OWYzZmU0ZmRiMmU0ZTU4OSJ9fX0="
spawn-times:
- "20:00" # List of 24-hour clock times when auto-spawn is triggered.
- "23:15"
amount: 5 # Number of crates to spawn simultaneously during auto-spawn.
rewards:
# CHANCE | REWARD:DATA (New v1.1 Format)
- "100%|eventpoints:20"
- "50%|item:DIAMOND:1"
- "10%|item:GOLD_INGOT:5"
- "5%|command:give %player% super_sword 1"
wand-item: # Item to set Region use /qwand give
material: GOLDEN_AXE
name: "&e&lQEventBox Region Wand"
lore:
- "&7Left Click: Set Pos 1"
- "&7Right Click: Set Pos 2"
- ""
- "&eUse &c/qwand &esave to save region."
messages:
start: "§aBox has appeared in {x} {y} {z}!" # Broadcast message when a crate is manually spawned.
half: "§6Box will disappear in {time} seconds!" # Broadcast warning when a crate reaches half its lifetime.
expired: "§cBox vanished due to unclaimed!" # Broadcast when a crate disappears naturally.
claimed: "§b{player} §7has claimed the box!" # Broadcast when a crate is successfully claimed.
auto: "§e[QEventBox] §aEvent Box has spawned in %world%" # Broadcast message when the auto-spawn is triggered.
points: "QCoin" # The custom name used for the plugin's currency (replaces "Points" placeholders).
Commands & Permissions
| Command | Description | Permission |
|
Code (Text):
/qeventbox
|
Main admin command to control crate drops & reload. |
Code (Text):
qeventbox.admin
|
|
Code (Text):
/eventshop
|
Open event shop GUI. |
Code (Text):
qeventbox.shop
|
|
Code (Text):
/qpoints
|
Manage player event points (Admin command). |
Code (Text):
qeventbox.admin
|
|
Code (Text):
/qwand
|
Manage the region selection wand. |
Code (Text):
qeventbox.admin
|
------------------------------------------------
Support & Contribution
Found a bug or have a suggestion? We welcome contributions!
Report Bugs: Please open an issue on the GitHub Issues page.
Suggest Features: Feel free to open a new discussion thread.
---
License: This project is licensed under the GPL-3.0 License.
Resource Information
Author:
----------
Total Downloads:
10
First Release:
Nov 30, 2025
Last Update:
Dec 7, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings