English Instructions For Installing And Using Model Loader Plugin:
IMPORTANT - THIS REQUIRES ANOTHER PLUGIN TO FUNCTION.
ToolsAPI Download
A. There's two important steps to installing the ToolsAPI plugin.
1. The first being that you have to extract the ToolsAPI files from the downloaded file. This should be extracted to your plugins folder which will be located somewhere like this: "C:\Program Files (x86)\Steam\steamapps\common\RisingWorld\_New Version\Plugins", alternatively if you're playing through Steam you can right click Rising World in your Steam Library and then "Browse Local Files" which will open the file location, making it easier to find the plugins folder.
2. Once you extract the files you need to rename the ToolsAPI folder to ensure that it is the first plugin loaded. You can do this by simply renaming the folder to something like .ToolsAPI or 0ToolsAPI . This makes sure it's the first folder in alphabetical order so the game knows to load this first.
-----------------------------------
Model Loader Plugin Installation and Usage:
1. This first step like with all plugins is to download the plugin and extract it to the Plugins folder. It gets extracted to the same Plugins folder that you just used for the ToolsAPI Plugin.
2. You have to download the 3D models you want to use and extract those to the: "C:\Program Files (x86)\Steam\steamapps\common\RisingWorld\_New Version\Plugins\ModelLoader\Model3D" folder. It's easier to give each 3Dmodel it's own subfolder in the Model3D folder. The usable 3D model formats are .obj and .fbx
ie.
- ModelLoader
-Model3D
-Bonsai Tree
3. Launch the game and load the world you want to import the 3D model in
4. Press "T" to open the chat window (Not ~ for the Console Commands) and type /ml and press enter.
5. This will bring up the 3D model loader screen Noci has posted in their first post.
6. The first step is to select the 3D model that you want to use from the left side menu. The second step is to select the texture file you want to use, this will typically be either a .png or .jpg file and is selected by left clicking on the file name. The third step is to select the normal map, if the 3D model has one (if not click the slider on the normal map preview window) and then right click on the normal map file name to select it.
7. Once all three steps from step 6 are done the Confirm button at the bottom of the menu will highlight and be clickable. Depending on this size of the model, your system, etc. it can take several seconds or more for the model to finish loading in.
8. You can place, rotate, scale the 3D model with the following controls:
Right Mouse Button = Places 3D model
Left Mouse Button = Cancels Placement
Hold shift and press arrow keys, page up / page down = Axis Scaling
Press - or + (On Numpad) = Fixed Aspect scaling
Shift + Backspace = Resets Scaling
Arrow Keys, Page Up / Page Down = Rotation
Backspace = Resets Rotation
Point Cursor at 3D Model and hold "F" = Options Radial Menu
=================================
Common PLUGIN Issue:
Depending on the extraction program you're using it can sometimes create a double folder when extracting the files:
ie.
-ToolsAPI
-ToolsAPI
When the files were only supposed to go into the first ToolsAPI folder in our example. When this happens it can prevent plugins from being able to load properly. to solve this, simply move the files from the second ToolsAPI folder to the top ToolsAPI folder in our example.
===============================
===============================
Hopes this helps for anyone that was having issues understanding the machine translation.
