Cases Mrght12

English version

Tiered Loot Crate Plugin for Minecraft Servers: Instant Case Distribution & Guaranteed Ingots Drop

A lightweight, no‑fuss crate plugin for Spigot/Bukkit servers that lets you instantly give out cases and reward players with matching ingots. No complex configuration is required to start using the core mechanic: the plugin is ready to go right after installation.

Core Features:

• Four intuitive case tiers: Copper, Iron, Diamond, and Netherite crates. The case type directly determines the ingot type dropped when opened — no mismatches, no confusion.
• Instant case distribution via command: Use /case give <player> <case_type> <amount> to deliver any number of cases to any player. Perfect for admins, donator rewards, events, and emergency kit setups.
• Predictable loot logic: Each case drops 1–32 ingots of the matching type (e.g., a Copper case yields 1–32 Copper ingots). The exact amount is randomized per opening to keep it exciting.
• Zero mandatory config for basic use: The plugin works out of the box with default drop ranges. Configuration is optional and only needed if you want to tweak the min/max values.
• Optional advanced tuning: If you do want to customize the economy, you can adjust the drop ranges for each case tier in config.yml. This gives you full control over server balance while keeping the system simple.
• Compatible with economy and donator systems: Works seamlessly with Vault‑based economy plugins. Since rewards are raw ingots, they can be used as currency, crafting materials, or trade goods depending on your server’s economy design.
• Admin tooling: Includes commands for testing drops, reloading the config, and viewing crate statistics. Great for debugging and monitoring case usage.
• Performance optimized: Minimal overhead and no heavy background tasks. Suitable for servers of all sizes, including those with limited resources.
• Event‑ready: Ideal for starter kits, weekly giveaways, PvP tournaments, anarchy servers, and any setup where fast, clear rewards matter.

How It Works:

1. Install the plugin and restart or reload the server.
2. Use /case give <player> <case_type> <amount> to give cases instantly (e.g. /case give Steve copper 5 gives 5 Copper cases to Steve).
3. Players open the cases (via chest interaction or in‑hand item, depending on setup) to receive 1–32 matching ingots.
4. The exact number is randomly determined within the default or configured range.
5. Optional logging tracks each opening for transparency and anti‑cheat purposes.

Supported Case Types:

• copper – drops Copper ingots
• iron – drops Iron ingots
• diamond – drops Diamond ingots
• netherite – drops Netherite ingots

Ideal For:

• Economy servers where ingots serve as currency or trade items.
• Anarchy, PvP, and survival servers that reward raw resources.
• Event organizers who need quick, reliable giveaways.
• Servers with custom ranks and donator perks where instant case delivery is essential.

Русская версия

Плагин с кейсами для серверов Minecraft: мгновенная выдача и гарантированное выпадение слитков

Лёгкий и простой плагин для серверов Spigot/Bukkit, который позволяет моментально выдавать кейсы и награждать игроков слитками соответствующего типа. Для использования основной механики не требуется сложная настройка — плагин готов к работе сразу после установки.

Основные возможности:

• Четыре понятных уровня кейсов: медные, железные, алмазные и незеритовые кейсы. Тип кейса напрямую определяет тип слитков, которые выпадут при открытии — никаких несоответствий и путаницы.
• Мгновенная выдача кейсов через команду: используйте команду /case give <игрок> <тип_кейса> <количество>, чтобы выдать любое количество кейсов любому игроку. Идеально для администрации, донатных наград, ивентов и срочных стартовых наборов.
• Предсказуемая логика лута: из каждого кейса выпадает от 1 до 32 слитков соответствующего типа (например, из медного кейса — от 1 до 32 медных слитков). Точное количество определяется случайным образом при каждом открытии, что сохраняет элемент азарта.
• Отсутствие обязательной настройки для базового использования: плагин работает «из коробки» с предустановленными диапазонами выпадения. Конфигурация нужна только если вы хотите изменить минимальные и максимальные значения.
• Опциональная тонкая настройка: если вы хотите подстроить экономику сервера, можно изменить диапазоны выпадения для каждого типа кейса в файле config.yml. Это даёт полный контроль над балансом, сохраняя простоту системы.
• Совместимость с экономикой и донатом: плагин отлично работает вместе с экономическими плагинами на базе Vault. Поскольку награды — это чистые слитки, они могут использоваться как валюта, материалы для крафта или товары для торговли в зависимости от экономики вашего сервера.
• Инструменты для администрации: в плагин включены команды для тестирования выпадения, перезагрузки конфигурации и просмотра статистики по кейсам. Это удобно для отладки и контроля использования кейсов.
• Оптимизация производительности: минимальная нагрузка и отсутствие тяжёлых фоновых задач. Подходит для серверов любого размера, включая те, где ресурсы ограничены.
• Готовность к ивентам: идеален для стартовых наборов, еженедельных розыгрышей, PvP‑турниров, анархичных серверов и любых сценариев, где важны быстрые и понятные награды.

Как это работает:

1. Установите плагин и перезапустите или перезагрузите сервер.
2. Используйте команду /case give <игрок> <тип_кейса> <количество> для мгновенной выдачи кейсов (например, /case give Steve copper 5 выдаст 5 медных кейсов игроку Steve).
3. Игроки открывают кейсы (через взаимодействие с сундуком или предметом в руке — в зависимости от реализации) и получают от 1 до 32 соответствующих слитков.
4. Точное количество слитков определяется случайным образом в пределах стандартного или настроенного диапазона.
5. При необходимости ведётся лог каждого открытия для прозрачности и целей античита.

Поддерживаемые типы кейсов:

• copper — выпадают медные слитки
• iron — выпадают железные слитки
• diamond — выпадают алмазные слитки
• netherite — выпадают незеритовые слитки

Идеально подходит для:

• Экономических серверов, где слитки используются как валюта или товар для торговли.
• Анархичных, PvP и выживательных серверов, где ценятся чистые ресурсы.
• Организаторов ивентов, которым нужна быстрая и надёжная система розыгрышей.
• Серверов с кастомными рангами и донатом, где критически важна мгновенная выдача наград.