KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

TCS-PhysicsDropper

★ 39 Open GitHub ↗

Drops Objects In Edit Mode

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Physics Dropper Overlay for Unity
<img src="docs~/images/ExampleGif_1.gif" alt="Physics Dropper in Action" width="300" /><img src="docs~/images/ExampleGif_2.gif" alt="Physics Dropper in Action" width="300" />

[![Join our Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)](https://discord.gg/knwtcq3N2a)
![Discord](https://img.shields.io/discord/1047781241010794506)
![GitHub Forks](https://img.shields.io/github/forks/Ddemon26/TCS-PhysicsDropper)
![GitHub Contributors](https://img.shields.io/github/contributors/Ddemon26/TCS-PhysicsDropper)
![GitHub Stars](https://img.shields.io/github/stars/Ddemon26/TCS-PhysicsDropper)
![GitHub Repo Size](https://img.shields.io/github/repo-size/Ddemon26/TCS-PhysicsDropper)

## Overview

The **Physics Dropper Overlay** is a tool for Unity developers that allows efficient, physics-based placement of GameObjects in Unity's SceneView. By using simulated physics, this tool streamlines the positioning process, enabling natural placements without manual adjustments.

Using the Physics Dropper Overlay adds realism to your scene by leveraging Unity's physics engine. It is especially useful for creating dynamic environments, setting up test cases, or managing multiple objects, speeding up development while maintaining precision.

## Key Features

- **SceneView Integration**: Provides a seamless overlay within Unity's SceneView, allowing quick access to the dropper tool.
- **Toolbar Access**: Access the dropper via a dedicated toolbar button.
- **Configurable Stopping Criteria**: Choose when the simulation should stop based on time elapsed or velocity threshold.
- **Automatic Component Management**: Automatically adds necessary physics components like Colliders and Rigidbodies if absent.
- **MeshCollider Convex Settings Support**: Adjusts MeshColliders to be compatible with dynamic physics simulations.
- **Max Simulation Time Setting**: Allows users to define a maximum simulation duration to avoid endless simulations.

## How It Works

The **Physics Dropper Overlay** simplifies arranging GameObjects in Unity by using simulated physics within the editor. It ensures that each selected GameObject is equipped with necessary physics components and manages the simulation process in real time.

Workflow steps:

1. **Select GameObjects**: Highlight the GameObjects in the SceneView that you want to drop.
2. **Activate Dropper**: Click the custom toolbar button to initiate the dropper. This starts the physics simulation.
3. **Simulation Criteria**: The drop continues until one of the stopping criteria is satisfied:
   - **Time After Impact**: The simulation persists for a set time after the first contact.
   - **Velocity Threshold**: The simulation stops when the velocity falls below a predefined threshold.
4. **Automatic Cleanup**: The tool reverts any temporary components to return the GameObjects to their original state once the simulation is complete.

## Installation

```
https://github.com/Ddemon26/TCS-PhysicsDropper.git
```

To install the Physics Dropper Overlay:

1. Clone or download this repository.
2. Add the `PhysicsDropperOverlay.cs` script to your Unity project's `Editor` directory.
3. Launch Unity, and the Physics Dropper Overlay will be available within the SceneView.

## Usage

To use the Physics Dropper Overlay:

1. **Select GameObjects**: In the SceneView, select the GameObjects to drop.
2. **Click the Toolbar Button**: Locate and click the `PhysicsDropToolbarButton` to open the dropper interface.
3. **Configure Drop Settings**:
   - **Stopping Criteria**: Set criteria for ending the simulation:
     - **Time After Impact**: Duration after landing.
     - **Velocity Threshold**: Velocity below which the simulation stops.
   - **Maximum Simulation Time**: Set a time limit for the simulation.
4. **Start Simulation**: Click to initiate the drop. The objects will fall and interact naturally based on physics.

### Example Scenario

For designing a forest environment, instead of manually adjusting rocks and branches on uneven terrain, use the Physics Dropper tool to simulate realistic drops.

## <img src="docs~/images/IconImage.png" alt="Physics Dropper in Action" width="64" /> Toolbar Button and Interface

- **PhysicsDropToolbarButton**: The primary way to interact with the Physics Dropper. The button in Unity's SceneView toolbar allows you to start, configure, and stop the physics simulation.
- **PhysicsDropperWindow**: A popup window for modifying parameters like stopping criteria and maximum simulation time.

## Contributing

Contributions to improve the Physics Dropper Overlay are welcome. If you have feature suggestions or optimizations, feel free to fork the repository, make changes, and submit a pull request.

### Local Development

1. Fork this repository.
2. Create a new branch (`git checkout -b feature/NewFeature`).
3. Commit your changes (`git commit -m 'Add new feature'`).
4. Push to the branch (`git push origin feature/NewFeature`).
5. Open a Pull Request for review.

## Support

If you encounter issues or have questions, join our Discord community using the link at the top of this README.

## License

This project is licensed under the MIT License, allowing free use, modification, and distribution.

---

For more information, refer to the comments within the codebase or create an issue in the GitHub repository. Happy coding!

TCS-PhysicsDropper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README