Vortex

Vortex Development

1,061

152

1,061

412

View on GitHub

Top Related Projects

loot

1,658

A modding utility for Starfield and some Elder Scrolls and Fallout games.

Quick Overview

Vortex is an open-source mod manager developed by Nexus Mods for various games. It provides a user-friendly interface for installing, managing, and organizing game modifications, with support for multiple games and advanced features like load order optimization and conflict resolution.

Pros

Cross-platform compatibility (Windows, Linux, macOS)
Extensible plugin system for adding support for new games and features
Advanced mod conflict detection and resolution tools
Clean and intuitive user interface

Cons

Can be resource-intensive for large mod collections
Learning curve for advanced features and customization
Occasional stability issues, especially with certain games or large mod lists
Some users report slower performance compared to game-specific mod managers

Code Examples

As Vortex is primarily an application rather than a code library, there are no specific code examples to provide. However, it does offer an API for plugin development, which allows developers to extend its functionality.

Getting Started

Since Vortex is an application rather than a code library, there's no code-based quick start. Instead, here are the basic steps to get started with Vortex:

Download Vortex from the Nexus Mods website
Install Vortex on your system
Launch Vortex and log in with your Nexus Mods account
Select the games you want to manage mods for
Use Vortex to download and install mods from Nexus Mods or add mods manually
Manage your mod list, resolve conflicts, and adjust load order as needed
Deploy your mods and launch your game through Vortex

For more detailed instructions and documentation, refer to the official Vortex wiki on the Nexus Mods website.

Competitor Comparisons

Nexus-Mod-Manager

1,051

Pros of Nexus Mod Manager

Simpler and more straightforward user interface
Faster initial setup for basic modding needs
Better compatibility with older games and mods

Cons of Nexus Mod Manager

Limited advanced features and customization options
Lack of built-in conflict resolution tools
No longer actively developed or supported

Code Comparison

