Upgradable SellChest v1.2

Upgradable SellChest
Turn Player Grind Into Passive Income While They Sleep

The Professional Automated Selling System Built For Economy Servers

The Problem Every Economy Server Faces

Your players spend hours grinding resources. Mining. Farming. Hunting. Then they waste another 30 minutes at spawn shops manually selling everything, one click at a time. They log off frustrated. They burn out. They leave.

Meanwhile, your competitors are letting players automate the tedious parts and focus on what's actually fun.

Every minute players spend in a shop GUI selling cobblestone is a minute they're not exploring, building, or engaging with your server's real content. Manual selling isn't gameplay. It's busywork that kills retention.



The Solution: Intelligent Passive Income

SellChest doesn't just automate selling. It creates a strategic progression system where players invest in their infrastructure to maximize profits over time.

Place a chest. It sells automatically. Upgrade it to sell faster, more items, and for better prices. Players build selling networks across their bases. Your economy stays active 24/7, even when players are offline.

1. Set It And Forget It - Fully automated selling at configurable intervals
2. 3-Tier Upgrade System - Speed, quantity, and profit percentage progression
3. Real-Time Statistics - Live hologram displays showing earnings and performance
4. Economy Integration - Works with Vault, EconomyShopGUI, and any shop plugin
5. MySQL Support - Professional database storage with HikariCP pooling
6. Zero Performance Impact - Async operations, partitioned processing, enterprise-grade optimization

What Makes This Different

Strategic Upgrade Progression (Not Just Convenience)

This isn't a simple auto-sell plugin. It's an investment system that creates long-term goals:

1. Items Amount - Start at 1 item per cycle, upgrade to 64 items per cycle (7 levels)
2. Sell Frequency - Begin at every 10 minutes, push down to every 1 minute (6 levels)
3. Sell Percentage - Get 50% of item value initially, reach 100% at max level (6 levels)

Each upgrade costs in-game currency. Players need to earn money to upgrade, which earns them more money. This creates a natural progression loop that keeps players engaged for weeks.

Live Statistics That Drive Competition

1. Hologram Displays - Real-time earnings, items sold, and upgrade levels visible above each chest
2. Top Earners Leaderboard - Global rankings show who's maximizing their selling networks
3. PlaceholderAPI Integration - Display SellChest stats in scoreboards, chat, and anywhere else
4. Per-Chest Tracking - Players can monitor performance of individual locations and optimize placement

Players don't just use SellChests. They compete to build the most efficient selling empires.

Performance Engineering (Not An Afterthought)

Built for servers with hundreds of active SellChests:

1. Asynchronous Database Operations - Zero main thread blocking, ever
2. Partitioned Processing - Load distributed across multiple ticks to prevent lag spikes
3. Chunk-Based Mapping - O(1) lookup performance regardless of chest count
4. Dirty Tracking - Only writes changed data, minimizing database load
5. HikariCP Connection Pooling - Professional-grade MySQL optimization
6. Notification Batching - Smart message grouping prevents chat spam

Your TPS stays locked at 20, even during peak hours with mass selling operations.

Flexible Configuration (Your Economy, Your Rules)

Every value is configurable:

1. Base sell frequency (default: 10 minutes)
2. Starting sell percentage (default: 50%)
3. Initial items per cycle (default: 1)
4. Unlimited upgrade levels with custom costs
5. Automatic removal of unsellable items
6. MySQL or file-based storage
7. Multi-language support (English and Polish included)

Whether you run a hardcore economy or casual survival, SellChest adapts to your server's balance.



Feature Breakdown

Core Functionality

1. Place special chests that automatically sell contents at timed intervals
2. Three parallel upgrade paths (speed, quantity, profit margin)
3. GUI-based upgrade management with visual progress indicators
4. Automatic item valuation via EconomyShopGUI integration
5. Configurable whitelist/blacklist for sellable items
6. Option to void unsellable items or leave them in chest
7. Region protection compatibility (WorldGuard, GriefPrevention, Towny, Lands)

Data & Statistics

1. Per-chest earnings tracking (lifetime and session)
2. Items sold counter with material breakdown
3. Last sell timestamp and next sell countdown
4. Global leaderboards with top earners ranking
5. Player-specific chest lists with location info
6. Export capabilities for data analysis

Visual Feedback

1. Hologram displays above chests (requires compatible plugin)
2. Live updates showing current stats, upgrade levels, and earnings
3. Customizable hologram format and colors
4. Particle effects on sell completion (optional)
5. In-chat notifications with detailed sell reports

Economy Integration

1. Vault API for universal economy support
2. EconomyShopGUI price synchronization
3. Custom pricing configuration fallback
4. Per-item sell multipliers
5. Tax system support for server-wide fees
6. Transaction logging for anti-cheat audits

Database & Storage

1. MySQL support with HikariCP connection pooling
2. Automatic database schema creation and updates
3. YAML fallback for single-server setups
4. Async save operations with dirty tracking
5. Configurable autosave intervals (default: 5 minutes)
6. Data migration tools for storage type switching

Administration

1. Give SellChest items to players with commands
2. View any player's chest locations and stats
3. Force-trigger sell operations for testing
4. Hot-reload configuration without restart
5. Comprehensive permission system
6. Debug mode for troubleshooting

Commands & Permissions

Commands

/sellchest                         - Display help menu
/sellchest give  [amount]  - Give SellChest items (admin)
/sellchest list                    - View your SellChests and locations
/sellchest top                     - Display top earners leaderboard
/sellchest reload                  - Reload configuration (admin)
/sellchest stats [player]          - View detailed statistics (admin)

Aliases: /sc

Permissions

tokpl.sellchest.use         - Place and use SellChests (default: true)
tokpl.sellchest.admin       - Admin commands and bypasses (default: op)
tokpl.sellchest.upgrade     - Access upgrade GUI (default: true)
tokpl.sellchest.stats       - View own statistics (default: true)
tokpl.sellchest.stats.other - View other player stats (default: op)

Requirements & Compatibility

Required

1. Paper 1.21+ - Modern API for optimal performance
2. Vault - Economy integration
3. Java 21 - Latest language features and optimizations

Optional

1. EconomyShopGUI - Automatic item price synchronization
2. PlaceholderAPI - Display stats in scoreboards and chat
3. DecentHolograms / HolographicDisplays - Hologram support
4. MySQL - Professional database storage

Compatible With

1. WorldGuard, GriefPrevention, Towny, Lands (auto-detects region ownership)
2. Any Vault-compatible economy plugin
3. ProtocolLib for enhanced visual effects (optional)

Who Is This For?

Economy Servers
Give players a reason to invest their earnings back into infrastructure. SellChests become valuable assets that appreciate over time through upgrades.

Survival Networks
Reduce server load from players manually clicking through shop GUIs. Let them focus on building, exploring, and socializing instead of inventory management.

Towny / Land Claim Servers
Players build automated selling outposts across their territories. SellChests become strategic points in their economic empire.

Hardcore / Long-Term Servers
The upgrade system creates month-long progression goals. Players who reach max-level SellChests have invested serious time and money into optimization.

Prison / Mining Servers
Perfect for cell-based gameplay where players upgrade their mining infrastructure over time. Reduces shop congestion during peak hours.



Why Server Owners Choose SellChest

"It Just Works"
Drop in the plugins folder, configure your economy integration, and it's live. No complex dependencies, no fragile setups, no weird edge cases.

"My Players Actually Use It"
Unlike pure convenience plugins that get ignored, the upgrade system gives players a reason to engage. They want better SellChests.

"Zero Performance Issues"
Built by developers who understand Paper's async architecture. Every operation is thread-safe, non-blocking, and optimized.

"It Fits My Server's Balance"
Completely configurable costs, rates, and limitations. Whether you want cheap automation or expensive late-game content, it adapts.

"Support Actually Responds"
Active development, regular updates, and real support on Discord. Not another abandoned plugin.



Stop Losing Players To Manual Selling Tedium

Every day without SellChest is another day your players waste time in shop GUIs instead of experiencing your server's content. Your competitors are already automating the boring parts and keeping players engaged longer.

This isn't about convenience. It's about retention.

Give your players a progression system that rewards infrastructure investment. Let them build selling networks that generate passive income. Free them from inventory management so they can focus on what makes Minecraft fun.

Your economy deserves professional automation.