hytale/hytale-server
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update documentation; patch ChangeActiveSlotInteraction

Browse Source
This commit is contained in:
luk
2026-02-03 16:44:06 +00:00
parent f8d7b9a781
commit 49a80ebf77
16 changed files with 531 additions and 472 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
docs/05-entity-system.md
View File

@@ -1,6 +1,7 @@
# Entity Component System (ECS)
The Hytale server uses an Entity Component System architecture for managing game entities. This provides high performance and flexibility for handling large numbers of entities with varied behaviors.
The Hytale server uses an Entity Component System architecture for managing game entities. This provides high
performance and flexibility for handling large numbers of entities with varied behaviors.
## ECS Concepts
@@ -16,16 +17,16 @@ The ECS pattern separates data (Components) from behavior (Systems):
### Key Classes
| Class | Description |
|-------|-------------|
| `Component<S>` | Base component interface |
| Class | Description |
|---------------------|--------------------------------------|
| `Component<S>` | Base component interface |
| `ComponentRegistry` | Central registry for component types |
| `Store` | ECS data storage |
| `Ref` | Entity reference (ID wrapper) |
| `Holder<C>` | Component holder/accessor |
| `Archetype` | Entity archetype definition |
| `SystemType` | System type definition |
| `Query` | ECS query for finding entities |
| `Store` | ECS data storage |
| `Ref` | Entity reference (ID wrapper) |
| `Holder<C>` | Component holder/accessor |
| `Archetype` | Entity archetype definition |
| `SystemType` | System type definition |
| `Query` | ECS query for finding entities |
## Components
@@ -80,14 +81,14 @@ public class HealthComponent implements Component<EntityStore> {
The server provides several built-in components in `EntityStore.REGISTRY`:
| Component | Description |
|-----------|-------------|
| `TransformComponent` | Position, rotation, and scale |
| `UUIDComponent` | Unique entity identifier |
| `ModelComponent` | Visual model reference |
| `MovementAudioComponent` | Movement sound effects |
| `PositionDataComponent` | Position tracking data |
| `HeadRotation` | Head rotation for living entities |
| Component | Description |
|--------------------------|-----------------------------------|
| `TransformComponent` | Position, rotation, and scale |
| `UUIDComponent` | Unique entity identifier |
| `ModelComponent` | Visual model reference |
| `MovementAudioComponent` | Movement sound effects |
| `PositionDataComponent` | Position tracking data |
| `HeadRotation` | Head rotation for living entities |
### Registering Components