RUINED ECONOMY — COMPLETE MINECRAFT SHOP PLUGIN
You are an expert Minecraft Java plugin developer specializing in Paper, Bukkit, Vault, GUI systems, economy integrations, and high-performance server development.
PROJECT
Create a completely functional Minecraft shop and economy shop plugin named RuinedEconomy.
Target platform: Paper 1.21.10 Plugin name: RuinedEconomy Main currency: Indian Rupee (₹) Economy integration: Vault API Language: Java Build: Maven or Gradle, with a compiled ".jar" file and complete source code.
This must be a real working plugin, NOT a demo, concept, mockup, or incomplete implementation.
- ECONOMY SYSTEM — ₹ EVERYWHERE
Replace every visible "$", USD, dollar sign, and other default currency formatting with the Indian Rupee symbol "₹".
Examples:
- ₹52.50
- ₹1,000
- ₹25,000
- ₹1,00,000
- ₹10,00,000
Use Indian number formatting by default (lakhs and crores).
Make the following configurable:
- Currency symbol.
- Decimal places.
- Number formatting.
- Currency placement.
- Buy and sell price formats.
The ₹ symbol must appear everywhere:
- Shop GUI.
- Item lore.
- Buy and sell messages.
- Transaction confirmations.
- Balance displays.
- Admin messages.
- Error messages.
Never hardcode currency formatting into individual classes.
- VAULT ECONOMY INTEGRATION
Implement genuine Vault API integration.
Requirements:
- Work with compatible Vault economy providers.
- Support EssentialsX Economy and other compatible providers.
- Real player balance checking.
- Real deposits and withdrawals.
- Correct buy and sell transactions.
- Handle insufficient balance.
- Prevent duplicate purchases and transaction exploits.
- Never use fake balances or internal simulated money.
- Never replace the server's existing economy system.
Vault must be the actual economy connection.
If Vault or a compatible economy provider is missing, display a clear error instead of pretending transactions work.
- ECONOMYSHOPGUI ZIP MIGRATION
Use my uploaded "EconomyShopGUI.zip" as the reference for the shop configuration and content.
IMPORTANT:
- Inspect the complete ZIP.
- Extract every available shop category.
- Import all valid shop items.
- Preserve existing item materials.
- Preserve the original numerical buy and sell prices.
- Replace all currency display with ₹.
- Import category names and item configurations.
- Do not randomly remove items.
- Do not skip files.
- Do not lose existing configuration information.
Recreate the required functionality independently in RuinedEconomy. Do not simply rename the old plugin.
- COMPLETE CUSTOMIZATION SYSTEM
Everything must be editable by the server owner without recompiling the plugin.
Create configuration files such as:
- "config.yml"
- "categories.yml"
- "items.yml"
- "messages.yml"
- "gui.yml"
- "settings.yml"
Make ALL of these configurable:
Shop categories
- Rename any category.
- Change category icons.
- Change category materials.
- Change category descriptions.
- Change category positions.
- Create new categories.
- Remove categories.
- Rearrange categories.
Shop items
- Replace any item.
- Add new items.
- Remove items.
- Change material.
- Change display name.
- Change lore.
- Change item amount.
- Change custom model data where supported.
- Change buy price.
- Change sell price.
- Disable buying or selling individually.
- Change GUI slot.
- Configure enchantments and supported item metadata.
GUI
- Rename every inventory title.
- Change GUI size.
- Change button positions.
- Change icons.
- Change navigation buttons.
- Change background items.
- Customize item lore and price display.
- Configure confirmation menus.
- Configure pagination.
No important shop setting should be permanently hardcoded.
- SHOP GUI
Create a polished Minecraft inventory-based shop similar in functionality to EconomyShopGUI.
Include:
- Main shop menu.
- Category menus.
- Item purchase interface.
- Item selling interface.
- Buy and sell buttons.
- Back button.
- Next and previous page buttons.
- Price information.
- Item quantity information.
- Optional transaction confirmation.
- Configurable inventory layouts.
Use clean and professional GUI formatting.
All GUI elements should be configurable.
- BUY AND SELL SYSTEM
Implement proper purchasing and selling mechanics.
Players must be able to:
- Buy one item.
- Buy multiple items.
- Sell one item.
- Sell an entire stack.
- Sell multiple stacks where supported.
- Shift-click to use configured bulk transaction behavior.
- View the exact transaction price.
Requirements:
- Check money before purchasing.
- Check inventory capacity.
- Do not charge if an item cannot be delivered.
- Do not remove items if a sale fails.
- Calculate prices correctly.
- Avoid duplicated items and money.
- Support configurable transaction limits.
- Handle full inventories safely.
- PERFORMANCE — EXTREMELY IMPORTANT
The plugin must be lightweight and optimized.
Requirements:
- Fast shop opening.
- Fast GUI interactions.
- No unnecessary database queries.
- Cache shop configurations and item definitions.
- Avoid reading YAML files on every click.
- Avoid blocking the Minecraft server main thread.
- Perform suitable file and database operations asynchronously.
- Never access Bukkit world, inventory, or player APIs asynchronously when unsafe.
- Optimize event listeners.
- Prevent memory leaks.
- Avoid unnecessary repeating tasks.
- Avoid lag spikes when many players use the shop simultaneously.
Target smooth operation on a busy Paper server.
- ADMIN COMMANDS AND PERMISSIONS
Create these commands:
"/shop" — Open the main shop.
"/ruinedeconomy" — Main plugin information.
"/ruinedeconomy reload" — Reload all configurations safely.
"/ruinedeconomy version" — Display plugin version.
"/ruinedeconomy help" — Display commands.
Permissions:
- "ruinedeconomy.use"
- "ruinedeconomy.admin"
- "ruinedeconomy.reload"
Only authorized admins should be able to manage plugin configurations.
- RELOAD AND CONFIGURATION SAFETY
When an admin changes prices, items, categories, messages, GUI layouts, or currency settings:
- Reload updated configurations.
- Validate materials and prices.
- Detect invalid YAML.
- Display useful error messages.
- Never silently delete invalid configurations.
- Keep a backup before destructive configuration changes.
- Avoid requiring a server restart for normal shop changes wherever technically safe.
- COMPATIBILITY
Strictly target:
- Minecraft 1.21.10.
- Paper 1.21.10.
- Vault.
- Compatible Vault economy providers.
Verify the actual Paper API dependency, Java version, and available API methods before implementation.
Do not use outdated or incompatible Bukkit APIs.
Do not claim compatibility without successfully compiling and testing the plugin.
- DELIVERABLES
I need the actual working project, including:
- "RuinedEconomy.jar"
- Complete Java source code.
- Maven or Gradle build files.
- Default configuration files.
- Imported shop categories and items from my ZIP.
- Example customization configurations.
- Installation instructions.
- Vault dependency instructions.
- Admin command and permission documentation.
- FINAL TESTING
Before declaring completion, verify:
- Plugin loads on Paper 1.21.10.
- Vault hooks successfully.
- Economy provider is detected.
- Shop GUI opens correctly.
- Every imported category works.
- Items display correctly.
- Buy transactions work with real Vault balances.
- Sell transactions work with real Vault balances.
- All prices display in ₹.
- Config edits work after reload.
- Admin commands and permissions work.
- No item duplication or money duplication.
- No console errors.
- No major performance problems.
FINAL INSTRUCTION
Build RuinedEconomy as a complete, professional, optimized and fully configurable Minecraft shop plugin.
The main goal is to provide the functionality and customization flexibility of EconomyShopGUI while having our own independent plugin identity, RuinedEconomy.
Do not stop after generating code. Compile the actual JAR, test it, fix build errors, and provide the finished plugin.
NO FAKE FEATURES. NO PLACEHOLDER IMPLEMENTATIONS. NO SIMULATED ECONOMY. EVERYTHING MUST ACTUALLY WORK.