# RefreshLoot – Loot Refresh Plugin<\/p>\n
## Plugin Information
\n– **Name**: RefreshLoot
\n– **Version**: 1.0.0
\n– **Author**: 114514h
\n– **Supported Version**: Minecraft 1.21.4
\n– **API Version**: Spigot 1.21<\/p>\n
## Function Description
\nRefreshLoot is a plugin designed to refresh items in containers across the world. Administrators can use commands to refresh random slots in all containers, including chests, trapped chests, large chests, barrels, furnaces, hoppers, and more.<\/p>\n
### Main Features
\n– **Smart Refresh**: Randomly selects container slots for item refreshing.
\n– **Container Clearing**: Option to clear all items in containers before refreshing.
\n– **Configuration Reload**: Supports hot-reloading configuration files without server restart.
\n– **Multiple Container Support**: Compatible with chests, trapped chests, large chests, barrels, furnaces, hoppers, etc.
\n– **Asynchronous Processing**: Avoids server lag and ensures smooth operation.
\n– **Highly Configurable**: Customizable refresh items, quantities, container types, etc.<\/p>\n
## Commands
\n– `\/refreshloot` or `\/rloot` – Refresh random slots in all containers across the world.
\n– `\/refreshloot reload` or `\/rloot reload` – Reload the configuration file.
\n– **Permission**: `refreshloot.admin` (default OP permission)<\/p>\n
## Configuration Instructions<\/p>\n
### Basic Settings
\n“`yaml
\nsettings:
\n debug: false # Whether to enable debug mode
\n refresh-interval: 300 # Refresh interval in seconds
\n random-slots: 3 # Number of random slots to refresh each time
\n clear-containers: true # Whether to clear container contents before refreshing
\n“`<\/p>\n
**Container Clearing Explanation**:
\n– `clear-containers: true` – Clears all items in containers before adding new random items.
\n– `clear-containers: false` – Retains existing items in containers and only adds new items to randomly selected slots.
\n– Recommended setting: `true` for better refresh results.<\/p>\n
### Container Configuration
\nEach container type can be configured individually:
\n– `enabled`: Whether to enable refreshing for this container type.
\n– `refresh-slots`: Number of slots to refresh each time.
\n– `items`: List of possible items to refresh.<\/p>\n
### Item Format
\nItem configuration format: `MATERIAL:min-max`
\n– `DIAMOND:1-3` – Diamonds, quantity 1-3.
\n– `BREAD:2-5` – Bread, quantity 2-5.
\n– `IRON_SWORD:1` – Iron Sword, fixed quantity of 1.<\/p>\n
**Important Note**: In Minecraft 1.21.4, the names of golden equipment have been changed:
\n– `GOLD_HELMET` \u2192 `GOLDEN_HELMET`
\n– `GOLD_CHESTPLATE` \u2192 `GOLDEN_CHESTPLATE`
\n– `GOLD_LEGGINGS` \u2192 `GOLDEN_LEGGINGS`
\n– `GOLD_BOOTS` \u2192 `GOLDEN_BOOTS`<\/p>\n
Refer to the `MATERIAL_NAMES.md` file for a detailed list of item names.<\/p>\n
## Supported Container Types
\n– **Chest** (chest) – Regular chest
\n– **Trapped Chest** (trapped_chest) – Trapped chest
\n– **Large Chest** (large_chest) – Double chest
\n– **Barrel** (barrel) – Barrel
\n– **Furnace** (furnace) – Furnace, blast furnace, smoker
\n– **Hopper** (hopper) – Hopper<\/p>\n
## Installation Method
\n1. Place the compiled `RefreshLoot-1.0.0.jar` file into the server’s `plugins` folder.
\n2. Restart the server or use the `\/reload` command.
\n3. The plugin will automatically generate a configuration file `config.yml`.
\n4. Modify the configuration file as needed.
\n5. Use the `\/rloot` command to start refreshing containers.<\/p>\n
## Reload Functionality
\nThe plugin supports hot-reloading configuration files without restarting the server:<\/p>\n
### Usage
\n“`
\n\/rloot reload
\n“`<\/p>\n
### Reload Features
\n– **Instant Effect**: Changes take effect immediately after modifying the configuration file.
\n– **Safe Reload**: Includes error handling to prevent plugin failure during reload.
\n– **Debug Information**: Displays reload configuration status when debug mode is enabled.
\n– **Asynchronous Processing**: Reload process does not block the server’s main thread.<\/p>\n
### When to Reload
\n– After modifying container configurations.
\n– After adjusting the item refresh list.
\n– After changing plugin settings.
\n– After updating message configurations.<\/p>\n
## Notes
\n– The plugin scans all chunks in the world to find containers, which may take a long time in large worlds.
\n– It is recommended to use the refresh command during periods of low server load.
\n– Customize items and quantities for each container type in the configuration file.
\n– Enable debug mode to view detailed refresh information.<\/p>\n
## Permissions
\n– `refreshloot.admin` – Allows the use of loot refresh commands (default OP permission)<\/p>\n
# RefreshLoot – \u7269\u8d44\u5237\u65b0\u63d2\u4ef6<\/p>\n
## \u63d2\u4ef6\u4fe1\u606f
\n– **\u540d\u79f0**: RefreshLoot
\n– **\u7248\u672c**: 1.0.0
\n– **\u4f5c\u8005**: 114514h
\n– **\u652f\u6301\u7248\u672c**: Minecraft 1.21.4
\n– **API\u7248\u672c**: Spigot 1.21<\/p>\n
## \u529f\u80fd\u63cf\u8ff0
\nRefreshLoot \u662f\u4e00\u4e2a\u7528\u4e8e\u5237\u65b0\u4e16\u754c\u5185\u5bb9\u5668\u7269\u54c1\u7684\u63d2\u4ef6\u3002\u7ba1\u7406\u5458\u53ef\u4ee5\u4f7f\u7528\u547d\u4ee4\u6765\u5237\u65b0\u4e16\u754c\u5185\u6240\u6709\u5bb9\u5668\u7684\u968f\u673a\u69fd\u4f4d\uff0c\u5305\u62ec\u7bb1\u5b50\u3001\u9677\u9631\u7bb1\u3001\u5927\u7bb1\u5b50\u3001\u6728\u6876\u3001\u7194\u7089\u3001\u6f0f\u6597\u7b49\u3002<\/p>\n
### \u4e3b\u8981\u7279\u6027
\n– **\u667a\u80fd\u5237\u65b0**: \u968f\u673a\u9009\u62e9\u5bb9\u5668\u4e2d\u7684\u69fd\u4f4d\u8fdb\u884c\u7269\u54c1\u5237\u65b0
\n– **\u5bb9\u5668\u6e05\u9664**: \u53ef\u9009\u62e9\u5728\u5237\u65b0\u524d\u6e05\u9664\u5bb9\u5668\u4e2d\u7684\u6240\u6709\u7269\u54c1
\n– **\u914d\u7f6e\u91cd\u8f7d**: \u652f\u6301\u70ed\u91cd\u8f7d\u914d\u7f6e\u6587\u4ef6\uff0c\u65e0\u9700\u91cd\u542f\u670d\u52a1\u5668
\n– **\u591a\u79cd\u5bb9\u5668\u652f\u6301**: \u652f\u6301\u7bb1\u5b50\u3001\u9677\u9631\u7bb1\u3001\u5927\u7bb1\u5b50\u3001\u6728\u6876\u3001\u7194\u7089\u3001\u6f0f\u6597\u7b49
\n– **\u5f02\u6b65\u5904\u7406**: \u907f\u514d\u670d\u52a1\u5668\u5361\u987f\uff0c\u786e\u4fdd\u6d41\u7545\u8fd0\u884c
\n– **\u9ad8\u5ea6\u53ef\u914d\u7f6e**: \u53ef\u81ea\u5b9a\u4e49\u5237\u65b0\u7269\u54c1\u3001\u6570\u91cf\u3001\u5bb9\u5668\u7c7b\u578b\u7b49<\/p>\n
## \u547d\u4ee4
\n– `\/refreshloot` \u6216 `\/rloot` – \u5237\u65b0\u4e16\u754c\u5185\u6240\u6709\u5bb9\u5668\u7684\u968f\u673a\u69fd\u4f4d
\n– `\/refreshloot reload` \u6216 `\/rloot reload` – \u91cd\u65b0\u52a0\u8f7d\u914d\u7f6e\u6587\u4ef6
\n– **\u6743\u9650**: `refreshloot.admin` (\u9ed8\u8ba4OP\u6743\u9650)<\/p>\n
## \u914d\u7f6e\u8bf4\u660e<\/p>\n
### \u57fa\u672c\u8bbe\u7f6e
\n“`yaml
\nsettings:
\n debug: false # \u662f\u5426\u542f\u7528\u8c03\u8bd5\u6a21\u5f0f
\n refresh-interval: 300 # \u5237\u65b0\u95f4\u9694\uff08\u79d2\uff09
\n random-slots: 3 # \u6bcf\u6b21\u5237\u65b0\u65f6\u968f\u673a\u5237\u65b0\u7684\u69fd\u4f4d\u6570\u91cf
\n clear-containers: true # \u662f\u5426\u5728\u5237\u65b0\u524d\u6e05\u9664\u5bb9\u5668\u5185\u5bb9
\n“`<\/p>\n
**\u6e05\u9664\u5bb9\u5668\u529f\u80fd\u8bf4\u660e**:
\n– `clear-containers: true` – \u5728\u5237\u65b0\u7269\u54c1\u524d\u5148\u6e05\u9664\u5bb9\u5668\u4e2d\u7684\u6240\u6709\u7269\u54c1\uff0c\u7136\u540e\u6dfb\u52a0\u65b0\u7684\u968f\u673a\u7269\u54c1
\n– `clear-containers: false` – \u4fdd\u7559\u5bb9\u5668\u4e2d\u7684\u73b0\u6709\u7269\u54c1\uff0c\u53ea\u5728\u968f\u673a\u9009\u62e9\u7684\u69fd\u4f4d\u4e2d\u6dfb\u52a0\u65b0\u7269\u54c1
\n– \u5efa\u8bae\u8bbe\u7f6e\u4e3a `true` \u4ee5\u83b7\u5f97\u66f4\u597d\u7684\u5237\u65b0\u6548\u679c<\/p>\n
### \u5bb9\u5668\u914d\u7f6e
\n\u6bcf\u4e2a\u5bb9\u5668\u7c7b\u578b\u90fd\u53ef\u4ee5\u5355\u72ec\u914d\u7f6e\uff1a
\n– `enabled`: \u662f\u5426\u542f\u7528\u8be5\u5bb9\u5668\u7c7b\u578b\u7684\u5237\u65b0
\n– `refresh-slots`: \u6bcf\u6b21\u5237\u65b0\u65f6\u5237\u65b0\u7684\u69fd\u4f4d\u6570\u91cf
\n– `items`: \u53ef\u80fd\u5237\u65b0\u7684\u7269\u54c1\u5217\u8868<\/p>\n
### \u7269\u54c1\u683c\u5f0f
\n\u7269\u54c1\u914d\u7f6e\u683c\u5f0f\uff1a`MATERIAL:min-max`
\n– `DIAMOND:1-3` – \u94bb\u77f3\uff0c\u6570\u91cf1-3\u4e2a
\n– `BREAD:2-5` – \u9762\u5305\uff0c\u6570\u91cf2-5\u4e2a
\n– `IRON_SWORD:1` – \u94c1\u5251\uff0c\u56fa\u5b9a1\u4e2a<\/p>\n
**\u91cd\u8981\u63d0\u793a**: \u5728Minecraft 1.21.4\u7248\u672c\u4e2d\uff0c\u91d1\u8d28\u88c5\u5907\u7684\u540d\u79f0\u5df2\u66f4\u6539\uff1a
\n– `GOLD_HELMET` \u2192 `GOLDEN_HELMET`
\n– `GOLD_CHESTPLATE` \u2192 `GOLDEN_CHESTPLATE`
\n– `GOLD_LEGGINGS` \u2192 `GOLDEN_LEGGINGS`
\n– `GOLD_BOOTS` \u2192 `GOLDEN_BOOTS`<\/p>\n
\u8be6\u7ec6\u7269\u54c1\u540d\u79f0\u5bf9\u7167\u8868\u8bf7\u53c2\u8003 `MATERIAL_NAMES.md` \u6587\u4ef6\u3002<\/p>\n
## \u652f\u6301\u7684\u5bb9\u5668\u7c7b\u578b
\n– **\u7bb1\u5b50** (chest) – \u666e\u901a\u7bb1\u5b50
\n– **\u9677\u9631\u7bb1** (trapped_chest) – \u9677\u9631\u7bb1
\n– **\u5927\u7bb1\u5b50** (large_chest) – \u53cc\u7bb1\u5b50
\n– **\u6728\u6876** (barrel) – \u6728\u6876
\n– **\u7194\u7089** (furnace) – \u7194\u7089\u3001\u9ad8\u7089\u3001\u70df\u718f\u7089
\n– **\u6f0f\u6597** (hopper) – \u6f0f\u6597<\/p>\n
## \u5b89\u88c5\u65b9\u6cd5
\n1. \u5c06\u7f16\u8bd1\u597d\u7684 `RefreshLoot-1.0.0.jar` \u6587\u4ef6\u653e\u5165\u670d\u52a1\u5668\u7684 `plugins` \u6587\u4ef6\u5939
\n2. \u91cd\u542f\u670d\u52a1\u5668\u6216\u4f7f\u7528 `\/reload` \u547d\u4ee4
\n3. \u63d2\u4ef6\u4f1a\u81ea\u52a8\u751f\u6210\u914d\u7f6e\u6587\u4ef6 `config.yml`
\n4. \u6839\u636e\u9700\u8981\u4fee\u6539\u914d\u7f6e\u6587\u4ef6
\n5. \u4f7f\u7528 `\/rloot` \u547d\u4ee4\u5f00\u59cb\u5237\u65b0\u5bb9\u5668<\/p>\n
## \u91cd\u8f7d\u529f\u80fd
\n\u63d2\u4ef6\u652f\u6301\u70ed\u91cd\u8f7d\u914d\u7f6e\u6587\u4ef6\uff0c\u65e0\u9700\u91cd\u542f\u670d\u52a1\u5668\uff1a<\/p>\n
### \u4f7f\u7528\u65b9\u6cd5
\n“`
\n\/rloot reload
\n“`<\/p>\n
### \u91cd\u8f7d\u529f\u80fd\u7279\u70b9
\n– **\u5b9e\u65f6\u751f\u6548**: \u4fee\u6539\u914d\u7f6e\u6587\u4ef6\u540e\u7acb\u5373\u751f\u6548
\n– **\u5b89\u5168\u91cd\u8f7d**: \u5305\u542b\u9519\u8bef\u5904\u7406\uff0c\u91cd\u8f7d\u5931\u8d25\u4e0d\u4f1a\u5f71\u54cd\u63d2\u4ef6\u8fd0\u884c
\n– **\u8c03\u8bd5\u4fe1\u606f**: \u542f\u7528\u8c03\u8bd5\u6a21\u5f0f\u65f6\u663e\u793a\u91cd\u8f7d\u540e\u7684\u914d\u7f6e\u72b6\u6001
\n– **\u5f02\u6b65\u5904\u7406**: \u91cd\u8f7d\u8fc7\u7a0b\u4e0d\u4f1a\u963b\u585e\u670d\u52a1\u5668\u4e3b\u7ebf\u7a0b<\/p>\n
### \u91cd\u8f7d\u65f6\u673a
\n– \u4fee\u6539\u5bb9\u5668\u914d\u7f6e\u540e
\n– \u8c03\u6574\u5237\u65b0\u7269\u54c1\u5217\u8868\u540e
\n– \u66f4\u6539\u63d2\u4ef6\u8bbe\u7f6e\u540e
\n– \u66f4\u65b0\u6d88\u606f\u914d\u7f6e\u540e<\/p>\n
“`<\/p>\n
## \u6ce8\u610f\u4e8b\u9879
\n– \u63d2\u4ef6\u4f1a\u626b\u63cf\u4e16\u754c\u4e2d\u7684\u6240\u6709\u533a\u5757\u6765\u67e5\u627e\u5bb9\u5668\uff0c\u5728\u5927\u4e16\u754c\u4e2d\u53ef\u80fd\u9700\u8981\u8f83\u957f\u65f6\u95f4
\n– \u5efa\u8bae\u5728\u670d\u52a1\u5668\u8d1f\u8f7d\u8f83\u4f4e\u65f6\u4f7f\u7528\u5237\u65b0\u547d\u4ee4
\n– \u53ef\u4ee5\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u81ea\u5b9a\u4e49\u6bcf\u79cd\u5bb9\u5668\u5237\u65b0\u7684\u7269\u54c1\u548c\u6570\u91cf
\n– \u542f\u7528\u8c03\u8bd5\u6a21\u5f0f\u53ef\u4ee5\u67e5\u770b\u8be6\u7ec6\u7684\u5237\u65b0\u4fe1\u606f<\/p>\n
## \u6743\u9650
\n– `refreshloot.admin` – \u5141\u8bb8\u4f7f\u7528\u7269\u8d44\u5237\u65b0\u547d\u4ee4\uff08\u9ed8\u8ba4OP\u6743\u9650\uff09<\/p>\n","protected":false},"excerpt":{"rendered":"
A plugin for refreshing world contents item\u4e00\u4e2a\u7528\u4e8e\u5237\u65b0\u4e16\u754c\u5185\u5bb9\u5668\u7269\u54c1\u7684\u63d2\u4ef6<\/p>\n","protected":false},"featured_media":131322,"template":"","meta":{"_minecraft_slug":"refreshloot","_minecraft_project_id":"581ga5m6","_minecraft_author":"114514h","_minecraft_license":"MIT","_minecraft_downloads":81,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"refreshloot.zip","_minecraft_size_bytes":15963,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:14:01.390590Z","_minecraft_date_created":"2025-09-24T00:33:52.509044Z","_minecraft_date_modified":"2025-09-23T01:41:15.451135Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/refreshloot","_minecraft_icon_attachment_id":131322,"_minecraft_imported_at":"2026-06-07T17:48:41+00:00","_minecraft_import_hash":"aeecefd0da1ea36f4352a5a562c5c574","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,91],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-131321","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n