? RagnarSellChests
RagnarSellChests 是一款功能强大且可配置的自动出售插件,专为 Paper 服务器设计。
它引入了特殊的 SellChest(出售箱),能够利用服务器现有的 EconomyShopGUI 价格自动出售其内容物。
玩家只需放置一个 SellChest,装入物品,插件便会自动处理出售流程。每个 SellChest 都可以拥有自己的持续时间和出售倍率,同时实时全息投影会显示剩余时间、已生成金钱、所有者以及下一次自动出售等有用信息。
RagnarSellChests 旨在融入现有的服务器经济体系,而不是创建一个完全独立的商店或定价系统。
✨ 主要特性
- ? 自动 SellChest:定期出售其内容物
- ? EconomyShopGUI 集成:用于获取物品出售价格
- ⏱️ 自动出售间隔
- ⚡ 个体出售倍率:每个 SellChest 均可独立设置
- ⌛ 限时 SellChest
- ? 所有权系统
- ? 当所有者离线时,自动出售会自动暂停
- ? 总生成金钱追踪
- ?️ 实时全息投影:显示 SellChest 相关信息
- ? 支持双层箱子
- ?️ 防止未经授权的玩家操作
- ? 防爆保护
- ? 可配置允许放置的世界
- ? 完全可配置的 SellChest 数量限制
- ? 基于权限的限制,兼容自定义等级
- ? 持久化保存 SellChest 数据
- ? 可配置出售通知和音效
- ? 正常的箱子库存交互——无需不必要的自定义存储 GUI

