+
## Event Nodes
Lifecycle events as blueprint entry points:
-| Node | Description |
-|------|-------------|
-| `EventBeginPlay` | Triggered when blueprint starts |
-| `EventTick` | Triggered each frame, receives deltaTime |
-| `EventEndPlay` | Triggered when blueprint stops |
+| Node | Description | Outputs |
+|------|-------------|---------|
+| `EventBeginPlay` | Triggered when blueprint starts | Exec, Self (Entity) |
+| `EventTick` | Triggered each frame | Exec, Delta Time |
+| `EventEndPlay` | Triggered when blueprint stops | Exec |
+
+### Example: Game Initialization
+
+
+
+
+
+
+ Event BeginPlay
+
+
+
+
+
+ Self
+
+
+
+
+
Print
+
+
+
+ Exec
+
+
+
+ Message
+ "Game Started!"
+
+
+
+
+
+### Example: Per-Frame Movement
+
+
+
+
+
+
+ Event Tick
+
+
+
+
+
+ Delta Time
+
+
+
+
+
Multiply
+
+
+
+ A
+
+
+
+ B
+ 100
+
+
+
+ Result
+
+
+
+
+
Set Property
+
+
+
+ Exec
+
+
+
+ Target
+
+
+
+ x
+
+
+
+
## Entity Nodes
-ECS entity operations:
+Manipulate ECS entities:
| Node | Description | Type |
|------|-------------|------|
-| `Get Self` | Get entity owning this blueprint | Pure |
-| `Create Entity` | Create new entity in scene | Execution |
-| `Destroy Entity` | Destroy specified entity | Execution |
-| `Destroy Self` | Destroy self entity | Execution |
+| `Get Self` | Get the entity owning this blueprint | Pure |
+| `Create Entity` | Create a new entity in the scene | Exec |
+| `Destroy Entity` | Destroy specified entity | Exec |
+| `Destroy Self` | Destroy the owning entity | Exec |
| `Is Valid` | Check if entity is valid | Pure |
| `Get Entity Name` | Get entity name | Pure |
-| `Set Entity Name` | Set entity name | Execution |
-| `Get Entity Tag` | Get entity tag | Pure |
-| `Set Entity Tag` | Set entity tag | Execution |
-| `Set Active` | Set entity active state | Execution |
-| `Is Active` | Check if entity is active | Pure |
+| `Set Entity Name` | Set entity name | Exec |
| `Find Entity By Name` | Find entity by name | Pure |
-| `Find Entities By Tag` | Find all entities by tag | Pure |
-| `Get Entity ID` | Get entity unique ID | Pure |
-| `Find Entity By ID` | Find entity by ID | Pure |
+| `Find Entities By Tag` | Find all entities with tag | Pure |
+
+### Example: Create Bullet
+
+
+
+
+
+
+ Event BeginPlay
+
+
+
+
+
+ Self
+
+
+
+
+
Create Entity
+
+
+
+ Exec
+
+
+
+ Exec
+
+
+
+ Entity
+
+
+
+
+
Add Transform
+
+
+
+ Exec
+
+
+
+ Entity
+
+
+
+
## Component Nodes
-ECS component operations:
+Read and write component properties:
| Node | Description | Type |
|------|-------------|------|
+| `Get Component` | Get component of specified type from entity | Pure |
| `Has Component` | Check if entity has specified component | Pure |
-| `Get Component` | Get component from entity | Pure |
-| `Get All Components` | Get all components from entity | Pure |
-| `Remove Component` | Remove component | Execution |
-| `Get Component Property` | Get component property value | Pure |
-| `Set Component Property` | Set component property value | Execution |
-| `Get Component Type` | Get component type name | Pure |
-| `Get Owner Entity` | Get owning entity from component | Pure |
+| `Add Component` | Add component to entity | Exec |
+| `Remove Component` | Remove component from entity | Exec |
+| `Get Property` | Get component property value | Pure |
+| `Set Property` | Set component property value | Exec |
+
+### Example: Modify Position
+
+
+
+
+
Get Self
+
+
+
+ Entity
+
+
+
+
+
Get Component
+
+
+
+ Entity
+
+
+
+ Transform
+
+
+
+
+
Get Property
+
+
+
+ Target
+
+
+
+ x
+
+
+
+
## Flow Control Nodes
-Control execution flow:
+Control blueprint execution flow:
| Node | Description |
|------|-------------|
-| `Branch` | Conditional branch (if/else) |
-| `Sequence` | Execute multiple outputs in sequence |
-| `For Loop` | Loop execution |
-| `For Each` | Iterate array |
-| `While Loop` | Conditional loop |
+| `Branch` | Conditional branching (if/else) |
+| `Sequence` | Execute multiple branches in order |
+| `For Loop` | Loop specified number of times |
+| `For Each` | Iterate over array elements |
+| `While Loop` | Loop while condition is true |
| `Do Once` | Execute only once |
-| `Flip Flop` | Alternate between two branches |
-| `Gate` | Toggleable execution gate |
+| `Flip Flop` | Alternate between A and B |
+| `Gate` | Gate switch control |
+
+### Example: Conditional Branch
+
+
+
+
+
Condition
+
+
+
+ Exec
+
+
+
+ Result
+
+
+
+
+
Branch
+
+
+
+ Exec
+
+
+
+ Cond
+
+
+
+ True
+
+
+
+ False
+
+
+
+
+
Print
+
+
+
+ Exec
+
+
+
+ Msg
+ "Yes"
+
+
+
+
+
Print
+
+
+
+ Exec
+
+
+
+ Msg
+ "No"
+
+
+
+
+
+### Example: For Loop
+
+
+
+
+
+
+ Event BeginPlay
+
+
+
+
+
For Loop
+
+
+
+ Exec
+
+
+
+ First
+ 0
+
+
+
+ Last
+ 10
+
+
+
+ Body
+
+
+
+ Index
+
+
+
+ Done
+
+
+
+
## Time Nodes
-| Node | Description | Type |
-|------|-------------|------|
-| `Delay` | Delay execution | Execution |
-| `Get Delta Time` | Get frame delta time | Pure |
-| `Get Time` | Get total runtime | Pure |
+| Node | Description | Output |
+|------|-------------|--------|
+| `Delay` | Delay execution by specified seconds | Exec |
+| `Get Delta Time` | Get frame delta time | Float |
+| `Get Time` | Get total runtime | Float |
+
+### Example: Delayed Execution
+
+
+
+
+
+
+ Event BeginPlay
+
+
+
+
+
Delay
+
+
+
+ Exec
+
+
+
+ Duration
+ 2.0
+
+
+
+ Done
+
+
+
+
+
Print
+
+
+
+ Exec
+
+
+
+ Msg
+ "After 2s"
+
+
+
+
## Math Nodes
-Basic Operations:
+### Basic Operations
+
+| Node | Description | Inputs | Output |
+|------|-------------|--------|--------|
+| `Add` | Addition | A, B | A + B |
+| `Subtract` | Subtraction | A, B | A - B |
+| `Multiply` | Multiplication | A, B | A × B |
+| `Divide` | Division | A, B | A / B |
+| `Modulo` | Modulo | A, B | A % B |
+
+### Math Functions
+
+| Node | Description | Inputs | Output |
+|------|-------------|--------|--------|
+| `Abs` | Absolute value | Value | \|Value\| |
+| `Sqrt` | Square root | Value | √Value |
+| `Pow` | Power | Base, Exp | Base^Exp |
+| `Floor` | Floor | Value | ⌊Value⌋ |
+| `Ceil` | Ceiling | Value | ⌈Value⌉ |
+| `Round` | Round | Value | round(Value) |
+| `Clamp` | Clamp to range | Value, Min, Max | min(max(V, Min), Max) |
+| `Lerp` | Linear interpolation | A, B, Alpha | A + (B-A) × Alpha |
+| `Min` | Minimum | A, B | min(A, B) |
+| `Max` | Maximum | A, B | max(A, B) |
+
+### Trigonometric Functions
| Node | Description |
|------|-------------|
-| `Add` / `Subtract` / `Multiply` / `Divide` | Basic arithmetic |
-| `Modulo` | Modulo operation (%) |
-| `Negate` | Negate value |
-| `Abs` | Absolute value |
-| `Sign` | Sign (+1, 0, -1) |
-| `Min` / `Max` | Minimum/Maximum |
-| `Clamp` | Clamp to range |
-| `Wrap` | Wrap value to range |
+| `Sin` | Sine |
+| `Cos` | Cosine |
+| `Tan` | Tangent |
+| `Asin` | Arc sine |
+| `Acos` | Arc cosine |
+| `Atan` | Arc tangent |
+| `Atan2` | Two-argument arc tangent |
-Power & Roots:
+### Random Numbers
-| Node | Description |
-|------|-------------|
-| `Power` | Power (A^B) |
-| `Sqrt` | Square root |
+| Node | Description | Inputs | Output |
+|------|-------------|--------|--------|
+| `Random` | Random float [0, 1) | - | Float |
+| `Random Range` | Random in range | Min, Max | Float |
+| `Random Int` | Random integer | Min, Max | Int |
-Rounding:
+### Comparison Nodes
-| Node | Description |
-|------|-------------|
-| `Floor` | Round down |
-| `Ceil` | Round up |
-| `Round` | Round to nearest |
+| Node | Description | Output |
+|------|-------------|--------|
+| `Equal` | A == B | Boolean |
+| `Not Equal` | A != B | Boolean |
+| `Greater` | A > B | Boolean |
+| `Greater Or Equal` | A >= B | Boolean |
+| `Less` | A < B | Boolean |
+| `Less Or Equal` | A <= B | Boolean |
-Trigonometry:
+### Example: Clamp Value
-| Node | Description |
-|------|-------------|
-| `Sin` / `Cos` / `Tan` | Sine/Cosine/Tangent |
-| `Asin` / `Acos` / `Atan` | Inverse trig functions |
-| `Atan2` | Two-argument arctangent |
-| `DegToRad` / `RadToDeg` | Degree/Radian conversion |
+
+
+
+
Random Range
+
+
+
+ Min
+ 0
+
+
+
+ Max
+ 100
+
+
+
+ Result
+
+
+
+
+
Clamp
+
+
+
+ Value
+
+
+
+ Min
+ 20
+
+
+
+ Max
+ 80
+
+
+
+ Result
+
+
+
+
-Interpolation:
+## Variable Nodes
-| Node | Description |
-|------|-------------|
-| `Lerp` | Linear interpolation |
-| `InverseLerp` | Inverse linear interpolation |
+Blueprint-defined variables automatically generate Get and Set nodes:
-Random:
+| Node | Description | Type |
+|------|-------------|------|
+| `Get ` | Read variable value | Pure |
+| `Set ` | Set variable value | Exec |
-| Node | Description |
-|------|-------------|
-| `Random Range` | Random float in range |
-| `Random Int` | Random integer in range |
+### Example: Counter
-## Logic Nodes
-
-Comparison:
-
-| Node | Description |
-|------|-------------|
-| `Equal` | Equal (==) |
-| `Not Equal` | Not equal (!=) |
-| `Greater Than` | Greater than (>) |
-| `Greater Or Equal` | Greater than or equal (>=) |
-| `Less Than` | Less than (<) |
-| `Less Or Equal` | Less than or equal (<=) |
-| `In Range` | Check if value is in range |
-
-Logical Operations:
-
-| Node | Description |
-|------|-------------|
-| `AND` | Logical AND |
-| `OR` | Logical OR |
-| `NOT` | Logical NOT |
-| `XOR` | Exclusive OR |
-| `NAND` | NOT AND |
-
-Utility:
-
-| Node | Description |
-|------|-------------|
-| `Is Null` | Check if value is null |
-| `Select` | Choose A or B based on condition (ternary) |
+
+
+
+
+
+ Event Tick
+
+
+
+
+
+ Delta
+
+
+
+
+
Get Count
+
+
+
+ Value
+
+
+
+
+
Add
+
+
+
+ Exec
+
+
+
+ A
+
+
+
+ B
+ 1
+
+
+
+ Result
+
+
+
+
+
Set Count
+
+
+
+ Exec
+
+
+
+ Value
+
+
+
+ Exec
+
+
+
+
## Debug Nodes
| Node | Description |
|------|-------------|
-| `Print` | Print to console |
+| `Print` | Output message to console |
-## Auto-generated Component Nodes
+## Related Documentation
-Components marked with `@BlueprintExpose` decorator auto-generate nodes:
-
-```typescript
-@ECSComponent('Transform')
-@BlueprintExpose({ displayName: 'Transform', category: 'core' })
-export class TransformComponent extends Component {
- @BlueprintProperty({ displayName: 'X Position' })
- x: number = 0;
-
- @BlueprintProperty({ displayName: 'Y Position' })
- y: number = 0;
-
- @BlueprintMethod({ displayName: 'Translate' })
- translate(dx: number, dy: number): void {
- this.x += dx;
- this.y += dy;
- }
-}
-```
-
-Generated nodes:
-- **Get Transform** - Get Transform component
-- **Get X Position** / **Set X Position** - Access x property
-- **Get Y Position** / **Set Y Position** - Access y property
-- **Translate** - Call translate method
+- [Blueprint Editor Guide](./editor-guide) - Learn how to use the editor
+- [Custom Nodes](./custom-nodes) - Create custom nodes
+- [Blueprint VM](./vm) - Runtime API
diff --git a/docs/src/content/docs/modules/blueprint/nodes.md b/docs/src/content/docs/modules/blueprint/nodes.md
index 18f7221c..a058778e 100644
--- a/docs/src/content/docs/modules/blueprint/nodes.md
+++ b/docs/src/content/docs/modules/blueprint/nodes.md
@@ -1,17 +1,117 @@
---
title: "ECS 节点参考"
-description: "蓝图内置 ECS 操作节点"
+description: "蓝图内置 ECS 操作节点完整参考"
---
+本文档提供蓝图系统所有内置节点的完整参考，包含可视化示例。
+
+## 引脚类型说明
+
+