Floor3D Pro Card – Game Engine Backbone Edition
Your Home Digital Twin for Home Assistant (3D Lovelace Card)
Floor3D Pro Card (source & documentation):
Original concept and vision:
floor3d-cardby @andyHA – with full respect and acknowledgment of the foundational work.
Original card (source & documentation):
https://github.com/adizanni/floor3d-card
Important:
This is not a feature expansion of the original Project.
For feature requests or development inquiries, please contact the original author.
Context
The original floor3d-card works exceptionally well and introduced a powerful idea: a true digital twin inside Home Assistant.
However, as models grow large and entity counts increase, natural performance and lifecycle limits emerge — not due to poor design, but because UI‑driven architectures do not scale like engines.
This Project focuses on scaling and stabilization, not on rewriting the core idea.
Built on a Real Game-Engine Backbone
Release 1.5.3-Pro.Faz.0
Shaped by architectural discipline — not just code.
Not a game engine, but engineered to behave like one.
This card implements a deterministic game-engine architecture for both rendering and asset management.
Determinism as the Primary Goal
This isn’t a performance hack — it’s determinism as a foundation.
Deterministic rendering. Deterministic assets. Isolated instances. Stable behavior.
Deterministic Render Scheduler
Floor3D Pro routes every render trigger through a single, predictable scheduler.
This ensures 100 triggers result in only 1 render, eliminating jitter, lag, and random redraws for a consistently smooth experience on any device.
Deterministic Asset Backbone
All models load once, and each card receives its own isolated clone.
This prevents duplicate fetches, parse storms, and UI‑driven chaos, delivering a stable and efficient asset pipeline that behaves like a real game engine.
Deterministic Transactional Editor
All edits stay in a draft state until you intentionally commit them.
This removes rebuild storms, preview resets, and accidental refresh loops, resulting in a clean, predictable editing workflow even in large, complex setups.
Deterministic Engine Core Overview
Detailed explanation in ENGINE.md
Additional Pro Features
Release 1.5.3-Pro.Faz.1
Activation (All Pro features are opt-in and disabled by default.)
Engine Diagnostics (optional)
Pro_log: engine
Feature Skills (optional)
Pro_skill: [level, editor, mobile]
Enables selected Pro skill modules.
level→ Pro Skill:levelkeeps entity‑heavy multi‑floor models fast and responsiveeditor→ Pro Skill:editorstable editing without auto‑commit chaosmobile→ Pro Skill:mobilesmoother experience on tablets/phones
You can enable one or multiple skills:
Pro_skill: level
or
Pro_skill: [level, editor]
To disable all skills (default):
Pro_skill: []