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!

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

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

@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!

Tami Liu

Home Assistant is widely known as a powerful platform for smart homes. But in practice, many people also use it to monitor small businesses, workshops, farms, greenhouses, and commercial spaces.

As sensor networks grow and buildings become more complex, traditional dashboards often become cluttered and difficult to interpret.

Zircon3D was designed to solve this problem by adding a digital twin layer on top of Home Assistant, by turning raw sensor data into an interactive 3D representation of your physical space.

This approach makes it easier to monitor environments, identify patterns, and manage devices across an entire facility.

From Smart Home Dashboard to Digital Twin

Most Home Assistant dashboards list devices as cards or charts. This works well for a handful of sensors, but it becomes challenging when a building contains dozens or hundreds of devices.

Zircon3D introduces a 3D facility view where sensors, equipment, and spaces are mapped directly into a building model.

Instead of scrolling through lists, users can visually explore their environment and immediately understand what is happening in each location.

For example:

Temperature sensors appear where they are physically installed
Machines or appliances can be mapped to specific areas
Environmental patterns become visible across rooms or zones

This spatial approach helps transform Home Assistant from a device dashboard into a visual monitoring system.

Business-Specific Capabilities

Multi-Building and Multi-Floor Monitoring

Small businesses often operate in spaces that include multiple floors or separate buildings. Zircon3D projects can organize these layouts into a single visual environment.

This allows users to monitor sensors across:

different floors
multiple buildings
separate operational areas

All within one unified view.

Facility Monitoring and Equipment Mapping

Zircon3D makes it possible to associate sensors with the physical equipment or spaces they represent.

Common monitoring scenarios include:

Energy consumption across rooms or machines
Air quality monitoring in offices or labs
Temperature tracking in storage rooms or server racks
Environmental monitoring for plants or food storage

Instead of reading numbers in isolation, users can immediately see where the issue occurs in the building.

Thermal and Heatmap Analytics

One of Zircon3D’s most powerful features is the real-time heatmap system.

Heatmaps transform sensor data into a color-based visualization that reveals environmental patterns across a space.

This is especially useful for:

greenhouses monitoring temperature or humidity distribution
server rooms detecting heat concentration
warehouses checking environmental uniformity
offices analyzing comfort conditions

Users can also replay historical heatmaps to review how conditions changed throughout the day.

Performance on Home Assistant Hardware

Zircon3D uses a GPU-accelerated WebGL rendering engine, allowing complex 3D scenes to run smoothly inside a browser.

Even installations running on modest hardware, such as a Home Assistant OS system or small server can display interactive environments with large numbers of sensors.

The goal is to provide professional-level visualization without requiring enterprise-grade infrastructure.

Data Privacy and Local Control

For many small businesses, data privacy and operational security are essential.

Zircon3D runs entirely inside Home Assistant as a local add-on, which means:

sensor data never leaves the local system
building models remain private
monitoring operates even without internet connectivity

This local-first design ensures that sensitive operational data stays under the user’s control.

Scalable Plans for Growing Systems

Zircon3D offers a free plan for smaller installations and personal projects.

As deployments grow, paid tiers provide higher limits for:

project size
building areas
number of monitored entities

This allows users to start small and scale the system as their business expands.

More details can be found here:
https://zircon3d.com/pricing

Simplifying Complex Facilities

Large monitoring systems often overwhelm users with data. Zircon3D includes different view modes that help simplify complex environments.

For example:

Transparent Mode makes walls semi-transparent to reveal sensors behind them
Whiteout Mode highlights devices and monitoring data while reducing visual distractions

These modes allow managers to quickly locate devices and understand the state of a facility.

A Practical Alternative to Enterprise Systems

Enterprise facility-management platforms often require expensive hardware, specialized software, and complex deployment processes.

Zircon3D offers a lightweight alternative by building on top of the Home Assistant ecosystem:

no specialized infrastructure required
simple deployment as a Home Assistant add-on
flexible enough for both individuals and businesses

For many small organizations, this makes advanced monitoring capabilities accessible without enterprise-level costs.

Learn More

Documentation:
https://zircon3d.com/docs

Home Assistant Community Discussion:
https://community.home-assistant.io/

Pricing Information:
https://zircon3d.com/pricing

YouTube Tutorials & Examples:
https://www.youtube.com/@Zircon3D

Tami Liu

If you would like to cancel your Zircon3D subscription and remove your saved payment method, please follow the steps below.

Step 1 – Log in and Open the Console

Go to https://zircon3d.com
Click the Console button at the top right.
Log in to your account if prompted.

Step 2 – Go to Billing

In the left sidebar, click Billing.
You will see your current subscription plan.
Click the Update Plan button.

Step 3 – Cancel Subscription or Remove Card (Stripe Page)

After clicking Update Plan, you will be redirected to the secure Stripe Billing Portal.

From there, you can:

Cancel Subscription

