🚶‍♂️Intro

This page will go over Noir, and teach you how to setup an addon with Noir.

Links

Noir GitHub Repo

Discord Community

What Is Noir?

Noir is a framework for Stormworks: Build and Rescue designed to hold your hand in some areas with addon development. Noir also introduces structured development through a clean architecture based on Services, Libraries and Classes (Noir adds class support!). It also reduces boilerplate as Noir comes with built-in services (eg: PlayerService), libraries and classes out of the box.

In Noir, your addon is divided into "services" - self-contained logic units that can interact with libraries, classes and other services alike. Libraries are purely for reusable logic that do not interact with the game but provide utilities instead (like math utilities, etc). Classes, on the other hand, purely define structured data and behaviour and is a big portion of the OOP nature of Noir.

Setting Up a Project With Noir

Noir comes with a tool to help you set up a project with Noir in just a minute. This section will show you how to install and use it.

Note that this tool has only been tested on Windows. MacOS and Linux are untested but should work.

1. Head over to here to download the compiled Project Manager tool.

   ⚠️ | If you don't trust the .exe and have Python installed, head to /tools/project_manager in the Noir repo to run from source instead.

2. Run the downloaded .exe in a terminal. You'll see the tool description along with prompts below it. Simply follow what the prompts ask to set up your project.

3. The first prompt asks for the project name. This is the name of your addon essentially. For example, you could put AI Gunners if your desired addon is based around AI gunners.

4. The second prompt asks for the desired path to your addon. This path can be anywhere. I recommend somewhere in your Documents folder (if on Windows). For example: C:/Users/JohnDoe/Documents/Addons/AIGunners.

5. The third prompt asks for the path to your Stormworks addons. On Windows, this is 1000% %appdata%/Stormworks/data/missions.

The tool's prompts

Good job! After all of that, you'll enter a new area of the tool that allows you to create the addon (create all necessary files), update the addon (update Noir and tools), open the addon in VSCode (or if not possible, file explorer), and exit the tool.

Simply type create to create the addon. This will automatically open the addon after creation is complete.

Project control choices

If Noir receives an update, simply repeat the previous steps and type update instead of create.

Using the Stormworks Lua VSCode Extension Instead

This assumes you have the Stormworks Lua VSCode Extension.

1. Download Noir.lua.

2. Move the downloaded file into your addon directory.

3. Add require("Noir") into your addon's main file.

4. Build your addon via the extension's build keybind or the build command in the command palette (CTRL + SHIFT + P)

Congratulations!

You've set up your addon with Noir. Head to the Tutorials section to figure out:

• How to start Noir

• Services

• Libraries

• ...etc