Zircon3D community

Tami Liu

@haoxian2023 Glad it is working now! Good job!

Tami Liu

@haoxian2023
Thanks for the detailed log.

The new error:

ENETUNREACH 198.18.0.18:443

It means the add-on cannot reach the target network at all (network unreachable) from the HA server, which is different from the previous Firebase error. This usually indicates the VPN/proxy is not applied to the Home Assistant add-on container itself, even if it works on your phone or NAS.

Key point:

The Zircon3D add-on runs inside a Docker container, and:
It does NOT automatically use your system/NAS VPN or proxy
Environment proxy variables often don’t work unless the container is explicitly configured to route traffic through it

What likely happened
Your VPN works on your device
But the HA add-on container is still using the normal network
So requests to zircon3d.com (and Firebase) fail or get routed to invalid IPs like 198.18.x.x

Recommended solution

Run Home Assistant through a system-level VPN:

Install VPN on your router, or
Install VPN directly on the Home Assistant host machine

This ensures all containers (including Zircon3D) can access the internet properly.

Also, just to confirm, are you located in China?
Currently, Zircon3D relies on Google Firebase services, which are restricted in China. Because of this, Zircon3D is not well supported in China at the moment due to network limitations.

Sorry about this, we understand it’s inconvenient and are considering alternative solutions for better regional support in the future.

Tami Liu

@haoxian2023
Hi, it seems Google services (including Firebase Authentication) are blocked, so Zircon3D cannot create the online session. That’s why you see:

auth/network-request-failed (fetch failed)

Zircon3D currently requires access to Google Firebase for login/session initialization, even though the rest of the system runs locally.

Possible solutions:
1. Use a network that can access Google services (VPN or similar)
2. Configure your router or system to allow outbound access to Firebase/Google APIs
3. If you already have a VPN on your network, make sure the Home Assistant machine (not just your phone/PC) is also using it

Notes:
• This issue is not related to your Home Assistant setup, your logs show HA connection is working fine
• It’s purely a network restriction to Firebase

Tami Liu

@Nima-Hamed Thanks for the reply!
Tuya is great to know, that helps us a lot when planning support.

Regarding the touch experience: in our latest version, we’ve introduced a Control panel designed for touch devices (please see the attached screenshot). This is a temporary solution to improve usability on phones and tablets.

If you don’t see the control icon in the bottom bar, please make sure your add-on is updated to the latest version.

We agree that touch interaction is very important, and improving it is definitely on our roadmap. We’ll continue refining the experience and adding more touch-friendly features in future updates.

Thanks again for your feedback!

Tami Liu

Hi Nima, thanks for your question!

At the moment, shade/cover controls (such as a position slider) are not yet supported in the UI. However, we’ve discussed this with our team, and support for window shades, including slider-based position control, is definitely on our roadmap for a future update.

If I may ask, what brand or integration are you using for your shade motors? This helps us ensure the feature works well with real-world setups.

In the meantime, you can still link your shade entities to objects in the 3D view and monitor their state. Interactive control (like adjusting the position directly from the floorplan) will be available in a future release.

Thanks again for your feedback, it’s very helpful for us!

chris

Hi, unfortunately we don't have this feature currently.
But that's an interesting idea and we do have this feature in our backlog, we will add it in near future, please stay tuned.

Tami Liu

A common question from new users is whether Zircon3D requires a cloud connection to run.

The short answer is no, Zircon3D is designed to run locally.

Local Operation

All core functionality of Zircon3D runs locally inside your Home Assistant add-on, including:

3D floorplan modeling
Real-time data visualization
Heatmaps and dashboards
Sensor monitoring
Device interaction and controls

Zircon3D reads data directly from your Home Assistant instance, so your monitoring and visualization continue to work even without external services.

Your data and floorplans remain stored locally on your system.

Zircon3D Account and Licensing

To use Zircon3D, you will need a Zircon3D online account.
This account is used for license management.

Normally, the add-on performs a quick online license verification.

Offline Activation

If your system does not have internet access, Zircon3D can still be activated.

You can generate a manual license token from the Zircon3D website and paste it into the add-on to activate your license.

This allows Zircon3D to continue operating in restricted or offline environments.

Optional Cloud Backup for Floorplans

Zircon3D also provides an optional cloud backup for your floorplan projects.

If enabled, your floorplan design can be uploaded to the cloud, which helps prevent data loss if you reinstall Home Assistant or move to another system.

Important to note:

Only floorplan project data is stored in the cloud
Sensor data and Home Assistant data are never uploaded
Visualization still reads live data directly from Home Assistant

