Ground Loot

This mod helps map makers or natural structure designers to spawn outdoor loot on the ground or on block surfaces, similar to PUBG or EFT.

File Details
DownloadInstall

zombovlooter-1.1.9.jar

Byunlhs1
  • R
  • Jul 10, 2026
  • 199.77 KB
  • 29
  • 1.20.1
  • Forge

File Name

zombovlooter-1.1.9.jar

Supported Versions

  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:ground-loot-1492502:8406884")
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Change Log — v1.1.9 (2026-07-10)

🆕 New Features

  • Virtual Loot Point System [Beta] — Place persistent loot spawn points in the world that periodically generate items from any loot table. Edit and manage them visually with the in-game editor wand (stick). Editor mode is Creative-only — switching to Survival or Adventure auto-exits.
  • Better Looting Compatibility [Experimental] — Items inside GroundLoot chests now appear in Better Looting's pickup overlay UI. Clicking them triggers GroundLoot's pickup logic.
  • Item Flip System — Per-item upside-down display control with horizontal/vertical flip types and configurable height offset.
  • Item Rotation Commands — Set custom yaw/pitch/roll per item for in-chest rendering, persisted across restarts.
  • Item Count Tooltip — Display item stack count in the hover tooltip.

⚡ Improvements

  • Hover name tooltip performance optimization with configurable refresh interval.
  • Multiplayer safety hardening: all client-only code properly isolated.

Commands

All commands use the /zloot prefix.

Chest Management

/zloot refresh <radius>

Search all loot chests within <radius> blocks and refresh their loot tables (re-roll loot). Progress is reported as a batch task.

  • radius: Integer, 1–128

/zloot setinterval <radius> <lootTableId> <newInterval>

Find all chests within <radius> blocks whose loot table matches lootTableId, then set their generation interval to newInterval ticks.

  • radius: Integer, 1–128
  • lootTableId: Loot table resource location (e.g. minecraft:chests/simple_dungeon)
  • newInterval: Integer, 1–1,000,000 ticks

/zloot progress

View the status of the currently running batch task.

/zloot progress start <from> <to> [lootTableId]

Start a remote batch refresh task over a cubic area defined by two corner positions. Optionally filter by loot table.

  • from/to: Block positions (e.g. 12 64 -45)
  • lootTableId: Optional loot table filter

/zloot progress pause

Pause the current batch task.

/zloot progress continue

Resume the paused batch task.

/zloot progress cancel

Cancel the current batch task.

Item Rotation

/zloot rotation set <itemId> <yaw> [pitch] [roll]

Set a custom rotation for a specific item when rendered inside a loot chest. Persisted across restarts.

  • itemId: Item resource location (e.g. minecraft:diamond)
  • yaw/pitch/roll: Float values, -180 to 180 degrees

/zloot rotation get <itemId>

View the current custom rotation for an item.

/zloot rotation remove <itemId>

Remove the custom rotation for an item (reverts to default).

/zloot rotation list

List all items with custom rotations configured.

Item Flip (Upside-Down Display)

Flip types: 0 = none, 1 = horizontal flip, 2 = vertical flip.

/zloot flip set <itemId> <type1> [type2] [type3]

Set allowed flip directions for an item. Pass up to 3 types for random selection.

  • itemId: Item resource location
  • type1/2/3: 0 (none), 1 (horizontal), or 2 (vertical)

/zloot flip get <itemId>

View flip configuration for an item.

/zloot flip remove <itemId>

Remove flip configuration.

/zloot flip list

List all items with flip configurations.

/zloot flip height set <itemId> <offset>

Set a vertical height offset for flipped items (-1.0 to 1.0 blocks).

/zloot flip height get <itemId>

View height offset for an item.

/zloot flip height remove <itemId>

Remove height offset.

Virtual Loot Points [Beta]

Loot points are persistent world positions that periodically generate items from a loot table. Use a stick as the editor wand.

Recommended mods for use together: ItemPhysic (for realistic item drop physics) and Better Looting (for the pickup overlay UI). The loot point system spawns real ItemEntities, so any mod that interacts with dropped items will work seamlessly.

/zloot point list

List all loot points in the current dimension.

