P3DE v0.4.9

P3DE v0.4.9: Documentation Audit & Architectural Polish

This release marks the completion of the "Clean Code & Documentation" milestone. Every core component has been audited and standardized to ensure the source matches the quality of the project whitepaper.

🚀 Key Improvements

1. Comprehensive Documentation Audit

• Standardized Headers: All 18 core files now feature professional headers (v0.4.9).
• Algorithm Transparency: Explicit [ALGORITHM] documentation for PBR, Raycasting, VLB Transpilation, and Recursive Scoping.
• Class-Level Summaries: Clearly defined responsibilities for all manager and utility classes.

2. Architectural Refactoring & Consolidation

• Global Import Strategy: Consolidated all java.util, java.io, and java.net imports into the main p3deditor.pde file.
• Educational Clarity: Replaced complex fully-qualified Java paths with readable class names (e.g., in the Blueprint Expression Parser).
• Reduced Redundancy: Removed duplicate imports and cleaned up code headers across all secondary PDE files.

3. Stability & Cleanup

• Bug Fixes: Resolved compilation errors related to missing library references.
• Syntax Correction: Fixed unclosed comment blocks and redundant tags introduced during the audit.

📦 Project Milestone

This version serves as the definitive reference for the engine's internal architecture, making it ideal for both developers and academic review.

P3DE v0.4.8

Introduces Scene-wide Level Blueprint system, custom background color picker, and dynamic camera/environment orchestration. Includes owner-agnostic blueprint architecture and enhanced PDES support.

P3DE v0.4.2

Major Milestone: Blueprint System Prototype Success

本版本标志着 VLB (Visual Logic Blueprint) 视觉化逻辑蓝图系统 的核心雏形正式搭建成功！

核心更新亮点:

• 蓝图系统雏形: 实现了从可视化节点到 PDES 脚本的完整编译执行链路。
• 实时调试增强: 引入全局调试变量缓存，提供稳定、无闪烁的实时数值监测体验。
• 数学表达式支持: 高级 Math Expression 节点现支持实时解析，并标准化了时间单位。
• 默认工作流优化: 新建蓝图自动生成 OnStart 与 OnUpdate 节点，加速逻辑搭建。
• 稳定性修复: 解决了包含空格实体名的引用问题 ($this)，并优化了变量解析逻辑。

蓝图系统现在已具备处理复杂物体交互与动态逻辑的能力，为后续的关卡设计与自动化脚本奠定了坚实地基。

P3DE v0.2.5

P3DE v0.2.5: The P3DES Logic Era (逻辑引擎时代)

该版本是 P3DE 发展史上的一个重要分水岭。我们不仅为编辑器注入了灵魂——P3DES 逻辑脚本引擎，还从底层加固了渲染稳定性，并实现了完美的国际化字符显示。

🌟 核心亮点 (Highlights)

1. 🚀 P3DES 逻辑脚本：让场景“活”起来

这是本次更新的重头戏。您可以编写 .p3des 脚本来控制场景中的物体，实现复杂的动态逻辑。

• 非阻塞异步执行：脚本运行在后台，不影响相机操作与 gizmo 交互。
• 丰富的流控指令：支持 while、for 循环，以及 if/else 条件判断。
• 毫秒级定时：利用 wait <ms> 实现精准的动画序列或逻辑延时。
• 变量与运算：内置变量系统 ($var)，让物件生成更具规律性。

2. 🛡️ 稳定性护盾：光照上限管理

为了根治 Processing 系统下超过 8 盏灯导致的崩溃难题：

• 动态上限控制：点光源 (PointLight) 数量被严格平衡为 5 盏。
• 全局灯光优化：整合了环境光 (Ambient) 与平行光 (Directional)，确保在各种光照配额下都能获得最佳视觉深度。

3. 🌏 国际化支持：再无“方块”

• 微软雅黑原生集成：现在控制台、层级面板、属性框已完美支持中文字符，不再出现乱码或空白。
• 全链路 Unicode：脚本代码、注释以及 echo 输出均已支持中文。

4. ⌨️ 极速工作流 (UX Improvements)

• 删除键回归：支持键盘 Delete/Backspace 直接删除物件，并带有智能焦点锁定。
• 快捷指令补完：新增 rename (重命名)、clear (一键清空场景)、echo (控制回显) 等实用命令。

📄 快速开始 (Quick Start)

下载源码后，在终端尝试：
run demo —— 观看全新的逻辑脚本全能秀。

---

“P3DE：从静态搭建，迈向动态逻辑。”

P3DE 0.2.2

P3DE v0.2.2 Release Notes

This update introduces the Macro Scripting System, a robust automation engine for the P3DE editor, along with professional-grade UI refinements for a focused developer experience.

🚀 Macro Scripting (.p3dec)

• Script Execution: Run batch instructions using the exec <filename> command.
• Auto-Startup: Automatic execution of init.p3dec on launch for instant environment configuration.
• Command Aliasing: Create custom shorthand blueprints (e.g., alias redcube "create Cube; color Cube #FF0000") with recursion protection.
• Multi-Command Chaining: Execute sequential logic in a single line using the ; separator.

🎨 UI/UX Polish

• Glass Console: Reverted to a high-alpha semi-transparent background for a premium 'glassmorphism' look.
• Artifact Suppression: Dynamic background UI suppression (Stats and Menu Bar) eliminates 'bleed-through' line artifacts when the terminal is open.
• Input Guardians: Strict mouse-blocking ensures no accidental scene modifications while typing in the console.
• Hierarchy Refinement: Pixel-perfect text clipping with ellipses (...) for long entity names.

