Skip to content

Commit

Permalink
Updated setup for Windows
Browse files Browse the repository at this point in the history
  • Loading branch information
cybereality committed Jul 6, 2022
1 parent 700fac8 commit f0e5473
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 1 deletion.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ For manual install, download the `addons` folder from this repository and copy i
* To enable the plug-in, click `Project` `Project Settings` `Plugins` and check `Enable` next to the `Godot Space Mouse` entry.
* Use the `Space` dock in the editor to adjust speed or change to object or camera control.
* The 3Dconnexion driver is not needed on any OS. However, if you're on Windows, and have the driver installed, please first open the Godot editor, then open the 3Dconnexion app. You'll see a pop-up with the name of the Godot editor executable. Click `Advanced Settings`, then disable all navigation and zoom controls, as these can conflict with the viewport controls.
* If you are using a wireless Space Mouse, on Windows, you'll have to make sure only the correct HID device is enabled for the plug-in. First do a Windows Update, and check the Optional Updates for the 3Dconnexion driver. Then open `Device Manager`, click `View` `Devices by container`. You should see an entry for `3Dconnexion Universal Receiver` and underneth `3Dconnexion Wireless Device` which is the driver we just installed. Below that, there may be around 6 entries for `HID-compliant vendor-defined device`. Right-click on each of those and disable them. You will have to click `Yes`, but don't choose `Restart`. Wait until you have disabled all those on the list, then restart your machine.
![Screenshot](screenshots/Godot_Space_Mouse_Win_Fix.jpg)
* On Linux you will need to allow HID access via udev rules. First, download the file `70-space-mouse.rules` from the `addons/spacemouse/bin/` folder and place this file in the correct directory for your distro, such as `/etc/udev/rules.d/`. Then replug your Space Mouse hardware or run `sudo udevadm control --reload-rules && sudo udevadm trigger` to update the rules.
* For macOS, you must uninstall the 3Dconnexion drivers, as they're incompatible with the plug-in.
* Please note, a Space Mouse or Space Navigator hardware device from 3Dconnexion is required.
Expand Down
2 changes: 1 addition & 1 deletion addons/spacemouse/plugin.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@
name="Godot Space Mouse"
description="Enables 6 degrees of freedom control for the viewport camera in the Godot editor. Requires a SpaceMouse hardware device from 3Dconnexion."
author="Andres Hernandez"
version="1.4.2"
version="1.4.3"
script="SpaceMouse.gd"
Binary file added screenshots/Godot_Space_Mouse_Win_Fix.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f0e5473

Please sign in to comment.