BLCKSTG SellChest

A lightweight, customizable and feature-rich SellChest plugin for Paper servers, designed for automatic selling, virtual storage, economy integration and reliable long-term use.

BLCKSTG SellChest allows players to place special chests that automatically collect and sell supported items. The plugin includes configurable SellChest types, sell multipliers, virtual storage, holograms, hopper support, multiple price sources and administrative recovery tools.

The goal of the plugin is to provide a flexible SellChest system that can be used on anything from smaller survival servers to larger economy-based server networks.

🇬🇧 English

✨ Features

💰 Automatic Selling

SellChests can automatically sell their stored contents at configurable intervals.

This makes them suitable for:

• generator servers
• farming systems
• economy servers
• automatic resource production
• hopper-based collection systems

Players do not need to manually empty and sell the contents of their SellChest.

📦 Virtual Storage

SellChests use virtual storage instead of relying only on the physical Minecraft chest inventory.

This allows the plugin to support much larger storage capacities while keeping the system compact and easy to manage.

Different SellChest types can be configured with different storage capacities and behavior.

📊 Multiple SellChest Types

The plugin supports multiple SellChest tiers/types.

Default permission nodes include:

• blckstg.sellchest.type.basic
• blckstg.sellchest.type.boosted
• blckstg.sellchest.type.advanced
• blckstg.sellchest.type.elite

Different types can be used to provide different progression levels, multipliers or server-specific rewards.

📈 Sell Multipliers

SellChests can apply configurable selling multipliers.

This makes it possible to create stronger SellChest tiers or reward players with upgraded versions of the system.

🏷️ Built-in Holograms

SellChests can display built-in hologram information directly above the chest.

This allows players to quickly identify and inspect their SellChest without requiring additional hologram plugins.

🔄 Hopper Support

SellChests support hopper-based item input.

Players can connect farms, generators or other item transportation systems directly to their SellChest.

This allows fully automated collection and selling setups.

💵 Economy Integration

The plugin supports Vault-compatible economies.

Money earned from SellChest sales can be deposited directly into the player's economy balance.

🛒 Multiple Price Sources

BLCKSTG SellChest supports multiple ways of determining item prices.

Supported price sources include:

• EconomyShopGUI
• Essentials
• Custom configured prices

This allows server owners to choose the pricing system that best matches their existing economy setup.

🛡️ Secure GUI

SellChest management uses a secure inventory GUI designed to prevent unintended item movement and duplication issues.

The system includes protections focused on maintaining safe SellChest interaction.

🔒 Anti-Dupe Protection

The plugin includes anti-duplication protections for SellChest interactions and storage handling.

This is especially important for automated economy systems where duplication bugs could negatively affect the server economy.

💾 Backup & Recovery

SellChest includes backup and recovery functionality.

Administrators can recover SellChest data when necessary and use dedicated recovery tools for troubleshooting or maintenance.

⚙️ Configurable

Messages, behavior and SellChest settings are configurable.

The plugin is designed so server owners can adjust the system to better match their own economy and progression.

🔑 Permissions

Player Permissions

General

blckstg.sellchest.use Allows the player to use SellChest functionality.

blckstg.sellchest.place Allows the player to place SellChests.

blckstg.sellchest.open Allows the player to open and interact with SellChests.

blckstg.sellchest.pickup Allows the player to pick up SellChests.

SellChest Type Permissions

blckstg.sellchest.type.basic

blckstg.sellchest.type.boosted

blckstg.sellchest.type.advanced

blckstg.sellchest.type.elite

These permissions can be used to control which SellChest types individual players or permission groups are allowed to use.

Administrator Permissions

blckstg.sellchest.admin Main administrator permission.

blckstg.sellchest.admin.give Access to SellChest giving functionality.

blckstg.sellchest.admin.reload Allows reloading the plugin configuration.

blckstg.sellchest.admin.list Access to SellChest listing functionality.

blckstg.sellchest.admin.info Access to detailed SellChest information.

blckstg.sellchest.admin.forcesell Allows administrators to force a SellChest sale.

blckstg.sellchest.admin.manageothers Allows management of SellChests owned by other players.

blckstg.sellchest.admin.diagnose Access to diagnostic functionality.

blckstg.sellchest.admin.price Access to price-related administration.

blckstg.sellchest.admin.recover Access to SellChest recovery tools.

🔌 Integrations

BLCKSTG SellChest is designed to work with common Paper economy setups.

Supported integrations include:

• Vault — economy handling
• EconomyShopGUI — item prices
• Essentials — item prices
• Custom prices — prices configured directly for SellChest

The selected setup depends on the configuration of your server.

🎯 Recommended For

BLCKSTG SellChest can be useful for servers using:

• generators
• automatic farms
• economy progression
• resource production
• hopper systems
• automated selling
• custom SellChest tiers

It can also be used as part of a larger generator or farming system where players continuously produce items that need to be collected and sold.

⚠️ Beta Status

BLCKSTG SellChest is currently in BETA.

The plugin is actively being tested and improved.

Bug reports, suggestions and feedback are very welcome and can help improve stability, compatibility and future features.

If you encounter an issue, please include as much information as possible, such as:

• server version
• plugin version
• console errors
• steps to reproduce the problem

🇭🇺 Magyar

✨ Funkciók

💰 Automatikus eladás

A SellChestek képesek a bennük tárolt tárgyakat automatikusan, meghatározott időközönként eladni.

Ez különösen hasznos:

• generátoros szervereken
• farm rendszereknél
• economy szervereken
• automatikus nyersanyagtermelésnél
• hopperes gyűjtőrendszereknél

A játékosoknak nem kell folyamatosan kézzel kiüríteniük és eladniuk a láda tartalmát.

📦 Virtuális tárhely