/zloot point add <lootTable>

Add a loot point at the executor's current position.

  • lootTable: Loot table resource location (e.g. minecraft:chests/simple_dungeon)

/zloot point remove <id>

Remove a loot point by its UUID (first 8 characters shown in list).

/zloot point refresh <radius>

Force-refresh all loot points within <radius> blocks of the executor.

Editor Mode (Client-side, Creative-only)

Hold a stick in your main hand while in Creative mode:

  • B — Toggle editor mode (only works in Creative; auto-exits on Survival/Adventure)
  • P — Add a point at crosshair target
  • Left Click — Select a point; drag to move it
  • Right Click — Open configuration GUI (loot table, interval, one-time mode)
  • Delete — Remove selected point

Editor mode requires Creative mode + operator permissions (/op in singleplayer).

Configuration

File: config/zombovlooter-common.toml

Setting Default Description
rendering.lodDistance 32 LOD distance for multi-item simplification
rendering.itemScales.items [] Per-item scale factors
rendering.offsets.defaultGroundYOffset 0.0 Default Y offset for ground chest
rendering.offsets.defaultWallDepthOffset 0.0 Default depth offset for wall chest
gameplay.pickupDistance 5.0 Pickup interaction range
gameplay.lootPointCheckInterval 200 Lazy refresh check interval (ticks)
gameplay.lootPointSaveInterval 6000 Autosave interval (ticks)
ui.hoverNameEnabled true Enable hover name display
ui.hoverNameRefreshInterval 200 Tooltip refresh interval (ms)
flip.enableRandomFlip true Enable random item flipping
particle.particleEffectEnabled false Enable particle effects
lootPoint.enableLootPoints true Enable virtual loot point system
lootPoint.editorWandItem "minecraft:stick" Editor wand item ID
lootPoint.defaultPointInterval 24000 Default loot point refresh interval

Dependencies

  • Required: Minecraft Forge 47.4.3+ (Minecraft 1.20.1)
  • Optional: Better Looting (for compatibility overlay)

更新日志 — v1.1.9 (2026-07-10)

🆕 新功能

  • 虚拟战利品点系统 [Beta] — 在世界中放置持久的战利品生成点，定时从战利品表中生成物品。使用游戏内编辑器魔棒（木棍）进行可视化编辑和管理。编辑器模式仅限创造模式，切到生存或冒险自动退出。
  • Better Looting 兼容 [实验性] — 战利品点位内的物品现在会显示在 Better Looting 的拾取界面中，点击即可触发 GroundLoot 自身的拾取逻辑。
  • 物品翻转系统 — 逐物品控制倒置显示，支持水平/垂直翻转类型和可配置高度偏移。
  • 物品旋转命令 — 为每个物品设置在战利品点位中的渲染偏航/俯仰/翻滚角，重启后持久保存。
  • 物品数量悬浮提示 — 在鼠标悬浮提示中显示物品堆叠数量。

⚡ 改进

  • 悬浮提示渲染性能优化，增加可配置刷新间隔。
  • 多人游戏安全加固：所有客户端专用代码正确隔离。

命令说明

所有命令使用 /zloot 前缀。

点位管理

/zloot refresh <半径>

搜索执行者周围 <半径> 格内的所有战利品点位，刷新其战利品表。进度以批量任务形式报告。

  • 半径: 整数，1–128

/zloot setinterval <半径> <战利品表ID> <新间隔>

在 <半径> 范围内查找所有匹配指定战利品表 ID 的点位，将其生成间隔设置为 <新间隔> tick。

  • 半径: 整数，1–128
  • 战利品表ID: 战利品表资源路径（例如 minecraft:chests/simple_dungeon）
  • 新间隔: 整数，1–1,000,000 tick

/zloot progress

查看当前批量任务的运行状态。

/zloot progress start <起点> <终点> [战利品表ID]

在两个方块坐标定义的立方体区域内启动远程批量刷新任务。可选按战利品表过滤。

  • 起点/终点: 方块坐标（例如 12 64 -45）
  • 战利品表ID: 可选的战利品表过滤

/zloot progress pause

暂停当前批量任务。

/zloot progress continue