Click Cancel subscription
Confirm the cancellation

Your subscription will remain active until the end of your current billing period.

Remove Payment Method

Under Payment Methods, click the ⋯ (three dots) next to your card
Select Delete

If multiple cards are saved, you can remove them individually.

Important Notes

Subscription cancellations take effect at the end of your current billing cycle.
Removing your card does not automatically cancel your subscription - please make sure to cancel first if that is your intention.
All billing operations are securely handled by Stripe.

If you encounter any issues, please contact us as support@lichr.com and we’ll be happy to assist.

Tami Liu

What happens to my projects if my subscription ends?

Short answer:
Your projects will NOT disappear.
Your data stays safe.
Your account will be downgraded to the Free plan, with some limits.

After your subscription ends, you’ll be on the Free plan, which includes:

1 editable project
Up to 1000 m² building area
Up to 25 monitored devices
Heatmap view: Temperature (Free plan feature)

*This quota is based on the Free plan limits as of January 2026.

What if I have more than the Free plan allows?

You can still view everything, but editing is limited:

Multiple projects

You can view all projects
You can edit only one project at a time
You decide which project to keep editable
If it’s not the one you want:
- Go to Project → More > → Project Settings
- Delete it
- The next project becomes editable
  This lets you choose which project fits the Free plan

Area / devices / features over quota

Projects that exceed Free limits will show warnings (like in the screenshots)
You can:
- View everything
- Remove devices, reduce area, or simplify the project
Once it fits the Free plan limits, it works normally again

Important takeaway

️ No lock-out
️ No data loss
️ No forced deletion
️ You’re always in control of what to keep

If you later re-subscribe, all advanced features and higher limits are instantly available again.

Example after downgrade

In this screenshot, the project “test” is the active project and can be viewed, edited, and deleted. All other projects are automatically switched to view-only mode. They remain fully visible, but editing is disabled until you delete projects or adjust your setup to meet the Free plan quota.

View-only projects can be opened and viewed, but not edited; they can still be deleted from Project Settings → Advanced.

Tami Liu

@keiflab Glad to hear it’s working after the update, thanks for letting us know!

Tami Liu

@keiflab Hi, just a quick update, we’ve fixed this issue in the latest release.

Please upgrade the Zircon3D Home Assistant add-on to v2.0.8 (2026-01-25), or wait for the auto-upgrade if you have it enabled.

v2.0.8 – Bug Fix
Fixed a bug that could cause an infinite loop during loading

Thanks again for your patience and for helping us identify this.

Tami Liu

@keiflab Hi, thanks a lot for sending the logs and screenshots, they really helped.

From the logs, this looks like a logic issue (a dead loop during loading) rather than anything hardware-related. We’re confident this isn’t caused by your computer or browser.

We’ll work on a quick fix for this and will let you know as soon as it’s ready.

If you’re okay with it, could you also share your email address? That way we can notify you directly once the fix is available.

Thanks again for your patience and for helping us track this down, we really appreciate it.

Tami Liu

@keiflab Hi, thanks for sending the screenshots, that’s very helpful.

From what we can see, the floorplan data appears to be present, but the floor itself isn’t being rendered or loaded. While it could be hardware-related, but it’s more likely an edge case involving the floor’s internal data or geometry state, which we’ll need to investigate more closely.

To help us dig further, could you please check the browser logs?

Press F12 to open Developer Tools
Go to the Console tab
Reload the page
If you see any errors, please copy the details and send them to us

If you don’t mind, could you also share which browser you’re using and what device/computer you’re on? That can help us check for any browser- or hardware-specific issues.

Sorry for the inconvenience, we understand how frustrating it is when a floor doesn’t load. Thanks for your patience while we look into this.

Tami Liu

Hi, thanks for reporting this.
To help us narrow this down, could you please check the following?

Home node check
In the top navigator, please click on the Home node.
Do you see the list of floors there, or does it also fail to load?
Areas list under the floor
When you select the Basement floor, please click the Areas sub-tab under the navigator.
This should show a list of all areas on that floor, does it appear correctly?
Enable debug helpers
Please open the Debug tool (see the screenshot I attached), then enable:

Debug Show Hole Helper
Debug Show Handles

After enabling these, see what happens in the scene.
If possible, please send us screenshots of what you see — that would be very helpful.

Also, is there anything special or unusual about this floor?
For example:

very large or complex geometry
many holes / cut-outs

This doesn’t look like a hardware limitation at first glance, but the answers above should help us confirm where the issue is coming from.

Tami Liu

Design decisions, technology choices, and what to expect on mobile and tablets

Zircon3D is often described as “fast” or “smooth,” but that performance is not accidental.
It is the result of deliberate architectural and technical choices made from the very beginning of the project.

This article explains why Zircon3D performs the way it does, what technologies make it possible, and why certain interactions especially on phones and tablets are currently more limited, even though the core system itself remains highly performant.

A real-time system, not a rendering pipeline

