MODELUR 2026.10.22 README

-------------------------------------------------------------------------------
                             ~ TABLE OF CONTENTS ~
-------------------------------------------------------------------------------

1.  WHAT IS MODELUR?

2.  SYSTEM REQUIREMENTS

3.  SETUP AND CONFIGURATION
    3.1  Installation Instructions
    3.2  Uninstall Instructions

4.  WHAT'S NEW (version history)

5.  KNOWN LIMITATIONS

6.  GETTING HELP
    6.1  User Guide
    6.2  Video Tutorials
    6.3  Support

7.  PURCHASING MODELUR

8.  LICENSE AND LEGAL DOCUMENTS

9.  CONTACT INFORMATION

-------------------------------------------------------------------------------
1.  WHAT IS MODELUR?
-------------------------------------------------------------------------------

Modelur is a parametric urban design tool. It is implemented as a plug-in for
Trimble SketchUp.

With Modelur you can:
- rapidly design built environment,
- respond quickly to changed conditions of planned site,
- automatically change built environment,
- quickly create different variants of urban design solution,
- avoid mistakes issued by wrong building articulation and
- have continuous supervision about achieved urban control values.

-------------------------------------------------------------------------------
2. SYSTEM REQUIREMENTS
-------------------------------------------------------------------------------

To run Modelur, your system must meet these specifications:
- Microsoft Windows or Mac OS,
- Trimble SketchUp v2023 or higher.

-------------------------------------------------------------------------------
3.  SETUP AND CONFIGURATION
-------------------------------------------------------------------------------

3.1 Installation Instructions

There are several ways you can install Modelur:
- Using universal RBZ installer.
- Via Extension Warehouse.
- Via SketchUcation Plugin Store.

To install a SketchUp Ruby plugin in RBZ format use the standard SketchUp
installation procedure:
1. In SketchUp, select Extensions > Extension Manager. The Extension Manager
   window appears.
2. Click the Install Extension button.
3. In the Open dialog box that appears, navigate to the .rbz file saved to your
   computer, select the file, and click OK (Microsoft Windows) or Open (Mac OS
   X).
4. When SketchUp warns you about installing only extensions from trusted
   sources, click Yes to proceed and install your extension. (This assumes you
   do, in fact, trust the source of your extension.)

3.2 Uninstall Instructions

To uninstall Modelur from your computer:
- Delete Modelur.rb and /Modelur directory from SketchUp's /Plugins directory.

To temporarily disable Modelur, uncheck it via SketchUp menu Extensions >
ManageExtension.

-------------------------------------------------------------------------------
4.  WHAT'S NEW
-------------------------------------------------------------------------------

2026.10.22

