Skip to content

musbabaff/SwiftDelivery

Repository files navigation

⚡ SwiftDelivery

Premium Delivery Event Automation Plugin for Minecraft Servers

Release License Minecraft Version Java 17+

FeaturesInstallationCommandsConfigurationWikiChangelog


Built by NettyForge — crafting premium server tools.

🚀 Features

Feature Description
📦 Scheduled Deliveries Fully automated delivery events with cron-like scheduling
🏆 Leaderboard System Real-time rankings with customizable rewards for top deliverers
🎨 Custom GUI Menus Beautiful, compact inventory menus with custom head textures
✨ Custom Items Support Deep native hooks for Nexo, Oraxen, and ItemsAdder engines
✉️ Player-to-Player Mail Send items securely across the server or network (/mail send)
📈 Courier Progression RPG-like leveling system with XP gained per delivery and mail
🛡️ Bulletproof Anti-Dupe Robust UUID transaction logging available securely for admins
🌈 MiniMessage & Hex Full support for modern <gradient> and legacy hex formatting
🌍 Multi-Language 8 built-in locales: English, Turkish, German, Spanish, French, Portuguese, Russian, Chinese
🔔 Discord Webhooks Automated Discord notifications with rich embeds for event start/end
⚡ Chest & NPC Hooks Bulk deliver via chests or instantly hook Citizens/FancyNpcs
🎁 Flexible Rewards Commands, items, Vault, and Courier XP rewards

📋 Requirements

  • Java: 17 or higher
  • Server: Spigot, Paper, Purpur, or any fork (1.16.5 – 1.21.4)
  • Optional: Vault (for economy rewards), PlaceholderAPI

📥 Installation

  1. Download the latest SwiftDelivery-x.x.x.jar from Releases
  2. Place the JAR in your server's plugins/ folder
  3. Start your server — default configs will be generated
  4. Configure plugins/SwiftDelivery/config.yml to your liking
  5. Set up deliveries in plugins/SwiftDelivery/deliveries.yml
  6. Reload with /swiftdelivery reload or restart

💻 Commands

Player Commands

Command Permission Description
/delivery swiftdelivery.use Opens the delivery menu
/deliver swiftdelivery.deliver Quick-deliver items from inventory
/deliver chest swiftdelivery.deliver.chest Deliver items from a chest
/delivery profile swiftdelivery.use View your Courier Level, XP, and Mail Inbox
/mail send <player> swiftdelivery.mail Send the held item to another player for a configurable fee

Admin Commands

Command Permission Description
/swiftdelivery reload swiftdelivery.admin.reload Reload all configuration files
/swiftdelivery start <name> swiftdelivery.admin.start Force-start a delivery event
/swiftdelivery stop <name> swiftdelivery.admin.stop Stop an active delivery event
/swiftdelivery list swiftdelivery.admin.list List all deliveries and their status
/swiftdelivery status swiftdelivery.admin.status View plugin status and diagnostics
/swiftdelivery adminlog <player> swiftdelivery.admin View the last 15 delivery transaction logs for an audit

⚙️ Configuration

All configuration files are generated in plugins/SwiftDelivery/:

File Purpose
config.yml General settings, display names, webhooks, events
deliveries.yml Delivery definitions, schedules, rewards
categories.yml Item categories with weights
items.yml Custom item display names per locale
locales/*.yml Language files (8 built-in locales)

📖 Full documentation is available in the Wiki.

🔔 Discord Webhook

SwiftDelivery can send beautiful embed notifications to your Discord server:

  1. Create a webhook in your Discord channel settings
  2. Paste the URL into config.yml under webhook.url
  3. Set webhook.enabled: true
  4. Customize the embed templates in config.yml

🏗️ Building from Source

git clone https://github.com/musbabaff/SwiftDelivery.git
cd SwiftDelivery
mvn clean package

The compiled JAR will be at target/SwiftDelivery-1.0.0.jar.

See BUILDING.md for detailed build instructions.

📄 License

This project is All Rights Reserved. See LICENSE for details.

🤝 Support


⚡ SwiftDelivery — Premium Delivery Events for Minecraft
Made with ❤️ by NettyForge

About

Premium server logistics \u0026 delivery network plugin for Spigot/Paper.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages