📦 RagnarSellChests

RagnarSellChests is a powerful and configurable automatic selling plugin designed for Paper servers.

It introduces special SellChests that automatically sell their contents using your server's existing EconomyShopGUI prices.

Players simply place a SellChest, fill it with items, and the plugin handles the selling process automatically. Each SellChest can have its own duration and sell multiplier, while a live hologram displays useful information such as the remaining time, generated money, owner and next automatic sale.

RagnarSellChests is designed to integrate into an existing server economy instead of creating a completely separate shop or pricing system.

---

✨ Main Features

• 📦 Automatic SellChests that periodically sell their contents
• 💰 EconomyShopGUI integration for item sell prices
• ⏱️ Automatic selling intervals
• ⚡ Individual sell multipliers for every SellChest
• ⌛ Time-limited SellChests
• 👤 Ownership system
• 🟢 Selling automatically pauses while the owner is offline
• 📊 Total generated money tracking
• 🏷️ Live holograms displaying SellChest information
• 📦 Double chest support
• 🛡️ Protection against unauthorized players
• 💥 Protection against explosions
• 🌍 Configurable allowed worlds
• 🔢 Fully configurable SellChest limits
• 🔐 Permission-based limits compatible with custom ranks
• 💾 Persistent SellChest data
• 🔊 Configurable sale notifications and sounds
• 🧱 Normal chest inventory interaction — no unnecessary custom storage GUI
• 

---

🔧 How does it work?

A server administrator creates a SellChest using the /sellchest command.

For example:

/sellchest give Steve 30d 1.25

This gives Steve a SellChest with:

• 30 days of usage
• a ×1.25 sell multiplier

The player can then place the SellChest in an allowed world.

Once placed, the SellChest becomes active and its duration starts counting down.

Players can use it like a normal Minecraft chest: open it, place items inside it and remove items whenever necessary.

At regular intervals, RagnarSellChests checks the inventory and automatically sells compatible items.

There is no separate selling inventory or complicated interface. The chest itself is the system.

---

💰 EconomyShopGUI Integration

RagnarSellChests does not maintain a separate list of item prices.

Instead, it integrates directly with EconomyShopGUI and uses its configured sell prices.

This means that if an item is worth $100 in EconomyShopGUI, RagnarSellChests uses that price when automatically selling the item.

If you later change that item's price through EconomyShopGUI, you do not need to manually update RagnarSellChests.

What happens to unsellable items?

Only items supported for selling by EconomyShopGUI are sold.

Items without a valid sell price are simply left inside the chest.

They are not deleted.

This allows players to safely put mixed inventories inside their SellChests without unsupported items disappearing.

---

🏷️ Live SellChest Holograms

Every active SellChest has a hologram displaying its current status.

For example:

SELL CHEST
Owner: Steve
Time remaining: 29d 23h 41m 08s
Multiplier: ×1.25
Generated: 1.27M $
Next sale: 1m 34s

The information is automatically updated while the SellChest is running.

Owner

Shows the player who currently owns the SellChest.

Time remaining

Displays exactly how much time the SellChest has before it expires.

Multiplier

Displays the SellChest's current sell multiplier.

Generated

Tracks how much money that individual SellChest has generated through automatic sales.

Large numbers are automatically displayed in a compact format such as:

950 $
1.25K $
53.4K $
1.27M $
2.4B $

Next sale

Shows the remaining time before the next automatic selling cycle.

---

⏳ SellChest Duration

SellChests are designed around limited durations.

An administrator can decide how long a SellChest should remain active when giving it to a player.

Examples include:

7d
30d
60d
90d

The duration does not start when the administrator creates the item.

It starts when the SellChest is placed and activated.

This means players can safely keep unused SellChests in their inventories or storage before deciding to activate them.

---

What happens when a SellChest expires?

Expiration does not destroy the chest.

It also does not delete the items stored inside it.

Once the duration reaches zero, automatic selling simply stops.

The chest and its remaining contents remain accessible.

---

⚡ Sell Multipliers

Every SellChest can have its own sell multiplier.

For example:

×1.0
×1.25
×1.5
×2.0

This allows server administrators to create different SellChest tiers.

For example, a normal SellChest could use:

×1.0

while a more valuable SellChest could use:

×1.5

If the normal selling value of an inventory is $10,000, a ×1.5 SellChest would generate $15,000 from that sale.

The multiplier is attached to the individual SellChest.

---

🟢 Owner Online System

SellChests only perform automatic selling while their owner is online.

When the owner disconnects, the automatic selling process pauses.

When the owner returns, the selling system can continue.

This prevents SellChests from continuously generating money while their owners are away from the server.

