📢 Zircon3D v2.2 Released! Check Out What’s New!

Tami Liu

We’re excited to introduce Zircon3D v2.2, a feature-rich update focused on making 3D building visualization more flexible, interactive, and useful for real-world smart home and facility scenarios.

Watch the v2.2 release video here:

This release adds support for custom GLB models, editable simple cube objects, more smart device control cards, room-level Box View styling, multiple selection, and many bug fixes and performance improvements.

Custom Models: Upload Your Own `.glb` Models

You can now import your own .glb 3D models into Zircon3D.

This makes it possible to add custom furniture, equipment, machines, facility assets, or any other 3D model that better represents your real space.

This is especially useful when the built-in model library is not enough for your specific project.

Simple Cube Object

We added a new Simple Cube Object.

This object is very flexible: you can edit its:

Width
Depth
Height
Color or material

Even though it starts as a simple cube/block, it can be resized into many useful forms, such as a table, platform, partition, box, equipment block, parking area, raised base, or simple placeholder object.

It is a small feature, but very practical for quickly building custom scenes.

More Smart Device Control Cards

Zircon3D v2.2 adds more interactive control cards for Home Assistant entities.

The enhanced control cards include:

Light Card - Supports brightness percentage and color control.

Cover Card - For garage doors, windows, shades, blinds, curtains, and other cover entities.

Climate Card - For air conditioners, heat pumps, thermostats, and similar climate devices.

Lock Card - For door locks and other lock entities.

Fan Card - For fan entities, with related controls.

These cards make Zircon3D not only a 3D visualization interface, but also a more convenient 3D control layer for your smart home.

Status Bubbles on the Floorplan
Control cards also show clear colored status bubbles directly on the floorplan. This makes important states much easier to notice at a glance, such as when a window is open, a garage door is open, or a door is unlocked.

This provides a more intuitive way to understand the real status of your home or building directly from the 3D view.

Room Box View

We added Box View support at the room level.

You can now show rooms as colored box-style blocks and assign colors to different rooms. This provides a cleaner and more abstract way to understand room layout, zones, or functional areas.

In the next version, we plan to extend this feature so the room Box View can be mapped to monitoring sensor data, allowing rooms to be colored dynamically based on real-time values. For example room occupancy or other sensor data.

Multiple Selection

You can now select multiple objects or rooms by holding the Ctrl key.

This allows you to move or delete multiple items at once, making editing much faster and more convenient when working with larger floorplans.

Bug Fixes and Performance Improvements

This release also includes many bug fixes and performance improvements across the Designer and Viewer.

We continue to improve stability, usability, and the overall editing experience as Zircon3D grows into a more powerful 3D visualization platform.

Try Zircon3D v2.2

Thank you to everyone who continues to test Zircon3D, share feedback, and help us improve the product.

Get started with Zircon3D: https://zircon3d.com
Documentation: https://zircon3d.com/docs
Community forum: https://forum.zircon3d.com
YouTube tutorials: https://www.youtube.com/@Zircon3D
Facebook group: https://www.facebook.com/groups/zircon3d

Tami Liu

This usually happens due to a Home Assistant ingress authorization issue.

Related: https://forum.zircon3d.com/topic/6/

How to fix it

You have two options:

Option 1 (Recommended)
Use port :11200 to access Zircon3D directly.

Open Zircon3D via http://<your-ha-ip>:11200
Copy and use the view link from there
This avoids the ingress issue entirely

Option 2 (Using default HA port 8123)
If you’re accessing through port 8123, you need to authorize Zircon3D first:

Open Home Assistant
Click the Zircon3D tab in the left sidebar
Then reload your dashboard/view

Why this happens

Home Assistant only initializes ingress access after the add-on UI is opened once. If you try to load an embedded Zircon3D view before that, it may return a 401 Unauthorized error.

If the issue persists, feel free to reach out with details about your setup

Tami Liu

Zircon3D allows you to visualize not only raw sensor data, but also custom computed values using tools like Home Assistant template sensors.

This guide shows how to create a Temperature Delta heatmap, but the same approach works for any custom metric.

What is “Pre-Processed Data”?

Pre-processed data means:

Data that is calculated or transformed before visualization

Examples:

Temperature Delta (current vs target)
VPD (humidity + temperature)
Energy efficiency metrics
Custom scoring or alerts

Step 1 Create a Template Sensor

In Home Assistant:

template:
  - sensor:
      - name: "Living Room Temperature Delta"
        unique_id: "living_room_temperature_delta"
        unit_of_measurement: "°C"
        state: >
          {{ (
              state_attr('climate.living_room', 'current_temperature')
              - state_attr('climate.living_room', 'temperature')
            ) | abs | round(1) }}

Repeat for other rooms with consistent naming.

Step 2 Create a Heatmap in Zircon3D

Add a new heatmap layer
Name it (e.g., Temperature Delta)
Select your template sensors

