@slot-engine/core 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -61,6 +61,12 @@ interface GameConfigOptions<TGameModes extends AnyGameModes = AnyGameModes, TSym
      * Some required hooks must be implemented for certain features to work.
      */
     hooks: GameHooks<TGameModes, TSymbols, TUserState>;
+    /**
+     * If, for some reason, you run your game WITHOUT `cd`ing into the game root,\
+     * you can specify the root directory here to ensure assets are resolved correctly.\
+     * Normally, this is not needed.
+     */
+    rootDir?: string;
 }
 type GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> = Required<Omit<GameConfigOptions<TGameModes, TSymbols, TUserState>, "symbols">> & {
     /**
@@ -68,6 +74,7 @@ type GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends
      */
     symbols: Map<keyof TSymbols & string, TSymbols[keyof TSymbols]>;
     outputDir: string;
+    rootDir: string;
     /**
      * A mapping of spin types to the number of scatter symbols required to trigger anticipation.
      */
@@ -1113,6 +1120,7 @@ declare class SlotGame<TGameModes extends AnyGameModes = AnyGameModes, TSymbols
             freespins: number;
         };
         outputDir: string;
+        rootDir: string;
         id: string;
         name: string;
         gameModes: TGameModes;
@@ -1232,8 +1240,7 @@ type WinCombination = {
         posIndex: number;
     }>;
 };
-type PostProcessFn<TWinCombs extends WinCombination[]> = (winType: WinType, ctx: GameContext) => {
-    payout: number;
+type PostProcessFn<TWinCombs extends WinCombination[]> = (wins: TWinCombs, ctx: GameContext) => {
     winCombinations: TWinCombs;
 };
 type WildSymbol = GameSymbol | Record<string, any>;
@@ -1305,8 +1312,6 @@ declare class ManywaysWinType extends WinType {
         payout: number;
         winCombinations: ManywaysWinCombination[];
     };
-    private _checked;
-    private _checkedWilds;
     constructor(opts: ManywaysWinTypeOpts);
     private validateConfig;
     /**
@@ -1315,8 +1320,6 @@ declare class ManywaysWinType extends WinType {
      */
     evaluateWins(board: Reels): this;
     private getWayLength;
-    private isChecked;
-    private isCheckedWild;
 }
 interface ManywaysWinTypeOpts extends WinTypeOpts {
 }

package/dist/index.d.ts

@@ -61,6 +61,12 @@ interface GameConfigOptions<TGameModes extends AnyGameModes = AnyGameModes, TSym
      * Some required hooks must be implemented for certain features to work.
      */
     hooks: GameHooks<TGameModes, TSymbols, TUserState>;
+    /**
+     * If, for some reason, you run your game WITHOUT `cd`ing into the game root,\
+     * you can specify the root directory here to ensure assets are resolved correctly.\
+     * Normally, this is not needed.
+     */
+    rootDir?: string;
 }
 type GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> = Required<Omit<GameConfigOptions<TGameModes, TSymbols, TUserState>, "symbols">> & {
     /**
@@ -68,6 +74,7 @@ type GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends
      */
     symbols: Map<keyof TSymbols & string, TSymbols[keyof TSymbols]>;
     outputDir: string;
+    rootDir: string;
     /**
      * A mapping of spin types to the number of scatter symbols required to trigger anticipation.
      */
@@ -1113,6 +1120,7 @@ declare class SlotGame<TGameModes extends AnyGameModes = AnyGameModes, TSymbols
             freespins: number;
         };
         outputDir: string;
+        rootDir: string;
         id: string;
         name: string;
         gameModes: TGameModes;
@@ -1232,8 +1240,7 @@ type WinCombination = {
         posIndex: number;
     }>;
 };
