sMagicBox v1.2.2

sMagicBox​

---

Overview​

sMagicBox is a powerful and easy-to-use lootbox plugin designed for modern Paper servers.
Create custom lootboxes, configure rewards, add opening effects, use sound profiles, set cooldowns, enable broadcasts, and manage everything through an in-game visual editor.

Whether you run a survival, PvP, skyblock, factions, boxpvp or network server, sMagicBox gives you a clean and professional way to create premium-style lootbox experiences.

---

Main Features​

• Fully configurable lootboxes.
• In-game visual editor.
• Custom rewards system.
• Opening animations and visual effects.
• Custom sound profiles.
• Cooldown system.
• Permission-based access.
• Reward preview system.
• Physical lootbox items.
• Broadcast messages.
• Multi-language support.
• YAML-based storage.
• PlaceholderAPI support.
• License activation system.
• Modern and clean plugin structure.

---

Main Commands​

Most commands require administrator/OP permissions.

• /smagicbox help — Shows the main help menu.
• /smagicbox create — Creates a new lootbox.
• /smagicbox delete — Deletes an existing lootbox.
• /smagicbox rename — Renames a lootbox.
• /smagicbox give — Gives a physical lootbox item to a player.
• /smagicbox open — Forces a lootbox opening.
• /smagicbox list — Opens the lootbox list menu.
• /smagicbox edit — Opens the in-game lootbox editor.
• /smagicbox rewards — Opens the reward editor for a lootbox.
• /smagicbox lang — Changes the global plugin language.
• /smagicbox effects — Shows the loaded visual effects.
• /smagicbox debug — Shows quick plugin diagnostics.
• /smagicbox reload — Reloads the plugin configuration files.

---

License Commands​

• /smagicboxlicense — Manage and activate the sMagicBox premium license.
• /smlicense — Shortcut alias for the license command.
• /smblicense — Shortcut alias for the license command.
• /magicboxlicense — Shortcut alias for the license command.

---

License Activation​

• sMagicBox requires a valid license key to activate the plugin.
• The license key is provided after purchase.
• You can obtain your license key through our official Discord/support system.
• Use /smagicboxlicense in-game to activate and manage your license.
• An internet connection is required during activation to validate the license.
• If you need help with your license, open a support ticket in our Discord.

License Support: https://discord.gg/MP3JJzhXCJ

Click to expand...

---

Obfuscation Notice​

• This plugin is obfuscated because it includes a premium license activation system.
• The obfuscation is used to protect the licensing system and premium source code.
• Because of this, the plugin should not be marked as unobfuscated.

---

Setup​

When creating a lootbox, the plugin uses YAML storage and automatically generates configurable lootbox files.
You can customize the main settings of each lootbox, including:

• material — The item used as the lootbox. Default: ENDER_CHEST.
• cooldown-seconds — Time players must wait before opening again. Default: 86400.
• consume-on-open — Removes the lootbox item after opening.
• permission-required — Requires permission before a player can open the lootbox.
• preview-rewards — Allows players to preview possible rewards.
• opening-effect — Selects the visual animation used when opening.
• rewards-per-opening — Defines how many rewards the player receives per opening.
• broadcast — Sends a server message when a player opens a lootbox.

---

Visual Editor​

Do not waste time editing every file manually.
Use /smagicbox edit to open the in-game editor and configure your lootboxes in a clean visual menu.

• Core Settings — Status, item, cooldown and consume options.
• Visual Settings — Effects, sounds, titles and visual preview.
• Access Settings — Permissions, broadcasts and reward previews.
• Reward Settings — Rewards per opening and lootbox rewards.
• Menu Layout — Customize the editor menu layout using slots.

---

Rewards System​

sMagicBox allows you to create flexible rewards for each lootbox.

• Command rewards.
• Item rewards.
• Multiple rewards per opening.
• Reward preview support.
• Configurable chances.
• Custom display names and descriptions.
• Broadcasts for special rewards.

Create simple crates, premium boxes, seasonal lootboxes, rank boxes, event boxes, PvP boxes and more.

Click to expand...

---

Effects & Sounds​

sMagicBox includes professional opening effects and sound profiles to make every lootbox feel unique and special.

• Nebula Vortex — A magical purple-style opening effect.
• Abduction Levitation — UFO-style levitation effect with particles.
• Zeus Strike — Lightning-themed opening animation.
• Cupid Blessing — Heart and cherry particle effect.
• Sonic Boom — Shockwave-style effect.
• Golden God — Totem and golden blessing animation.

---

Custom Audio Profiles​

The plugin also includes sound profiles that can be used during lootbox openings.

• Ascenso Heroico — Classic Minecraft level-up sound.
• Campanas Galácticas — Amethyst crystal chime sound.
• Rugido del End — Deep Ender Dragon roar.
• Desbloqueo Mágico — Magical note block chime.
• Eco del Vacío — Shulker-style dimensional opening sound.
• Bendición Ancestral — Totem blessing sound.
• Final Pirotécnico — Firework blast ending sound.
• Silencio — Disable opening sounds.

---

How to Start​

1. Download the plugin.
2. Place the plugin file inside your /plugins folder.
3. Make sure PlaceholderAPI is installed if you want placeholder support.
4. Start your server.
5. Activate your license using /smagicboxlicense.
6. Create your first lootbox using /smagicbox create MyBox.
7. Open the editor using /smagicbox edit MyBox.
8. Add rewards, select effects, configure sounds and start using your lootbox.

---

Example Workflow​

1. Create a lootbox with /smagicbox create DailyBox.
2. Open the editor with /smagicbox edit DailyBox.
3. Set the material to ENDER_CHEST.
4. Choose an opening effect.
5. Select a sound profile.
6. Add rewards using /smagicbox rewards DailyBox.
7. Give the lootbox to a player using /smagicbox give.

---

Important Notes​

• Requirements: sMagicBox runs on modern Paper servers.
• Softdepend: PlaceholderAPI is supported and recommended.
• Storage: The plugin uses YAML storage.
• Default Language: Spanish is enabled by default, with English support available.
• Permissions: Use smagicbox.admin to give full admin access.
• License: A license key is required. The key is provided after purchase through our official Discord/support system.
• Internet: Required during license activation.
• Obfuscation: The plugin is obfuscated to protect the license system.
• Version: sMagicBox v1.2.2.

---

Support​

Need help, license support, setup assistance or configuration help?
Join our official Discord server and open a ticket.