Many traditional 3D tools follow a render-first workflow:

Design → export → render → view
Any change requires reprocessing the entire scene

Zircon3D follows a different approach.

It is built as a real-time visualization engine, where:

The 3D scene is always live
Data changes update the scene incrementally
There is no export or re-render cycle

This is a fundamental reason why interactions feel immediate and responsive.

GPU-accelerated rendering with WebGL

At its core, Zircon3D runs on a GPU-accelerated WebGL rendering pipeline, which means:

Heavy visual work is handled by the graphics card, not the CPU
Large scenes remain interactive even with live data updates
Animations, lighting, and heatmaps are computed efficiently

Rather than relying on pre-rendered images or static textures, Zircon3D renders geometry and visual states dynamically, frame by frame.

This is what allows:

Smooth camera movement
Real-time device state changes
Continuous heatmap updates without freezing the UI

Data-oriented scene design

Zircon3D does not treat the 3D view as a decorative layer.

The scene is directly driven by structured data, including:

Rooms and spaces
Devices and sensors
Live state updates from Home Assistant

Only the parts of the scene that actually change are updated.
This avoids unnecessary recalculation and keeps performance predictable, even as systems grow.

Separation of interaction logic and rendering

Another key performance factor is architectural separation:

Rendering logic is isolated from UI logic
State updates are carefully scoped
Expensive operations are minimized during interaction

This makes actions like:

Dragging objects
Rotating the view
Zooming in and out

feel smooth and consistent, even on modest hardware.

Why mobile and tablet interactions are currently more limited

Zircon3D’s core engine performs well on phones and tablets.
However, interaction is a separate challenge from rendering performance.

On desktop:

Mouse and keyboard provide precise control
Complex gestures are easy to distinguish

On mobile and tablets:

Fingers are less precise
Gestures overlap (drag vs pan vs rotate)
Screen space is limited
Accidental input is more likely

Rather than shipping a compromised or frustrating editing experience, Zircon3D currently focuses mobile and tablet usage on:

Viewing
Monitoring
Light interaction

This is a deliberate design choice, not a technical limitation of the engine itself.

Roadmap: hand-friendly interaction on tablets

Tablet-first interaction requires different design thinking.

Zircon3D’s roadmap includes:

Larger, touch-optimized interaction zones
Gesture-aware tools designed specifically for fingers
Reduced precision requirements for placement and control
Editing modes tailored for tablet usage rather than adapted from desktop

This work is planned as a dedicated tablet experience, not a scaled-down desktop UI.

High performance as a long-term commitment

Performance in Zircon3D is not a one-time optimization.
It is a guiding principle that affects:

Rendering architecture
Data flow design
UI structure
Feature decisions

This is why Zircon3D can:

Scale from small homes to complex environments
Handle real-time data without freezing
Remain responsive even as features grow

In summary

Zircon3D is high-performance because it is:

A real-time system, not a static renderer
GPU-accelerated by design
Data-driven at its core
Architected to minimize unnecessary work

While editing on phones and tablets is currently limited by interaction constraints, the underlying engine is already capable and a tablet-friendly, hand-first experience is actively planned.

Zircon3D is built not just to look good today, but to remain fast, reliable, and scalable as your system grows.

Tami Liu

We’ve released Zircon3D v2.0.6 (2026-01-11) with improvements specifically targeting connect / disconnect toggle issues, which may be more noticeable in setups that use cloud services (for example Nabu Casa).

What’s new in v2.0.6:

Improved WebSocket stability for unreliable or high-latency network environments
Added a built-in log viewer to both the Designer and Viewer to make debugging easier

If you’ve experienced frequent connection toggling, please upgrade the Zircon3D Proxy add-on to v2.0.6 - this update should be more stable.

️ If the issue still happens after upgrading:

When you see the connection (Wi-Fi) icon switching between connected / disconnected
Click the icon to open the Connection Panel
Click Debug Info and export the log
Share the log with us so we can take a closer look

This new debug information will help us identify environment-specific issues much faster.

Thanks to everyone who reported this and helped us improve Zircon3D

Tami Liu

@Hacker182
Hi,
We’ve released an improvement along with a new debug tool in Zircon3D v2.0.6 (2026-01-11).
Please upgrade the Zircon3D Proxy add-on to this version, it should be more stable, as we’ve enhanced the WebSocket connection handling.

What’s new in v2.0.6:

Improved WebSocket stability for unreliable or high-latency network environments
Added a built-in log viewer to both the Designer and Viewer for easier debugging

If the connect/disconnect issue happens again, please do the following:

When you see the Wi-Fi / connection icon toggling between connected and disconnected
Click the icon to open the connection panel
Click the Debug Info icon
Export the log information and send it to us

I’ll attach a screenshot to show exactly where to find this option.

Thanks again for your patience and for helping us track this down, the new debug data will make it much easier for us to identify what’s happening if the issue persists.