How netniv/stfc-mod works
This repository provides a Star Trek Fleet Command community mod, with Windows and macOS injection entry points, plus a macOS launcher/updater. The main runtime path injects the mod and applies game patches; configuration and documented gameplay/UI features form supporting branches. The launcher presents update actions through a view model backed by Xsolla update logic. Feature coverage uses README-documented capabilities and tree paths; most individual patch implementations were not sampled, so their internal call relationships are not asserted.
Main entry points: patches.cc Patch Application · src/main.cc Windows Proxy · src/main.cc macOS Loader · src/main.cc macOS Mod Library
Components 16
Launch and Injection
- Windows Proxy
win-proxy-dll/src/main.cc - macOS Loader
macos-loader/src/main.cc - macOS Mod Library
macos-dylib/src/main.cc
macOS Updater
- Updater Views
macos-launcher/src/ActionView.swift - Updater View Model
macos-launcher/src/ViewModel/GameUpdaterViewModel.swift - Game Update Logic
macos-launcher/src/XsollaLib.swift
Mod Runtime
- Patch Application
mods/src/patches/patches.cc - Mod Configuration
mods/src/config.h - Toast Notifications
mods/src/patches/notification_service.cc
Gameplay Features
- Fleet Actions
mods/src/prime/FleetsManager.h - Action Queue
mods/src/prime/ActionQueueManager.h - Fleet Deployment
mods/src/prime/DeploymentManager.h - Chat Preview
mods/src/prime/ChatPreviewController.h - UI and Navigation Tweaks
mods/src/patches/parts - Combat and Fleet Tweaks
mods/src/patches/parts
Other components
- Player
Connections 14
- Player → Windows Proxy: launches game
README.md - Windows Proxy → Patch Application: applies patches
win-proxy-dll/src/main.cc - Player → macOS Loader: launches game
README.md - macOS Loader → macOS Mod Library: preloads library
macos-loader/src/main.cc - macOS Mod Library → Patch Application: applies patches
macos-dylib/src/main.cc - Player → Updater Views: requests update
README.md - Updater Views → Updater View Model: uses view model
macos-launcher/src/ActionView.swift - Updater View Model → Game Update Logic: calls update logic
macos-launcher/src/ViewModel/GameUpdaterViewModel.swift - Mod Configuration → Patch Application: configures features
README.md - Patch Application → UI and Navigation Tweaks: enables tweaks
README.md - Patch Application → Combat and Fleet Tweaks: enables tweaks
README.md - Fleet Actions → Fleet Deployment: requests tow
mods/src/prime/FleetsManager.h - Action Queue → Fleet Actions: uses fleet data
mods/src/prime/ActionQueueManager.h - Toast Notifications → Mod Configuration: reads settings
mods/src/patches/notification_service.cc