- 版权类型
- 原创
- 插件中文名称
- 真实物品掉落
- 插件英文名称
- RealItemDrop
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- Packetevents
- 适配版本（Java）
- 1.21
RealItemDrop 插件说明文档
一、插件简介
RealItemDrop 是一款基于 Paper 1.21+ 的轻量级插件，利用 PacketEvents 在不放置真实实体的前提下，为玩家呈现“物品展示框”掉落物视觉效果，并支持左右键拾取、异步批量生成、一键清除等功能。
（PS: 插件目前只适用于1.21.4，其他版本会有不同程度的使用问题，比如说网络协议错误等，我有时间会解决这个问题）
---
二、核心功能
幽灵展示框 仅发送 spawn/despawn 数据包，无实体、无卡顿
一键清屏 /dfc 瞬间抹除所有展示框（内存 + 客户端）
异步批量 /dropframe <材质> [数量] [半径] 非阻塞生成上千框架
离线自动清理 玩家退出时自动销毁其所有幽灵框
零依赖 仅需 Paper 1.21+ 与 PacketEvents
---
三、命令列表
指令 别名 权限 说明
/dropframe <mat> [n] [r] /df 无 异步生成 n 个幽灵框，半径 r（上限 5000/100）
/dropframeclear [all] /dfc dropframe.clear.all（仅 all） 清除自己（或全员）的全部幽灵框
---
四、技术亮点
1. 纯发包实现
- 客户端可见，服务器 0 实体、0 tick 开销。
- 支持 重叠堆放，每格可放多个框。
2. 异步分帧生成
- 只在 已加载区块 内生成，绝不触发 chunk 加载。
- 每 200 个让出 1 tick，服务器全程可响应。
3. 批量摧毁优化
- 一键清屏时 合并为单个摧毁包，网络流量最小化。
---
五、性能实测
同时生成超1w的物品在地上展示，TPS无明显波动（注意测试是本地测试，所以玩家只有我一个，实际情况请按照你自己的服务器为准）
---
六、实际演示图片
一、插件简介
RealItemDrop 是一款基于 Paper 1.21+ 的轻量级插件，利用 PacketEvents 在不放置真实实体的前提下，为玩家呈现“物品展示框”掉落物视觉效果，并支持左右键拾取、异步批量生成、一键清除等功能。
（PS: 插件目前只适用于1.21.4，其他版本会有不同程度的使用问题，比如说网络协议错误等，我有时间会解决这个问题）
---
二、核心功能
幽灵展示框 仅发送 spawn/despawn 数据包，无实体、无卡顿 一键清屏 /dfc 瞬间抹除所有展示框（内存 + 客户端） 异步批量 /dropframe <材质> [数量] [半径] 非阻塞生成上千框架 离线自动清理 玩家退出时自动销毁其所有幽灵框 零依赖 仅需 Paper 1.21+ 与 PacketEvents---
三、命令列表
指令 别名 权限 说明
/dropframe <mat> [n] [r] /df 无 异步生成 n 个幽灵框，半径 r（上限 5000/100）
/dropframeclear [all] /dfc dropframe.clear.all（仅 all） 清除自己（或全员）的全部幽灵框
---
四、技术亮点
1. 纯发包实现
- 客户端可见，服务器 0 实体、0 tick 开销。
- 支持 重叠堆放，每格可放多个框。
2. 异步分帧生成
- 只在 已加载区块 内生成，绝不触发 chunk 加载。
- 每 200 个让出 1 tick，服务器全程可响应。
3. 批量摧毁优化
- 一键清屏时 合并为单个摧毁包，网络流量最小化。
---
五、性能实测
---
六、实际演示图片