A SellChest nem kizárólag a normál Minecraft ládainventory méretére támaszkodik.

A virtuális tárhely segítségével jóval nagyobb mennyiségű tárgy kezelhető egyetlen SellChestben.

A különböző SellChest típusokhoz eltérő tárhelyméret és működés állítható be.

📊 Több SellChest típus

A plugin több SellChest szintet/típust támogat.

Az alapértelmezett jogosultságok között megtalálható:

• blckstg.sellchest.type.basic
• blckstg.sellchest.type.boosted
• blckstg.sellchest.type.advanced
• blckstg.sellchest.type.elite

Ezekkel különböző fejlődési szintek, rangok vagy szerver-specifikus jutalmak alakíthatók ki.

📈 Eladási szorzók

A SellChestekhez eladási szorzók használhatók.

Így létrehozhatók erősebb vagy magasabb szintű SellChestek, amelyek ugyanazokat a tárgyakat magasabb szorzóval értékesítik.

🏷️ Beépített hologramok

A SellChest saját hologramrendszerrel rendelkezik.

Ennek segítségével fontos információk jeleníthetők meg közvetlenül a láda felett anélkül, hogy külön hologram pluginra lenne szükség.

🔄 Hopper támogatás

A SellChest támogatja a hopperből érkező tárgyakat.

Így farmok, generátorok és egyéb item szállító rendszerek közvetlenül összeköthetők vele.

Ez lehetővé teszi teljesen automatikus gyűjtő- és eladórendszerek kialakítását.

💵 Economy integráció

A plugin támogatja a Vault kompatibilis economy rendszereket.

Az eladott tárgyak után kapott pénz közvetlenül a játékos economy egyenlegére kerülhet.

🛒 Többféle árforrás

A SellChest több különböző rendszerből képes meghatározni az itemek eladási árát.

Támogatott árforrások:

• EconomyShopGUI
• Essentials
• saját, konfigurációban megadott árak

Így a plugin könnyen hozzáigazítható a szerveren már meglévő economy rendszerhez.

🛡️ Biztonságos GUI

A SellChest kezelőfelülete biztonságos inventory GUI-t használ.

A rendszer célja a hibás itemmozgatások és duplikációs lehetőségek csökkentése.

🔒 Anti-Dupe védelem

A plugin külön védelmeket tartalmaz a SellChest kezeléséhez és virtuális tárhelyéhez kapcsolódó duplikációs hibák ellen.

Ez különösen fontos economy alapú szervereken, ahol egy dupe hiba komoly gazdasági problémát okozhat.

💾 Backup és Recovery

A SellChest backup és recovery rendszerrel rendelkezik.

Az adminisztrátorok szükség esetén helyreállítási és diagnosztikai eszközöket használhatnak a SellChest adatok kezeléséhez.

⚙️ Testreszabható

A plugin üzenetei, működése és SellChest beállításai konfigurálhatók.

Ennek köszönhetően a rendszer könnyen hozzáigazítható a szerver saját economy és fejlődési rendszeréhez.

🔑 Jogosultságok

Játékos jogosultságok

blckstg.sellchest.use SellChest használata.

blckstg.sellchest.place SellChest lerakása.

blckstg.sellchest.open SellChest megnyitása és kezelése.

blckstg.sellchest.pickup SellChest felszedése.

SellChest típus jogosultságok

blckstg.sellchest.type.basic

blckstg.sellchest.type.boosted

blckstg.sellchest.type.advanced

blckstg.sellchest.type.elite

Ezekkel szabályozható, hogy egy játékos vagy permission csoport mely SellChest típusokat használhatja.

Admin jogosultságok

blckstg.sellchest.admin Fő admin jogosultság.

blckstg.sellchest.admin.give SellChest kiosztási funkciók.

blckstg.sellchest.admin.reload Konfiguráció újratöltése.

blckstg.sellchest.admin.list SellChest lista megtekintése.

blckstg.sellchest.admin.info SellChest információk megtekintése.

blckstg.sellchest.admin.forcesell Kényszerített eladás.

blckstg.sellchest.admin.manageothers Más játékosok SellChestjeinek kezelése.

blckstg.sellchest.admin.diagnose Diagnosztikai funkciók.

blckstg.sellchest.admin.price Árkezeléssel kapcsolatos admin funkciók.

blckstg.sellchest.admin.recover Recovery/helyreállítási funkciók.

🔌 Integrációk

A BLCKSTG SellChest a gyakori Paper economy rendszerekhez készült.

Támogatott integrációk:

• Vault — economy kezelés
• EconomyShopGUI — item árak
• Essentials — item árak
• Custom Prices — saját konfigurálható árak

A használni kívánt rendszer a szerver konfigurációjától függ.

🎯 Milyen szerverekhez ajánlott?

A SellChest különösen jól használható olyan szervereken, ahol fontos szerepet kap:

• a generátoros játékmenet
• az automatikus farmolás
• az economy fejlődés
• a nyersanyagtermelés
• a hopperes automatizálás
• az automatikus eladás
• a különböző SellChest szintek

Nagyobb generator vagy farming rendszerek részeként is használható, ahol a játékosok folyamatosan termelnek eladható tárgyakat.

⚠️ BÉTA verzió

A BLCKSTG SellChest jelenleg BÉTA verzióban van.

A plugin aktív tesztelés és fejlesztés alatt áll.

Minden hibajelentést, ötletet és visszajelzést szívesen fogadok, mert ezek segítenek a stabilitás, kompatibilitás és a későbbi funkciók fejlesztésében.

Hibajelentés esetén lehetőség szerint add meg:

• a szerver verzióját
• a plugin verzióját
• a konzolban megjelenő hibát
• a hiba reprodukálásának lépéseit