Description
Overview
This mod is designed for map makers, adding a transparent carpet-like loot block. You can set refresh intervals to create repeatable exposed loot points similar to those in PUBG or extraction shooters, or enable one-time mode for other scenarios. The refresh mechanism relies on random ticks and world time, ensuring low performance impact.
概述
这是一个为地图制作者设计的模组，添加了透明地毯状的战利品方块。可以通过设置刷新时间间隔实现类似PUBG或者搜索撤离游戏中可重复刷新的裸露物资刷新点，也可以通过设置一次性刷新模式满足其他场景的需要。该mod使用的刷新判定方法为游戏随机刻以及世界时间，对性能占用较低。
Usage – Obtaining and Basic Setup
Use /give zombovlooter:loot_chest or /give zombovlooter:wall_loot_chest to obtain the block. After placing, sneak + right-click the block (or use an NBT editor like IBE) to edit its properties. You can configure the loot table ID, refresh interval, and one-time mode to define the loot behavior.
Default mode is repeatable refresh. If marked as one-time mode, the block will not refresh naturally after completing one refresh, and will automatically disappear when it contains no items.
When holding the loot block item, surrounding loot blocks are highlighted: red for different loot table IDs, green for the same ID, helping map makers locate spawn points.
用法 – 获取以及基础用法
使用 /give zombovlooter:loot_chest 或 /give zombovlooter:wall_loot_chest 获取方块，放置后潜行右键点击方块（或使用 IBE 等NBT编辑器）编辑方块属性，可通过编辑方块的战利品表ID、刷新间隔以及是否一次性模式来定义该点的物品刷新行为。
默认为重复刷新模式；若标记为一次性模式，则方块将在完成一次刷新后不再自然刷新，当方块内不含物品时，方块将自动消失
手持战利品方块物品时，可将周围的战利品方块以颜色框标记出来，不同战利品表ID的为红色，相同战利品表ID的为绿色，方便制作者寻找刷新点。
Commands
/zloot refresh <radius>
Forces all loot blocks within the specified radius (1~128 blocks) around the player to generate loot immediately (regardless of one-time mode).
Example: /zloot refresh 16
/zloot setinterval <radius> <lootTableID> <newInterval>
Changes the refresh interval for all blocks with matching loot table ID within the radius, and resets their last refresh time to the current game time.
Parameters: radius (1~128), lootTableID (e.g., minecraft:chests/simple_dungeon), newInterval (ticks, 1~1,000,000).
Example: /zloot setinterval 32 "minecraft:chests/simple_dungeon" 12000
/zloot progress start x1 y1 z1 x2 y2 z2 [lootTableID]
Refreshes all loot blocks in the defined cuboid area (optionally filtered by loot table ID). The task runs in the background to avoid freezing the game, but avoid extremely large areas.
Parameters: two corner coordinates, optional lootTableID.
Example: /zloot progress start 100 64 100 120 80 120 "minecraft:chests/simple_dungeon"
/zloot progress
Shows the status of the currently running task (type, progress, state).
/zloot progress pause
Pauses the ongoing task.
/zloot progress continue
Resumes a paused task.
/zloot progress cancel
Cancels the current task (cannot be resumed).
命令行
/zloot refresh <半径>
作用：刷新以玩家为中心指定半径内的所有战利品方块（不区分一次性模式），立即执行一次战利品生成
参数：半径 – 整数，范围 1~128（方块距离）
示例：/zloot refresh 16
/zloot setinterval <半径> <战利品表ID> <新的时间间隔>
作用：修改半径内所有战利品表 ID 匹配的方块的刷新间隔，并将最后刷新时间重置为当前游戏时间
参数：半径 (1~128)，战利品表ID（如 minecraft:chests/simple_dungeon），新间隔 (刻，1~1,000,000)
示例：/zloot setinterval 32 "minecraft:chests/simple_dungeon" 12000
/zloot progress start x1 y1 z1 x2 y2 z2 <战利品表ID>（可选）
作用：对指定立方体区域内的所有战利品方块执行一次刷新（可选按战利品表 ID 过滤）。任务将在后台分批处理（不建议设置范围过大，否则容易卡死造成一段时间的Tick冻结）
参数：两个角坐标，可选战利品表ID
示例：/zloot progress start 100 64 100 120 80 120 "minecraft:chests/simple_dungeon"
/zloot progress
作用：查看当前正在进行的任务状态（类型、进度、状态）
/zloot progress pause
作用：暂停当前正在执行的任务
/zloot progress continue
作用：恢复被暂停的任务
/zloot progress cancel
作用：取消当前任务（不可恢复）