Skip to content

Automatically organizes inventory and containers with a simple command.

License

Notifications You must be signed in to change notification settings

TheNolle/quicksort-plugin

Repository files navigation

QuickSort Logo

✨ The ultimate inventory-sorting plugin for your Minecraft server! ✨

Minecraft Version PaperMC API License Contributions Welcome

Modrinth Hangar Spigot Curseforge


🚀 Overview

QuickSort is a lightweight and efficient Minecraft plugin designed to simplify inventory management for players. Whether you're a builder, an adventurer, or just tired of the clutter, QuickSort automates the process of organizing your inventory and container contents with a single command.

Caution

QuickSort is optimized for vanilla inventories. Using it with plugins that create custom inventories may result in unintended behavior.


📦 Features

  • ✨ Instant Sorting: Automatically group and organize items in player inventories and containers.
  • ✨ Armor & Off-hand Safety: Your equipped armor and off-hand items remain untouched.
  • ✨ Multi-container Support: Works seamlessly with vanilla containers like chests, barrels, shulker boxes, and more.
  • ✨ Customizable Commands: Use /quicksort or its aliases to organize your inventory in seconds.
  • ✨ Lightweight & Efficient: Built with Kotlin and PaperMC API for blazing-fast performance.
  • ✨ Future-ready: Fully compatible with Minecraft 1.21+.

📚 Commands

Command Aliases Description Permission
/quicksort /qs Sorts your player inventory. N/A
/quicksort container /qs container Sorts the currently open container. N/A

📥 Installation

  1. Download the latest .jar file from the Releases section.
  2. Place the .jar file in your server's /plugins folder.
  3. Restart your server to load the plugin.
  4. That's it! You're ready to start sorting your inventory with QuickSort.

🎬 Quick Preview

Here's a quick demonstration of QuickSort in action:

QuickSort Demo


⚙️ Requirements

  • Minecraft 1.21+
  • PaperMC server
  • No additional dependencies required.

📜 Disclaimer

QuickSort is a free and open-source project developed by Nolly for the Minecraft community. This project is licensed under the MIT License and is provided as-is without any warranties or guarantees. Use at your own risk. Please note that QuickSort is not affiliated with or endorsed by Mojang Studios or Microsoft Corporation.

  • QuickSort is not recommended for use with custom inventories from other plugins.
  • Only tested with vanilla container inventories.
  • Use at your own discretion.

🤝 Contributing

We welcome contributions from the community! Here’s how you can help:

  1. Fork the repository.
  2. Create a new branch (git checkout -b your-feature-name).
  3. Commit your changes (git commit -am 'Add new feature').
  4. Push to the branch (git push origin your-feature-name).
  5. Create a new Pull Request.
  6. Sit back and relax while we review your changes. For major changes, please open an issue first to discuss what you would like to change.

🔧 Development Workflow

  1. Clone the repository to your local machine.
  2. Open the project in your favorite IDE (IntelliJ IDEA recommended).
  3. Set up dependencies using Gradle.
  4. Make your changes and test them locally.
  5. Build the project using ./gradlew clean build.
  6. Locate the generated .jar file in the /build/libs folder.
  7. Test the plugin on your server.

🪪 License

QuickSort is licensed under the MIT License. You are free to use, modify, and distribute this project for personal or commercial purposes. We only ask that you provide proper attribution to the original author and include a link to the original repository.


💜 Acknowledgments

This plugin wouldn’t be possible without:

  • PaperMC for enabling developers to create high-performance Minecraft plugins.
  • Kotlin for providing a modern and expressive programming language.

📬 Contact

📧 Email: contact@thenolle.com 💬 Discord: Join our Discord Server


🌌 Happy Sorting! 🌌