A mod manager

A modern mod manager and launcher for FreeSpace Open

Website

Installation instructions

Dependencies

To run this script you'll need the following:

• Python 2 or 3
• SDL2
• OpenAL
• 7zip (IMPORTANT: This script needs the full implementation, i.e. p7zip-full and p7zip-rar on Ubuntu)
• pipenv
• yarn
• Node.js
• ninja

To install the Python and JavaScript dependencies run the following commands:

pipenv install
yarn install

If you're on Windows, the windows_run.bat file will take care of this in addition to launching Knossos itself.

Ubuntu 18.04 Packages

Install the following packages: sudo apt install nodejs npm python3-wheel python3-setuptools pyqt5-dev pyqt5-dev-tools qttools5-dev-tools qt5-default

Then install pipenv and yarn using the install instructions at their webpages. Also note that you'll need to uninstall the package cmdtest as that also has an executable called yarn.

Usage

After your first checkout you will have to run the two commands above and pipenv run python configure.py once. If it aborts before displaying Writing build.ninja..., you have to fix the error before you can continue. If it complains that rcc is missing, you will need to install the developer packages for Qt5.

Now you can use ninja run to launch Knossos in release mode and ninja debug to launch it in debug mode. In debug mode you can use a chromium-based browser to access the DevTools by navigating to http://localhost:4006/.

If you add or remove files in knossos, html/templates or html/images, you need to run tools/common/update_file_list.py (or update_file_list.bat on Windows) to update file_list.json.

If you have changed Node.js versions you may need to remove the node_modules directory and rerun yarn install.

License

Licensed under the Apache License, Version 2.0. See the NOTICE file for information.

The icon is borrowed from Hard Light.