Nexus Mod Manager (C#):

public class ModInstaller
{
    public void InstallMod(string modPath)
    {
        // Simple mod installation logic
    }
}

Vortex (JavaScript):

class ModInstaller {
  async installMod(modPath) {
    // Advanced mod installation with error handling and conflict resolution
    await this.resolveConflicts(modPath);
    // More complex installation logic
  }
}

The code comparison highlights the difference in complexity and features between the two mod managers. Nexus Mod Manager uses a simpler approach with basic mod installation, while Vortex implements more advanced features like asynchronous operations and conflict resolution.

Vortex, being the successor to Nexus Mod Manager, offers a more robust and feature-rich modding experience. It provides better mod management, conflict resolution, and support for a wider range of games. However, some users may prefer the simplicity of Nexus Mod Manager for basic modding needs or older games.

loot

1,658

A modding utility for Starfield and some Elder Scrolls and Fallout games.

Pros of LOOT

Specialized focus on load order optimization for Bethesda games
Lightweight and efficient, with a smaller codebase
Community-driven masterlist updates for game-specific rules

Cons of LOOT

Limited to load order management, lacks broader mod management features
Supports fewer games compared to Vortex's wider compatibility
Less frequent updates and smaller development team

Code Comparison

LOOT (C++):

void Game::LoadOrderMethod(const GameType gameType) {
    switch (gameType) {
        case GameType::tes4:
        case GameType::tes5:
        case GameType::fo3:
        case GameType::fonv:
            return LoadOrderMethod::timestamp;
        default:
            return LoadOrderMethod::textfile;
    }
}

Vortex (JavaScript):

function determineLoadOrder(game) {
  const gameSupport = getGame(game);
  return gameSupport.getLoadOrder()
    .then(loadOrder => {
      // Process and return the load order
    });
}

This comparison highlights LOOT's specialized approach to load order management for specific games, while Vortex offers a more generalized and extensible framework for mod management across various games.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

Vortex Mod Manager

Last Commit Build Status Contributors License

Introduction

Vortex is the current mod manager from Nexus Mods. It is designed to make modding your game as simple as possible for new users, while still providing enough control for more experienced veterans of the modding scene.

Our approach with Vortex aims to take complex tasks such as sorting your load order or managing your mod files and automates as much of the process as possible with the goal of having you achieve a stable modded game with minimal effort. We want to help you spend less time modding and more time playing your games.

Features

Multi-game Support - with mod support for over 250 different games and counting, Vortex is the most versatile mod manager available. This includes games such as Skyrim, Fallout 3, Fallout 4, Fallout: New Vegas, Cyberpunk 2077, Baldur's Gate 3, Starfield, Stardew Valley, Bannerlord, Witcher 3, Elden Ring, The Sims 4, Monster Hunter: World, Oblivion, Palworld, Blade & Sorcery, Valheim, Hogwarts Legacy, 7 Days to Die.
Close integration with Nexus Mods - Vortex is designed to seamlessly interact with Nexus Mods allowing you to easily find, install, and play mods from our site, learn about new files and catch the latest news.
Modding made easy - The built-in auto-sorting system manages your load order and helps you to resolve mod conflicts with powerful, yet easy to use plugin management features.
Mod Profiles - Easily set up, switch between, and manage independent mod profiles enabling you to use exactly the combination of mods that you want for a particular playthrough.
Modern, Easy-to-use UI - Featuring a fully customisable interface, Vortex allows you to quickly and easily access tools and manage your games, plugins, downloads and save games.
Extensions and Plugins - Vortex is released under a GPL-3 License giving our community the ability to write extensions and frameworks which can then interact with Vortex, continually adding to its functionality.

Getting Started

To get started, Vortex can be downloaded from Nexus Mods or from GitHub. After the installer has been downloaded, just run it and follow the instructions.

Additional information on Vortex and guides can be found in the Vortex Wiki.

Development

To start development on Vortex, please use this mostly automated method to download and install all dependencies, clone the Vortex repo from GitHub and then build it so it can be run from source. Most dependencies are installed using Scoop.

Start a powershell by clicking the Start button and typing powershell.
Run Invoke-WebRequest "https://raw.githubusercontent.com/Nexus-Mods/Vortex/master/bootstrap.ps1" -OutFile bootstrap.ps1 to fetch the bootstrap script
By default, this script will build Vortex in C:\build\vortex. If you wish for it to be located somewhere else, edit the script to change the build directory before running it.
You will more than likely need to allow scripts to be run. This can be set using Set-ExecutionPolicy Unrestricted but a powershell with admin access is required.
Run the script (.\bootstrap.ps1)

Decisions

The following section aims to clarify and explain a few development decisions.

Development vs Release builds

The toolchain for development builds and release builds is quite different.

In dev builds, the typescript compiler (tsc) is used directly to transliterate each .ts file to .js individually, electron runs those files directly, dependencies are loaded from node_modules.

In release builds we use webpack and ts-loader to bake all .ts files and dependencies into two javascript files (one for the main/browser process, one for the renderer). electron-builder is used to bundle code & assets, generate an nsis installer, build it into an exe installer and sign them (and all the executables and dlls we ship). There are mulitple electron-builder configuration files for multiple variants, only "oneclick" and "advanced" are used for release builds, the others may be in different states of disrepair (though ci should work as well)

As a result, dev builds are easier to work with and building is much quicker but runtime is slower.

Further, we use a two-package structure, meaning the /package.json file is used for all development and the build environment for releases (e.g. this file always controls the electron version being used/bundled) whereas /app/package.json decides settings (name, version, dependencies) for the release builds only. We use a custom script (checkPackages.js) to ensure that the dependencies for release are a subset of the build env dependencies and that they use the same version to avoid problems that didn't occur during testing because of differing dependencies.

Bundled extensions on the other hand are built the same between dev and release: they are always built with webpack and each have their own build setup - with the exception of simple game extensions which are already single js files, those simply get copied over.

Yarn 1 vs Yarn 3 vs NPM vs PNPM

This codebase still use yarn 1 (classic). Any attempt to use yarn 2 or 3 ended up with nonsensical errors (missing dependencies that are clearly listed, successive installs leading to missing packages) with no reasonable way to investigate why. npm and pnpm are quite slow in comparison. We don't really use any yarn-specific features (workspaces?) so switching shouldn't be too difficult but for now yarn "classic" works.

ESM vs CommonJS

At the time of writing, electron doesn't support ES modules so everything is transpiled to commonjs. This has the consequence that some updated libraries supporting only esm can't be used (e.g. new versions of d3). It also means that asynchronous imports (const foo = await import('bar')) are actually synchronous at runtime. Doesn't really matter though since everything is baked into a single file on release builds anyway and code splitting isn't really needed.

Reporting Bugs

Please report issues on GitHub and include at the very least the following information:

The exact version of Vortex you're using
Your OS
What you were doing when the bug happened
What exactly the bug is (crash? error messages? unexpected behaviour?)
If you get any error message, include the full and exact error message. Do not paraphrase, do not leave out information that looks cryptic or unimportant to you
The log file (see below)
Ideally also the application state (see below)

All data the client generates (including settings and logs) are stored at:

Build Type	Location	Common Path
Release	`%AppData%\Vortex`	`C:\Users\<USERNAME>\AppData\Roaming\Vortex`
Dev	`%AppData%\vortex_devel`	`C:\Users\<USERNAME>\AppData\Roaming\vortex_devel`

If you need to report a bug, the following paths inside that directory may be useful in addition to the error message displayed on screen:

\vortex.log (logs are rotated at a certain size, this is the latest one)
\state\ except global_account (that one contains keys and passwords so sensitive information)
\<game>\state\ (if the bug pertains to a specific game)

Troubleshooting

TODO: Manual steps with dependencies and versions

Resources

Download Vortex from Nexus Mods
GitHub for source code, issues, and pull requests.
Vortex Forum or Discord for support and discussions with the community and the team.
Vortex Wiki for knowledge base, articles and troubleshooting
Project Structure for an overview of how the codebase is organized.

Contributing

The majority of Vortex code is open-source. We are committed to a transparent development process and highly appreciate any contributions. Whether you are helping us fix bugs, proposing new features, improving our documentation or spreading the word - we would love to have you as a part of the Vortex community.

Bug Report: If you see an error message or encounter an issue while using Amplication, please create a bug report.
Feature Request: If you have an idea or if there is a capability that is missing and would make development easier and more robust, please submit a feature request.
Review Extension: If you're creating a game extension and need us to review it, please submit a review extension request.

License

A this project is licensed under the GPL-3.0 license.

Top Related Projects

Nexus-Mod-Manager

1,051

loot

1,658

A modding utility for Starfield and some Elder Scrolls and Fallout games.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot