Go to file
HiddenCirno 4144fccbd1 Complete issues #667 (Possible issue with flea buying) (!382)
Now when a profile create a new offer and another profile buy it, it can work correctly(For example profile A create a offer and profile B buy this offer, now A will receive money from profile B)
and set RagfairOfferHelper.completeOffer to public because TradeHelper now use it to resolve trade between 2 profiles on ragfair

Reviewed-on: https://dev.sp-tarkov.com/SPT/Server/pulls/382
Co-authored-by: HiddenCirno <2301697863@qq.com>
Co-committed-by: HiddenCirno <2301697863@qq.com>
(cherry picked from commit f555c24709)
2024-07-21 16:17:29 +01:00
.gitea/workflows Gitea workflows rebrand (!346) 2024-05-21 21:30:27 +00:00
project Complete issues #667 (Possible issue with flea buying) (!382) 2024-07-21 16:17:29 +01:00
.drone.yml Remove unused config files + swapped rome for biome (!163) 2023-10-31 16:03:45 +00:00
.gitattributes Merge branch '3.8.2-DEV' into 3.9.0-DEV 2024-05-08 00:21:12 -04:00
.gitignore Update gitignore rebranding (!347) 2024-05-21 21:03:21 +00:00
FEATURES.md Fixed broken link 2024-05-22 11:01:12 +01:00
LICENSE.md Update LICENSE.md (!349) 2024-05-21 23:07:55 +00:00
README.md Revert "Updated server node version to 20.14.0 from 20.11.1" 2024-06-03 17:34:22 +01:00
set_gitcredential.sh Add Repo 2023-03-03 15:23:46 +00:00

Single Player Tarkov - Server Project

This is the Server project for the Single Player Tarkov mod for Escape From Tarkov. It can be run locally to replicate responses to the modified Escape From Tarkov client.

Table of Contents

Features

For a full list of features, please see FEATURES.md.

Installation

Requirements

This project has been built in Visual Studio Code (VSC) using Node.js. We recommend using NVM to manage installation and switching Node versions. If you do not wish to use NVM, you will need to install the version of Node.js listed within the .nvmrc file manually.

There are a number of VSC extensions that we recommended for this project. VSC will prompt you to install these when you open the workspace file. If you do not see the prompt, you can install them manually:

Initial Setup

To prepare the project for development you will need to:

  1. Run git clone https://dev.sp-tarkov.com/SPT/Server.git server to clone the repository.
  2. Run git lfs pull to download LFS files locally.
  3. Open the project/mod.code-workspace file in Visual Studio Code (VSC).
  4. Run nvm use 20.11.1 in the VSC terminal.
  5. Run npm install in the VSC terminal.

Development

Commands

The following commands are available after the initial setup. Run them with npm run <command>.

Command Description
check:circular Check for circular dependencies in the project.
lint Check the project for coding standards and post-Prettier formatting issues.
lint:fix Automatically fix coding standard issues and post-Prettier formatting issues.
style Check the project for coding standards and post-Prettier formatting issues.
style:fix Automatically fix coding standard issues and post-Prettier formatting issues.
format Run Prettier and then ESLint Stylistic to fix code formatting.
test Run all tests.
test:watch Run tests in watch mode. Tests will re-run when files are changed.
test:coverage Run tests and generate a coverage report.
test:ui Run tests in UI mode. This will open a browser window to view tests.
build:release Build the project for release.
build:debug Build the project for debugging.
build:bleeding Build the project on the bleeding edge.
build:bleedingmods Build the project on the bleeding edge with mods.
run:build Run the project in build mode.
run:debug Run the project in debug mode.
run:profiler Run the project in profiler mode.
gen:types Generate types for the project.
gen:docs Generate documentation for the project.

Debugging

To debug the project in Visual Studio Code, you can select the Run tab and then select the Start Debugging option (or the F5 shortcut). This will start the server in debug mode, attaching a debugger to code execution, allowing you to set breakpoints and step through the code as it runs.

Mod Debugging

To debug a server mod in Visual Studio Code, you can copy the mod files into the user/mods folder and then start the server in debug mode. You should now be able to set breakpoints in the mod's Typescript files and they will be hit when the server runs the mod files.

Contributing

We're really excited that you're interested in contributing! Before submitting your contribution, please consider the following:

Branchs

  • master
    The default branch used for the latest stable release. This branch is protected and typically is only merges with release branches.
  • 3.9.0-DEV
    Development for the next minor release of SPT. Minor releases target the latest version of EFT. Late in the minor release cycle the EFT version is frozen for stability to prepare for release. Larger changes to the project structure may be included in minor releases.
  • 3.8.4-DEV
    Development for the next hotfix release of SPT. Hotfix releases include bug fixes and minor features that do not effect the coding structure of the project. Special care is taken to not break server mod stability. These always target the same version of EFT as the last minor release.

Pull Request Guidelines

  • Keep Them Small
    If you're fixing a bug, try to keep the changes to the bug fix only. If you're adding a feature, try to keep the changes to the feature only. This will make it easier to review and merge your changes.
  • Perform a Self-Review
    Before submitting your changes, review your own code. This will help you catch any mistakes you may have made.
  • Remove Noise
    Remove any unnecessary changes to white space, code style formatting, or some text change that has no impact related to the intention of the PR.
  • Create a Meaningful Title
    When creating a PR, make sure the title is meaningful and describes the changes you've made.
  • Write Detailed Commit Messages
    Bring out your table manners, speak the Queen's English and be on your best behaviour.

Style Guide

We use a combination of Prettier and ESLint Stylistic to enforce a consistent code style. Please run npm run format before submitting your changes. This is made easier by using the recommended VSC extensions to automatically format your code whenever you save a file.

Tests

We have a number of tests that are run automatically when you submit a pull request. You can run these tests locally by running npm run test. If you're adding a new feature or fixing a bug, please conceder adding tests to cover your changes so that we can ensure they don't break in the future.

License

This project is licensed under the NCSA Open Source License. See the LICENSE file for details.