YachtPit Systems Crate

The systems crate provides the core game systems, vessel logic, and maritime system integrations for the YachtPit virtual yacht cockpit application.

Overview

This crate contains all the business logic and system implementations built on top of Bevy's ECS (Entity-Component-System) architecture. It bridges the visual components with real maritime system behaviors, data processing, and vessel simulation logic.

System Modules

World Management

world::player - Player entity management and vessel ownership
- PlayerPlugin - Bevy plugin for player system integration
- get_vessel_systems() - Retrieves available vessel systems
- setup_instrument_cluster_system() - Initializes instrument displays

Vessel Systems

vessel::vessel_systems - Core vessel system implementations
- VesselSystem - Base trait for all vessel systems
- SystemStatus - System operational status tracking
- SystemInteraction - User interaction handling
- create_vessel_systems() - Factory for vessel system creation

Maritime Systems

AisSystem - Automatic Identification System integration
- Vessel tracking and identification
- Collision avoidance data
- Maritime traffic monitoring
GpsSystem - Global Positioning System implementation
- Position tracking and navigation
- Waypoint management
- Course and speed calculations
RadarSystem - Radar detection and display system
- Object detection and tracking
- Range and bearing calculations
- Weather and obstacle detection

Key Features

System Integration

Real-time Data Processing - Continuous updates of vessel and environmental data
System Interconnectivity - Maritime systems work together for comprehensive navigation
Status Monitoring - Track operational status of all vessel systems
User Interaction - Handle user inputs and system controls

Vessel Simulation

Realistic Behavior - Systems behave like real maritime equipment
Data Validation - Ensure data integrity and realistic ranges
System Dependencies - Model real-world system interdependencies
Performance Optimization - Efficient processing for real-time operation

Plugin Architecture

Modular Design - Each system can be enabled/disabled independently
Bevy Integration - Full integration with Bevy's plugin system
Event-Driven - Responsive to system events and state changes
Extensible - Easy to add new maritime systems

Usage

This crate is designed for internal use within the YachtPit project and is not published to crates.io. It provides the systems layer that connects components with application logic.

use systems::{
    PlayerPlugin, VesselSystem, SystemStatus,
    AisSystem, GpsSystem, RadarSystem,
    create_vessel_systems, get_vessel_systems
};

Dependencies

Bevy 0.16 - Core ECS engine and plugin system
components - UI components and instrument widgets
Rust Standard Library - Core functionality and data structures

Architecture

The systems crate follows these design principles:

ECS Integration

Systems - Process vessel data and update component states
Components - Store vessel and system state data
Resources - Manage shared data like vessel configuration
Events - Handle system interactions and state changes

Data Flow

Input Processing - Handle user interactions and external data
System Updates - Process maritime system logic and calculations
Component Updates - Update visual components with new data
Event Dispatch - Notify other systems of state changes

Performance Considerations

Efficient Queries - Optimized ECS queries for real-time performance
Batch Processing - Group similar operations for better performance
Memory Management - Careful resource management for smooth operation
Platform Optimization - Optimized for desktop, web, and mobile platforms

3.9 KiB Raw Blame History