- Note: AgiliCity codebase moved to monorepo (includes new issue/MR numbering).
- Enhancement: Support Modelur on SketchUp 2027 (#86).
- Enhancement: Update Excel LiveSync when object's layer changes (#87).
- Enhancement: Added Tag (Layer) parent folder path to Excel LiveSync / Modelur
               Data Table (#89).
- Enhancement: Added GisBridge (including support for different CRSes and SHP
               import)(#32).
- Enhancement: Added Land Use specs to GIS mapping setting export, and using it
               when Land Use doesn't exist in active model (#95).
- Enhancement: Allow more granular construction/demolition date specification
               (according to ISO 8601 specification) - YYYY or YYYY-MM-DD (#81).
- Enhancement: Import Complex Buildings (#60).
- Bugfix: Prevent finding layers for deleted objects (#114).
- Bugfix: Fix TypeError on deleted Group in OnSuperiorsChange (#107).
- Bugfix: Validating non-existent SKP model on MacOS, fix switching different
          models (#106).
- Bugfix: (Re)store UI sidebar tools (regression from 2026.05.21).
- Bugfix: Prevent starting new operation when another operation is still open
          (#104).
- Bugfix: Prevent checking Faces that were not created (#103).

2026.05.21

- Enhancement: Make sure Building groups are on same level before creating
               Complex Building (#1262).
- Enhancement: Make UI creation independent of Context translations (#1257).
- Enhancement: Remove Material of deleted Use to fix pasting deleted Use later
               (#1283).
- Enhancement: Add Syncfusion Data Grid functionality, which is also used to
               modify Excel LiveSync layout (!1154).
- Bugfix: Fix bugsplat after failed license validation in event handlers
          (#1250).
- Bugfix: Prevent "invalid instance path - deleted elements" error when doubling
          storeys or changing blocks (#1268).
- Bugfix: Trying to save closed Excel file (#1222).
- Bugfix: Prevent error when Use dictionary doesn't contain Use Name (#1252).
- Bugfix: Fix handling of incomplete pasted Use Materials (#1277).
- Bugfix: Handle references to Groups deleted by third-party extensions (#1271).
- Bugfix: Recreate instance path when Modelur Building's instance path becomes
          invalid (#1278).
- Bugfix: Prevent "cannot remove an instance in the active editing path" error
          when initializing Modelur while inside a Group (#1251).
- Bugfix: Prevent "reference to deleted Entities" error when removing observer
          (#1253).
- Bugfix: Prevent crash during model initialization when materials contain
          invalid/nil entries (#1254).
- Bugfix: Handle error when Building Parts can't be read properly (#1256).
- Bugfix: Fix detection of registered Modelur Objects (#1261).
- Bugfix: Fixed undo of placing Component Instances (#1281).
- Bugfix: Ensure all GIS contexts are correctly initialized before importing GIS
          data (#1089).
- Bugfix: Reconnect Material on deleted Use undo (#1282).
- Bugfix: Run Massing Generator also when Mix of Uses is not defined, and fix
          Single Use massing generation (#1247).
- Bugfix: Fix calling Redo after initialization Undo (#1246).

2025.12.30

- Enhancement: Allow show/hide Modelur objects on Free plan (#1239).
- Enhancement: Check model consistency when loading Modelur (#1132).
- Enhancement: Improved capturing of undefined SketchUp model (#1244).
- Bugfix: Avoid problems when Groups are deleted by third-party extension
          (#1248).
- Bugfix: OSM import regression when terrain is selected (#1241).

2025.12.07

- Bugfix: Fix scaling problems when Scale Tool is used to transform Modelur
          objects in all 3 directions (#1211).
- Bugfix: Fix handling of reported pages changes on SketchUp 2026 (#1237).
- Bugfix: Improve undo/redo adding or removing Complex Building Parts or
          exploding Complex Building (#1238).

2025.12.03

- Enhancement: Prevent scaling more than one Component Instance of the same
               Component to prevent strange behavior (#1192).
- Enhancement: Improved French translations. Thank you David Blavy!
- Enhancement: Added Japan and Korean translations (#1174).
- Enhancement: Allow grouping of Modelur objects (#1144).
- Enhancement: Use Component Definition's name as Component Instance name when
               placing it to the model (#1156).
- Enhancement: Prevent adding Component Instances as Complex Building Parts to
               avoid strange behavior (#1148).
- Enhancement: Add more tolerance when rotating objects (#1141).
- Enhancement: Prevent material related errors triggered by some other
               Extensions (#1147).
- Enhancement: Further Excel LiveSync improvements (#1153).
- Enhancement: Add statusbar guidance for Split Modelur Object Tool (#1155).
- Enhancement: Circumvent attribute_dictionary monkey-patching problem (#1155).
- Enhancement: Use different icon when Modelur is not able to load (#1072).
- Enhancement: Improve problem reporting when Float values are NaN or Infinity
               (#1186).
- Enhancement: More informative message when Modelur needs to call undo to
               prevent problems (#1203).
- Enhancement: Better reaction to changing Building height via Scale Tool + VCB
               (#1204).
- Enhancement: Improve split Complex Buildings with hidden parts (#1220).
- Bugfix: Don't show development timeline message when City Block becomes
          visible (#1219).
- Bugfix: Attach observer to Building or City Block if inside it when
          initializing Modelur (#1212).
- Bugfix: Place Massing Generator generated Buildings onto City Block, not to Z
          = 0 (#1208).
- Bugfix: Pressing Ctrl+Shift when Split Object Tool is active or starting Split
          Object Tool while inside Building (#1209).
- Bugfix: Allow one editable model on Free plan regression (#1200).
- Bugfix: Heads-up Display values when initializing Modelur with Modelur model
          open (#1158).
- Bugfix: Updating Complex Buildings Component Instances and their Building
          Parts Uses (#1206).
- Bugfix: Copy/Paste Modelur objects from older models (!1027).
- Bugfix: Don't erase user defined Uses from defaults.json (#1145).
- Bugfix: Wrong Use references in Excel Examples (#1124).
- Bugfix: Redo creating Modelur objects (#1179).
- Bugfix: Split Modelur Object problem when no plane is defined (#1155).
- Bugfix: Preparing license authorization data with problematic characters
          (#1109).
- Bugfix: Improved the handling of invalid license files (#1063).
- Bugfix: Prevent error when new Modelur model contains Material pasted from old
          (pre-2025) Modelur version (#1182).
- Bugfix: Detecting objects coming from other models (#1183).
- Bugfix: Problem when switching and/or opening models on macOS (#1138).
- Bugfix: Prevent too low storey heights (#1150).
- Bugfix: Comparing deleted materials when pasting objects (#1188).

2025.07.03

- Enhancement: Support SlideView on SketchUp 2023 and 2024 and on Mac OS
               (SlideView
- Enhancement: Improve UX by disabling SlideView if toolbar icon is clicked when
               SlideView is active (SlideView !15).
- Enhancement: Provide complete translations for all languages. If some
               translations seem odd, please report them to us - we used DeepL
               to create them (!1023).
- Enhancement: Add troubleshooting guide when Modelur can't be loaded due to
               Frozen error (SlideView
- Enhancement: Default Modelur expiration prolonged to 2 years.
- Bugfix: Prevent jumping of related Component Instances when one Instance is
          rotated (#1133).
- Bugfix: Remove cloned material's dictionary and improve handling of pasted
          materials (#1134).
- Bugfix: Calling redo after pasting object with Use material has been undone
          (#1135)
- Bugfix: Fix problem reporting when PushPull tool is used inside Building
          (#1140).

2025.06.10

- Enhancement: Added support for SketchUp's Component Instances. To use it, just
               create a Modelur Building and convert it using SketchUp's Make
               Component context menu (#1090).
- Enhancement: Added SlideView, a tool that helps you compare design options
               side-by-side. Only available on SketchUp 2025 and higher (#1095).
- Enhancement: Improved bug reporting for some errors we are not able to
               reproduce (#1064,
- Enhancement: Improved behavior of Modelur Buildings that are made visible
               using Development Timeline (#1094).
- Enhancement: Improved Excel templates (#1096).
- Bugfix: Import OSM Buildings when Group with multiple instances is selected
          (#1075).
- Bugfix: Prevent crashing Modelur when rescuing problem and Modelur Object
          contains multiple instances (#1078).
- Bugfix: Aligning Split Tool plane to Edge or Construction Line that has
          multiple instances (#1087).
- Bugfix: Show notification instead of Problem report when there are no OSM
          buildings to download (#1086).
- Bugfix: Don't load OpenSSL when it is already loaded (#1049).
- Bugfix: Prevent infinite loop when expired license isn't extended (#1077).
- Bugfix: Restore user-defined toolbar items in Modelur UI (#1123).

2025.03.17

- Enhancement: Add Customize UI Text tool to translate or modify Modelur UI
               text. You can find it under Help menu -> Customize UI Text
               (#1061).
- Enhancement: Prevent error when Array.sum is monkey-patched (#1063).
- Enhancement: Improve GIS import when features can't have centroid calculated
               (#1069).
- Bugfix: Prevent error when opened model contains corrupt Complex Buildings
          (#1062).
- Bugfix: Don't trigger problem report when some other Extension deletes layer
          (#1070).

2025.02.21

- Enhancement: Calculate Façade Area of Buildings. See it in Heads-Up Display or
               with Excel LiveSync -> Modelur Buildings Tab (#1050).
- Bugfix: Download OSM Buildings when Component Instances are selected (#1058).
- Bugfix: Switching pages on Free plan (#1054).
- Bugfix: Remove Complex Buildings observers after Modelur has Quit (#1060).

2025.02.14

- Enhancement: Allow Edit mode with SketchUp Templates (#1052).
- Enhancement: Check for updates when Modelur is initialized (#1047).
- Bugfix: Modelur Error when Use Material contains no Use ID (#1048).

2025.02.07

- Enhancement: User Interface enhancements and translations cleanup (!264).
- Enhancement: Notifications when objects with existing or new uses are pasted
               to SketchUp Model (#1039).
- Enhancement: Use last selected Modelur object when using Split Tool, cancel
               when Esc key is pressed (#1039).
- Bugfix: Import of OpenStreetMap buildings when small footprint object is
          selected (#1044).
- Bugfix: Pasting Complex Building with conflicting Uses from another SketchUp
          Model (#1035).
- Bugfix: Heads-Up Display of Whole Plot Parking Spaces (#1035).
- Bugfix: Show Included Floor Area in Whole Plot Dashboard -> Current Model
          (#1034).

2025.01.21

- Bugfix: Prevent Modelur Error when Buildings can't be fully setup (#1013).
- Bugfix: Fix pasting objects with incomplete Use specification (#1026).
- Bugfix: Error can happen when importing GIS data (#981).
- Bugfix: Modelur loading on Mac OS (#1021).
- Bugfix: Error when exiting Modelur or closing all models on Mac OS (#1018).
- Bugfix: Update values when Complex Building Parts are hidden via Outliner
          (#1024).

2025.01.10

- Enhancement: Fix Complex Building's parts vertical position on load or when
               problem is resolved (#1014).
- Enhancement: Added support for upcoming SketchUp 2025. Note this release was
               tested to limited extent (#1002).
- Enhancement: Significant performance improvement most noticeable on large
               scale models (#999).
- Enhancement: Improved Heads-Up Display with breakdown of required and provided
               Parking Spaces (#987).
- Enhancement: Show warning message when wrong GIS object type is being imported
               (#984).
- Enhancement: Support ThomThom's Component Replacer Extension to replace
               Modelur Objects (#979).
- Enhancement: Improve Error handling when Modelur is being initialized (#988).
- Enhancement: Improve Excel templates, and show persistent IDs of City Blocks
               and Buildings (#964).
- Enhancement: Improve City Block's HeadsUp Display to display floor area based
               on FAR calculation (#964).
- Enhancement: Improve initial defaults for users that work in Imperial units
               (#961).
- Enhancement: Add Modelur Help menu (#952).
- Enhancement: Allow Split Object Tool when in Free plan edit mode (#944).
- Enhancement: Improve Excel LiveSync notice on protected sheets (#955).
- Enhancement: Show only included Gross Floor Area FAR in Modelur Dashboard
               (#950).
- Enhancement: Allow specifying Modelur settings directory (specify it in
               /Modelur/data/config.json) (#317).
- Enhancement: Improve OpenStreetMap attribution (#951).
- Enhancement: Alignment of Complex Buildings and City Blocks Bounding Boxes
               (#958).
- Enhancement: Prevent problems by exiting Modelur when all windows are closed
               on Mac OS to (#948).
- Enhancement: Quit Modelur if Floating License Seat is not approved (#1003).
- Bugfix: Remember Building or City Block name when UI focus is lost (#235).
- Bugfix: Handle unsupported GIS file types (#985).
- Bugfix: Don't load Actions::InitializeModelur twice (#990).
- Bugfix: Switching from Free edit mode to View-only mode when error is caught
          (#966).
- Bugfix: Complex Building Parts distribution upon creation when base Face is
          not on Z = 0 (#962).
- Bugfix: Message when user starts editing Excel protected cells with LiveSync
          turned on (#956).
- Bugfix: Delete locked source Entity when using Split Tool (#957).
- Bugfix: Excel LiveSync non-defined values (#938).
- Bugfix: Updating Modelur License failed (#940).
- Bugfix: Updating Free mode when SKP dictionary doesn't exist (#942).
- Bugfix: Make reloading Modelur model more robust (#943).
- Bugfix: Release floating license seat when quitting SketchUp (#945).

2024.11.11

- Enhancement: Added dashboard to present relevant data about City Blocks or
               Whole Plot (depending on selection). Use `Data -> Modelur
               Dashboard` menu entry to open the dashboard (!799).
- Enhancement: Improved OSM Buildings import (!804).
- Enhancement: Let users know if not all OSM of WFS tiles have been downloaded
               (!807).
- Enhancement: Export Buildings and City blocks to GeoJSON (#891).
- Enhancement: Vertical scale of Buildings when VCB is used to define the height
               (#479).
- Enhancement: Further UI enhancements (tabs sorting, vertical scroll) (!775).
- Enhancement: Trigger error report when error happens in Modelur Tools (#887).
- Enhancement: Improve messaging when Modelur quits due to an error (!793).
- Enhancement: Fix toolbar icons when Modelur quits (!793).
- Enhancement: Added Update Modelur License button to Extensions > Modelur menu
               (#934).
- Bugfix: Overcome SketchUp 2024 issue that causes bugsplat when opening new
          models while Modelur is turned on (#835).
- Bugfix: Fallback when upgrading Excel LiveSync settings fails (#835).
- Bugfix: Fix erasing Material that is applied to Modelur objects (!809).
- Bugfix: Infinite loop in case something goes wrong when ModelObserver is
          triggered (#924).
- Bugfix: Loading of expired Modelur (#931).
- Bugfix: Upgrading of pre 6.0 version Modelur models (#931).
- Bugfix: Loading of objects with Parameters set to nil value (#846).

2024.08.26

- Enhancement: Improved User Interface design and functionality (!733).
- Enhancement: Added UI sidebar to define shortcuts to the tools of your choice
               (!733).
- Enhancement: Use +/- signs to add to or subtract from current value when
               changing values in input boxes (!733).
- Enhancement: Allow stacking panels side-by-side to show more than one tab
               (!733).
- Enhancement: Migrate from Clipper to Clipper2, add full Mac OS support (!748).
- Enhancement: Improved loading time, especially of large models (#816).
- Enhancement: Improved performance when changing City Blocks visibility via
               Tags (Layers) (#815).
- Enhancement: Show notification when (Geo)JSON file can not be read (#808).
- Enhancement: Add upgrading MJSON from v0 to v1 (#809).
- Enhancement: Scaling of Buildings created via GIS Import or Massing Generator
               (#801).
- Enhancement: Handle rename of Use when it is used in GIS Import Mapping
               (#769).
- Enhancement: Improve splitting of large City Blocks and Buildings with
               redundant edges (!740).
- Enhancement: Less restrictive EPGS:4326 check when importing GIS objects
               (#811).
- Enhancement: Improve LightUp responsiveness (#813).
- Enhancement: Ruby Console issues warnings when some Excel values can not be
               handled properly (#819).
- Enhancement: Fixed too many decimals in UI when using scroll or chevron
               (#825).
- Enhancement: Add GIS imported objects to dedicated layers automatically
               (#826).
- Bugfix: Modelur icon when it fails to load (#830).
- Bugfix: Language related changes updates in User Interfaces (#823).
- Bugfix: Excel Building Assessed Investment formatting and formatting update
          when columns change is detected (#819).
- Bugfix: Handling undefined values for Excel LiveSync (#819).
- Bugfix: Update named cells when Use is renamed (#805).
- Bugfix: Ask user to restart SketchUp after Modelur has been updated (#802).
- Bugfix: Prevent import of invalid GIS geometry (#806).
- Bugfix: Allow saving of GIS Mapping to user defined location (#806).
- Bugfix: Calling Undo in SketchUp 2024 (#812).
- Bugfix: Error reporting with long texts (#817).

2024.06.14

- Enhancement: Dynamic size of Heads-Up Display based on View size (#796).
- Enhancement: Add support for multiple SketchUp models on Mac OS (#795).
- Enhancement: Copying Modelur objects between SketchUp models now also
               transfers Use data to recreate missing Uses (#486).
- Enhancement: Improve softening of Building's Edges (#789).
- Enhancement: Remove redundant Edges from Buildings generated by Massing
               Generator (#692).
- Bugfix: Proximity check after Complex Building is created (#800).
- Bugfix: Improve cleanup of redundant Edges when on hidden Layers (#797).
- Bugfix: Inform users why Massing Generator can't produce results (#788).
- Bugfix: Upgrading City Blocks from previous version of Modelur (#787).
- Bugfix: Upgrading MJSON from old Modelur version (!717).
- Bugfix: Saving default Modelur settings (!723).
- Bugfix: Redo after undo of pasted Modelur Object (#791).

2024.05.06

- Enhancement: Re-added Split Object Tool. It now supports splitting all
               Buildings and City Blocks (#772,
- Enhancement: Added Split Object Tool snapping to align split plane to clicked
               edge or construction line. Use Ctrl for parallel, and Shift for
               perpendicular alignment (#772).
- Enhancement: Improved Split Object Tool now allows splitting in wall plane (on
               L-shaped buildings) or on objects that contain inner loops (eg.
               Building with atrium) (#772).
- Enhancement: When splitting Modelur Object that is adjacent to some other
               Modelur Object, you can select it before entering the split to
               set it as preferred one to split (#772).
- Enhancement: Improved cleanup of coplanar faces(!689).
- Enhancement: Soften Buildings Edges when creating Buildings if faces angle is
               below 160° (!703).
- Enhancement: Improved GIS import error reporting (!705).
- Enhancement: Add GIS option to import simple 2D Faces / Polygons (#782).
- Enhancement: Disable GIS import while file is not defined, and mapping not set
               (!698).
- Enhancement: Import only GIS Features that do not exist in the model (!707).
- Enhancement: Add required and provided parking spaces to Excel City Block tab
               (#773).
- Enhancement: Handle GIS import with Z values relative to Sea (#784).
- Enhancement: Improve performance of GIS City Blocks import and handling of
               multiple City Blocks in one command (!712).
- Bugfix: Net Floor Area per Primary Unit UI problem (#774).
- Bugfix: Erasing empty Volumes on OSM import (!697).
- Bugfix: Importing GeoJSON with Z coordinates (#781).
- Bugfix: Show message when trying to import non-defined GIS file (!698).
- Bugfix: Create MJSON when mapped value use is numeric (!699).
- Bugfix: Automatic finding of acceptable Use names when Property values are
          numeric (!700).
- Bugfix: Fix upgrading old Danish package models (!701).
- Bugfix: Update Layer information when Modelur Object's Layer changes (#785).

2024.04.04

- Enhancement: Re-added GIS import (Buildings and City Blocks).
- Enhancement: Reset Modelur User Interface Windows to main monitor (#754).
- Enhancement: Improve Heads-Up Display with included and excluded areas (#749).
- Enhancement: Add named ranges to each Modelur data column in Excel LiveSync
               (!662).
- Enhancement: Sort Excel LiveSync rows by object name. Complex Buildings are
               added after Simple Buildings (!660).
- Enhancement: Split Building's required and provided Parking Spaces in Excel
               LiveSync (!663).
- Enhancement: Upgrade Excel templates (!664).
- Enhancement: Add Complex Buildings Use data in Excel LiveSync (#664).
- Enhancement: Added Included and Excluded GFA to Excel LiveSync (#750).
- Enhancement: Added Excel settings upgrade mechanism (#733).
- Enhancement: Improve adding one storey to Complex Buildings with adjacent
               parts of same number of storeys (#743).
- Enhancement: Improved synchronization of layers and their showing/hiding
               (#745).
- Enhancement: Allow setting empty values to Use parameters (#747).
- Bugfix: Update Excel LiveSync colum names upon opening (!661).
- Bugfix: Allow modifying buildings that are almost, but not completely,
          horizontal (!658).
- Bugfix: Remove excluded Gross Floor Areas from displaying in City Block's and
          Whole Plot sum (#718).
- Bugfix: Create Building from faces that are almost, but not completely
          horizontal (#752).
- Bugfix: Mark Building or City Block as invisible when the object is visible,
          but it's faces and edges are hidden (not visible in SketchUp) (#451).
- Bugfix: Fix updating model Layer is turned on that contains some Complex
          Building's Parts (#722).
- Bugfix: Setting Buildings or City Blocks Parameters to nil (#741).
- Bugfix: Complex Buildings in SketchUp 2019 (!670).
- Bugfix: Changing of first storey height in Complex Building with adjacent
          parts (#734).
- Bugfix: Initialize Modelur when license does not yet exist and it can't be
          copied from old version (!642).

2024.02.06

- Bugfix: Formatting zero values (#725).

2024.01.29

- Enhancement: Re-added Massing Generator (#115).
- Enhancement: Added click-button integration with LightUp to perform daily
               sunlight analysis (!577).
- Enhancement: Improved integration with SketchUp model units. Use SketchUp
               Window > Model Info > Units to set Modelur unit system (metric or
               imperial) (#684,
- Enhancement: Improved pasting of objects from another SketchUp model (#703).
- Enhancement: Automatic switching between Modelur UI Tabs based on SketchUp
               object selection - Building, City Block, or Use Material (#679).
- Enhancement: User interface styling improvements.
- Enhancement: Fix Bounding Box of copied Complex Building when it changes
               number of storeys (!595).
- Enhancement: Improved distribution of Uses with Massing Generator (#690).
- Enhancement: Don't update use of hidden objects when opening saved model
               (#678).
- Enhancement: Added sum of plot area per use to Excel LiveSync (#683).
- Enhancement: Improved language support in Excel LiveSync template examples.
- Enhancement: Added two more Excel template examples - sum of Gross and Net
               Floor Areas per City Block and calculation of remaining floor
               areas on a City Block.
- Enhancement: Added Excel LiveSync header cell names for easier referencing.
- Enhancement: Improve Excel LiveSync stability (#652).
- Enhancement: Improved Excel LiveSync column auto-fitting (#653,
- Enhancement: Handling objects uses when material changes outside Modelur
               (#686).
- Bugfix: Instant update of Complex Building Part primary and secondary units
          (#720).
- Bugfix: Calling Undo then Redo after Complex Building is exploded (#698).
- Bugfix: Calling Undo then Redo after switching Pages with mixed layers turned
          on and off (#704).
- Bugfix: Converting non-unique (eg. copied) Envelope Group to Building
          conversion (!584).
- Bugfix: Error handling when Modelur can not be properly initialized (#689).
- Bugfix: Don't send hidden objects to Excel (#675).
- Bugfix: Mark user-hidden buildings when opening model (#680).
- Bugfix: Update Buildings use when City Block's Use is changed via material
          application (#668).
- Bugfix: Update City Block's material when it has default use, and the user
          changes default use in Whole Plot (#676).

2023.12.18

- Enhancement: Excel LiveSync has been reintroduced with significant
               improvements in speed and data organization. It now includes a
               template sheet with examples to facilitate a smooth start. The
               data is now segregated into three separate sheets and enclosed
               within named ranges for simplified retrieval.
- Enhancement: OSX Heads-Up Display improvement.
- Bugfix: Added more strict Building error checking.
- Bugfix: Heads-Up Display values when user switches units.
- Bugfix: Applying non-Modelur Material to Modelur object.
- Bugfix: Regression when (old version) proximity check is turned on.
- Bugfix: Area of Circular Building when nothing is selected upon creation.
- Bugfix: Activating Modelur with a license key.
- Bugfix: OS X SketchUp Bugsplat on Quit.
- Bugfix: Occasional Modelur initialization Bugsplat.

2023.11.11

- Enhancement: Implement reset to Modelur factory settings.
- Enhancement: Store Modelur UI tab order.
- Enhancement: Add option to calculate Gross Floor Area by internal floors only
               or by internal and external (terraces and loggias) floors.
- Enhancement: Update Modelur UI active Use when user selects its corresponding
               material in SketchUp Materials panel.
- Enhancement: When exising Use material is applied to Face from which object
               (City Block or Building) is created, apply this Use to the
               object.
- Enhancement: Use prevalent Use material of envelope when creating new Building
               from it.
- Enhancement: Change Building or City Block Use when corresponding Use Material
               is applied to it.
- Enhancement: Remove required parking area calculation to prevent confusion.
- Bugfix: Material of Building or City Block if it is set on face from which
          object is created.
- Bugfix: Undo regression after new or saved Modelur model is opened.
- Bugfix: Use in-model parameters when previously saved model is opened.

2023.10.19

- Enhancement: Fix Convert Envelope to Building icon in older versions of
               SketchUp.
- Enhancement: Use GIS properties when converting volumes imported from
               OpenStreetMap to Modelur Buildings.
- Enhancement: Import OpenStreetMap Buildings as 2d floor plans/morphology.
- Enhancement: Limit OpenStreetMap Buildings import to terrain or selected
               Groups.
- Enhancement: Import duplicate OSM/GIS Features only once.
- Enhancement: Add more common default Uses (Hotel, Office, Education, ...)
- Bugfix: Fix a crash when undo is triggered after adding new Use.
- Bugfix: If Undo is called after adding Use, remove the Use from the user
          interface.
- Bugfix: Fix removing existing Use.

2023.09.25

- Enhancement: Add OSM buildings import.
- Enhancement: Add feature to convert extruded building volume to Modelur
               Building.
- Enhancement: Improve handling of Buildings that were modified using
               third-party Extensions.
- Enhancement: Allow pasting Complex Buildings to another Complex Building.
- Enhancement: Improve behaviour of Buildings pasted into Complex Building.
- Enhancement: Allow Purge Unused command of SketchUp Model.
- Bugfix: Change HUD language when language is changed in UI.

2023.09.05

- Enhancement: New modern user interface and complete rewrite.
- Breaking Change: Modelur Buildings created with this version will not work in
                   the previous versions of the Modelur.

2022.12.03

- Enhancement: Improve license check.
- Enhancement: Add support for SketchUp 2023.
- Bugfix: Improve placing buildings on terrain if terrain groups are
          transformed.
- Bugfix: Improve GIS import of GeoJSON features with geometry collection as
          geometry.

2022.12.01

- Bugfix: Fix loading of Modelur after it could not be initialized.

2022.09.01

- Enhancement: Improve interactive tutorial for Free Plan.

2022.08.01

- Enhancement: Add support for Apple computers with M1 and M2 processors.
- Enhancement: Sort building storey GFA in Excel by building name.
- Enhancement: Add support for Modelur Free Plan.
- Bugfix: Calculation of total Number of Storeys in Complex Buildings.
- Bugfix: Fix OSM building import when Modelur works in imperial units.
- Bugfix: Loading of Modelur on localized Windows systems where username
          contains non-ascii characters.

2022.06.01

- Enhancement: Support for Sketchup 2022.
- Bugfix: Dashboards work as expected.
- Bugfix: Don't reset manually edited setbacks.
- Bugfix: Place Massing Generator buildings onto City Block.

2022.2.2

- Enhancement: Updating of Buildings and City Blocks materials when Land Use
               material is deleted.
- Bugfix: Land use ratio is refreshed in building dashboard when building
          changes.
- Bugfix: Refresh terrace and loggia materials on Buildings when material is
          deleted.
- Bugfix: Proper terrace and loggia materials on manually modified Buildings.

2021.11.01

- Breaking Change: Objects that are imported from GIS are locked by default.
                   Users can change that in Gis Preferences in Gis import window
                   (File -> Import GIS Data ...).
- Enhancement: Added Building Dashboard that displays rich summary of the last
               selected building. It can be found in Data menu.
- Enhancement: Added Whole Plot Dashboard that displays rich summary of the
               whole site. It can be found in Data menu.
- Enhancement: Added GIS information window. You can now see the information
               provided by GIS for imported objects.
- Enhancement: Pressing Enter key is not necessary to change parameters in the
               Modelur user interface.
- Enhancement: Added dynamic stack bar charts for Car Parking section on all of
               the dashboards.
- BugFix: In some cases aggregated values of urban control values for Land use
          and Whole plot counted parts of hidden complex buildings. This bug
          didn't affect the values of the City Blocks.
- Bugfix: Whole plot calculations include contributions of parts of a hidden
          complex building if it is on a different layer than the complex
          building itself
- Bugfix: Copy/paste of City Block.
- Bugfix: Buildings Land Use data in Excel LiveSync.

2021.08.01

- Enhancement: Perimeter Massing Generator
- Enhancement: Added City Block Dashboard that displays rich summary of the last
               selected city block. City Block Dashboard can be found in Data
               menu.
- Enhancement: Added new "Data" menu to Modelur user interface. The menu
               contains tools for data presentation. It has the following
               entries: "Open Urban Control Data Table", "Send Modelur Data to
               Excel" and the new "City Block Dashboard".
- Bugfix: Update City Block and Whole Plot urban control values when a part of a
          Complex Building is deleted.

2021.07.02

- Bugfix: Handling cutting and pasting building parts from complex buildings.

2021.07.01

- Bugfix: Loading Modelur when language translation is not complete.
- Bugfix: Show notification when floating license seat limit is reached.
- Bugfix: Modelur loading when license is not present (SketchUp 2017-2020).
- Enhancement: Notification when Modelur is not able to load toolbar.
- Enhancement: Improved error report when Modelur can not be loaded.

2021.6.01

- Bugfix: Built area of Complex building is calculated correctly when a complex
          building is copied.
- Bugfix: Correctly save properties for buildings in GeoJSON export.
- Bugfix: Complex buildings that are hidden when user opens the model.
- Bugfix: Scaling Complex buildings in horizontal and vertical direction.
- Enhancement: Updated complete Portuguese translation. Thank you again Edson
               Mahfuz!.
- Enhancement: City block setbacks.
- Enhancement: City Block envelope, that visually displays maximum allowed
               height and setback.
- Enhancement: Display Land Use summary for City Block in Excel Live Sync.
- Enhancement: New Interactive Tutorial (Modelur menu -> Help -> Interactive
               tutorial).

2021.5.11

- Bugfix: Built area of Complex building is calculated correctly when a complex
          building is copied.
- Bugfix: GIS import of Complex Buildings.
- Enhancement: Save Sketchup persistent id of Modelur objects to GeoJSON export.

2021.5.02

- Enhancement: Improved trial registration process.
- Bugfix: Correctly set First Storey Height and Other Storeys Height on undo.
- Bugfix: Licensing problems on some Mac OSX computers.

2021.4.01

- Enhancement: Randomly generate buildings on empty city blocks.
- Enhancement: Display gross floor area per storey in Excel Live Sync.
- Breaking Change: Modelur Buildings created with this version will not work in
                   the previous versions of the Modelur. Use "File -> Save in
                   Modelur Legacy Format ..." to save in format compatible with
                   previous versions of Modelur.

2021.1.28

- Bugfix: Sum of City Block Land Uses in Urban Control Data Table / Excel
          export.
- Bugfix: Building Height parameter when changed via UI.
- Bugfix: Tag Folders hiding/un-hiding.
- Enhancement: City Blocks ID in Urban Control Data Table.
- Enhancement: Updated Licenses for external libraries.

2021.0.01

- Enhancement: Support for Trimble SketchUp 2021 and ruby 2.7.

2020.0.04

- Enhancement: Excel live sync now includes named cells for easier and more
               dynamic referencing and it is faster.
- Enhancement: Excel live sync and Urban Control Data Table can now display City
               Block data aggregated by land uses.
- Enhancement: Added support for GIS MultiLineString import.
- Enhancement: Improved GeoJSON export now includes achieved urban control
               parameters.
- Enhancement: Added a tool to drop buildings onto the terrain.
- Enhancement: Display 0% for land uses that don't count in GFA
- Bugfix: Sum of whole plot and land use values when Complex Building is
          recreated by adding new part to existing Complex Building.
- Bugfix: Load GIS data with non-ascii characters.
- Bugfix: Regression of loading GIS data near the Equator.
- Bugfix: Handle odd number of rows in excel export.

2020.0.03 (GIS Release Candidate 1)

- Enhancement: General improvements to Modelur Parametric Buildings core engine
               (Clipper).
- Enhancement: Import OpenStreetMap 3D Buildings (note that data is community
               provided so it is not 100% reliable!).
- Enhancement: Added sum of all City Block's plot areas in Land Uses.
- Enhancement: Added Land Use Assessed Income parameter.
- Enhancement: Improved intersection of Complex Building's Parts.
- Enhancement: Show statusbar information on GIS/OSM import progress.
- Enhancement: Added function to place all Modelur Buildings onto the terrain
               (UI > Tools > Place Buildings on Selected Terrain).
- Bugfix: Fix storey heights of buildings if they are not defined.
- Bugfix: Cut/paste Building Part from Complex Building to model.
- Bugfix: Erasing Building Part in Complex Building after undo/redo.
- Bugfix: Fix min and max storey settings when randomizing buildings height.
- Bugfix: Licensing Modelur for users with non-Chinese character usernames.
- Bugfix: Placing GIS imported Complex Buildings onto the 3D terrain.

2020.0.02 (GIS Beta)

- Enhancement: Live data connection from Modelur to Excel (Windows only).
- Enhancement: Added Split Buildings Tool.
- Enhancement: Export Buildings and City Blocks in GeoJSON format.
- Enhancement: Display / Export Land Use data in alphabetic order.
- Bugfix: Fix importing of GIS polygons that have points closer than 1/1000th of
          an inch.
- Bugfix: Fix loading of SHP files that contain attribute names with non-ascii
          characters.
- Bugfix: Convert Complex Building to Simple Building when all parts above
          ground are removed.

2020.0.01 (GIS Beta - Tech Preview 1)

- Enhancement: Add default Land Use to City Block's data table / export.
- Enhancement: Improved Trees import options (added basic species).
- Enhancement: Overall GIS import improvements.
- Enhancement: Added tolerance when calculating intersecting Complex Buildings
               Parts.
- Bugfix: City Block Land Use areas in HeadsUp Display.

2018.3.6 (GIS Alpha 6)

- Announcement: New GIS version of Modelur only works with SketchUp 2017 and
                above.
- Enhancement: New UI for GIS import (open it via Modelur menu Open > Import GIS
               Data).
- Enhancement: Added options to set GIS import preferences.
- Enhancement: Improved messaging when City Blocks errors are found.
- Enhancement: General improvements to SHP file reading.
- Enhancement: Optimized updating when multiple Building's Parameters are
               changed at once.
- Bugfix: Handle loading of files where CityBlocks are corrupted (their Faces
          are missing).
- Bugfix: Tick City Blocks checkboxes if their limitation is overloaded with
          empty values.
- Bugfix: Import City Blocks with undefined limitations (don't create parameters
          with no values).

2018.3.5 (GIS Alpha 5)

- Enhancement: Check if SHP and GeoJSON Feature Types can be loaded with
               Modelur.
- Enhancement: Check distance from origin only if GIS file has been loaded
               properly.
- Enhancement: Add MultiLineString support for GeoJSON.
- Enhancement: Try to fix Building Parts if they were corrupted outside of
               Modelur.
- Enhancement: Use own Z scale algorithm to determine height of Buildings.
- Bugfix: Fixed loading when other plugins that use RubyEncoder are present (eg.
          Skalp).
- Bugfix: Proper import Modelur Buildings from GIS file when some shapes
          (features) are empty.
- Bugfix: Import Building Volumes when some GeoJSON Features can not be
          generated in 3D.
- Bugfix: Fix Curve generation.
- Bugfix: Fix Other Storeys Height in manually edited Buildings when First
          storey height has been already changed.
- Bugfix: Loading of large DEM GIS files.

2018.3.3 (GIS Alpha 4)

- Enhancement: Include improvements and bugfixes from 2018.2.7.
- Bugfix: Improve erasing of objects when there are many City Blocks in the
          model.

2018.3.2 (GIS Alpha 3)

- Enhancement: Import ComplexBuildings (each segment should be imported as
               separate layer).
- Enhancement: Import PolyLines (Road, Rail, Metro, Underground infrastructure).
- Enhancement: Import 3D terrain from SHP/GEOJson.
- Enhancement: Add imported objects to the Layer with same name.
- Enhancement: Place building to specified height (ground floor height from sea
               level).
- Bugfix: Import Polygons with holes that touch outer Edge of Polygon.
- Bugfix: Loading of saved Buildings when their UID is missing.
- Bugfix: Undo Erase CityBlock with Buildings.

2018.3.0 (GIS Alpha 2)

- Optimization: Improved import speed of Modelur Buildings.
- Enhancement: Also drop trees to terrain (if selected).
- Enhancement: Improved storing of attribute mapping within same SketchUp
               session.
- Enhancement: Enabled Built-up area assignment when importing Buildings or
               Buildings volumes.
- Enhancement: Buildings and Trees can now be dropped also to Terrains that are
               Components.
- Bugfix: Import GIS objects that include Z coordinates.
- Bugfix: Warnings about objects being to far when imported GIS file includes Z
          coordinates.
- Bugfix: Loading of SHP files when some of its attribute records are not valid.
- Bugfix: Create Buildings that have 0 Number of Storeys (assign 1 storey and
          let user know about it).
- Bugfix: Prevent failure if some Buildings can not be imported, but let user
          know about that.

2018.3.0 (GIS Alpha 1)

- Enhancement: Read GIS files relative to mjson file with import settings.
- Enhancement: Modelur Buildings or Buildings Volumes are dropped onto 3D
               terrain if the terrain is selected at the time of import.
- Enhancement: Improved construction year behaviour.
- Enhancement: Confirm import if GIS file is located more than 2km from model
               origin.
- Enhancement: Show only object types that can be imported.
- Enhancement: Improved trees layer (default).

2018.3.0 (GIS Alpha 0)

- Note: First, early Alpha release of Modelur with GIS import capabilities
        (reading SHP and GeoJSON files).

2019.2.7

- Enhancement: Added Italian translation (thank you Salvatore Colletti!),
               improved English translation.
- Enhancement: Vertical clustering of Complex Building's parts.
- Enhancement: Added Land Use sum of Building's Volumes.
- Bugfix: Release network license when license was created before Feb 2019.
- Bugfix: Add Gross Floor Area parameter when Complex Building is created.
- Bugfix: Undo Erase CityBlock with Buildings.
- Bugfix: Loading of saved Buildings when their UID is missing.
- Bugfix: City Block and Whole Plot Heads-up display of GFA per land use.

2019.2.6

- Enhancement: Disable creating of default Buildings and Complex Buildings if no
               default shape is selected.
- Enhancement: Handling of Buildings and City Blocks that were modified outside
               of Modelur.
- Bugfix: From Factor calculation for simple Buildings with terraces/loggias.
- Bugfix: Fix Building's storey heights when opening saved and modified SKP
          model if some City Blocks exist.
- Bugfix: Loading Modelur when user's operation system is in non-ascii language
          and username includes non-ascii characters.
- Bugfix: Enable release network license button with new licenses.
- Bugfix: Export Buildings primary units.

2018.2.5

- Enhancement: Added option to calculate Building's form factor, envelope area
               and surface to volume ratio (via Tools > Calculate Building's
               Form Factor or via Context Menu when Building is selected).
- Enhancement: Show sum of Net Floor Area in Sum of Selected Buildings.
- Enhancement: Floor Area sum of Land Uses in Sum of Selected Buildings is now
               based on how FAR is calculated (from GFA or NFA).
- Enhancement: Improved deleting of many Buildings from the model in one step
               (+1k).
- Enhancement: Show license reminder only once within 3/1 weeks.
- Enhancement: Improved calculation of manually modified Buildings volumes.
- Enhancement: Improved handling of SketchUp version requirement (this version
               works with SketchUp 2014 through 2019).
- Enhancement: Improved opening, regeneration and recalculation of Modelur
               model.
- Enhancement: Fix First and Other storey heights on model open if Buildings
               were modified outside of Modelur.
- Bugfix: General improvements to undo/redo mechanism and exploding of
          Buildings.
- Bugfix: Proper display of overloaded Building Parts parameters.
- Bugfix: CSV export when Buildings contain Construction or Demolition year.
- Bugfix: Erase layers with Modelur Buildings.

2018.2.4

- Enhancement: Sum multiple built areas in single Complex Building.
- Enhancement: General improvements to undo/redo mechanism.
- Enhancement: Added calculation of Primary Units based on Storeys.
- Enhancement: Don't force close SKP model when it was created using newer
               version of Modelur.
- Enhancement: Improved alignment of ComplexBuildings bounding box (2018.2.3
               regression).
- Enhancement: Improved manual editing of Buildings/Complex Buildings Parts.
- Enhancement: Added option to select or filter City Blocks by their Land Use.
- Bugfix: Calculation of ComplexBuilding areas with multiple transformations.
- Bugfix: Prevent dropping of ComplexBuildings when they are not at Z = 0.
- Bugfix: Complex Building Built-up Area when copied via VCB.
- Bugfix: Opening files with hidden Complex Buildings.

2018.2.3

- Enhancement: Added option to choose whether to synchronize Building's Entities
               layer to Building's Layer or not. On by default.
- Enhancement: Improved handling of layers within Complex Buildings Building
               Parts.
- Bugfix: Updating Gross Floor Area when Complex Building is moved to hidden
          layer.
- Bugfix: Negative vertical scale of Buildings.

2018.2.2

- Bugfix: Loading of Modelur UI when trial or project license is used.

2018.2.1

- Enhancement: Improved detection of computer's ID needed to generate license
               file.
- Enhancement: Improved notification when RgLoader problems occur.

2018.2.0

- Enhancement: Added option to calculate FAR based on Gross or Net Floor Area
               (Options > Calculate FAR Based On).
- Enhancement: Added option to select or filter Buildings based on Land Use
               (Extensions > Modelur > Select Buildings by Land Use).
- Enhancement: Sum of Selected Buildings now shows also count of Buildings
               selected per Land Use.
- Enhancement: Urban Control Data Table and CSV export now show also Land Use
               number of simple Buildings count.
- Enhancement: Improved calculation of Complex Building Built Area.
- Enhancement: Improved alignment of Bounding Boxes for rotated Buildings,
               Complex Buildings and City Blocks.
- Bugfix: Collapsed Complex Buildings that are on hidden layers when saved model
          is opened.
- Bugfix: Remove remaining BuiltUp Area Group when creating new Complex Building
          from existing one.

2018.1.3

- Bugfix: Calculation of Gross Floor Area when Building is scaled negatively in
          only X or Y direction (but not both).

2018.1.2

- Enhancement: Make sure Land Use names are unique and use GUID for internal
               representation.
- Enhancement: Improved notification of Trial limitations.
- Bugfix: Creating of City Blocks in Trial mode.

2018.1.1

- Enhancement: Better handling of undo when focus is inside Modelur User
               Interface field.
- Enhancement: Manual updating of Modelur License.
- Bugfix: Moving Buildings after two City Blocks were entered successively and
          Building is moved to the first one that was selected.
- Bugfix: Copying simple Building to City Block via Ctrl mechanism if Building
          and City Block have same parameters.
- Bugfix: Updating of secondary units after new Land Use is added.
- Bugfix: Display of urban control values when deleting object and some of them
          are locked (thus not erased).
- Bugfix: Display of Parking Spaces in Land Uses that are derived from Parking
          Land Use.

2018.1.0

- Enhancement: The first fully functional release of Modelur.

2018.1 Release Candidate 8 (Beta)

- Bugfix: Proper handling of zero values in user interface.
- Bugfix: Creating Buildings with non-default floor areas.
- Bugfix: Updating gross floor area parameter after building is created.

2018.1 Release Candidate 7 (Beta)

- Enhancement: Improved vertical scaling of Complex Building when some parts
               have different storey heights.
- Enhancement: Modelur SKP models can now be opened if they were created using
               the same Modelur major version (eg. 2018.1)
- Enhancement: Warning and model reset when newer version Modelur model is
               opened.
- Bugfix: Copying of Buildings from City Blocks that have overloaded Building
          parameters.
- Bugfix: HeadsUp Display newlines on OSX.
- Bugfix: Buildings and City Blocks area calculations if they are skewed.
- Bugfix: Built area of Complex Buildings when they are moved after scale on
          them is undone.

2018.1 Release Candidate 6 (Beta)

- Enhancement: Improved user interface.
- Enhancement: Drop Building Parts to origin when ground Building Part is moved
               vertically.
- Bugfix: Fixed rounding errors when storing default parameters after dimension
          units are changed.
- Bugfix: Changing of Land Use color via Modelur UI.
- Bugfix: Update Complex Buildings even when parts are selected via Urban
          Control Data Table.

2018.1 Release Candidate 5 (Beta)

- Change: Modelur expiration date set to December 31st 2019.
- Enhancement: Improved Trial registration.
- Bugfix: Inconsistent behavior when checking (overloading) Building's
          parameters.
- Bugfix: Changing Building's parameters when menus are opened.

2018.1 Release Candidate 4 (Beta)

- Enhancement: Improved loading time of large models.
- Enhancement: Keep City Blocks and Buildings sorted when exporting values to
               CSV.
- Enhancement: Overall improvement of CSV export and Urban Control Data Table.
- Enhancement: Optimized hiding and showing of Buildings and City Blocks.
- Enhancement: Optimized moving of Buildings and City Blocks to hidden Layers.
- Enhancement: Added permitted City Blocks values when exporting data to CSV
               file.
- Enhancement: Automatic updating of Modelur license when Proxy Server mode is
               used.
- Enhancement: Let users with annual license know that the license is about to
               expire when there are 21 days left (or less).
- Enhancement: Modelur User Interface tabs and menus improved.
- Enhancement: Modelur User Interface Land Use colors improved.
- Enhancement: HeadsUp Display number rounding and smaller fixes.
- Enhancement: Offer user a preference to not show warning when switching to
               unofficial language.
- Enhancement: 'Selected City Block Parameters' and 'Selected Building
               parameters' now offer single click selection of multiple
               checkboxes at once by holding the SHIFT key and clicking on one
               of the checkboxes.
- Enhancement: Smooth edges when changing Building's number of storeys.
- Enhancement: Prevent vertical overlapping of Buildings when Complex Building
               is exploded.
- Enhancement: Proper position and alignment when default Building is created if
               model's origin is moved/rotated.
- Bugfix: Opening of Urban Control Data Table after City Blocks have been
          sorted.
- Bugfix: Over-sized Bounding Box in rotated Complex Buildings when its parts
          are modified.
- Bugfix: Updating Buildings to City Blocks parameters if they are part of the
          Layer that changed from hidden to visible.
- Bugfix: Dimension units in Urban Control Data Table when opened SKP model uses
          different dimension units than set by user's preferences.
- Bugfix: HeadsUp Display GFA sum of Land Uses in Whole Plot and City Blocks
          when dimension units are changed.
- Bugfix: When creating Complex Building with Ground Floor below zero level
          (coordinate z<0), the Building is moved up.
- Bugfix: Hidden Complex Buildings when saved SKP model is opened.
- Bugfix: Updating of Building Height input Parameter when moved to another City
          Block (if it has non-default Storey Heights).
- Bugfix: Changing of Whole Plot or City Block default Building number of
          storeys when Buildings with default Number of Storeys are hidden.
- Bugfix: Prevented entering into Simple Building's built-up area Group which
          bug-splat SketchUp.
- Bugfix: SHIFT + mouse scrolling properly changes values on all fields.

2018.1 Release Candidate 3 (Beta)

- Enhancement: Using construction lines inside Modelur Buildings is now
               possible.
- Enhancement: Added Context menu operation that selects all Buildings that are
               part of selected City Blocks.
- Enhancement: Added Land Use percentage in Sum of selected buildings Heads-up
               display.
- Enhancement: City Blocks and Whole Plot now calculate also GFA per Land Use.
- Enhancement: Improved refreshing of HeadsUp Display.
- Enhancement: Urban Control Data Table now includes percentages of Land Use
               GFAs if selected for Complex Buildings.
- Enhancement: Added Net Floor Area for Buildings and Complex Buildings in CSV
               export and in Urban Control Data Table.
- Enhancement: Added Land Uses Assessed Investment in CSV export and in Urban
               Control Data Table.
- Enhancement: Loading of Modelur when settings can not be properly updated.
- Enhancement: Improved Randomize Building Heights dialog.
- Bugfix: Preparation of Mean Num. of Storeys for Urban Control Values Data
          table.
- Bugfix: Updating of Urban Control Values when Land Use sum setting is changed.
- Bugfix: Copying of Building Parts when inside Complex Building.
- Bugfix: Building update when scaled in negative vertical direction using
          SketchUp Scale Tool.
- Bugfix: Visual fixes of some dialog elements.
- Bugfix: Verification of zoning constraints when randomize Building heights is
          used.
- Bugfix: Background of land use color selection field now properly follows
          selected color value.

2018.1 Release Candidate 2 (Beta)

- Enhancement: Improved Modelur initialization.
- Enhancement: Creating Buildings and City Blocks from faces that have hidden or
               soft edges.
- Enhancement: More robust upgrading from old Modelur versions.
- Bugfix: Calculation of Land Use dependent parameters (eg. number of required
          Parking Spaces) in Complex Building when its Gross Floor Area changes.
- Bugfix: Ruby error when selecting Land Use in Complex Building Urban Control
          Data Table.
- Bugfix: Fixed SketchUp Entities regression introduced in 2018.1 RC1.
- Bugfix: Updating of Urban Control Values when SketchUp Scene is changed.
- Bugfix: Urban Control Data Table sorting for Buildings and Complex Buildings.
- Bugfix: Creating Buildings and City Blocks from non-horizontal faces with
          inner holes (eg. atriums).

2018.1 Release Candidate 1 (Beta)

- Enhancement: Added option to save and import Land Use specifications.
- Enhancement: Added option to calculate primary units (apartments, offices,
               etc.) based on Net Floor Area.
- Enhancement: Min. Height to Distance Ratio changed to Percentage of Building
               Height.
- Enhancement: Show sum of selected Buildings in HeadsUp Display.
- Enhancement: General Modelur performance on OSX.
- Bugfix: Updating City Blocks values when selected via UI "Select All" button.
- Bugfix: Proximity check works correctly even when multiple Buildings are
          attached together.
- Bugfix: Modelur loading if layout file is corrupt.
- Bugfix: Notice when updating license fails if SketchUp is not connected to
          internet.
- Bugfix: GE optimized Buildings put on separate layer completely.
- Bugfix: Resetting City Block land use color.
- Bugfix: updating of City Block defined Whole Plot area when all City Blocks
          are hidden.
- Bugfix: Updating model when City Blocks and Buildings layers are hidden.

0.6.1 R02 (Beta)

- Enhancement: Improved Floating licensing.
- Bugfix: Improved decimals output in HeadsUp Display and Urban Control Data
          table.
- Bugfix: Copying of Buildings and City Blocks with non-default Land Use from
          one model to another.
- Bugfix: Export of Urban Design Control Values when Complex Buildings are not
          selected for export.
- Bugfix: Opening model with many Land Uses when using Trial license.

0.6.1 R01 (Beta)

- Enhancement: Improved initialization of Modelur.
- Enhancement: Internal FileUtils library switched to Ruby's Core Lib.
- Enhancement: Added free Modelur Viewer mode.
- Enhancement: Improved handling of City Blocks Layers.
- Bugfix: Automatic license update if it has expired.
- Bugfix: Manual license update if license has already expired.
- Bugfix: Warnings when too high Buildings are hidden or not yet built.

0.6.0 Technical Preview 2 (Beta)

- Enhancement: Added Danish translation. Thank you Uffe Gross Nielsen!
- Bugfix: Fixed City Block material selection (by Land Use or user defined).
- Bugfix: Loading of Land Use data when it doesn't exist in UI yet.
- Bugfix: Updating of Whole Plot area size when new City Blocks are added and no
          Buildings are present in the model.
- Bugfix: Saving of JSON files which contain strings with commas.
- Bugfix: Fixed City Block error when assessed investment is not set for
          selected Land Use.

0.6.0 Technical Preview 1 (Beta)

- Major Enhancement: Added City Blocks, which allow you to define default Zoning
                     Parameters and calculate Urban Control Values on City Block
                     level. Learn more at
                     https://modelur.github.io/docs/reference/city_block/
- Deprecated: Parametric Maps have been removed, use City Blocks instead. In
              case you have some models with Parametric Maps, you can still turn
              them on by executing the following code in SketchUp Ruby Console:
              "Modelur::enable_parametric_maps". Once executed, you will be
              asked to restart SketchUp. To disable Parametric Maps, execute
              "Modelur::disable_parametric_maps" in Ruby Console.
- Enhancement: Added Modelur Context Menu.
- Enhancement: Heads-Up Display of urban control values now shows name of
               selected Entity (Building and City Block).
- Enhancement: Descriptions of Modelur commands in SketchUp UI.
- Enhancement: Overloading of Parameters when multiple objects are selected.
- Enhancement: Hidden Buildings are not shown in Urban Control Data table and
               not exported to CSV.
- Enhancement: Improved editing of Complex Buildings and their Building parts
               when selected via Urban Control Data Table.
- Bugfix: Proper conversion of ComplexBuildings heights to number of storeys
          when base part has non-default first storey height.
- Bugfix: Exit VCB copying of Buildings when Modelur Parameter is changed.
- Bugfix: Building names can now start with number.
- Bugfix: Changing of dimension units when default Land Uses were erased.
- Bugfix: Updating of Complex Building values when Land Use requirements change.
- Bugfix: Marking of Terraces and Loggias when editing the Building manually.
- Bugfix: Creating Complex Building from scratch when default number of storeys
          is different than defined by default Complex Building itself

0.5.9 R5 (Beta)

- Bugfix: Opening of Modelur UI when license expires.

0.5.9 R4 (Beta)

- Enhancement: Added support for validating Modelur behind proxy using NTLM
               authentication protocol.

0.5.9 R3 (Beta)

- Enhancement: Newly created Buildings are placed on the Layer of the Face from
               which they are created.
- Enhancement: License moved to Modelur Appdata folder, so only one activation
               per user account is needed and it can be then used by different
               versions of SketchUp.
- Enhancement: Added option to check License data (Extensions > Modelur > Check
               License Data).
- Enhancement: Sum of selected Buildings data now shows also Gross Floor Area
               per Land Use.
- Enhancement: Added option to set Proxy server for Modelur online validation.

0.5.9 R2 (Beta)

- Enhancement: Improved readability of Whole Plot and Land Use data in Urban
               Control Data Table.
- Enhancement: Manual License update can now be called even if Modelur is not
               yet initialized.
- Enhancement: Materials observer.
- Bugfix: Urban Control Data Table Window initialization.
- Bugfix: Manual License update.
- Bugfix: Observers error when Urban Control Data has not yet been opened.
- Bugfix: Observers error when layer is switched in new SKP Model.
- Bugfix: Ruby error when image import is cancelled.
- Bugfix: Urban Control Data Table checkboxes for SketchUp 2014 and 2015.

0.5.9 R1 (Beta)

- Enhancement: Added Urban Control Data Table, so you can inspect all Building's
               values inside SketchUp. You can open it in Modelur User Interface
               > Tools > Open Urban Control Data Table.
- Enhancement: Improved Modelur update check.
- Bugfix: Sync of Building's first and other storey heights input value.

0.5.8 R3 (Beta)

- Enhancement: Added Modelur update notification.
- Enhancement: You can now reactivate Network License Seat even if it was
               released before without the need to restart SketchUp.
- Enhancement: Modelur now issues a warning and stops loading the model if the
               file was created with version of Modelur that is newer than the
               version installed.
- Enhancement: Added Building Name in Selected Building Survey.
- Bugfix: Colons disappearing in Land use panel.
- Bugfix: When ComplexBuilding can't be initialized properly, its Building Parts
          are not added to sum values.

0.5.8 R2 (Beta)

- Enhancement: Added HeadsUp Display of primary and secondary units for selected
               simple Buildings.
- Bugfix: Land Use removal, which reappeared if model was saved and later
          reopened.
- Bugfix: Fixed releasing of network license.

0.5.8 R1 (Beta)

- Enhancement: Added new default Land Use - Parking.
- Enhancement: Added calculation of Mean Number of Storeys for the Whole Plot.
- Enhancement: Required parking lots changed to parking lots deficit
               calculation. You can now set negative parking lots in eg. Parking
               Land Use and Modelur will calculate the difference between
               required and provided parking lots.
- Enhancement: Added options to exclude Land Use from calculating sums for the
               Whole Plot completely or to include only parking requirements.
- Enhancement: Primary and secondary Land Use units can now be set to empty
               value or 0 and Modelur will not calculate them.
- Enhancement: Added Land Use normative to calculate required parking area size.
- Enhancement: Disabled Release Network License menu entry for non-floating
               licenses.
- Enhancement: Added Parking Space deficit in sum of selected Buildings.
- Enhancement: Improved manual editing of Buildings.
- Bugfix: Fixed weird rotation when new Complex Buildings are created based on
          other Complex Buildings (SketchUp 2017 only).
- Bugfix: Complex Buildings optimization for Google Earth.
- Bugfix: Updating of selected Building height parameter when using imperial
          units.

0.5.7 R2 (Beta)

- Enhancement: Added option to easily rename Modelur Buildings (also in batch).
- Enhancement: Added option to choose whether to export Complex Building's parts
               and Land Use areas when exporting data to CSV.
- Bugfix: Fixed loading of SKP models that contain broken buildings.

0.5.7 R1 (Beta)

- Enhancement: You can now add loggias/cantilevers to only part of Building's
               wall.
- Enhancement: Added development timeline option. You can set each Building's
               construction and demolition date. Use Survey > Development
               Timeline > Slider to show different stages of development
               construction (urban control parameters are also calculated
               accordingly).
- Enhancement: Improved Help menu and English translations.
- Bugfix: Loading of Complex Buildings with non-default Land Use.

0.5.6 R3 (Beta)

- Enhancement: Added calculation of required Parking Lots based on Net Floor
               Area.
- Enhancement: Improved trial license request.

0.5.6 R2 (Beta)

- Bugfix: Randomization of Buildings heights.
- Bugfix: Unlimited Land-uses for Student License.

0.5.6 R1 (Beta)

- Enhancement: Improved urban control values CSV export.
- Bugfix: Improved creating and modifying of Complex Buildings when model axes
          are rotated.
- Bugfix: Improved calculation of Complex Buildings built areas.

0.5.5 (Beta)

- Enhancement: Updated French translation.
- Enhancement: Added floating (network) license option.
- Enhancement: Modelur can be loaded from non-default SketchUp plugins paths.
- Enhancement: Improved online validation so Modelur can be validated behind
               proxy, too.
- Enhancement: Improved Modelur activation.
- Bugfix: Fixed upgrading of old Modelur models, which didn't contain Mixed-use
          buildings.
- Bugfix: Fixed Trial License activation problem reported by some users.

0.5.4 (Beta)

- Enhancement: Added an option to request for a trial license during activation.
- Enhancement: Improved licensing.

0.5.3 (Beta - Release Candidate 2)

- Enhancement: Added license auto update (SketchUp 2014+).
- Bugfix: Marking of Complex Buildings when Urban Control Values are exported.
- Bugfix: Undo after Complex Building is created.

0.5.2 (Beta - Release Candidate 1)

- Enhancement: Improved automatic updating of Complex Buildings when it's parts
               are moved around.
- Enhancement: Improved licensing system.
- Enhancement: Improved export of urban control values.
- Bugfix: Calculation of urban control values when all Modelur Buildings are
          hidden.
- Bugfix: Export of urban control values when SketchUp model precision is set to
          integer rounding (no decimal points).
- Bugfix: Built-up area of manually modified Buildings now updates correctly if
          the Building is lowered to 1 storey (which makes it non-modified).

0.5.1 (Beta - Technical Preview)

- Enhancement: Updated English and Chinese translation.
- Enhancement: Improved handling of Complex Building Materials.
- Enhancement: Improved automatic rotation of Complex Building Bounding Box.
- Enhancement: Improved initialization of Modelur when it's default settings are
               corrupt or they can not be upgraded.
- Enhancement: Added information on how to fix Modelur installation if it didn't
               upgrade properly.
- Bugfix: Creating of Complex Buildings which are not on horizontal plane.
- Bugfix: Proximity check of Complex Buildings that contain manually modified
          Building Parts.
- Bugfix: Opening of .skp model which includes Buildings and Parametric Maps are
          present.
- Bugfix: Chekcking if Complex Buildings are inside of Parametric Maps area.
- Bugfix: Updating of Building's overloaded parameters when moved around the
          Parametric Map area.
- Bugfix: Fixed updating of Buildings when SketchUp Scale Tool is used in model
          with Parametric Maps.
- Bugfix: Call to manual license procedure when it can not be generated
          automatically.
- Bugfix: Opening the .skp model when Parametric Maps and Buildings are already
          present.

0.5.0 (Beta - Technical Preview)

- Enhancement: Added Complex (mixed-use) Buildings.
- Enhancement: New licensing system, which enables offline use.
- Enhancement: Buildings can now be created also from edges that form closed
               loop. You can select one of three options: 1.) do not create
               Buildings based on selected edges, 2.) create Building if only
               one edge is selected, 3.) create Building only if complete edges
               loop is selected.
- Enhancement: Added randomizing of Building's number of storeys (Tools >
               Randomize Buildings Heights).
- Enhancement: Improved performance when deleting remaining faces after
               Buildings were exploded.
- Enhancement: SketchUp 2016 specific - when there are many entities in the
               model, Buildings were updated slowly when number of storeys have
               changed. This has been greatly improved.
- Enhancement: Improved CSV export.
- Enhancement: Prevented erasing of Modelur Building entities such as faces or
               edges when editing Buildings manually.
- Enhancement: Added command line functionality to make some changes more
               quickly. When typing in S(sync) followed by a number in the First
               Storey Height parameter also changes Other Storeys Height to the
               same value, and vice versa.
- Enhancement: Added new shortcuts for changing parameters values in input
               fields: Shift + UP, Shift + DOWN, Ctrl + Shift + UP and Ctrl +
               Shift + DOWN.
- Enhancement: Improved automatic orientation of new Modelur Buildings.
- Enhancement: Improved copying of Modelur Buildings, which are now moved a bit
               so you can easily see them.
- Enhancement: Copying of Buildings is now completely transparent so that it
               does not interfere with SketchUp undo/redo mechanism.
- Enhancement: Modifying of Buildings using SketchUp native Scale Tool is now
               completely transparent so you can now easily change its scale
               using Value Control Box the same way as with all regular Sketchup
               objects.
- Enhancement: Improved proximity check between Modelur Buildings.
- Bugfix: Regeneration of Building's Bounding Box if pushpull or storey heights
          are undone.
- Bugfix: Handling of Modelur Buildings when layers containing them are deleted.
- Bugfix: Modelur materials are now persistent, so there are no more errors when
          some of them get purged.
- Bugfix: Modelur doesn't crash if some of the parametric maps are missing.
- Bugfix: Copying Modelur Buildings from one .skp model to another.

0.4.5 (Pre-beta 4)

- Announcement: Please note that this is the last public release in Modelur
                Pre-Beta series. If you would like to be one of the first to
                test the upcoming Modelur Beta - which will be available to
                invited users only - please make sure to reserve your seat by
                filling out the invitation request form at
                http://bit.ly/beta-request.
- Enhancement: Modelur updated for SketchUp 2016.
- Enhancement: Better user interface experience when Modelur is not valid
               anymore.
- Bugfix: Proper initialization of Building's parameters when parametric maps
          are used.
- Bugfix: No more errors when Building's are dragged out of parametric maps
          using Modelur move tool.
- Bugfix: Repaired Google Earth export.
- Bugfix: Properly calculated values for Buildings when saved model is opened.
- Bugfix: Updating of secondary control values when Building is scaled only in
          horizontal direction.
- Bugfix: Manual editing of buildings when terraces are made on all sides of the
          building.

0.4.4 (Pre-beta 4)

- Enhancement: Improved handling of empty Buildings (when user erases all faces
               inside Sketchup Group that represents Modelur Building).
- Enhancement: Added explicit selection of visible Parametric maps - to select
               Parametric map, which is shown in 3D viewport, just click on its
               name in Modelur UI.
- Enhancement: Improved proximity check, which now skips Buildings that are
               hidden.
- Bugfix: Fixed initialization of Modelur if there are some incomplete Land Uses
          in .skp model.
- Bugfix: Proper calculation of Building's built-up area when it is modified
          manually.
- Bugfix: Improved handling of manually modified Buildings.
- Bugfix: Cleanup of coplanar faces inside Modelur Building.
- Bugfix: fileutils.rb renamed to modelur_fileutils.rb so that it doesn't clash
          with the one that comes with SketchUp.

0.4.3 (Pre-beta 4)

- Enhancement: Buildings will now be created properly even when faces they are
               created from are not completely horizontal.
- Enhancement: Vertical edges of Buildings with coplanar walls are now
               automatically erased.
- Enhancement: Rounded Building walls are now smoothed if they their plane angle
               is below specified angle threshold (20° by default).
- Enhancement: Modelur user interface is properly refreshed when Building is
               selected before Modelur is initialized.
- Enhancement: Improved Buildings proximity check when Modelur Move Tool is
               used.
- Enhancement: Improved Urban Control Values .csv export.
- Enhancement: Improved Building warnings when they are outside parametric maps.
- Bugfix: When Buildings are created, they are now properly marked if they are
          not inside parametric maps.
- Bugfix: Using proper parameter values when rotated Buildings are created on
          parametric maps.
- Bugfix: Fixed storing of user preferences, a glitch which appeared in v0.4.2.
- Bugfix: Heads-up display of Building control values is refreshed even if
          Modelur user interface is hidden.
- Bugfix: After Building parameter is changed and confirmed with Enter, no new
          Buildings are created.
- Bugfix: Refreshing of Land Use control values in Modelur user interface.
- Bugfix: Copying Buildings via Value Control Box works properly if Building
          proximity check is engaged during the process.
- Bugfix: Improved Heads-Up Display of Urban Control Values.

0.4.2 (Pre-beta 4)

- Enhancement: Some of Modelur buttons and menu items disabled if Modelur is not
               initialized.
- Enhancement: All new Buildings are now renamed to Modelur Building upon
               creation.
- Enhancement: Added Building's name when exporting (Buildings) Urban Control
               Values to .csv.
- Enhancement: Copy Buildings command, which caused some confusion among Modelur
               users, moved from Modelur Toolbar to Modelur Plugins/Extensions
               menu entry.
- Enhancement: No changes in parametric map material when opening skp model.
- Enhancement: Parametric map material hidden when all maps are deactivated.
- Enhancement: Added Modelur options description, which is visible in Status
               bar.
- Enhancement: Improved checking of distances between Modelur Buildings.
- Enhancement: Proximity check now works in real-time as Buildings heights are
               being changed.
- Bugfix: No more javascript errors on SketchUp versions 2013 and below when
          .skp model with Parametric maps is loaded prior to Modelur
          initialization.
- Bugfix: Restoring of Modelur Buildings, which were created by duplicating
          existing Buildings.
- Bugfix: Modelur HeadsUp display now works properly if it is deleted when .skp
          model is loaded prior to Modelur initialization.
- Bugfix: Proper reset of Building to default values (if needed) when undo is
          called after Scale Tool was used.
- Bugfix: No more distorted SketchUp Entities when creating Modelur Building
          from Faces that touch other Entities.

0.4.1 (Pre-beta 4)

- Enhancement: If Modelur UI doesn't show up properly, you can now reset Modelur
               settings by clicking on Extensions (Plugins prior to SU 2015) >
               Modelur > Restore default settings in SketchUp menu.
- Enhancement: Sum of Land Use and Whole Plot values is now calculated only for
               visible buildings. This way you can now e.g. create different
               development alternatives and put them on separate layers. Hiding
               the layer will take all buildings on that layer out of the urban
               control values calculation for both Land Uses and the Whole Plot.
- Enhancement: Parametric Maps are saved into SketchUp .skp model.
- Enhancement: Optimized performance of Modelur Move Tool.
- Enhancement: Improved creation of new Modelur Buildings. Buildings with
               selected default floor plan are now created even if some other,
               non-Face SketchUp objects are selected. They are also properly
               created when the Face they are made of intersects with some other
               Face in the Model.
- Bugfix: Bounding Box is now properly shown when Buildings are modified
          manually.
- Bugfix: Improved Undo/Redo mechanism, which is now better integrated into
          SketchUp.
- Bugfix: Updating of Building's Built-up Area when ScaleTool is used and "Keep
          Built-up Area when scaling manually" in turned on.
- Bugfix: Color distance bug with gray images and land uses.

0.4.0 (Pre-beta 4)

- Enhancement: Added Parametric Maps functionality. To update Modelur Buildings
               to parameters from Parametric Maps in real-time, use the provided
               Modelur Move Tool (blue cross arrow in Modelur Toolbar). At the
               moment .png, .jpg or .gif file formats are supported by
               Parametric Maps.
- Enhancement: Calculation of building control values displayed inside Modelur
               UI.
- Enhancement: When creating new building with no faces selected, all Parameters
               are set to default.
- Enhancement: UI design changes
- Bugfix: Undo works when parameter of Whole Plot or Land Use is changed in the
          Modelur UI.
- Bugfix: Updating of Urban Control Values when Modelur Buildings are deleted
          and some other locked entities are selected.
- Bugfix: Updating of Urban Control Values when Modelur Buildings are deleted
          and deletion is then undone.
- Bugfix: Creating of Buildings with convex floor plan and default Built Area.
- Bugfix: Updating of Buildings when Scale Tool is used together with keep
          Built-up Area when scaling manually option turned on.
- Bugfix: Importing Google Earth Terrain is not crashing anymore if Modelur is
          running.

0.3.6 (Pre-beta 3)

- Enhancement: Update for SketchUp 2014.

0.3.5 (Pre-beta 3)

- Enhancement: Length units are now recalculated and written to defaults when
               user switches between metric and feet.
- Enhancement: If .skp model is loaded, only length units preference is loaded
               from it, while all other preferences (eg. language) are loaded as
               specified by the user. Of course, user can still switch length
               units.
- Enhancement: Huge performance improvement on large models when duplicating
               Modelur Buildings using Value Control Box mechanism.
- Enhancement: Modelur better mimics behavior of SketchUp when using its native
               Value Control Box mechanism.
- Enhancement: Buildings are not warned anymore when they are touching each
               other, as we consider them as one building structure.
- Enhancement: Buildings now react to Scale Tool when their height is changed
               via Value Control Box, too. For example, you can now use Scale
               Tool to start raising Building and the type in *5 + Enter which
               will raise the Building five times.
- Enhancement: More intuitive handling of overloaded parameters, when they are
               set back to default values.
- Bugfix: HeadsUp Display showing Building and Whole Plot values is now loaded
          properly (as defined by user preferences) when .skp model is opened.
- Bugfix: Fixed Modelur Building copy/paste mechanism.
- Bugfix: Proximity check (warnings when buildings are too close together) is
          now engaged automatically when Modelur is started if set so by
          preference.
- Bugfix: Fixed undo mechanism when Modelur building is deleted.
- Bugfix: Fixed updating of manually modified Modelur Building when user moves
          its corner. Please note that you need to select all vertically aligned
          edges (whole corner) to use this functionality!
- Bugfix: Overloaded Building parameters are now updated properly when default
          (Whole Plot) parameters change.
- Bugfix: Fixed updating of terraces and loggias when Building floors are added
          or removed.
- Bugfix: Fixed restoring of manually modified Modelur Buildings to default
          values.
- Bugfix: Fixed duplicating Building mechanism when default land use is not the
          same as it was in the previous model.
- Bugfix: Fixed refreshing of terraces and loggias when buildings are stretched
          in horizontal plane.
- Bugfix: Fixed Building Bounding Box size when buildings are scaled in
          horizontal plane plane and they are set to keep built area.
- Bugfix: Buildings are now properly duplicated when using Rotate Tool and Value
          Control Box mechanism to create several instances of selected
          Building.
- Bugfix: Building terraces and loggias are now properly marked (according to
          preference) when .skp model is opened.
- Bugfix: Fixed storing of selected Land Uses in both, Land Use requirements and
          Urban control - Land Use panels when they are not present in
          preferences.

0.3.4 (Pre-beta 3)

- Enhancement: Modelur remembers changes on the user interface layout.
- Enhancement: When Modelur is run for the first time, it loads in the language
               of SketchUp if translation exists.
- Enhancement: Options 'Calculate sum values of selected Buildings', 'Optimize
               Building for Google Earth', 'Toggle Built-up Area visibility',
               'Toggle terraces and loggias' moved from Sketchup Plugins menu to
               the user interface
- Enhancement: Modelur initialization message is now in the same window as
               Modelur's user interface itself.
- Bugfix: Bounding box is now properly refreshed when user changes number of
          storeys or height of the Building if it is selected and Scale tool
          activated.
- Bugfix: Loggias are now properly defined when user modifies Building manually.

0.3.3 (Pre-beta 3)

- Enhancement: Added validation check of Modelur Buildings. User is now warned
               if Modelur finds some corrupted building, which are not
               parametric anymore.
- Enhancement: User interface is updated with Urban Control Indicators while
               Modelur Buildings are being manually edited.
- Enhancement: Improved optimization and preparation of 3D model for Google
               Earth export.
- Bugfix: Neighbor Buildings, which were too close to selected one are now
          unmarked when the Building is far enough.
- Bugfix: Fixed initialization of .skp models which contain one-storey Modelur
          Buildings.
- Bugfix: Fixed error when lowering other storeys height in manually modified
          building.

0.3.2 (Pre-beta 3)

- Enhancement: Language selection dropdown now sorted alphabetically.
- Enhancement: You can now copy/paste Modelur Buildings between different .skp
               models.
- Enhancement: Improved Modelur menu behaviour - panels now close automatically
               after selection is made.
- Enhancement: All Modelur methods moved to MODELUR namespace so there is less
               chance of Modelur clashing with other plugins.
- Enhancement: Chinese and Spanish translations back to 100%! Thank you Edgar
               Navas and Xiaoqi Wang!
- Bugfix: Fixed wrong dropdown translations for primary and secondary Land Use
          units when language is changed.
- Bugfix: No more user interface freezing when the default language is switched
          to Chinese.
- Bugfix: Land Use Requirements panel is now properly refreshed when last Land
          Use in dropdown is deleted.
- Bugfix: Primary and secondary units are now refreshed properly when language
          is changed on Windows platform.

0.3.1 (Pre-beta 3)

- Enhancement: Added error message when incompatible version of Modelur model is
               opened.
- Enhancement: Improved undo mechanism for deleted buildings. They are now
               recreated properly; nonetheless they should be avoided as much as
               possible as it might lead to unexpected behaviour when used
               repeatedly.
- Enhancement: Added exporting of Urban control value survey. Users can select
               which data they would like to export: Whole Plot, Land Uses and
               Buildings.
- Enhancement: Added option to choose the default shape of the building when
               creating it with no faces selected. Supported shapes: square,
               circle and L-shaped building.
- Enhancement: Improved Modelur icons.
- Enhancement: Improved Modelur version upgrade system and initialization
               methods.
- Enhancement: Added Modelur Help options (video tutorials, forum, blog, ...)
- Bugfix: Fixed Land Use survey calculations when opening saved models.
- Bugfix: Location of built-up area face inside the building if it is not on the
          horizontal plane.
- Bugfix: Fixed showing of terraces and loggias using materials.
- Bugfix: Calculation of number of primary units (e.g. apartments) and required
          parking lots due to Length class rounding error.
- Bugfix: Fixed saving of default settings.

0.3.0 (Pre-beta 3)

- Note: Major Modelur core engine and user interface update. Most of the code
        rewritten.
- Enhancement: Added dynamic Land Use system, so end-users can add their own
               land uses. Land uses can also be renamed.
- Enhancement: Added Modelur Toolbar with Initialize Modelur,Create Building and
               Copy building buttons.
- Enhancement: Improved mechanism for duplicating buildings via Value Control
               Box.
- Enhancement: If no face is selected when a user wants to create a building
               Modelur creates it automatically. User can choose between square,
               circular or L shape.
- Enhancement: Added option to colour terrace and loggia floors so end-users can
               check if correct faces as marked.
- Enhancement: Renaming land use material in SketchUp also renames the land use
               itself. Vice versa works only on SketchUp 8M1 and above.
- Enhancement: Added SketchUp Modelur menu language translations.
- Enhancement: Added user interface Status Bar, which explains abbreviations.
- Known limitation: undoing Modelur parameter changes works only partially.

0.2.9 (Pre-beta 2)

- Note: This is the last version of Modelur Pre-beta 2. It will stop to work on
        31st of July 2013. Please note that Modelur Pre-beta 3 will not be
        backward compatible!

0.2.8 (Pre-beta 2)

- Bugfix: Multiple buildings can now again be created in one step.

0.2.7 (Pre-beta 2)

- Enhancement: Exporting urban control values now also exports the values for
               each building and marks buildings in 3D model by their unique IDs
               (marks are placed to layer Buildings UIDs).

0.2.6 (Pre-beta 2)

- Enhancement: Improved performance of realtime distance checking between
               buildings.
- Enhancement: Improved VCB copying mechanism.

0.2.5 (Pre-beta 2)

- Note: Beginning with version 0.2.5, Modelur works also with Google SketchUp 8.
- Enhancement: Improved Chinese translation of user interface. Thank you Wantao
               Xiao!
- Bugfix: Fixed changing of metric/imperial units.

0.2.4 (Pre-beta 2)

- Enhancement: Major stability improvement when buildings are being duplicated
               extensively in 3d view.
- Enhancement: Dutch translation of user interface. Thank you Gertjan
               Laurenssen!
- Enhancement: Spanish translation of user interface. Thank you Diego Rodriguez!
- Enhancement: 'Invisible' UI scroller. Usage: select a building, click on input
               field (i.e. Building > Number of storeys), press Shift key and
               scroll mouse wheel - selected building will update itself to the
               new value. Change scroll stepping by holding Ctrl in addition to
               Shift key.
- Enhancement: Automatic fixing of rotated floor plans when creating building.
               Modelur now tries to create orthogonal bounding box for
               buildings, so they can easily be scaled.
- Enhancement: Basic optimization of buildings for Google Earth export.
               Optimized geometry can be found in Modelur2GE layer. This feature
               is still in development.
- Enhancement: Improved input parameters handling. User interface can now accept
               different styles of input data (i.e. decimals written with dot or
               comma, whitespaces, alphabet characters) and handles them
               automatically.
- Enhancement: Newly drawn (floor plan) faces are now selected automatically, so
               it one does not have to select it by hand in order to create
               Modelur building from it.
- Enhancement: Newly created buildings now get the default name 'Building', so
               one can easily found them in the Outliner.
- Enhancement: Improved calculation of mixed use ratio.
- Bugfix: Fixed bug which prevented to duplicate last duplicated building in 3d
          view using Ctrl/Cmd key.
- Bugfix: Fixed bug for 'Manually drawn floor plan assumes default built area'
          checkbox.
- Bugfix: Fixed creation of building when default number of storeys is 1.

0.2.3 (Pre-beta 2)

- Bugfix: Hotfix for bug, which prevented to set plot area size and parking lots
          normatives.

0.2.2 (Pre-beta 2)

- Enhancement: Huge performance optimization when opening .skp model with many
               Modelur buildings. Model now opens 10-50 times faster.
- Enhancement: Optimized performance of urban control values calculation (about
               30% faster).
- Enhancement: Improved communication speed between Modelur user interface and
               its engine.
- Enhancement: Improved reaction to scale tool.
- Enhancement: Improved calculation of built area.
- Enhancement: Improved checking of user defined parameter values in user
               interface.
- Enhancement: Added Chinese translation of user interface. Thank you Huaqiao
               Wang and James Baq!

0.2.1 (Pre-beta 2)

- Enhancement: Improved calculation of building volume and built area.
- Bugfix: Fixed bug of gross floor area calculation when terrace or loggia
          normative is changed.
- Bugfix: Fixed undo/redo stack (SketchUp 7).
- Bugfix: User interface bug fixes.
- Bugfix: Fixed bug that prevented realtime update of building control values
          when user changed parameter of terrace or loggia percent.

0.2.0 (Pre-beta 2)

- Enhancement: Advanced manual editing of buildings which enables the creation
               of terraces and loggias. How much they contribute to gross floor
               area of building is defined as percentage, in Terrace gross floor
               area percent and Loggia gross floor area percent, respectively.
- Enhancement: Menus added to the user interface, which now works on Internet
               Explorer 6 also.
- Enhancement: Modelur now works offline too, yet it has some limitations.
- Enhancement: Export of urban control values to .csv file.
- Enhancement: Calculation of net floor area, based on percentage of gross floor
               area. Defined as Percent of usable gross floor area.
- Enhancement: Distance units can now be switched between metric (meters) and
               imperial (feet).
- Enhancement: Warnings about minimal distance between buildings (default 4m).
- Enhancement: Simplified applying of texture to the terrain.
- Enhancement: Polish translation of user interface. Thank you Tomasz Gutowski.
- Enhancement: Duplication of buildings via Value Control Box together with some
               other minor bugfixes.

0.1.1 (Pre-beta 1)

- Enhancement: Modelur is now available also on Apple Mac OS X.
- Enhancement: We have also added French, German and Portuguese translations of
               user interface. Thank you Pilou, Burkhard and Edson from
               Sketchucation!

0.1.0 (Pre-beta 1)

- Note: This is the initial release of Modelur Pre-beta version.

-------------------------------------------------------------------------------
5.  KNOWN LIMITATIONS
-------------------------------------------------------------------------------

- When using Live connection to Excel, the Sketchup might become unresponsive if
  Excel requires user attention. Proposed solution: switch to Excel and finish
  the operation in Excel, the Sketchup should become responsive again.
- GIS import is not working well with edge cases, eg. when parts of model are on
  different sides Equator or when attribute names contain non-ascii characters.
- GIS Data import is limited to WGS84. Area calculation differs for a small
  amount (usually < 1%) from area calculated with GIS applications as areas are
  calculated using Cartesian (flat) instead of Spherical method.
- Live connection to Excel only works on Windows OS.
- SketchUp 2019 and below: slow performance and opening of large models when
  SketchUp's Outliner panel is opened. Proposed solution: hide the Outliner when
  opening the model (and when working with Modelur).
- Complex Buildings currently don't take into account terraces and loggias when
  calculating Gross Floor Area.
- Manually edited buildings might behave strange or even get corrupted when
  changing number of storeys. Proposed solution: make manual editing only after
  you will not be changing Building's number of storeys anymore.

-------------------------------------------------------------------------------
6.  GETTING HELP
-------------------------------------------------------------------------------

6.1 User Guide

Documentation on how to use Modelur can be found at
http://userguide.modelur.com.

6.2 Video tutorials

To learn basics of Modelur, we are currently providing Modelur video tutorials,
which are available on YouTube Modelur channel. You can take a look at the them
at www.youtube.com/modelur.

6.3  Modelur Support

AgiliCity is committed to providing a reliable, high-quality product that is
easy to use. If you have any problem installing or using Modelur, we want to
know about it.

In case you have any questions, please send us an email to support@modelur.com.

-------------------------------------------------------------------------------
7.  PURCHASING MODELUR
-------------------------------------------------------------------------------

You can purchase your license of Modelur at https://modelur.com/.

-------------------------------------------------------------------------------
8.  LICENSE AND LEGAL DOCUMENTS
-------------------------------------------------------------------------------

Downloading, installing and using Modelur is subject to its End User License
Agreement (EULA) and its related documents which can be found at
https://modelur.com/legal/.

-------------------------------------------------------------------------------
9.  CONTACT INFORMATION
-------------------------------------------------------------------------------

AgiliCity d.o.o.
Pri malem kamnu 11
SI-1210 Ljubljana
Slovenia, EU
VAT ID: SI75471256

Phone: +386.5.901.87.98
E-mail: info@modelur.com
Web: https://modelur.com

©2026 AgiliCity d.o.o.. All Rights Reserved.
