Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
76 commits
Select commit Hold shift + click to select a range
f795a55
feature/improve-ship-management-2.0 (#283)
GingerNinja-STFC Sep 19, 2026
c4286f4
fix xcode 27 build problem for launcher UI by making sure xmake loads…
a5ehren Sep 19, 2026
48e2221
Treat empty shortcut strings as disabled bindings (#290)
Guffawaffle Sep 19, 2026
38114ea
Add initial M95 Haven sync (#298)
lightbull-stfc Sep 22, 2026
8ff540b
Force update of loading screen
netniV Sep 22, 2026
68834e3
Update version to .1 for dev testing
netniV Sep 22, 2026
fcc53aa
Preserve 64-bit ship locale IDs in the native wrapper (#300)
Guffawaffle Sep 24, 2026
21e66c6
Show ship cargo totals immediately with a TOML toggle (#306)f
Guffawaffle Sep 27, 2026
b693360
docs: correct AGENTS.md header, macOS minver, and localized example l…
blevouschurverantunt Sep 27, 2026
245d253
Show automatic Warp/Jump choice on the system course button (#292)
Guffawaffle Sep 27, 2026
4ba65c0
Arbitrate WASD movement through configurable hotkeys (#309)
Guffawaffle Sep 27, 2026
941c20c
Update sync targets with default urls (#311)
netniV Sep 27, 2026
a0c1646
Update version to 1.1.9 beta 1
netniV Sep 27, 2026
fd8cb11
Go directly to Ship Swap (#312)
netniV Sep 29, 2026
7b0934b
Fix up haven shortcut
netniV Sep 29, 2026
51b3821
The Vneck GA QoL Improvement: Add an opt-in Galactic Anomaly countdow…
Guffawaffle Sep 29, 2026
86f5fac
Add a features list
netniV Sep 30, 2026
74bfddf
Fix patches and feature enablement to be used correctly (#313)
netniV Sep 30, 2026
6ceb892
Add shortcut to swap officers (#316)
netniV Sep 30, 2026
bc39646
Restore battle log and ship sync for the current client (build 267) (…
blevouschurverantunt Oct 1, 2026
e3705fd
Fix x64 trampoline offsets when multiple instructions expand (#303)
Guffawaffle Sep 22, 2026
d39e36b
Fix armada level
netniV Oct 1, 2026
234c70a
Add OfficerPreset shortcut (#317)
netniV Oct 1, 2026
1c2e70e
feat: sync away team assignments (#295)
blevouschurverantunt Oct 3, 2026
a38241f
Include trait demand in away assignment events (#318)
blevouschurverantunt Oct 4, 2026
861f772
feat: optionally hide artifact Exchange All button (#276)
Guffawaffle Oct 4, 2026
e54caa5
Rename exchange all setting
netniV Oct 4, 2026
d8a5714
Some minor variable renaming for better readability
netniV Oct 4, 2026
a1587ee
Try to fix MacOS CI
netniV Oct 4, 2026
e7a646b
Update example files
netniV Oct 4, 2026
d237fcf
Add cross-platform notification audio cues (#253)
Guffawaffle Oct 5, 2026
cc70198
Support All wildcard in the existing named audio event filter (#259)
Guffawaffle Oct 7, 2026
03bc0fa
Reverse Haven Stats (history) (#320)
netniV Oct 8, 2026
16f8a7e
Expand Haven zoom while preserving road surface detail (#319)
Guffawaffle Oct 9, 2026
ef4f434
Expand Haven sync with building pieces and fix map data (#321)
lightbull-stfc Oct 10, 2026
b66f3df
Bugfix/suppress store popups (#244)
GingerNinja-STFC Oct 10, 2026
e41501c
Apply configured backdrop scale on system entry (#322)
Guffawaffle Oct 11, 2026
b3ea133
Update version for next beta 3
netniV Oct 11, 2026
e298381
Repair mission HUD visibility overrides for the current client (#296)
Guffawaffle Oct 11, 2026
4502cb2
Add log history (#323)
netniV Oct 11, 2026
546454f
Fix artifact gallery (#326)
netniV Oct 14, 2026
fd360de
Re-emit job events when start, duration or reduction changes (#327)
blevouschurverantunt Oct 15, 2026
b266794
Sync dock with Manage Ships and try reset stuck abilities
netniV Oct 16, 2026
11b738a
Protect and recover Kirshara queues after target or address changes (…
Guffawaffle Oct 16, 2026
b4a43a6
feat: hide player title rows in chat messages (#329)
GingerNinja-STFC Oct 16, 2026
c0e8dfa
feat(reveal-confirmation): auto-confirm the Excelsior's Decloaking De…
GingerNinja-STFC Oct 16, 2026
8844639
Make primary-action target visibility protection opt-in (#328)
Guffawaffle Oct 16, 2026
f89bc47
feat: pin or unpin fleet dock ships with SHIFT+click (#330)
GingerNinja-STFC Oct 16, 2026
c4bf35c
Divsion 12 loading screen
netniV Oct 17, 2026
44958fe
feat: station-interior zoom-out (interior_zoom_scale) (#332)
kcid9660 Oct 17, 2026
270c876
Update all the mod example files
netniV Oct 17, 2026
5e72654
Fix issue with PC player titles
netniV Oct 17, 2026
f7bc054
feat: prefer tech-applied ship in pinned ship level ties (#335)
GingerNinja-STFC Oct 20, 2026
5ae1ede
feat: auto-confirm the alliance max-level contribution warning (#336)
GingerNinja-STFC Oct 20, 2026
8400fda
Make daily bulk-claim faction defaults explicit (#338)
Guffawaffle Oct 20, 2026
37e3308
Fix ship shortcut hints when dock indices have gaps (#341)
Guffawaffle Oct 20, 2026
98dc3d8
perf: cache Haven road material discovery (#343)
Guffawaffle Oct 22, 2026
6b56e4c
Scope galactic anomaly owner discovery to the active HUD (#344)
Guffawaffle Oct 22, 2026
bb49107
Sync faction store offers (opt-in store_offers) (#342)
blevouschurverantunt Oct 22, 2026
3c8ab85
Add name to forbidden tech selections (#347)
netniV Oct 24, 2026
dfb48d2
Add option to disable target camera lock (#348)
DerPizzadieb Oct 24, 2026
1e868b6
Hook player titles through the shared implementation (#337)
Guffawaffle Oct 24, 2026
e884efa
Sync the local player's own profile (opt-in profile) (#346)
blevouschurverantunt Oct 24, 2026
f9a131e
fix: restore station-exterior zoom after interior visit (interior_zoo…
kcid9660 Oct 26, 2026
d303903
Update canonical upstream repository endpoints after transfer (#351)
Guffawaffle Oct 26, 2026
4f403a9
Recover anomaly timer owners across registered HUD canvases (#350)
Guffawaffle Oct 26, 2026
ff17958
Sync: opt-in live fleet state (`fleets`) (#325)
ProgenyAlpha Oct 27, 2026
9cb7ee0
Fix first-sync flag for Haven (#356)
lightbull-stfc Nov 1, 2026
64577eb
Enable Kirshara queue protections on macOS (#339)
Guffawaffle Nov 1, 2026
03a45a0
Fix fleet sync number conversion on supported macOS versions (#354)
Guffawaffle Nov 1, 2026
ed0535c
Fix galaxy map drag and momentum overshoot (#357)
Guffawaffle Nov 11, 2026
2ae3eb6
Fix Alliance Games Store research, currencies and purchase refresh (#…
Guffawaffle Nov 11, 2026
9c31ede
Fix wave joining, and auto-open chat (#358)
netniV Nov 12, 2026
5385e3e
Fix/wave joining (#359)
netniV Nov 12, 2026
3a27347
Prep for release 1.1.10 (#360)
netniV Nov 12, 2026
0c51e78
Prepare exact 1.1.10.0 snapshot for main
netniV Nov 15, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Keep text files consistent across Windows and macOS.
* text=auto eol=lf
56 changes: 46 additions & 10 deletions .github/workflows/ci.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,11 @@ concurrency:
cancel-in-progress: true

env:
XMAKE_VERSION: "3.1.0"
XMAKE_VERSION: "3.1.1"
# Bump this when a dependency cache must be invalidated manually.
XMAKE_CACHE_SCHEMA: "v4"
# Narrow protobuf-only compiler-cache experiment.
PROTOBUF_SCCACHE_VERSION: "v0.17.0"
PROTOBUF_SCCACHE_VERSION: "v0.18.0"
PROTOBUF_SCCACHE_SCHEMA: "v1"
STFC_PROTOBUF_SCCACHE: "1"
# Keep sccache local; actions/cache owns persistence explicitly.
Expand Down Expand Up @@ -189,6 +189,20 @@ jobs:
shell: pwsh
run: sccache --zero-stats

- name: Test IL2CPP runtime helpers
run: |
xmake build -y il2cpp-runtime-tests
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
xmake run il2cpp-runtime-tests
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

- name: Test IL2CPP class lookup
run: |
xmake build -y il2cpp-class-lookup-tests
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
xmake run il2cpp-class-lookup-tests
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

- name: Build
run: xmake build -y stfc-community-mod

Expand All @@ -211,6 +225,11 @@ jobs:
"build/windows/x64/release/stfc-community-mod.dll" `
"version.dll"

- name: Test checked IL2CPP helpers
run: |
xmake build -y il2cpp-checked-tests
xmake run il2cpp-checked-tests

- name: Verify DLL provenance
shell: pwsh
run: |
Expand Down Expand Up @@ -262,7 +281,7 @@ jobs:
needs: build-win
if: >-
github.event_name == 'push' &&
github.repository == 'netniV/stfc-mod' &&
github.repository == 'STFC-Mod/mod' &&
github.ref_protected &&
(github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
runs-on: windows-2025-vs2026
Expand Down Expand Up @@ -331,8 +350,10 @@ jobs:

runs-on: ${{ matrix.runner }}
env:
MACOSX_DEPLOYMENT_TARGET: "13.5"
SWIFT_MODULE_CACHE_SCHEMA: "v1"
MACOSX_DEPLOYMENT_TARGET: "14.6"
# Swift PCM files embed their absolute module-cache path. Invalidate the
# cache when the repository checkout path changes (for example, on rename).
SWIFT_MODULE_CACHE_SCHEMA: "v2"
SCCACHE_DIR: ${{ github.workspace }}/build/.protobuf-sccache
SCCACHE_CACHE_SIZE: "1G"

Expand Down Expand Up @@ -477,6 +498,16 @@ jobs:
shell: bash
run: sccache --zero-stats

- name: Test IL2CPP runtime helpers
run: |
xmake build -y il2cpp-runtime-tests
xmake run il2cpp-runtime-tests

- name: Test IL2CPP class lookup
run: |
xmake build -y il2cpp-class-lookup-tests
xmake run il2cpp-class-lookup-tests

- name: Build
# -D keeps the existing XMake compiler-cache diagnostics too.
run: xmake -y -D
Expand Down Expand Up @@ -504,6 +535,11 @@ jobs:
echo "::warning::Swift module cache directory was not created"
fi

- name: Test checked IL2CPP helpers
run: |
xmake build -y il2cpp-checked-tests
xmake run il2cpp-checked-tests

- name: Verify portable macOS linkage
shell: bash
run: |
Expand Down Expand Up @@ -754,26 +790,26 @@ jobs:
shell: bash
run: |
set -euo pipefail

APP="build/macosx/arm64/release/STFC Community Mod.app"

check_linkage() {
local binary="$1"
local deps

echo
echo "==> $binary"
deps="$(otool -L "$binary")"
printf '%s\n' "$deps"

if printf '%s\n' "$deps" | grep -E \
'/opt/homebrew/|/usr/local/(opt|Cellar)/|(^|/)libssl(\.[0-9]+)*\.dylib|(^|/)libcrypto(\.[0-9]+)*\.dylib|(^|/)libcurl(\.[0-9]+)*\.dylib'
then
echo "::error file=$binary::Forbidden dynamic dependency detected"
return 1
fi
}

check_linkage "$APP/Contents/MacOS/macOSLauncher"
check_linkage "$APP/Contents/stfc-community-mod-loader"
check_linkage "$APP/Contents/libstfc-community-mod.dylib"
Expand Down
12 changes: 7 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
This file provides guidance to AI coding agents working with code in this repository.

## Project Overview

Expand All @@ -15,7 +15,7 @@ This project uses **XMake** (not CMake). All build configuration is in `xmake.lu
```bash
# Configure and build (command line)
xmake # Build default target
xmake f -p macosx -a arm64 -m debug --target_minver=13.5 # Configure for macOS ARM debug
xmake f -p macosx -a arm64 -m debug --target_minver=14.6 # Configure for macOS ARM debug
xmake f -p windows -m release # Configure for Windows release

# Generate Visual Studio solution
Expand All @@ -40,7 +40,7 @@ Delete the `build/` folder to reset. Also delete `.vs/` for a full Visual Studio

- Keep changes scoped. Do not stage unrelated dirty files or generated artifacts unless the user explicitly asks.
- Before finishing C++ or patch work, run `git diff --check` and the narrowest relevant xmake build.
- For macOS core mod changes, use `xmake f -p macosx -a arm64 -m debug --target_minver=13.5 -y && xmake -y mods`.
- For macOS core mod changes, use `xmake f -p macosx -a arm64 -m debug --target_minver=14.6 -y && xmake -y mods`.
- Review the final diff for risky hooks, platform guards, config default mismatches, and missing example config updates.
- If a subtree such as `macos-launcher/` needs specialized guidance, prefer a nested `AGENTS.md` near that code instead of overloading this root file.

Expand Down Expand Up @@ -92,9 +92,11 @@ static auto class_helper = il2cpp_get_class_helper("Assembly.Name", "Namespace",
static auto method = class_helper.GetMethodInfo("MethodName");
```

**Adding a new patch** — Create a `.cc` file in `mods/src/patches/parts/`, write an `InstallXxxHooks()` function, declare it in `patches.cc`, add a `bool installXxx` to `Config`, and register in the `patches[]` array in `patches.cc`. Patch toggles are only read from TOML in `_MODDBG` builds, so update both the `_MODDBG` config parsing path and the non-`_MODDBG` release defaults in `config.cc`.
**Adding a new patch** — Create a `.cc` file in `mods/src/patches/parts/`, write an `InstallXxxHooks()` function, declare it in `patches.cc`, add a `bool installXxx` to `Config`, and register it in the `patches[]` array in `patches.cc`. Hook-install toggles are read from the `[patches]` TOML table in all build modes and should default to `true`; they exist as emergency compatibility switches for hook collisions or client drift.

**Config** — User settings are in TOML files. The `Config` singleton (`Config::Get()`) is loaded once during `il2cpp_init_hook`. Add new settings to `config.h`, add defaults in `defaultconfig.h`, and load them in `config.cc`. For user-facing settings, update every localized example (`example_community_patch_settings_en.toml`, `example_community_patch_settings_de.toml`, `example_community_patch_settings_fr.toml`, and `example_community_patch_settings_nl.toml`) unless the setting is intentionally internal. The unsuffixed `example_community_patch_settings.toml` is only a pointer to these localized examples.
**Separate hook installation from feature enablement** — Do not use a user-facing feature setting to decide whether its hooks are installed. Normally install all supported hooks, then have each hook check the feature setting and immediately preserve native behavior (usually by calling `original`) when the feature is disabled. Keep hook-install switches under `[patches]` and feature settings in their relevant sections such as `[ui]`, `[graphics]`, or `[audio]`; never place a feature-only toggle under `[patches]`. If an installer contains an early return based on a feature setting, or a `patches[]` entry points directly at a feature setting, treat that as a design error. Helpers that install no hooks, such as shortcut-only behavior, do not belong in `patches[]` at all.

**Config** — User settings are in TOML files. The `Config` singleton (`Config::Get()`) is loaded once during `il2cpp_init_hook`. Add new settings to `config.h`, add defaults in `defaultconfig.h`, and load them in `config.cc`. For user-facing settings, update only the English example (`example_community_patch_settings_en.toml`). Do not update the other localized examples unless the user explicitly asks for translation updates. The unsuffixed `example_community_patch_settings.toml` is only a pointer to these localized examples and should not be changed when adding or modifying settings.

### Dependencies (via xmake packages)

Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ sponsorships are greatly appreciated.
First clone and initialize the repository:

```bash
git clone https://github.com/netniv/stfc-mod.git
git clone https://github.com/STFC-Mod/mod.git stfc-mod
cd stfc-mod
```

Expand Down
179 changes: 179 additions & 0 deletions FEATURES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,179 @@
# STFC Community Mod Features

The STFC Community Mod adds configurable quality-of-life improvements to the desktop version of Star Trek Fleet Command. This catalog describes the user-facing features represented by the current source code and English example configuration.

Most options are configured in `community_patch_settings.toml`. The mod creates a default settings file when one is missing and also writes a parsed settings file so you can see the values that were applied. Nearly every shortcut can be remapped; see [`KEYMAPPING.md`](KEYMAPPING.md) for valid key names.

## Display and window controls

- Set the overall interface scale and the amount changed by each scale adjustment.
- Scale object viewers independently from the main interface.
- Scale ship models in System View independently from the interface.
- Adjust the interface, viewer, and ship scales while playing with configurable shortcuts.
- Enable freely resizable game windows on Windows.
- Enable borderless fullscreen mode and switch between fullscreen and windowed mode without restarting the game.
- Control whether the game replaces the system cursor.
- Adjust the frame-rate scaling factor used by visual effects.
- Set the duration of screen transitions.

## System View camera and navigation

- Increase the maximum System View zoom distance.
- Set the zoom level used when entering a system.
- Configure five System View zoom presets.
- Zoom in, zoom out, jump to minimum or maximum zoom, and reset zoom by shortcut.
- Save the current zoom or a preset as the new default.
- Configure keyboard zoom speed.
- Configure System View pan momentum and momentum falloff.
- Use keyboard movement controls for System View, or disable those movement keys.
- Configure player and non-player fleet labels to use native, expanded, compact, or zoom-threshold-based detail.
- Configure separate fleet-label zoom thresholds for player and non-player fleets.

## Hotkeys and screen navigation

- Enable or disable all hotkeys.
- Choose between the community mod hotkeys and Scopely's native hotkeys.
- Enable an extended set of mod shortcuts.
- Remap shortcuts in the settings file, including multiple keys or mouse buttons for one action.
- Open or focus commonly used screens directly, including:
- Alliance, Alliance Armada, and Alliance Help.
- Artifact Gallery, Away Teams, Battle Reports, Bookmarks, and Chat.
- Command Center, Daily Missions, Events, ExoComp, Factions, and Fleet Commander.
- Galaxy View, System View, Station Exterior, and Station Interior.
- Gifts, Haven, Inventory, Missions, Officers, Q Trials, Refinery, Research, and Scrap Yard.
- Settings, shield selection, ship construction, ship management, and ship swapping.
- Open Alliance, Galaxy, and Private chat tabs directly.
- Focus the current screen's search field with a shortcut.
- Use configurable primary-action, alternate-action, queue, recall, repair, and cancel shortcuts.
- Select ships 1 through 8 and configure the double-tap timing used to locate a selected ship.
- Recall a selected ship or perform context-sensitive actions against mines, players, hostiles, and other targets.
- Clear focused text or close chat with Escape.

## Combat and ship interaction

- Enable the Kir'Shara attack queue by default when the artifact is owned.
- Add targets to the Kir'Shara queue, clear the queue, or toggle queuing by shortcut.
- Use a configurable primary action for context-sensitive attacks, warps, and cancellations.
- Choose the automatic action for the instant-warp confirmation: show the dialog, use regular warp, or use instant jump.
- Configure ship-name lists that always use regular warp, always use instant jump, or always show the confirmation dialog.
- Cycle the current instant-warp behavior by shortcut.
- Keep the warp action label consistent with the selected automatic action.
- Automatically confirm Forbidden Tech level and tier upgrades when enabled.

## Cargo and target previews

- Show cargo or rewards automatically in the default target preview.
- Configure cargo visibility independently for player ships, stations, hostiles, and armadas.
- Toggle each cargo-preview mode while playing.
- Switch between cargo and the normal target view with a shortcut.
- Close pre-scan and target viewers with Escape.
- Allow or block locate and recall actions while previews are open, with runtime toggles for both behaviors.
- Show cargo totals immediately instead of playing the native count-up animation on supported Windows clients.
- Configure the number of decimal places used for abbreviated cargo values such as `1.25M`.

## Fleet and officer management

- Select the previous or next ship in the fleet-management dock with the Left and Right arrow keys.
- Double-click a ship in the fleet-management dock to assign it.
- Pin configured ship names to the front of the fleet-management dock while preserving the selected sort order.
- Restore the **Below Deck Ability** sorting option to officer roster and assignment screens.
- Show a ship's out-of-dock power while it is docked.

## Rewards donations and Daily Goals

- Skip chest-reveal animations and open rewards immediately.
- Extend the Alliance donation slider to a configurable maximum.
- Extend supported tagged chest-purchase sliders to a configurable maximum on Windows.
- Open the bulk gift-claim flyout automatically when entering Gifts.
- Exit the relevant section after gift collection through the mod's streamlined gift flow.
- Apply the Daily Goals **Claim All** behavior only to selected Federation, Klingon, or Romulan goals.
- Force the Daily Goals **Claim All** toggle on the first time the screen is opened in a session.

## Chat interface and HUD

- Hide Galaxy Chat.
- Hide Veil Chat.
- Open Chat full-screen or docked on either side by shortcut.
- Control the visibility of the Daily Goals, Field Training, Missions, Outposts, and Q Trials HUD buttons.
- Set each supported HUD item to native automatic behavior, always shown, or always hidden.
- Prevent Escape from opening the game-exit prompt.
- Optionally require a configurable double press of Escape before showing the exit prompt.

## Banners audio and popups

- Suppress selected toast-banner types.
- Send desktop notifications for selected banner types.
- Disable standard toast banners through the experimental global toggle.
- Suppress selected audio events by event name.
- Trace audio event names to the log to help build a suppression list.
- Automatically confirm Discovery prompts.

## Loading and transition screens

- Replace the login loading background with the mod's embedded artwork.
- Load a custom loading-screen image from a configured path.
- Scale the loading-screen logo.
- Show rotating community-mod tips on the loading screen.
- Reuse the loading artwork during transitions.
- Use a black transition background instead of artwork.

## Data synchronization

- Sync selected game data to one or more configured community services.
- Configure independent sync targets, including custom endpoints and access tokens.
- Sync any combination of:
- Battle logs.
- Buffs.
- Buildings.
- Inventory and resources.
- Jobs and missions.
- Owned officers, ships, and Forbidden Tech.
- Research.
- Slots.
- Traits.
- Use the built-in target definitions for STFC Data, Spock's Club, and Next Spock's Club.
- Route sync traffic through a proxy.
- Enable or disable SSL certificate verification.
- Configure resolver caching, diagnostic logging, and detailed debug logging.

## Reliability and configuration support

- Apply client-specific crash fixes and compatibility patches.
- Generate a default TOML settings file if no configuration exists.
- Generate a parsed TOML file showing the settings actually applied at runtime.
- Enable or disable patch groups independently in development builds.
- Log mod initialization, patch installation, and optional sync or audio diagnostics for troubleshooting.
- Support both Windows and macOS through platform-specific injection and loading components.

## Platform and availability notes

- Windows and macOS do not necessarily expose every feature in exactly the same way.
- Free window resizing and extended tagged chest-purchase sliders are Windows-specific.
- The instant cargo counter is guarded for a supported Windows client build; unsupported builds retain the native animation.
- Some settings are experimental or diagnostic and may be disabled, client-version-specific, or intended for troubleshooting.
- Patch availability can change when the game client changes because the mod hooks the native IL2CPP runtime.

## Default shortcut overview

The default shortcut map includes the following high-use controls. All of these can be changed in the settings file.

| Action | Default shortcut |
| --- | --- |
| Zoom presets | `F1` to `F5` |
| Zoom in or out | `Q` or `E` |
| Minimum maximum or default zoom | `BACKSPACE` `MINUS` or `=` |
| Main interface scale | `PGUP` or `PGDOWN` |
| Viewer scale | `SHIFT-PGUP` or `SHIFT-PGDOWN` |
| Ship model scale | `CTRL-PGUP` or `CTRL-PGDOWN` |
| Open full-screen chat | `C` |
| Open side chat | `ALT-C` or `` ` `` |
| Select or focus ships | `1` to `8` |
| Primary action or queue action | `SPACE` or `MOUSE1` |
| Recall or alternate action | `R` |
| Toggle cargo view | `V` |
| Toggle Kir'Shara queue | `CTRL-Q` |
| Clear Kir'Shara queue | `CTRL-C` |
| Focus search | `CTRL-F` |
| Toggle borderless fullscreen | `F11` |

For the complete shortcut list and the names accepted by the configuration parser, see [`README.md`](README.md) and [`KEYMAPPING.md`](KEYMAPPING.md).
Loading
Loading