RefreshLoot

# RefreshLoot - Loot Refresh Plugin ## Plugin Information - **Name**: RefreshLoot - **Version**: 1.0.0 - **Author**: 114514h - **Supported Version**: Minecraft 1.21.4 - **API Version**: Spigot 1.21 ## Function Description RefreshLoot 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. ### Main Features - **Smart Refresh**: Randomly selects container slots for item refreshing. - **Container Clearing**: Option to clear all items in containers before refreshing. - **Configuration Reload**: Supports hot-reloading configuration files without server restart. - **Multiple Container Support**: Compatible with chests, trapped chests, large chests, barrels, furnaces, hoppers, etc. - **Asynchronous Processing**: Avoids server lag and ensures smooth operation. - **Highly Configurable**: Customizable refresh items, quantities, container types, etc. ## Commands - `/refreshloot` or `/rloot` - Refresh random slots in all containers across the world. - `/refreshloot reload` or `/rloot reload` - Reload the configuration file. - **Permission**: `refreshloot.admin` (default OP permission) ## Configuration Instructions ### Basic Settings ```yaml settings: debug: false # Whether to enable debug mode refresh-interval: 300 # Refresh interval in seconds random-slots: 3 # Number of random slots to refresh each time clear-containers: true # Whether to clear container contents before refreshing ``` **Container Clearing Explanation**: - `clear-containers: true` - Clears all items in containers before adding new random items. - `clear-containers: false` - Retains existing items in containers and only adds new items to randomly selected slots. - Recommended setting: `true` for better refresh results. ### Container Configuration Each container type can be configured individually: - `enabled`: Whether to enable refreshing for this container type. - `refresh-slots`: Number of slots to refresh each time. - `items`: List of possible items to refresh. ### Item Format Item configuration format: `MATERIAL:min-max` - `DIAMOND:1-3` - Diamonds, quantity 1-3. - `BREAD:2-5` - Bread, quantity 2-5. - `IRON_SWORD:1` - Iron Sword, fixed quantity of 1. **Important Note**: In Minecraft 1.21.4, the names of golden equipment have been changed: - `GOLD_HELMET` → `GOLDEN_HELMET` - `GOLD_CHESTPLATE` → `GOLDEN_CHESTPLATE` - `GOLD_LEGGINGS` → `GOLDEN_LEGGINGS` - `GOLD_BOOTS` → `GOLDEN_BOOTS` Refer to the `MATERIAL_NAMES.md` file for a detailed list of item names. ## Supported Container Types - **Chest** (chest) - Regular chest - **Trapped Chest** (trapped_chest) - Trapped chest - **Large Chest** (large_chest) - Double chest - **Barrel** (barrel) - Barrel - **Furnace** (furnace) - Furnace, blast furnace, smoker - **Hopper** (hopper) - Hopper ## Installation Method 1. Place the compiled `RefreshLoot-1.0.0.jar` file into the server's `plugins` folder. 2. Restart the server or use the `/reload` command. 3. The plugin will automatically generate a configuration file `config.yml`. 4. Modify the configuration file as needed. 5. Use the `/rloot` command to start refreshing containers. ## Reload Functionality The plugin supports hot-reloading configuration files without restarting the server: ### Usage ``` /rloot reload ``` ### Reload Features - **Instant Effect**: Changes take effect immediately after modifying the configuration file. - **Safe Reload**: Includes error handling to prevent plugin failure during reload. - **Debug Information**: Displays reload configuration status when debug mode is enabled. - **Asynchronous Processing**: Reload process does not block the server's main thread. ### When to Reload - After modifying container configurations. - After adjusting the item refresh list. - After changing plugin settings. - After updating message configurations. ## Notes - The plugin scans all chunks in the world to find containers, which may take a long time in large worlds. - It is recommended to use the refresh command during periods of low server load. - Customize items and quantities for each container type in the configuration file. - Enable debug mode to view detailed refresh information. ## Permissions - `refreshloot.admin` - Allows the use of loot refresh commands (default OP permission) # RefreshLoot - 物资刷新插件 ## 插件信息 - **名称**: RefreshLoot - **版本**: 1.0.0 - **作者**: 114514h - **支持版本**: Minecraft 1.21.4 - **API版本**: Spigot 1.21 ## 功能描述 RefreshLoot 是一个用于刷新世界内容器物品的插件。管理员可以使用命令来刷新世界内所有容器的随机槽位，包括箱子、陷阱箱、大箱子、木桶、熔炉、漏斗等。 ### 主要特性 - **智能刷新**: 随机选择容器中的槽位进行物品刷新 - **容器清除**: 可选择在刷新前清除容器中的所有物品 - **配置重载**: 支持热重载配置文件，无需重启服务器 - **多种容器支持**: 支持箱子、陷阱箱、大箱子、木桶、熔炉、漏斗等 - **异步处理**: 避免服务器卡顿，确保流畅运行 - **高度可配置**: 可自定义刷新物品、数量、容器类型等 ## 命令 - `/refreshloot` 或 `/rloot` - 刷新世界内所有容器的随机槽位 - `/refreshloot reload` 或 `/rloot reload` - 重新加