---

Tagged: v0.2.2

P3DE 0.2.0

🚀 Minor Milestone: P3DE 0.2.0 - Developer Console & Global Logging

This major update transforms the editor's development workflow, introducing a professional-grade terminal and a comprehensive session-tracking system.

⌨️ Professional Developer Console

• Drop-down Terminal: Toggled anywhere via the Backtick (`) key.
• Input Isolation: Active terminal automatically blocks all global scene shortcuts (H, TAB, G, etc.) to ensure uninterrupted typing.
• Unified History: Commands executed via the bottom Inspector console are now automatically synchronized with the terminal's log history.
• Command History: Navigate previous commands using Up/Down arrow keys.

📜 Advanced Global Logging

• Session-Based Logs: Every run creates a unique, timestamped file (e.g., editor_20260322-001005.log) to prevent data overlap.
• Dynamic Path-Finding: Prioritizes D:\projects\Google_Antigravity\p3deditor log for storage, falling back to the sketch folder if missing.
• Severity Levels: Color-coded feedback for [INFO/SUCCESS], [WARN], and [ERROR].
• Audit Trail: Logs all entity lifecycle events (Creation, Deletion) and Scene IO (Save/Load).

🎨 UI & UX Refinement

• Perfect Z-Layering: Fixed rendering order so the terminal always stays on the absolute top layer.
• Viewport Status: Moved Tool/Snap status info into the UIManager for consistent depth management.

Built with 100% Native Processing Java. No external dependencies required.

P3DE v0.1.9-alpha

🚀 Major Update: Professional UI & Scripting Foundation

This release transforms the editor from a basic prototype into a professional-grade 3D tool with a standardized navigation system and scripting capabilities.

🎨 UI & UX Refinement

• Unity-style Top Menu Bar: Consolidated all scattered buttons into a clean, top-down navigation system (File, Edit, Create, Window).
• Glassmorphism Sidebar: Both side panels now feature a premium semi-transparent 'dark glass' effect (Alpha 230).
• Perfect Hierarchy: Improved entity list with manual text truncation (ellipses), vertical centering, and structural tree lines.
• Viewport Clipping: Implemented strict clip() bounds to prevent UI overlap during scrolling.

⌨️ Scripting & Control

• Command Interpreter: Pre-alpha support for text-based entity manipulation (move, tp, color, scale, delete).
• Real-time Feedback: Color-coded console results (Blue/Red) for instant execution status.
• Quote Awareness: Handles entity names with spaces (e.g., move "My Box" 10 0 0).

🛠️ Core Features

• Window Management: Toggle Console and Statistics overlays via the new menu.
• Reset Camera: One-click restoration of the default 3D monitoring angle.
• Cleanup: Thoroughly removed redundant sidebar hit-tests, optimizing interaction response.

No external dependencies required. 100% Native Processing Java.

P3DE v0.1.8

Release v0.1.8 - Advanced Lighting & Professional 3D Paradigm

软件概览与核心功能 (Unified Features)

本项目深度复刻了商业级引擎（如 UE5 / Unity）的交互逻辑，并在 Processing 原生环境下实现了以下核心模块：

• 引擎级双模相机：完美复刻 Fly Mode (右键 FPS 飞行) 与 Orbit Mode (Alt+左键 环绕检视)，支持无缝滚轮缩放与中键平移。
• 高精度射线拾取 (Raycast)：抛弃低效的颜色拾取，基于底层反投影矩阵实现的射线交叉检验，支持 AABB 包围盒 与 解析平面 的精准判定。
• 多模态变换操作轴 (Gizmos)：支持 位移 (1)、旋转 (2)、缩放 (3) 等操作。具备恒定视口比例 (Constant Size) 特性，无论相机远近，操作轴永远保持可点击的视觉大小。
• 动态场景树 (Hierarchy)：支持无限层级的父子嵌套，子物体自动继承父级的坐标矩阵变换。
• 新增：专业点光源系统：支持可交互的点光源实体，具备实时的 强度 (Intensity) 与 物理范围 (Range/Falloff) 调节，并伴有视口范围示意圈。
• 新增：材质与诊断系统：内置 10 色快速拾色盘 与 Hex 色值录入；视口左上方实时监控 FPS、物体总数 与 多边形计数 (Poly Count)。
• 场景持久化：支持基于 JSON 的双向序列化，配合系统原生文件对话框实现场景的保存与读取。

项目核心亮点 (The Philosophy)

• 【极致原生，零第三方依赖】：这是本项目的灵魂。完全基于 Processing (P3D) 原生库开发，不使用 ControlP5 等任何外部 UI 库或物理引擎。所有的数学库、射线碰撞模型、自研 UI 及鼠标劫持系统均采用原生 Java/Processing 实现。这不仅保证了极高的运行效率，也为开发者提供了一个最纯粹、无干扰的学习与开发范式。

有待修正与提升 (Known Issues)

• 复杂坐标系校准：目前在某些深层级嵌套旋转（Nested Rotation）的情况下，局部坐标系（Local Space）与世界坐标系（World Space）的实时换算算法在极端倾角下仍有优化空间，这可能会导致 Gizmo 在极少数情况下出现微小偏移。
• 撤销系统健壮性：对于极高频的复合操作，撤销/重做系统的命令栈仍需进一步进行原子化压力测试。