# DropObjects

**Repository Path**: ONori/drop-objects

## Basic Information

- **Project Name**: DropObjects
- **Description**: Unity的场景编辑插件.Drop Objects该插件允许您在Unity编辑器中将选定的物体抛到场景中，并模拟其物理效果。您还可以将物体随机聚集到一个中心点附近。

脚本可以在编辑器模式下运行,无需运行时.脚本就一个文件,方便修改和加入到项目中.
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-23
- **Last Updated**: 2025-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### Drop Objects

Drop Objects该插件允许您在Unity编辑器中将选定的物体抛到场景中，并模拟其物理效果。您还可以将物体随机聚集到一个中心点附近。

脚本可以在编辑器模式下运行,无需运行时.脚本就一个文件,方便修改和加入到项目中.

![输入图片说明](PreViewImg/DropObjects.png)
![输入图片说明](PreViewImg/DropObjects1.png)

### 使用步骤

1. **选择物体**
   
   - 在Unity编辑器的场景视图中选择您想要操作的物体。

2. **打开插件窗口**
   
   - 点击菜单栏中的 `Tools/Drop Selected Objects To Ground`，打开插件窗口。

3. **设置参数**
   
   - **Simulation Steps (模拟步数)**: 设置物理模拟的步数。数值越大，模拟越精确，但耗时也越长。
   - **Step Size (每步时间间隔)**: 设置每一步模拟的时间间隔。数值越小，模拟越精确，但耗时也越长。
   - **Convergence Radius (汇聚半径)**: 设置物体随机聚集时的半径大小。

4. **开始模拟**
   
   - 点击 `Start Simulation` 按钮，开始物理模拟。选定的物体将被抛到场景中，并模拟其物理效果。
   - 如果需要停止模拟，点击 `Stop Simulation` 按钮。

5. **随机聚集物体**
   
   - 点击 `Gather Selected Objects` 按钮，将选定的物体随机聚集到一个中心点附近。聚集的半径由 `Convergence Radius` 参数控制。

#### 注意事项

- 确保选定的物体具有碰撞体（Collider）组件，否则插件会自动添加一个。
- 插件会在模拟过程中自动添加和删除刚体（Rigidbody）组件，以确保物体能够正确地受到物理影响。
- 如果您在模拟过程中对结果不满意，可以使用Unity的撤销功能（Ctrl+Z）来恢复物体的原始位置和状态。

#### 高级功能

- **自定义汇聚半径**: 您可以通过修改 `Convergence Radius` 参数来控制物体聚集的紧密程度。
- **提前结束模拟**: 如果所有物体都已经静止，模拟会提前结束，以节省时间。

---

希望这个使用说明能够帮助您更好地理解和使用该插件。如果您有任何问题或建议，请随时联系插件开发者。



### 


### ### Drop Objects

The Drop Objects plugin allows you to throw selected objects into your scene in the Unity Editor and simulate their physics. You can also randomly gather objects around a central point.
The script can be run in editor mode, without the need for runtime. It's a single file, making it easy to modify and integrate into your project.

### Usage Instructions

1. **Select Objects**
   - In the Unity Editor's Scene view, select the objects you want to operate on.
2. **Open the Plugin Window**
   - Click on `Tools/Drop Selected Objects To Ground` in the menu bar to open the plugin window.
3. **Set Parameters**
   - **Simulation Steps**: Set the number of steps for the physics simulation. A higher number means more accuracy but takes longer.
   - **Step Size**: Set the time interval for each simulation step. A smaller value means more accuracy but takes longer.
   - **Convergence Radius**: Set the radius for random gathering of objects.
4. **Start Simulation**
   - Click the `Start Simulation` button to begin the physics simulation. The selected objects will be thrown into the scene, and their physics will be simulated.
   - If you need to stop the simulation, click the `Stop Simulation` button.
5. **Randomly Gather Objects**
   - Click the `Gather Selected Objects` button to randomly gather the selected objects around a central point. The gathering radius is controlled by the `Convergence Radius` parameter.
     
     #### Notes
- Ensure that the selected objects have a Collider component; otherwise, the plugin will automatically add one.
- The plugin will automatically add and remove Rigidbody components during the simulation to ensure that objects are correctly affected by physics.
- If you are dissatisfied with the simulation results, you can use Unity's undo function (Ctrl+Z) to restore the objects to their original position and state.
  
  #### Advanced Features
- **Customize Convergence Radius**: You can adjust the `Convergence Radius` parameter to control the density of the object gathering.
- **Early Termination of Simulation**: If all objects have come to rest, the simulation will end early to save time.

---

This user guide should help you better understand and use the plugin. If you have any questions or suggestions, please feel free to contact the plugin developer.