This package contains the official sector files exclusively for use by controllers and observers at VATSIM HK.
| Latest Version | |
|---|---|
| Sector Package |  |
| Sector Installer |  |
To install the package:
- Download the latest version of the Hong Kong Sector Installer.
- Run the .exe and select "Install Sector Package". Select the folder you wish to store the data files in and click OK. The installer will auomatically download the latest version of the Sector Package from this GitHub repository.
- Optionally, select "Change Colour Theme" to select your desired colour scheme.
- Open EuroScope, navigate to where you installed the files and select "Hong Kong TOPSKY.prf" to open the default profile. You are now ready to start observing / controlling!
To update the package:
- Run the installer.exe.
- Select "Update Sector Package," then select the folder containing your sector package.
- The installer will check for updates from this GitHub repository. If updates are found, it will download them and automatically merge them with your personal settings.
- If conflicts are detected, the installer will prompt you and resolve them automatically, or you can choose to resolve the conflicts manually (recommended for experienced controllers only).
If you are technically inclined, you can install the sector package by cloning the GitHub repository, allowing you to receive seamless updates. First, install Git for Windows by downloading and running their installer. Navigate to your EuroScope folder, right click anywhere in the explorer menu and click "Open in Terminal," then run the following commands:
git clone https://github.com/vatsimhk/Hong-Kong-Sector-Package.git
cd Hong-Kong-Sector-Package
To update the package, simply open the Terminal again and run these commands:
git checkout main
git pull --rebase --autostash
This will automatically install updates without affecting your other personal settings.
If the above options do not work, you can manually install the files using a ZIP install. Select the latest stable version in the table above, then scroll down below the changelog and click source code .zip file to download it. Extract it to a convenient location. When updates are released, download the new package, extract the new ZIP file and overwrite the files in your existing install. Please note that you may need to reconfigure certain settings by updating this way.
If you get an error on load, please install the latest C++ redistributables. The newly added plugins are compiled with newer C++ Libraries that you may or may not have already installed.
You can create an issue with a brief description of the bug/problem and I will address it for the next release.
All vACC certified controllers and staff members are allowed to contribute to the sector file. Please DM Justin Wai on Discord (@eightsmart) or email j.wai@vathk.com with your GitHub username and your VATSIM CID for your account to be verified. Contributions from unverified accounts will not be accepted.
At the beginning of each cycle, a branch will be created for the next AIRAC cycle, and the .sct and .ese sector names will be changed to XXXXdev (e.g. 2402dev) to show that the package is not an official release. All PRs should be submitted to this new branch. When that AIRAC cycle becomes active, the sector names will remove the 'dev' suffix and be merged to the main branch. Thus, the main branch should be reserved for final releases only, that other controllers will download and use. It is not recommended to use the development branch for active controlling.
- .prf files will contain your last session data, including your VATSIM CID and Password.
- Do not commit personal settings or customisations, such as screen layout, symbology/colours, custom tags, display settings, etc.
- .asr files will contain a personal directory to your computer, which should be removed before comitting.