Step 3 Use Matching Rules (Recommended)

To scale easily across rooms:

Use a rule like:
uid contains temperature_delta

This automatically includes all matching sensors.

Step 4 Configure Color Mapping

Example:

0°C → Green (good)
3°C → Yellow (moderate)
5°C → Red (needs attention)

Lower values = better comfort

Step 5 Assign Devices to Floorplan

Place climate/HVAC devices in your 3D layout
Or update existing ones to use the heatmap

Step 6 View the Heatmap

Switch to the heatmap layer to see your data visualized in 3D.

Beyond Temperature Delta

You can apply this method to:

Greenhouse climate (VPD, humidity)
Energy usage per zone
Occupancy and utilization
Air quality metrics

template:
  - sensor:
      - name: "Living Room Temperature Delta"
        unique_id: "living_room_temperature_delta"
        unit_of_measurement: "°C"
        state: >
          {{ (
              state_attr('climate.living_room', 'current_temperature')
              - state_attr('climate.living_room', 'temperature')
            ) | abs | round(1) }}

This calculates the difference between current and target temperature, and ensures it is always positive and easy to visualize.

2. Create a Heatmap in Zircon3D

Add a new heatmap layer (e.g., Temperature Delta)
Select your template sensors
Use matching rules (e.g., uid contains temperature_delta) to automatically include multiple rooms

3. Configure Color Range

Example:

0°C → Green (good)
3°C → Yellow (moderate)
5°C → Red (needs attention)

Lower values indicate better comfort.

4. Assign Devices to the Floorplan

Place your HVAC / climate devices in the 3D view
Or update existing devices to use the new heatmap

5. View the Result

Switch to the heatmap layer and instantly see temperature differences across your space.

Why This is Powerful

This is more than a visualization, it’s a data-driven spatial analysis tool.

You are not limited to built-in metrics. With Zircon3D, you can:

Define your own logic
Compute custom values
Visualize them in 3D space

Turning your system into a true 3D data dashboard

Learn More

Get started with Zircon3D: https://zircon3d.com
Documentation: https://zircon3d.com/docs
Community forum (support & discussions): https://forum.zircon3d.com
YouTube tutorials: https://www.youtube.com/@Zircon3D
Join our Facebook group (updates & previews): https://www.facebook.com/groups/zircon3d

What’s Next?

This is just one example of what’s possible.
We’re continuing to expand support for:

More advanced derived metrics
Better visualization layers
Business and enterprise use cases

Have ideas or use cases? Let us know, your feedback directly shapes future features.

Tami Liu

@Vagelis-Melidonis

Hi,

Yes, your solution is correct

The Floating Cards mode is controlled by the View Profile, which is the right place to store your preferred settings for daily use. In the Designer, it will always fall back to the system default settings.

We know this can be a bit confusing, and we may improve this in the future (for example, allowing it to be set via the URL).

Let us know if you have any questions

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!

📢 Zircon3D v2.2 Released! Check Out What’s New!

administrators

Posts

Custom Models: Upload Your Own `.glb` Models

Simple Cube Object

More Smart Device Control Cards

Room Box View

Multiple Selection

Bug Fixes and Performance Improvements

Try Zircon3D v2.2

How to fix it

Why this happens

What is “Pre-Processed Data”?

Step 1 Create a Template Sensor

Step 2 Create a Heatmap in Zircon3D

Step 3 Use Matching Rules (Recommended)

Step 4 Configure Color Mapping

Step 5 Assign Devices to Floorplan

Step 6 View the Heatmap

Beyond Temperature Delta

Related

Turn Derived Data into Real Spatial Insight with Zircon3D

What is Temperature Delta?

Why this matters

Example: Temperature Delta Heatmap

From Raw Data to Insight

Key Features Demonstrated

How It Works

Why This is Powerful

Learn More

What’s Next?

Member List

📢 Zircon3D v2.2 Released! Check Out What’s New!

administrators

Posts

Custom Models: Upload Your Own .glb Models

Simple Cube Object

More Smart Device Control Cards

Room Box View

Multiple Selection

Bug Fixes and Performance Improvements

Try Zircon3D v2.2

How to fix it

Why this happens

What is “Pre-Processed Data”?

Step 1 Create a Template Sensor

Step 2 Create a Heatmap in Zircon3D

Step 3 Use Matching Rules (Recommended)

Step 4 Configure Color Mapping

Step 5 Assign Devices to Floorplan

Step 6 View the Heatmap

Beyond Temperature Delta

Related

Turn Derived Data into Real Spatial Insight with Zircon3D

What is Temperature Delta?

Why this matters

Example: Temperature Delta Heatmap

From Raw Data to Insight

Key Features Demonstrated

How It Works

Why This is Powerful

Learn More

What’s Next?

Member List

Custom Models: Upload Your Own `.glb` Models