API: Added external api which returns gainExperience

markdown/bitburner.gangmemberexpgain.agiexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [agiEXP](./bitburner.gangmemberexpgain.agiexp.md)
+
+## GangMemberExpGain.agiEXP property
+
+Agi EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+agiEXP: number;
+```

markdown/bitburner.gangmemberexpgain.chaexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [chaEXP](./bitburner.gangmemberexpgain.chaexp.md)
+
+## GangMemberExpGain.chaEXP property
+
+Cha EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+chaEXP: number;
+```

markdown/bitburner.gangmemberexpgain.defexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [defEXP](./bitburner.gangmemberexpgain.defexp.md)
+
+## GangMemberExpGain.defEXP property
+
+Def EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+defEXP: number;
+```

markdown/bitburner.gangmemberexpgain.dexexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [dexEXP](./bitburner.gangmemberexpgain.dexexp.md)
+
+## GangMemberExpGain.dexEXP property
+
+Dex EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+dexEXP: number;
+```

markdown/bitburner.gangmemberexpgain.hackexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [hackEXP](./bitburner.gangmemberexpgain.hackexp.md)
+
+## GangMemberExpGain.hackEXP property
+
+Hack EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+hackEXP: number;
+```

markdown/bitburner.gangmemberexpgain.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md)
+
+## GangMemberExpGain interface
+
+
+**Signature:**
+
+```typescript
+interface GangMemberExpGain 
+```
+
+## Properties
+
+|  Property | Modifiers | Type | Description |
+|  --- | --- | --- | --- |
+|  [agiEXP](./bitburner.gangmemberexpgain.agiexp.md) |  | number | Agi EXP gain for a member after a given task |
+|  [chaEXP](./bitburner.gangmemberexpgain.chaexp.md) |  | number | Cha EXP gain for a member after a given task |
+|  [defEXP](./bitburner.gangmemberexpgain.defexp.md) |  | number | Def EXP gain for a member after a given task |
+|  [dexEXP](./bitburner.gangmemberexpgain.dexexp.md) |  | number | Dex EXP gain for a member after a given task |
+|  [hackEXP](./bitburner.gangmemberexpgain.hackexp.md) |  | number | Hack EXP gain for a member after a given task |
+|  [strEXP](./bitburner.gangmemberexpgain.strexp.md) |  | number | Str EXP gain for a member after a given task |
+

markdown/bitburner.gangmemberexpgain.strexp.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberExpGain](./bitburner.gangmemberexpgain.md) &gt; [strEXP](./bitburner.gangmemberexpgain.strexp.md)
+
+## GangMemberExpGain.strEXP property
+
+Str EXP gain for a member after a given task
+
+**Signature:**
+
+```typescript
+strEXP: number;
+```

markdown/bitburner.gangmemberinfo.expgain.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [GangMemberInfo](./bitburner.gangmemberinfo.md) &gt; [expGain](./bitburner.gangmemberinfo.expgain.md)
+
+## GangMemberInfo.expGain property
+
+Per Cycle Exp object for each stat for this gang member returned as a object containing each stats value returns null in the even that the member does not have a given task.
+
+**Signature:**
+
+```typescript
+expGain: GangMemberExpGain | null;
+```

markdown/bitburner.gangmemberinfo.md

@@ -37,6 +37,7 @@ interface GangMemberInfo
 |  [dex\_mult](./bitburner.gangmemberinfo.dex_mult.md) |  | number | Dexterity multiplier from equipment |
 |  [dex](./bitburner.gangmemberinfo.dex.md) |  | number | Dexterity skill level |
 |  [earnedRespect](./bitburner.gangmemberinfo.earnedrespect.md) |  | number | Amount of Respect earned by member since they last Ascended |
+|  [expGain](./bitburner.gangmemberinfo.expgain.md) |  | [GangMemberExpGain](./bitburner.gangmemberexpgain.md) \| null | Per Cycle Exp object for each stat for this gang member returned as a object containing each stats value returns null in the even that the member does not have a given task. |
 |  [hack\_asc\_mult](./bitburner.gangmemberinfo.hack_asc_mult.md) |  | number | Hack multiplier from ascensions |
 |  [hack\_asc\_points](./bitburner.gangmemberinfo.hack_asc_points.md) |  | number | Total Hack Ascension points accumulated |
 |  [hack\_exp](./bitburner.gangmemberinfo.hack_exp.md) |  | number | Current hack experience |

markdown/bitburner.md

@@ -79,6 +79,7 @@
 |  [GangFormulas](./bitburner.gangformulas.md) | Gang formulas |
 |  [GangGenInfo](./bitburner.ganggeninfo.md) | Gang general info. |
 |  [GangMemberAscension](./bitburner.gangmemberascension.md) |  |
+|  [GangMemberExpGain](./bitburner.gangmemberexpgain.md) |  |
 |  [GangMemberInfo](./bitburner.gangmemberinfo.md) |  |
 |  [GangMemberInstall](./bitburner.gangmemberinstall.md) |  |
 |  [GangOtherInfoObject](./bitburner.gangotherinfoobject.md) |  |

src/Gang/GangMember.ts

@@ -14,6 +14,7 @@ import {
   calculateAscensionMult,
   calculateAscensionPointsGain,
 } from "./formulas/formulas";
+import { GangMemberExpGain } from "@nsdefs";
 
 interface IMults {
   hack: number;
@@ -147,43 +148,80 @@ export class GangMember {
     };
   }
 
-  gainExperience(numCycles = 1): void {
+  // Calculate our gain for each stat based on each modifier of member
+  // if no task is assigned to that member we return null, other wise we
+  // return an object containing our per-cycle gains for each stat.
+  calculateExpGain(numCycles = 1): GangMemberExpGain | null {
     const task = this.getTask();
-    if (task === GangMemberTasks.Unassigned) return;
+    if (task === GangMemberTasks.Unassigned) return null;
+
+    const expValues = {
+      hackEXP: 0,
+      strEXP: 0,
+      defEXP: 0,
+      dexEXP: 0,
+      agiEXP: 0,
+      chaEXP: 0,
+    };
+
     const difficultyMult = Math.pow(task.difficulty, 0.9);
     const difficultyPerCycles = difficultyMult * numCycles;
     const weightDivisor = 1500;
     const expMult = this.expMult();
-    this.hack_exp +=
+
+    expValues.hackEXP +=
       (task.hackWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.hack *
       this.calculateAscensionMult(this.hack_asc_points);
-    this.str_exp +=
+
+    expValues.strEXP +=
       (task.strWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.str *
       this.calculateAscensionMult(this.str_asc_points);
-    this.def_exp +=
+
+    expValues.defEXP +=
       (task.defWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.def *
       this.calculateAscensionMult(this.def_asc_points);
-    this.dex_exp +=
+
+    expValues.dexEXP +=
       (task.dexWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.dex *
       this.calculateAscensionMult(this.dex_asc_points);
-    this.agi_exp +=
+
+    expValues.agiEXP +=
       (task.agiWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.agi *
       this.calculateAscensionMult(this.agi_asc_points);
-    this.cha_exp +=
+
+    expValues.chaEXP +=
       (task.chaWeight / weightDivisor) *
       difficultyPerCycles *
       expMult.cha *
       this.calculateAscensionMult(this.cha_asc_points);
+
+    return expValues;
+  }
+
+  gainExperience(): void {
+    // Do the calculations if our function returns null meaning no task is assigned
+    // then we return otherwise we add our exp gains to our total values
+    const gains = this.calculateExpGain();
+    if (gains === null) {
+      return;
+    }
+
+    this.hack_exp += gains.hackEXP;
+    this.str_exp += gains.strEXP;
+    this.def_exp += gains.defEXP;
+    this.dex_exp += gains.dexEXP;
+    this.agi_exp += gains.agiEXP;
+    this.cha_exp += gains.chaEXP;
   }
 
   earnRespect(numCycles = 1, gang: Gang): number {

src/NetscriptFunctions/Gang.ts

@@ -156,6 +156,7 @@ export function NetscriptGang(): InternalAPI<IGang> {
         respectGain: member.calculateRespectGain(gang),
         wantedLevelGain: member.calculateWantedLevelGain(gang),
         moneyGain: member.calculateMoneyGain(gang),
+        expGain: member.calculateExpGain(),
       };
     },
     canRecruitMember: (ctx) => () => {

src/ScriptEditor/NetscriptDefinitions.d.ts

@@ -1,5 +1,4 @@
 /** All netscript definitions */
-
 /** @public */
 interface HP {
   current: number;
@@ -918,6 +917,21 @@ interface GangTerritory {
   /** Wanted gain impact on task scaling */
   wanted: number;
 }
+/** @public */
+interface GangMemberExpGain {
+  /** Hack EXP gain for a member after a given task*/
+  hackEXP: number;
+  /** Str EXP gain for a member after a given task*/
+  strEXP: number;
+  /** Def EXP gain for a member after a given task*/
+  defEXP: number;
+  /** Dex EXP gain for a member after a given task*/
+  dexEXP: number;
+  /** Agi EXP gain for a member after a given task*/
+  agiEXP: number;
+  /** Cha EXP gain for a member after a given task*/
+  chaEXP: number;
+}
 
 /** @public */
 interface GangMemberInfo {
@@ -1004,6 +1018,10 @@ interface GangMemberInfo {
   wantedLevelGain: number;
   /** Per Cycle Income for this gang member */
   moneyGain: number;
+  /** Per Cycle Exp object for each stat for this gang member returned as a object containing each stats value
+   * returns null in the even that the member does not have a given task.
+   */
+  expGain: GangMemberExpGain | null;
 }
 
 /** @public */