|
1 | | -# Installation |
2 | | -**This is an experimental version of nxt_blender. Save early, save often.** |
3 | | -This is a Blender addon for nxt. Note that it will access the internet to install. |
4 | | -Please read all the steps below before starting. |
5 | | - |
6 | | -_In some of our testing we found that we needed to install Python on |
7 | | -the system inorder for Blender to be able to open the NXT editor. If you |
8 | | -get strange import errors when you try to import `nxt_editor`, try |
9 | | -installing Python (same version as Blender's) on your machine._ |
10 | | - |
11 | | -### By hand (if you're familiar with pip) |
12 | | -1. Locate the path to blenders Python interpreter |
13 | | - - In Blender, you can run `sys.exec_prefix` to find the folder containing the Python executable |
14 | | -2. Open Terminal, CMD, ect. - Must have elevated permissions |
15 | | -3. Run: `/path/to/blender/python.exe -m pip install nxt-editor` |
16 | | -4. Start Blender |
17 | | -5. Open the addon manager (Edit > Preferences > Add-ons) |
18 | | -6. Click "Install" and select the `nxt_blender.py` file provided with this addon zip |
19 | | -7. To launch NXT navigate the newly created `NXT` menu and select `Open Editor` |
20 | | - |
21 | | - |
22 | | -### Automated |
23 | | -1. Launch Blender with elevated permissions |
24 | | -2. Open the addon manager (Edit > Preferences > Add-ons) |
25 | | -3. Click "Install" and select the `nxt_blender.py` file provided with this addon zip |
26 | | - * In newer versions of Blender you need to click the small arrow on the top right and select "Install from Disk". |
27 | | -4. Enable the `NXT Blender` and twirl down the addon preferences |
28 | | -5. Click `Install NXT dependencies` |
29 | | - - It is recommended to open the console window before running the script, so you can see what's happening. Window > Toggle System Console. |
30 | | - - The installation may take a minute or two, during this time Blender will be unresponsive. |
31 | | -6. Restart Blender |
32 | | - |
33 | | -# Usage |
34 | | -- Ensure the `NXT Blender` addon is enabled |
35 | | -- To launch NXT navigate the newly created `NXT` menu and select `Open Editor` |
36 | | - |
37 | | -# Updating |
38 | | -_These steps also require elevated permissions for Blender or the terminal._ |
39 | | -### By hand (if you're familiar with pip) |
40 | | -1. In terminal or cmd run: `/path/to/blender/python.exe -m pip install -U nxt-editor nxt` |
41 | | -2. Restart Blender |
42 | | - |
43 | | -### Automated |
44 | | -1. Open the addon manager (Edit > Preferences > Add-ons) |
45 | | -3. Locate the `NXT Blender` and twirl down the addon preferences |
46 | | -3. Click `Update NXT dependencies` |
47 | | -4. Restart Blender |
48 | | - |
49 | | -_or_ |
50 | | - |
51 | | -1. Navigate to the NXT menu |
52 | | -2. Click `Update NXT` |
53 | | -3. Restart Blender |
54 | | - |
55 | | -# Uninstall |
56 | | -_These steps also require elevated permissions for Blender or the terminal._ |
57 | | -### By hand (if you're familiar with pip) |
58 | | -1. Open the addon manager (Edit > Preferences > Add-ons) |
59 | | -2. Locate the `NXT Blender` and twirl down the addon preferences |
60 | | -3. Click 'Remove' |
61 | | -1. In terminal or cmd run: `/path/to/blender/python.exe -m pip uninstall nxt-editor nxt -y` |
62 | | - |
63 | | -### Automated |
64 | | -1. Open the addon manager (Edit > Preferences > Add-ons) |
65 | | -3. Locate the `NXT Blender` and twirl down the addon preferences |
66 | | -3. Click `Uninstall NXT dependencies` |
67 | | -3. When that finishes, click the 'Remove' button |
| 1 | +# NXT Blender |
| 2 | +If you're interesting in using the NXT visual editor, directly in Blender, checkout our [nxt-blender](https://github.com/nxt-dev/nxt-blender) project! |
0 commit comments