Skip to content

Commit

Permalink
readme
Browse files Browse the repository at this point in the history
  • Loading branch information
ezra-sg committed Jun 30, 2023
1 parent bee9d0a commit f950181
Showing 1 changed file with 7 additions and 62 deletions.
69 changes: 7 additions & 62 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,64 +1,9 @@
## Updating
If you have installed an older version of this mod, you must delete it before installing this version.

This project was created to automate most parts of building and setting up an environment.
## Installation
Drop into `{SPT directory}/user/mods`

## **NodeJS:**

The first step would be to install nodejs on your pc, the version you NEED is **16.17.1**

That version is the one that has been used to test the mod templates and build scripts.

It can be downloaded from here: https://nodejs.org/dist/v16.17.1/node-v16.17.1-x64.msi

A system reboot may be needed after install.

## **IDE:**

The second step is having an IDE ready. We've setup a VSCodium workspace file to help with this.

You CAN use Visual Studio Code if you so desire, just keep in mind that our dev tests on the mod files was done using VSCodium.

You can get VSCodium here: https://vscodium.com/#install

## **Workspace:**

Once you have NodeJS and VSCodium ready, open the mod.code-workspace file with VSCodium (File->Open Workspace from File...).

Once the project loads into VSCodium you will be recommended to install the ESLint plugin. This is HIGHLY recommended.

## **Environment Setup:**

There is a task that will automatically setup your environment to use typescript.

To run it, you just need to go to:

> Terminal->Run Task...->Show All Tasks...->npm: install
After running this task, your environment will be ready to start coding.

DO NOT remove the node_modules folder, this is an auto generated directory that has the required dependencies to be able to use typescript and more.

## **IMPORTANT:**

Before starting to work on your mod, we suggest you read about Dependency Injection and Inversion of Control as this is the adopted architecture SPT-AKI has adopted.

It will be difficult to understand some of the problems you may be having if you dont understand the basics of it.

A guide explaining all the essentials will be available on the hub on release for you to read about.

## **Coding:**

All your work should be centered around the mod.ts file as an entry point.
You can ONLY change the following properties from the package.json file: `"name"`, `"version"`, `"license"`: `"MIT"`, `"author"`, `"akiVersion"`.

If you have never used typescript before, you can read about it here: https://www.typescriptlang.org/docs/

## **Distributing your mod:**

The project has been set up with an automatic task that will copy and zip ALL required files for your mod to work on SPT-AKI.
To run this task you just need to go to:

> Terminal->Run Task...->Show All Tasks...->npm: build:zip
The output will be a mod.zip file that will appear on the root of the project.

Always verify that all files were included into the zip file.
## Usage
Go into `{ SPT directory }/user/mods/plebeianrat-TimeInRaidTracker-1.0.1/` to view time tracker files. The files will be named like `{profile nickname}-time-tracker.txt`.
Note: if you change your profile nickname, a new file will be generated with the new nickname, and time will not be carried over unless you manually copy the contents of the old file into the new one / add them together.

0 comments on commit f950181

Please sign in to comment.