The SellChest's overall expiration duration, however, is based on its real duration and does not become unlimited simply because the player disconnects.

---

📦 Empty SellChests

A SellChest does not need to contain items at all times.

The automatic sale countdown can continue while the chest is empty.

This is particularly useful when SellChests are connected to farms.

For example, a farm can gradually insert items into the chest and the SellChest will attempt to sell whatever is available during its next selling cycle.

If there is nothing to sell, no money is generated and no unnecessary sale notification is sent.

---

📦 Double Chest Support

RagnarSellChests supports double chests.

A SellChest can be connected to another chest to provide additional storage capacity.

The combined inventory is handled as one SellChest, allowing both sides of the chest to participate in the automatic selling process.

The protection system also takes the connected chest into account to prevent players from using the second half to bypass SellChest protection.

The hologram is positioned appropriately for the SellChest structure.!

---

🛡️ Protection System

SellChests contain protection mechanisms designed to prevent unauthorized interaction with the system.

Ownership is tracked by the plugin, and protected SellChests cannot simply be destroyed by another player to bypass the system.

Protection also covers relevant connected chest behavior when using double chests.

SellChests are additionally protected against explosions where applicable.

---

🌍 Allowed Worlds

Server administrators can control exactly where SellChests are allowed to operate.

The list of allowed worlds is configurable.

For example:

allowed-worlds:
  - world
  - world_nether
  - world_the_end

This makes it possible to disable SellChests in hubs, minigame worlds, event worlds or any other location where they should not be used.

---

🔢 Configurable SellChest Limits

RagnarSellChests does not force your server to use predefined rank names.

Instead, server administrators can create their own SellChest limit groups.

For example:

limits:
  default: 1
  vip: 2
  premium: 3
  legend: 5

You can then assign those limits using permissions.

For example:

ragnarsellchests.limit.vip
ragnarsellchests.limit.premium
ragnarsellchests.limit.legend

This means RagnarSellChests can adapt to virtually any existing rank structure.

Your server could use ranks such as:

VIP
Premium
Legend

or completely different names.

You decide how the progression works.

If a player has access to multiple configured limit permissions, the plugin uses the highest applicable limit.

---

💾 Persistent Data

SellChest information is stored persistently.

Important information such as ownership, expiration, multiplier and generated money is preserved instead of existing only in server memory.

This allows SellChests to continue functioning correctly across normal server restarts.

---

🔊 Sale Notifications

When a SellChest successfully sells items, its owner receives feedback informing them that a sale occurred.

For example:

✔ Your SellChest sold items for 12.45K $!

A sound can also accompany successful sales.

If a selling cycle finds nothing that can be sold, the plugin does not spam the player with unnecessary successful-sale messages.

---

🛠️ Commands

Give a SellChest

/sellchest give <player> <duration> [multiplier]

Example:

/sellchest give Steve 30d 1.25

This gives the selected player a SellChest lasting 30 days with a ×1.25 multiplier.

---

Reload the plugin

/sellchest reload

Reloads the plugin configuration.

---

🔐 Permissions

Administrative functionality is controlled through:

ragnarsellchests.admin

Custom SellChest limits use:

ragnarsellchests.limit.<group>

For example:

ragnarsellchests.limit.vip

The <group> value corresponds to a group configured in the plugin's limits section.

---

⚙️ Configuration

RagnarSellChests is designed to be configurable so it can fit different server economies.

Server owners can configure important behavior such as:

• SellChest limits
• Allowed worlds
• Selling behavior
• Sell intervals
• Hologram display
• Messages
• Sounds
• Other SellChest behavior

After changing configuration values, the plugin can be reloaded using:

/sellchest reload

---

📋 Requirements

RagnarSellChests is designed for modern Paper servers.

Required

• Paper
• Java 21
• EconomyShopGUI
• A compatible economy setup

Make sure your economy and EconomyShopGUI installation are correctly configured before using automatic selling.

🎯 Who is RagnarSellChests for?

RagnarSellChests is particularly useful for:

• Survival servers
• SMP servers
• Economy servers
• Servers with automated farms
• Servers with rank progression
• Servers looking for premium or timed utility items

Because SellChests can have different durations, multipliers and player limits, server owners can integrate them into progression systems, events, rewards, crates, ranks or other server mechanics.

---

📦 RagnarSellChests

The goal of RagnarSellChests is simple:

Place a chest. Store your items. Let the chest handle the selling.

No second price database, no unnecessary selling GUI and no predefined rank structure.

Your EconomyShopGUI prices, your server economy, and your rank system remain in control.

👨‍💻 Author

RagnarSellChests is developed and maintained by paceski28.