Knowledge Base

Installing Modelur in SketchUp

You can install Modelur in several ways:

  1. Using universal RBZ installer.
  2. Via Extension Warehouse.
  3. Via SketchUcation Plugin Store.

In order to ensure you install the latest version of Modelur, we recommend you to use option #1 (universal RBZ installer).

To install a SketchUp Ruby plugin in RBZ format use the standard SketchUp installation procedure:

  1. We recommend logging into your computer as an admin before installing any Ruby scripts. This will make the installation go more smoothly and ensure that files get installed in the proper places.
  2. Select Window → Extension Manager (Windows) or SketchUp → Extension Manager (OS X). The Preferences dialog box is displayed.
  3. Click on Extensions. The Extensions panel is displayed.
  4. Click on the Install Extension button. The Open dialog box is displayed.
  5. Locate the Ruby zip file to install (.RBZ).
  6. Click on the Open button. The Ruby plugin appears in the list of extensions.
  7. Once installed, Modelur toolbar will appear in SketchUp. If not, you can turn it on via SketchUp menu Toolbars…> Modelur

Modelur Location #

Upon installation, Modelur is saved to Sketchup’s default Plugins folder, which resides at different locations, depending on the Operating System and version of SketchUp you use:

  • On Windows: %appdata%\SketchUp\SketchUp ####\SketchUp\Plugins\
  • On OS X~/Library/Application Support/SketchUp ####/SketchUp/Plugins/

Windows %appdata% points to C:\Users\YOUR USERNAME\AppData\Roaming\ folder. You can use it in eg. Windows Explorer.

Preferences Location #

Files containing your Modelur preferences are stored

  • On Windows%appdata%\Modelur
  • On OS X~/Library/Application Support/Modelur

All preferences are stored using standard JSON data-interchange format. Upon Modelur upgrade, these files will be automatically updated. In case you edit them manually and something doesn’t work, you can always restore them using the command available via SketchUp’s menu Extensions → Modelur → Restore default settings.

Installation problems #

If you encounter any problems with your Modelur installation, please do the following:

On Windows: #

  1. Delete \Modelur folder and modelur.rb file from \Roaming\SketchUp\SketchUp ####\SketchUp\Plugins\.
  2. Delete \Modelur folder from C:\Users\YOUR USERNAME\AppData\Roaming\ (if it exists).
  3. Install the newest RBZ version of Modelur and try to license it (make sure you are online).

On OS X: #

  1. Delete \Modelur folder and modelur.rb file from ~/Library/Application Support/SketchUp ####/SketchUp/Plugins/.
  2. Delete \Modelur folder from ~/Library/Application Support/Modelur/ (if it exists).
  3. Install the newest RBZ version of Modelur and try to license it (make sure you are online).