-type PostProcessFn<TWinCombs extends WinCombination[]> = (winType: WinType, ctx: GameContext) => {
-    payout: number;
+type PostProcessFn<TWinCombs extends WinCombination[]> = (wins: TWinCombs, ctx: GameContext) => {
     winCombinations: TWinCombs;
 };
 type WildSymbol = GameSymbol | Record<string, any>;
@@ -1305,8 +1312,6 @@ declare class ManywaysWinType extends WinType {
         payout: number;
         winCombinations: ManywaysWinCombination[];
     };
-    private _checked;
-    private _checkedWilds;
     constructor(opts: ManywaysWinTypeOpts);
     private validateConfig;
     /**
@@ -1315,8 +1320,6 @@ declare class ManywaysWinType extends WinType {
      */
     evaluateWins(board: Reels): this;
     private getWayLength;
-    private isChecked;
-    private isCheckedWild;
 }
 interface ManywaysWinTypeOpts extends WinTypeOpts {
 }

package/dist/index.js

@@ -76,7 +76,8 @@ function createGameConfig(opts) {
       [SPIN_TYPE.BASE_GAME]: getAnticipationTrigger(SPIN_TYPE.BASE_GAME),
       [SPIN_TYPE.FREE_SPINS]: getAnticipationTrigger(SPIN_TYPE.FREE_SPINS)
     },
-    outputDir: "__build__"
+    outputDir: "__build__",
+    rootDir: opts.rootDir || process.cwd()
   };
 }
 
