Skip to content

Development

Jump to bottom
Sam S edited this page May 8, 2026 · 1 revision

STUDSYS24

Welcome to the official technical repository and master documentation for StudSys24.

StudSys24 is a high-performance, multi-tier ecosystem designed to revolutionize the vatSys radar environment. This project serves as a comprehensive bridge between real-time virtual air traffic control (vATC) operations, enterprise-grade server hosting, and automated communication infrastructure. By leveraging WebSocket data streams and Discord RPC gateways, StudSys24 provides a unified Control Display System (CDS) and Voice Communication System (VCS) that enhances situational awareness and streamlines frequency management.

1. CORE SYSTEM ARCHITECTURE

The StudSys24 ecosystem is divided into three primary tiers, ensuring that failure in one module does not compromise the integrity of the entire system.

  • THE FRONTEND (vatSys Plugin): A C#/.NET 4.8 dynamic link library (.dll) that injects directly into the vatSys process. It handles coordinate transformation, UI rendering, and user input.

  • THE BRIDGE (Gateway Tier): The communication layer that connects the local workstation to the wider network using Discord RPC to control local voice clients and WebSockets for data uplink.

  • THE BACKEND (Server Tier): A 24/7 background service hosted on a Lenovo ThinkSystem SR630 running Ubuntu Server 22.04 LTS. It manages long-term data logging, aircraft tracking history, and cross-platform synchronization.

2. KEY FUNCTIONAL MODULES

A. THE VCS (VOICE COMMUNICATION SYSTEM)

The VCS module is an embedded window inside the radar environment that eliminates the need for manual window switching.

  • Automated Handoffs: Switches Discord channels automatically when a controller changes their active frequency.

  • Authorization Gateway: Uses OAuth2 protocols to securely link a user’s Discord profile to their ATC workstation via the Discord Developer Portal.

  • Rich Presence: Displays real-time controller stats (Sector, Callsign, Frequency) on the user's Discord profile.

B. THE CDS (CONTROL DISPLAY SYSTEM)

The CDS is the engine responsible for aircraft data processing.

  • Data Ingestion: Utilizes high-speed WebSockets to pull telemetry from the server.

  • Coordinate Transformation: Converts raw WGS84 GPS coordinates into Cartesian space for accurate radar blip placement on the vatSys canvas.

  • JSON Parsing: Uses Newtonsoft.Json for efficient handling of complex aircraft data packets.

3. HARDWARE & ENVIRONMENT SPECIFICATIONS

To maintain the high performance required for professional vATC simulation, StudSys24 adheres to the following standards:

Component | Minimum Specification | Recommended (Production) -- | -- | -- Workstation OS | Windows 10 | Windows 11 Framework | .NET Framework 4.8 | .NET Framework 4.8 (Dev SDK) Host Hardware | Raspberry Pi / Basic VM | Lenovo SR630 (Dual Xeon) Host OS | Windows Home | Ubuntu Server 22.04 LTS Dependencies | Discord Desktop App | Discord Desktop + PM2 Manager

4. DEPLOYMENT & BUILD AUTOMATION (CI/CD)

StudSys24 follows a "Zero-Local-Failure" development cycle. To eliminate local environment conflicts, the project utilizes GitHub Actions for all compilations.

  • Automated Testing: Every push to the repository triggers a build check on a Windows-Latest virtual runner.

  • Artifact Generation: Successful builds automatically upload a ready-to-use StudSys24.dll, allowing for immediate deployment.

  • Process Persistence: Backend services are managed by PM2 on Ubuntu, ensuring that services resume immediately upon system reboot.

5. DIRECTORY & REPOSITORY STRUCTURE

  • /CDS: Contains the Control Display System logic and the Discord VCS window code.

  • /Properties: Manages system-level metadata, including the project GUID and assembly versioning.

  • .github/workflows: Houses the YAML build scripts that manage automated cloud compilation.

  • StudSys24.sln: The master Solution file for Visual Studio 2022.

6. TROUBLESHOOTING & MAINTENANCE

  • Build Failure (Exit Code 1): Usually caused by a missing vatSys.exe reference in the root directory or a syntax error in AssemblyInfo.cs.

  • VCS Disconnect: Occurs if the Discord Desktop app is not running or if the RPC port (6463) is blocked by a local firewall.

  • Ubuntu Server Updates: Use sudo apt update && sudo apt upgrade followed by pm2 restart all to maintain backend security.

"Precision Control. Unified Communication. Absolute Reliability."

Clone this wiki locally