Satisfactory Server API Client

This is an unofficial HTTP API wrapper for Satisfactory Dedicated Server API.

The project is in an early state and will not document changelogs until v1.0.0 release.
If you want a specific API Endpoint prioritized, please open an issue.

Official API Docs can be found at Steam/steamapps/common/Satisfactory/CommunityResources/DedicatedServerAPIDocs.md or at satisfactory.wiki.gg HTTPS API.

You can obtain an accessToken by executing server.GenerateAPIToken in your server console.

Usage

1import { createClient } from "satisfactory-server-api-client";
2
3// If your dedicated server uses a self-signed certificate (generated by default),
4// you can disable SSL verification by configuring the following environment variable.
5//process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
6
7const client = createClient({
8  accessToken: "<your-access-token>",
9});
10
11client.v1
12  .HealthCheck({
13    data: {
14      clientCustomData: "",
15    },
16  })
17  .then((response) => {
18    console.log("HealthCheck Response:", response);
19  });
20
21client.v1.VerifyAuthenticationToken().then(() => {
22  // response will be an empty string if valid
23});
24
25client.v1.QueryServerState().then((response) => {
26  console.log("QueryServerState Response:", response);
27});
28
29client.v1.GetServerOptions().then((response) => {
30  console.log("GetServerOptions Response:", response);
31});
32
33client.v1.GetAdvancedGameSettings().then((response) => {
34  console.log("GetAdvancedGameSettings Response:", response);
35});
36
37client.v1
38  .PasswordlessLogin({
39    data: {
40      minimumPrivilegeLevel: PrivilegeLevel.NotAuthenticated,
41    },
42  })
43  .then((response) => {
44    console.log("PasswordlessLogin Response:", response);
45  });
46
47client.v1
48  .PasswordLogin({
49    data: {
50      minimumPrivilegeLevel: PrivilegeLevel.NotAuthenticated,
51      password: "your-password",
52    },
53  })
54  .then((response) => {
55    console.log("PasswordLogin Response:", response);
56  });
57
58client.v1
59  .ApplyAdvancedGameSettings({
60    data: {
61      appliedAdvancedGameSettings: {
62        "FG.GameRules.NoPower": "False",
63      },
64    },
65  })
66  .then(() => {
67    // response will be an empty string if valid
68  });
69
70client.v1
71  .ClaimServer({
72    data: {
73      serverName: "your-server",
74      adminPassword: "your-password",
75    },
76  })
77  .then((response) => {
78    console.log("ClaimServer Response:", response);
79  });
80
81client.v1
82  .RenameServer({
83    data: {
84      serverName: "Shinigami-PC localhost",
85    },
86  })
87  .then(() => {
88    // response will be an empty string if valid
89  });
90
91client.v1.EnumerateSessions().then((response) => {
92  console.log("EnumerateSessions Response:", response);
93});