@@ -1200,6 +1201,7 @@ var Book = class _Book {
   freespinsWins = 0;
   constructor(opts) {
     this.id = opts.id;
+    this.criteria = opts.criteria;
   }
   /**
    * Intended for internal use only.
@@ -1521,10 +1523,14 @@ Simulating game mode: ${mode}`);
         const simNumsToCriteria = ResultSet.assignCriteriaToSimulations(this, mode);
         await this.spawnWorkersForGameMode({ mode, simNumsToCriteria });
         createDirIfNotExists(
-          import_path.default.join(process.cwd(), this.gameConfig.outputDir, "optimization_files")
+          import_path.default.join(
+            this.gameConfig.rootDir,
+            this.gameConfig.outputDir,
+            "optimization_files"
+          )
         );
         createDirIfNotExists(
-          import_path.default.join(process.cwd(), this.gameConfig.outputDir, "publish_files")
+          import_path.default.join(this.gameConfig.rootDir, this.gameConfig.outputDir, "publish_files")
         );
         this.writeLookupTableCSV(mode);
         this.writeLookupTableSegmentedCSV(mode);
@@ -1577,7 +1583,7 @@ Simulating game mode: ${mode}`);
     await Promise.all(
       simRangesPerChunk.map(([simStart, simEnd], index) => {
         return this.callWorker({
-          basePath: this.gameConfig.outputDir,
+          basePath: import_path.default.join(this.gameConfig.rootDir, this.gameConfig.outputDir),
           mode,
           simStart,
           simEnd,
@@ -1600,7 +1606,7 @@ Simulating game mode: ${mode}`);
       }
     }
     return new Promise((resolve, reject) => {
-      const scriptPath = import_path.default.join(process.cwd(), basePath, TEMP_FILENAME);
+      const scriptPath = import_path.default.join(basePath, TEMP_FILENAME);
       const worker = new import_worker_threads.Worker(scriptPath, {
         workerData: {
           mode,
@@ -1650,10 +1656,10 @@ Simulating game mode: ${mode}`);
       ctx.state.currentGameMode,
       criteria
     );
+    ctx.state.currentResultSet = resultSet;
     while (!ctx.state.isCriteriaMet) {
       this.actualSims++;
       this.resetSimulation(ctx);
-      ctx.state.currentResultSet = resultSet;
       this.handleGameFlow(ctx);
       if (resultSet.meetsCriteria(ctx)) {
         ctx.state.isCriteriaMet = true;
@@ -1728,10 +1734,19 @@ Simulating game mode: ${mode}`);
     }
     rows.sort((a, b) => Number(a.split(",")[0]) - Number(b.split(",")[0]));
     let outputFileName = `lookUpTable_${gameMode}.csv`;
-    let outputFilePath = import_path.default.join(this.gameConfig.outputDir, outputFileName);
+    let outputFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      outputFileName
+    );
     writeFile(outputFilePath, rows.join("\n"));
     outputFileName = `lookUpTable_${gameMode}_0.csv`;
-    outputFilePath = import_path.default.join(this.gameConfig.outputDir, "publish_files", outputFileName);
+    outputFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      "publish_files",
+      outputFileName
+    );
     writeFile(outputFilePath, rows.join("\n"));
     return outputFilePath;
   }
@@ -1745,20 +1760,28 @@ Simulating game mode: ${mode}`);
     }
     rows.sort((a, b) => Number(a.split(",")[0]) - Number(b.split(",")[0]));
     const outputFileName = `lookUpTableSegmented_${gameMode}.csv`;
-    const outputFilePath = import_path.default.join(this.gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      outputFileName
+    );
     writeFile(outputFilePath, rows.join("\n"));
     return outputFilePath;
   }
   writeRecords(gameMode) {
     const outputFileName = `force_record_${gameMode}.json`;
-    const outputFilePath = import_path.default.join(this.gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      outputFileName
+    );
     writeFile(outputFilePath, JSON.stringify(this.recorder.records, null, 2));
     if (this.debug) this.logSymbolOccurrences();
     return outputFilePath;
   }
   writeIndexJson() {
     const outputFilePath = import_path.default.join(
-      process.cwd(),
+      this.gameConfig.rootDir,
       this.gameConfig.outputDir,
       "publish_files",
       "index.json"
@@ -1777,7 +1800,11 @@ Simulating game mode: ${mode}`);
   }
   async writeBooksJson(gameMode) {
     const outputFileName = `books_${gameMode}.jsonl`;
-    const outputFilePath = import_path.default.join(this.gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      outputFileName
+    );
     const books = Array.from(this.library.values()).map((b) => b.serialize()).map((b) => ({
       id: b.id,
       payoutMultiplier: b.payout,
@@ -1787,7 +1814,7 @@ Simulating game mode: ${mode}`);
     writeFile(outputFilePath, contents);
     const compressedFileName = `books_${gameMode}.jsonl.zst`;
     const compressedFilePath = import_path.default.join(
-      process.cwd(),
+      this.gameConfig.rootDir,
       this.gameConfig.outputDir,
       "publish_files",
       compressedFileName
@@ -1825,13 +1852,21 @@ Simulating game mode: ${mode}`);
    * Compiles user configured game to JS for use in different Node processes
    */
   preprocessFiles() {
-    const builtFilePath = import_path.default.join(this.gameConfig.outputDir, TEMP_FILENAME);
+    const builtFilePath = import_path.default.join(
+      this.gameConfig.rootDir,
+      this.gameConfig.outputDir,
+      TEMP_FILENAME
+    );
     import_fs2.default.rmSync(builtFilePath, { force: true });
     (0, import_esbuild.buildSync)({
-      entryPoints: [process.cwd()],
+      entryPoints: [this.gameConfig.rootDir],
       bundle: true,
       platform: "node",
-      outfile: import_path.default.join(this.gameConfig.outputDir, TEMP_FILENAME),
+      outfile: import_path.default.join(
+        this.gameConfig.rootDir,
+        this.gameConfig.outputDir,
+        TEMP_FILENAME
+      ),
       external: ["esbuild"]
     });
   }
@@ -1942,6 +1977,18 @@ function parseLookupTable(content) {
   }
   return lut;
 }
+function parseLookupTableSegmented(content) {
+  const lines = content.trim().split("\n");
+  const lut = [];
+  for (const line of lines) {
+    const [indexStr, criteria, weightStr, payoutStr] = line.split(",");
+    const index = parseInt(indexStr.trim());
+    const weight = parseInt(weightStr.trim());
+    const payout = parseFloat(payoutStr.trim());
+    lut.push([index, criteria, weight, payout]);
+  }
+  return lut;
+}
 function getTotalLutWeight(lut) {
   return lut.reduce((sum, [, weight]) => sum + weight, 0);
 }
