Troubleshooting

My Superhive order code is rejected

Almost always the wrong number. Superhive shows two identifiers per order:

Find the code with your order under Orders in your Superhive account. If you have just bought it, wait a minute and try again — the order takes a moment to register. Still stuck? Email Lucas Azar with your order details and you will get a key by hand.

Blender says a different port than I configured

Port: 9877 (was 9876) means your configured port was already in use. The server automatically tries the next nine ports. Set the Rhino panel to the port actually shown, or stop the server, change the port in preferences, and start again.

Rhino will not connect

Work through these in order:

1. Is the Blender server started? The header must show a link icon, not inactive.
2. Do the ports match, including any automatic fallback?
3. Is there a pending approval prompt waiting in the Blender sidebar?
4. For a remote machine: is Allow remote connections on, and was the server restarted after enabling it?
5. Check the Rhino panel log for the failure reason.

Geometry appears twice

Usually a source-name change. Press Purge stale sources.

If it happens after converting objects into a block, this was fixed in 2.17.1 — check your versions match on both sides. The Blender add-on flags version skew during the handshake.

An object looks wrongly smoothed

Select it and press Audit shading, then read the line it writes to the Sync Log. Meshes saved by much older versions are healed automatically on first re-adoption.

Materials I assigned keep disappearing

Materials assigned to block definition geometry apply to every instance and are preserved. Materials assigned to an individual instance cannot be, because the instance has no mesh data of its own. Use Make block real on that instance first.

Blocks are drawn twice, once at the origin

Show block definitions is on. Turn it off before rendering.

A push to Rhino did nothing

Check the Rhino panel log. push 'push_surface' not supported yet or push 'push_step' not supported yet means the object type is not implemented — see section 16.

The first sync of a large document is slow

Expected: every Brep must be tessellated. Lower Detail to Coarse, leave Clean quads off, and use Selection only or a layer filter to send less. Later syncs are incremental and much faster.

Syncing the same file from two machines re-imports everything

Turn on Shared source in the Rhino panel on both machines.

An object never arrives in Blender, or Blender got slow after a sync

Check the Rhino panel log. After each index it lists the objects that need attention:

• render mesh has N vertices (limit 150000) — SKIPPED — the object was not sent. Almost always degenerate geometry: a surface with an extreme parameter-space aspect ratio makes Rhino's adaptive mesher produce millions of vertices for one object, which stalls Blender for many minutes. Rebuild the object in Rhino, or lower its render-mesh density (Properties > Mesh). If the object is legitimately that dense — a scan, a dense terrain — raise Max vertices / object in the panel's Mesh section (0 removes the limit) and press Full sync.
• heavy render mesh (N vertices) — synced — the object arrived, but it alone will make every viewport redraw, shading pass and .blend save slower. Usually a meshing-density setting rather than real detail.

Press Select problem objects to select every flagged object in Rhino at once, rather than finding them by name.