{"id":20247314,"url":"https://github.com/alvgaona/unity-drone-controller","last_synced_at":"2025-04-10T21:32:10.904Z","repository":{"id":128890731,"uuid":"318886158","full_name":"alvgaona/unity-drone-controller","owner":"alvgaona","description":"A Unity-based project aimed to control a DJI F450 drone.","archived":false,"fork":false,"pushed_at":"2020-12-06T00:44:40.000Z","size":46584,"stargazers_count":33,"open_issues_count":1,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T18:52:35.006Z","etag":null,"topics":["dji","ps4-controller","robotics","simulation","uav","unity"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alvgaona.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-12-05T20:48:08.000Z","updated_at":"2025-03-18T01:09:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"fced6887-0cc8-42c6-bf47-a3527d7e91e1","html_url":"https://github.com/alvgaona/unity-drone-controller","commit_stats":{"total_commits":7,"total_committers":1,"mean_commits":7.0,"dds":0.0,"last_synced_commit":"e8ebe6e5933cf994298609e3ae3d1926480d6a08"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvgaona%2Funity-drone-controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvgaona%2Funity-drone-controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvgaona%2Funity-drone-controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvgaona%2Funity-drone-controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alvgaona","download_url":"https://codeload.github.com/alvgaona/unity-drone-controller/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248301509,"owners_count":21080903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dji","ps4-controller","robotics","simulation","uav","unity"],"created_at":"2024-11-14T09:36:46.515Z","updated_at":"2025-04-10T21:32:10.844Z","avatar_url":"https://github.com/alvgaona.png","language":"C#","readme":"# Unity Drone Controller\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"images/dji.gif\"/\u003e\u003c/p\u003e\n\nThe idea behind this project is to share a set-up for robotics simulation in Unity. \nAt the time of this writing, this is simply a Unity-based drone controller—in particular a DJI F450 controller written in C#—which can be controlled\nby any joystick you'd like; although, it's been only tested with a PS4 controller (it's pretty easy to set up a different one).\n\nKeep in mind it's a very basic implementation, inspired by other people, in which you can control the drone's altitude and orientation with the joystick sticks.\nFeel free to improve it!\n\n## Requirements\n\nTo start running this project you need to fulfil a few steps.\nFirstly, you've got to have Unity installed (obviously), and secondly, you should download the `Art` for the models.\nThere are only two models in the scene, the DJI F450 drone and the ground to collide with.\n\n### DJI F450 Drone\n\nThe model was downloaded from [here][3DWarehouse DJI F450] (thanks Matheus Monteiro).\nHowever, there are some caveats to use the model directly.\nIf you import either Collada or SketchUp files, the model won't be complete. \nSo I fixed it and exported a Unity package based on a FBX file. Download it from this [link][F450 Unity package].\n\n![DJI F450 Image]\n\n### Ground\n\nThe ground is basically a 2D `GameObject` (a plane) with some texture on it.\nBe sure to download the materials and the texture folders from [here][Ground Material/Textures].\nYou can place both `Material/` and `Textures/` folders within `Art/Ground` for instance.\nThanks [Indie Pixel] for the cool textures.\n\n## PS4 Controller\n\nThe PS4 controller is connected directly by pairing it with a computer.\nOnce you've confirmed that the OS has recognized the device you just need to install the Unity Package called \"Input System\".\nIt can be installed via the package manager in Unity.\n\n![New Input System Image]\n\nThe configuration for the drone inputs can be found this [directory][Drone Inputs].\n\n## Future work\n\nThere are a few things that can be done based on this project.\n\n1. Improve the physics of the drone.\n2. Integrate Unity with ROS and implement algorithms to automatically control the drone (e.g. hovering).\n3. Add a camera view to the GoPro Hero 4.\n4. Create a more realistic scene around the model to make a better simulation.\n\n\u003c!-- Images --\u003e\n[DJI F450 Image]: images/dji-f450.png\n[New Input System Image]: images/new-input-system.png\n\n\u003c!-- Internal links --\u003e\n[Drone Inputs]: drone_controller/Assets/F450_Controller/Input/F450_Inputs.inputactions\n\n\u003c!-- External links --\u003e\n[Indie Pixel]: https://www.youtube.com/channel/UC7P6olyswpgJlElZA6RXUNQ\n[F450 Unity package]: bit.ly/3qasto4\n[Ground Material/Textures]: https://bit.ly/2ImVLyU\n[3DWarehouse DJI F450]: https://3dwarehouse.sketchup.com/model/c69f18fa-06b0-4074-bdf5-e383c0772c44/DJI-F450-Quadcopter\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvgaona%2Funity-drone-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falvgaona%2Funity-drone-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvgaona%2Funity-drone-controller/lists"}