@@ -2054,7 +2101,7 @@ var Analysis = class {
     console.log("Analysis complete. Files written to build directory.");
   }
   getPathsForModes(gameModes) {
-    const rootPath = process.cwd();
+    const rootPath = this.gameConfig.rootDir;
     const paths = {};
     for (const modeStr of gameModes) {
       const lut = import_path2.default.join(
@@ -2126,7 +2173,7 @@ var Analysis = class {
       });
     }
     writeJsonFile(
-      import_path2.default.join(process.cwd(), this.gameConfig.outputDir, "stats_summary.json"),
+      import_path2.default.join(this.gameConfig.rootDir, this.gameConfig.outputDir, "stats_summary.json"),
       stats
     );
   }
@@ -2155,35 +2202,76 @@ var Analysis = class {
     ];
     const payoutRanges = {};
     for (const modeStr of gameModes) {
-      payoutRanges[modeStr] = {};
+      payoutRanges[modeStr] = { overall: {}, criteria: {} };
       const lutOptimized = parseLookupTable(
         import_fs3.default.readFileSync(this.filePaths[modeStr].lutOptimized, "utf-8")
       );
+      const lutSegmented = parseLookupTableSegmented(
+        import_fs3.default.readFileSync(this.filePaths[modeStr].lutSegmented, "utf-8")
+      );
       lutOptimized.forEach(([, , p]) => {
         const payout = p / 100;
         for (const [min, max] of winRanges) {
           if (payout >= min && payout <= max) {
             const rangeKey = `${min}-${max}`;
-            if (!payoutRanges[modeStr][rangeKey]) {
-              payoutRanges[modeStr][rangeKey] = 0;
+            if (!payoutRanges[modeStr].overall[rangeKey]) {
+              payoutRanges[modeStr].overall[rangeKey] = 0;
+            }
+            payoutRanges[modeStr].overall[rangeKey] += 1;
+            break;
+          }
+        }
+      });
+      lutSegmented.forEach(([, criteria, bp, fsp]) => {
+        const basePayout = bp / 100;
+        const freeSpinPayout = fsp / 100;
+        const payout = basePayout + freeSpinPayout;
+        for (const [min, max] of winRanges) {
+          if (payout >= min && payout <= max) {
+            const rangeKey = `${min}-${max}`;
+            if (!payoutRanges[modeStr].overall[rangeKey]) {
+              payoutRanges[modeStr].overall[rangeKey] = 0;
+            }
+            payoutRanges[modeStr].overall[rangeKey] += 1;
+            if (!payoutRanges[modeStr].criteria[criteria]) {
+              payoutRanges[modeStr].criteria[criteria] = {};
             }
-            payoutRanges[modeStr][rangeKey] += 1;
+            if (!payoutRanges[modeStr].criteria[criteria][rangeKey]) {
+              payoutRanges[modeStr].criteria[criteria][rangeKey] = 0;
+            }
+            payoutRanges[modeStr].criteria[criteria][rangeKey] += 1;
             break;
           }
         }
       });
-      const orderedRanges = {};
-      Object.keys(payoutRanges[modeStr]).sort((a, b) => {
+      const orderedOverall = {};
+      Object.keys(payoutRanges[modeStr].overall).sort((a, b) => {
         const [aMin] = a.split("-").map(Number);
         const [bMin] = b.split("-").map(Number);
         return aMin - bMin;
       }).forEach((key) => {
-        orderedRanges[key] = payoutRanges[modeStr][key];
+        orderedOverall[key] = payoutRanges[modeStr].overall[key];
+      });
+      const orderedCriteria = {};
+      Object.keys(payoutRanges[modeStr].criteria).forEach((crit) => {
+        const critMap = payoutRanges[modeStr].criteria[crit];
+        const orderedCritMap = {};
+        Object.keys(critMap).sort((a, b) => {
+          const [aMin] = a.split("-").map(Number);
+          const [bMin] = b.split("-").map(Number);
+          return aMin - bMin;
+        }).forEach((key) => {
+          orderedCritMap[key] = critMap[key];
+        });
+        orderedCriteria[crit] = orderedCritMap;
       });
-      payoutRanges[modeStr] = orderedRanges;
+      payoutRanges[modeStr] = {
+        overall: orderedOverall,
+        criteria: {}
+      };
     }
     writeJsonFile(
-      import_path2.default.join(process.cwd(), this.gameConfig.outputDir, "stats_payouts.json"),
+      import_path2.default.join(this.gameConfig.rootDir, this.gameConfig.outputDir, "stats_payouts.json"),
       payoutRanges
     );
   }
@@ -2245,7 +2333,7 @@ function makeMathConfig(optimizer, opts = {}) {
     }))
   };
   if (writeToFile) {
-    const outPath = import_path3.default.join(process.cwd(), game.outputDir, "math_config.json");
+    const outPath = import_path3.default.join(game.rootDir, game.outputDir, "math_config.json");
     writeJsonFile(outPath, config);
   }
   return config;
