==========================================================================
  Engimetry Link - a plugin for SAP2000
==========================================================================

  It lets the Engimetry website build your frame in the SAP2000 that is
  already open on this computer. No Python, no file to import.


--------------------------------------------------------------------------
  WHICH STEPS ARE YOURS
--------------------------------------------------------------------------

  Find your SAP2000 version under Help > About SAP2000.


  SAP2000 v22.2 AND NEWER  -  nothing to install
  ..........................................................................

    1. Put this folder somewhere it can stay. C:\Engimetry is fine.
       Do not leave it in Downloads: SAP2000 remembers the path.

    2. Right-click each .dll inside, choose Properties, and tick
       "Unblock" if you see it. Windows blocks files that came from a
       zip, and a blocked DLL fails silently.

    3. In SAP2000:  Tools > Add/Show Plugins
       Press Browse, and pick:

           net48\EngimetryLink.dll          for v22.2 to v25
           net8\EngimetryLink.dll           for v26 and newer

       The Plugin Name and Menu Text fill themselves in.
       Press Add. The status must say OK.


  SAP2000 v20 TO v22.1  -  one script, once
  ..........................................................................

    These versions cannot browse for a plugin, so it must be registered
    with Windows first.

    1. Put this folder somewhere it can stay.

    2. Right-click install.bat  >  Run as administrator.
       It unblocks the files and registers the plugin.

    3. In SAP2000:  Tools > Add/Show Plugins
       Type exactly:

           Plugin Name:   EngimetryLink
           Menu Text:     Engimetry Link

       Press Add. The status must say OK.


--------------------------------------------------------------------------
  USING IT
--------------------------------------------------------------------------

  1. In SAP2000:  Tools > Engimetry Link
     A small window opens and shows a pairing code.

  2. In Engimetry:  SAP2000 > Export Model  (or Ctrl+E)
     Type the pairing code into the box. Once is enough - it is
     remembered on both sides.

  3. Press "Send to SAP2000".

  Leave the Engimetry Link window open while you work. Closing it stops
  the link; opening it again from Tools starts it back up.


--------------------------------------------------------------------------
  IF IT DOES NOT WORK
--------------------------------------------------------------------------

  "The status does not say OK when I press Add"
      The DLL is blocked, or it is the wrong one for your version.
      Unblock it (step 2 above) and check the net48 / net8 choice.

  "Engimetry says there is no plugin on this computer"
      The Engimetry Link window is not open. Tools > Engimetry Link.

  "Engimetry says this website is not allowed"
      The Engimetry Link window will show the address and an Allow
      button. Press it, then send again.

  "Engimetry says the pairing code is wrong"
      Copy it again from the window - it changes if somebody pressed
      "New code".

  "Port 8787 is already taken"
      An older Python bridge is probably still running. Close its
      console window.


--------------------------------------------------------------------------
  WHAT IT TOUCHES
--------------------------------------------------------------------------

  Listens on 127.0.0.1 only - this computer talking to itself. It is not
  reachable from the office network or the internet.

  Settings and the pairing code are kept in:
      %APPDATA%\Engimetry\bridge.json

  To remove it: uninstall.bat (v20 to v22.1 only), then take it out of
  Tools > Add/Show Plugins and delete this folder.

==========================================================================