? 工作原理
服务器管理员使用 /sellchest 命令创建 SellChest。
例如:
/sellchest give Steve 30d 1.25
这将给 Steve 提供一个 SellChest,具备以下属性:
随后,玩家可以在允许的世界中放置该 SellChest。
一旦放置,SellChest 即激活并开始倒计时。
玩家可以像使用普通 Minecraft 箱子一样使用它:打开它,放入物品,并在必要时取出物品。
在固定的时间间隔内,RagnarSellChests 会检查库存并自动出售符合条件的物品。
没有单独的出售界面或复杂的交互逻辑。箱子本身就是该系统的一部分。
? EconomyShopGUI 集成
RagnarSellChests 不维护单独的物品价格列表。
相反,它直接集成到 EconomyShopGUI 中,并使用其后端配置的出售价格。
这意味着,如果某物品在 EconomyShopGUI 中价值 $100,RagnarSellChests 在自动出售该物品时也会采用此价格。
如果你后续通过 EconomyShopGUI 更改了该物品的价格,则无需手动更新 RagnarSellChests 的相关配置。
无法出售的物品会发生什么?
只有 EconomyShopGUI 支持出售的物品才会被出售。
没有有效出售价格的物品将简单地留在箱子内。
它们不会被删除。
这允许玩家将混合库存安全地放入 SellChest 中,而不会导致不受支持的物品消失。
?️ 实时 SellChest 全息投影
每个活跃的 SellChest 都有一个显示其当前状态的全息投影。
例如:
SELL CHEST
Owner: Steve
Time remaining: 29d 23h 41m 08s
Multiplier: ×1.25
Generated: 1.27M $
Next sale: 1m 34s
这些信息会在 SellChest 运行期间自动更新。
所有者 (Owner)
显示当前拥有该 SellChest 的玩家。
剩余时间 (Time remaining)
精确显示 SellChest 过期前剩余的时长。
倍率 (Multiplier)
显示 SellChest 当前的出售倍率。
已生成金额 (Generated)
追踪该特定 SellChest 通过自动出售所生成的金钱总额。
大数字会自动以紧凑格式显示,例如:
950 $
1.25K $
53.4K $
1.27M $
2.4B $
下次出售 (Next sale)
显示距离下一次自动出售周期剩余的时长。
⏳ SellChest 持续时间
SellChest 的设计围绕有限时长展开。
管理员在将 SellChest 交给玩家时,可以决定其保持活跃的时间长度。
示例包括:
7d
30d
60d
90d
持续时间并非从管理员创建物品时开始计算。
而是从 SellChest 被放置并激活时开始计算。
这意味着玩家可以安全地将未使用的 SellChest 保留在背包或储物柜中,直到决定激活它们为止。
SellChest 过期时会发生什么?
过期不会销毁箱子。
也不会删除其中存储的物品。
一旦持续时间归零,自动出售将停止。
箱子及其剩余内容物仍可访问。
⚡ 出售倍率
每个 SellChest 都可以拥有独立的出售倍率。
例如:
×1.0
×1.25
×1.5
×2.0
这允许服务器管理员创建不同等级的 SellChest。
例如,普通的 SellChest 可以使用:
×1.0
而更高价值的 SellChest 可以使用:
×1.5
如果一个库存的正常出售价值为 $10,000,那么使用 ×1.5 倍率的 SellChest 将从此次出售中生成 $15,000。
倍率是绑定在单个 SellChest 上的。
? 所有者在线系统
SellChest 仅在所有者在线时执行自动出售。
当所有者断开连接时,自动出售过程会暂停。
当所有者重新上线时,出售系统可以继续运行。
这防止了 SellChest 在所有者离开服务器时持续产生金钱。
然而,SellChest 的整体过期持续时间基于其真实时长,并不会因为玩家断开连接而变得无限长。
? 空的 SellChest
SellChest 并不需要始终包含物品。
即使箱子为空,自动出售倒计时也可以继续。
当 SellChest 连接到农场时,这一点特别有用。
例如,农场可以逐渐将物品放入箱子中,而 SellChest 将在其下一个售卖周期内尝试出售所有可用的物品。
如果没有可出售的物品,则不会生成金钱,也不会发送不必要的售卖通知。
? 双箱支持
RagnarSellChests 支持双箱。
SellChest 可以连接到另一个箱子以提供额外的存储空间。
组合后的库存被视为一个 SellChest,允许箱子的两侧都参与自动售卖过程。
保护系统也会考虑连接的箱子,以防止玩家利用另一半来绕过 SellChest 的保护。
全息图会根据 SellChest 的结构适当定位。
?️ 保护系统
SellChest 包含旨在防止未经授权与系统交互的保护机制。
所有权由插件跟踪,受保护的 SellChest 不能简单地被其他玩家破坏以绕过系统。
在使用双箱时,保护也涵盖相关的连接箱子行为。
在适用的情况下,SellChest 还受到爆炸保护。
? 允许的维度/世界
服务器管理员可以精确控制 SellChest 允许运行的位置。
允许的维度列表是可配置的。
例如:
allowed-worlds:
- world
- world_nether
- world_the_end
这使得可以在枢纽、小游戏维度、事件维度或任何不应使用 SellChest 的位置禁用它们。
? 可配置的 SellChest 限制
RagnarSellChests 不强制服务器使用预定义的等级名称。
相反,服务器管理员可以创建自己的 SellChest 限制组。
例如:
limits:
default: 1
vip: 2
premium: 3
legend: 5
然后你可以使用权限分配这些限制。
例如:
ragnarsellchests.limit.vip
ragnarsellchests.limit.premium
ragnarsellchests.limit.legend
这意味着 RagnarSellChests 可以适应几乎任何现有的等级结构。
你的服务器可以使用诸如以下等级的名称:
VIP
Premium
Legend
或者完全不同的名称。
由你决定进度如何运作。
如果玩家拥有多个配置的限制权限,插件将使用最高的适用限制。
? 持久数据
SellChest 信息是持久存储的。
重要信息(如所有权、过期时间、倍率和生成的金钱)会被保留下来,而不是仅存在于服务器内存中。
这允许 SellChest 在正常的服务器重启后继续正确运行。
? 售卖通知
当 SellChest 成功出售物品时,其所有者会收到反馈,告知他们发生了售卖。
例如:
✔ Your SellChest sold items for 12.45K $!
成功的售卖还可以伴随声音效果。
如果一个售卖周期没有找到任何可出售的物品,插件不会向玩家发送不必要的成功售卖消息。
?️ 命令
给予 SellChest
/sellchest give <player> <duration> [multiplier]
示例:
/sellchest give Steve 30d 1.25
这将给选定的玩家一个持续 30 天且带有 ×1.25 倍率的 SellChest。
重载插件
/sellchest reload
重载插件配置。
? 权限
管理功能通过以下权限控制:
ragnarsellchests.admin
自定义 SellChest 限制使用:
ragnarsellchests.limit.<group>
例如:
ragnarsellchests.limit.vip
<group> 值对应于插件 limits 部分中配置的一个组。
⚙️ 配置
RagnarSellChests 设计为可配置,以适应不同的服务器经济体系。
服务器所有者可以配置重要的行为,例如:
- SellChest 限制
- 允许的维度
- 售卖行为
- 售卖间隔
- 全息图显示
- 消息
- 声音
- 其他 SellChest 行为
更改配置值后,可以使用以下命令重载插件:
/sellchest reload
? 依赖项
RagnarSellChests 专为现代 Paper 服务器设计。
必需
- Paper
- Java 21
- EconomyShopGUI
- 兼容的经济设置
在使用自动售卖之前,请确保你的经济和 EconomyShopGUI 安装已正确配置。
? RagnarSellChests 适合谁?
RagnarSellChests 特别适用于:
- 生存服务器
- SMP 服务器
- 经济服务器
- 拥有自动化农场的服务器
- 拥有等级进度的服务器
- 寻找高级或限时实用物品的服务器
由于 SellChest 可以有不同的持续时间、倍率和玩家限制,服务器所有者可以将它们集成到进度系统、活动、奖励、宝箱、等级或其他服务器机制中。
? RagnarSellChests
RagnarSellChests 的目标很简单:
放置一个箱子。存储你的物品。让箱子处理售卖。
没有第二价格数据库,没有不必要的售卖 GUI,也没有预定义的等级结构。
你的 EconomyShopGUI 价格、你的 服务器经济 和 等级系统 仍由你掌控。
?? 作者
RagnarSellChests 由 paceski28 开发和维护。
? 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