@@ -2288,7 +2376,7 @@ function makeSetupFile(optimizer, gameMode) {
 `;
   content += `simulation_trials;${params.simulationTrials}
 `;
-  content += `user_game_build_path;${import_path4.default.join(process.cwd(), gameConfig.outputDir)}
+  content += `user_game_build_path;${import_path4.default.join(gameConfig.rootDir, gameConfig.outputDir)}
 `;
   content += `pmb_rtp;${params.pmbRtp}
 `;
@@ -2462,9 +2550,9 @@ var Optimizer = class {
   }
 };
 async function rustProgram(...args) {
+  console.log("Starting Rust optimizer. This may take a while...");
   return new Promise((resolve, reject) => {
-    const task = (0, import_child_process.spawn)("cargo", ["run", "--release", ...args], {
-      shell: true,
+    const task = (0, import_child_process.spawn)("cargo", ["run", "-q", "--release", ...args], {
       cwd: import_path5.default.join(__dirname, "./optimizer-rust"),
       stdio: "pipe"
     });
@@ -2635,9 +2723,9 @@ var WinType = class {
    * Custom post-processing of wins, e.g. for handling multipliers.
    */
   postProcess(func) {
-    const result = func(this, this.ctx);
-    this.payout = result.payout;
+    const result = func(this.winCombinations, this.ctx);
     this.winCombinations = result.winCombinations;
+    this.payout = result.winCombinations.reduce((sum, w) => sum + w.payout, 0);
     return this;
   }
   /**
@@ -2930,8 +3018,6 @@ var ClusterWinType = class extends WinType {
 
 // src/win-types/ManywaysWinType.ts
 var ManywaysWinType = class extends WinType {
-  _checked = [];
-  _checkedWilds = [];
   constructor(opts) {
     super(opts);
   }
@@ -3029,12 +3115,6 @@ var ManywaysWinType = class extends WinType {
   getWayLength(symbolList) {
     return Math.max(...Object.keys(symbolList).map((k) => parseInt(k, 10))) + 1;
   }
-  isChecked(ridx, sidx) {
-    return !!this._checked.find((c) => c.reel === ridx && c.row === sidx);
-  }
-  isCheckedWild(ridx, sidx) {
-    return !!this._checkedWilds.find((c) => c.reel === ridx && c.row === sidx);
-  }
 };
 
 // src/reel-set/GeneratedReelSet.ts
@@ -3238,6 +3318,7 @@ var GeneratedReelSet = class extends ReelSet {
       );
     }
     const filePath = import_path7.default.join(
+      config.rootDir,
       config.outputDir,
       `reels_${this.associatedGameModeName}-${this.id}.csv`
     );