You can learn more about local vs cloud mode in this article:

https://forum.zircon3d.com/topic/9/explained-zircon3d-local-vs-cloud-mode

Summary

3D rendering and visualization run locally
Data comes directly from Home Assistant
Your monitoring data stays inside Home Assistant
A Zircon3D account is required for licensing
Offline activation is supported
Optional cloud backup for floorplan projects

This design keeps Zircon3D aligned with the local-first philosophy of the Home Assistant ecosystem while still providing optional convenience features.

Tami Liu

Hi,

Thanks for the feedback and for sharing your use case!

That’s a very interesting idea. We’ll discuss this feature with our team, and we’ll get back to you after evaluating it.

Tami Liu

We’re excited to announce Zircon3D v2.1, bringing several usability improvements, better visualization controls, and refinements based on user feedback. This update focuses on improving the experience on mobile devices, heatmap visualization, and floorplan editing precision.

Below are the highlights of this release.
ou can also check out the video overview of this release here:
https://youtu.be/3_3LnBEamoQ

3D View Control Buttons (Mobile & Tablet Friendly)

To improve usability on touch devices, we added on-screen control buttons for common camera actions:

Rotate view
Pan the scene
Zoom in/out

These controls make it much easier to navigate the 3D scene on tablets and phones, especially for wall-mounted dashboards or touchscreen environments.

Data Card Display & Heatmap Overlay Improvements

We improved how data cards interact with heatmaps and added new display controls to reduce visual clutter when monitoring your building, including:

Better readability when heatmaps are active
Reduced overlapping between heatmaps and data panels
Cleaner visualization in environments with many sensors

These improvements make the heatmap view clearer and easier to interpret, especially in complex buildings with dense sensor deployments.

Card Display Modes

Three modes are available:

Detailed – Show all sensor data panels (current behavior).
Compact – Only show data panels related to the currently selected heatmap value.
Hidden – Hide all floating data panels for a clean heatmap visualization.

This makes it easier to focus on specific environmental metrics without unrelated sensors cluttering the view.

Additional Display Options

Two new options provide further control over what appears in the 3D scene:

Show Action Cards – Toggle the display of interactive device cards such as switches or cameras. These appear as small icon bubbles in the scene.
Enable Occlusion – Prevent data panels and action icons from rendering through floors. Elements hidden behind floors will now remain hidden, improving visual realism in multi-floor buildings.

Sensor Icons for Better International Usability

Zircon3D now supports automatic sensor icons for common values such as:

Temperature
Humidity

These icons appear in the data panel, making sensor types easier to identify even when entity names are not in English.

Disable Wall/Room Auto-Attach Helper by Holding Shift

When editing floorplans, Zircon3D normally uses an auto-attach helper to snap walls and objects together.

For more precise editing, you can now:

Hold the Shift key to resize rooms freely without auto-attach helper.

This allows finer control when adjusting room shapes or sizes.

Preview Button for Quick Viewing

A new Preview button has been added to the top toolbar.

This allows you to instantly preview your building visualization without manually switching to another view tab. You can quickly check how your floorplan and devices appear in the final scene while editing.

This makes the workflow faster when designing your building, letting you switch between editing and viewing at any time with a single click.

Automatic Switching Between Editing Modes

Zircon3D now automatically switches between Building Edit Mode and Object Edit Mode based on the element you select in the scene.

Building Edit Mode – for editing structural elements such as walls and rooms.
Object Edit Mode – for editing objects such as furniture, doors, windows, and devices.

This removes the need to manually change editing modes and makes the editing workflow more intuitive when building your home or facility model.

Bug Fixes & Performance Improvements

As always, this release also includes:

Various bug fixes
Performance improvements
General stability enhancements

Feedback Welcome

Many of these improvements were inspired by community feedback.
If you have suggestions or feature ideas, feel free to share them in the forum.

Tami Liu

@lina-sayeb Hi,

At the moment, Zircon3D doesn’t support importing external 3D models (such as .gltf files) yet.

For now, you have a couple of options:

1. Use the existing Air Conditioner model
You can place the current Air Conditioner object in the scene as a visual placeholder for the heater.

2. Add the real device from Home Assistant
If the heater is a device in Home Assistant, you can:

Open the Monitoring tab
Find your heater / temperature entity
Drag and drop it onto the floorplan

It will be placed in the scene as a sensor, and you’ll still be able to see all the monitoring data associated with it.

We know that allowing users to add custom objects is a useful feature, and it’s something we plan to improve in the future.

If you have any other questions while working on your project, feel free to ask, happy to help!