恢复已暂停的批量任务。

/zloot progress cancel

取消当前批量任务。

物品旋转

/zloot rotation set <物品ID> <偏航角> [俯仰角] [翻滚角]

为指定物品在战利品点位中的渲染设置自定义旋转角度。重启后持久保存。

  • 物品ID: 物品资源路径（例如 minecraft:diamond）
  • 偏航角/俯仰角/翻滚角: 浮点数，-180 到 180 度

/zloot rotation get <物品ID>

查看物品当前的自定义旋转角度。

/zloot rotation remove <物品ID>

移除物品的自定义旋转（恢复默认）。

/zloot rotation list

列出所有配置了自定义旋转的物品。

物品翻转（倒置显示）

翻转类型：0 = 无翻转，1 = 水平翻转，2 = 垂直翻转。

/zloot flip set <物品ID> <类型1> [类型2] [类型3]

设置物品允许的翻转方向。最多传入 3 个类型，系统会随机选择。

  • 物品ID: 物品资源路径
  • 类型1/2/3: 0（无）、1（水平）或 2（垂直）

/zloot flip get <物品ID>

查看物品的翻转配置。

/zloot flip remove <物品ID>

移除翻转配置。

/zloot flip list

列出所有配置了翻转的物品。

/zloot flip height set <物品ID> <偏移值>

为翻转物品设置垂直高度偏移（-1.0 到 1.0 格）。

/zloot flip height get <物品ID>

查看物品的高度偏移值。

/zloot flip height remove <物品ID>

移除高度偏移值。

虚拟战利品点 [Beta]

战利品点是世界中持久的坐标位置，定时从战利品表生成物品。使用 木棍 作为编辑器魔棒。

推荐配合使用的 Mod： ItemPhysic（真实掉落物物理效果）和 Better Looting（拾取覆盖界面）。战利品点系统生成的掉落物是真实 ItemEntity，任何与掉落物交互的 Mod 均可无缝配合。

/zloot point list

列出当前维度中的所有战利品点。

/zloot point add <战利品表>

在执行者当前位置添加战利品点。

  • 战利品表: 战利品表资源路径（例如 minecraft:chests/simple_dungeon）

/zloot point remove <ID>

按 UUID 移除战利品点（列表中显示前 8 个字符）。

/zloot point refresh <半径>

强制刷新执行者周围 <半径> 格内的所有战利品点。

编辑器模式（客户端，仅创造模式）

主手持 木棍，并处于创造模式：

  • B — 切换编辑器模式（仅创造模式可用，切到生存/冒险自动退出）
  • P — 在准星目标位置添加战利品点
  • 左键 — 选中战利品点；拖拽移动
  • 右键 — 打开配置界面（战利品表、间隔、一次性模式）
  • Delete — 删除选中的战利品点

编辑器模式需要创造模式 + 服务器管理员权限（单人游戏中使用 /op）。

配置文件

文件路径：config/zombovlooter-common.toml

配置项 默认值 说明
rendering.lodDistance 32 多物品简化的 LOD 距离
rendering.itemScales.items [] 逐物品缩放比例
rendering.offsets.defaultGroundYOffset 0.0 地面点位默认 Y 偏移
rendering.offsets.defaultWallDepthOffset 0.0 墙面点位默认深度偏移
gameplay.pickupDistance 5.0 拾取交互范围
gameplay.lootPointCheckInterval 200 惰性刷新检查间隔（tick）
gameplay.lootPointSaveInterval 6000 自动保存间隔（tick）
ui.hoverNameEnabled true 启用悬浮名称显示
ui.hoverNameRefreshInterval 200 悬浮提示刷新间隔（毫秒）
flip.enableRandomFlip true 启用随机物品翻转
particle.particleEffectEnabled false 启用粒子效果
lootPoint.enableLootPoints true 启用虚拟战利品点系统
lootPoint.editorWandItem "minecraft:stick" 编辑器魔棒物品 ID
lootPoint.defaultPointInterval 24000 默认战利品点刷新间隔

依赖

  • 必需: Minecraft Forge 47.4.3+ (Minecraft 1.20.1)
  • 可选: Better Looting（兼容层功能）