mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2026-05-02 05:47:14 +02:00
Michael Ficocelli
c8d2c9f769
This is a big change with a *lot* of moving parts. The largest part of it is enabling scripts to `playAsWhite` as a parameter to many Go functions. In the implementation, this involved a significant rewrite of `opponentNextTurn` promise handling. A number of other changes and bugfixes are included: * Fixes the issue where handicap stones are added on game load. * Better typing for error callbacks. * Throw errors instead of deadlocking on bad cheat usage. * Return always-resolved gameOver promise after game end * Added a new `resetStats` api function. --------- Co-authored-by: David Walker <d0sboots@gmail.com>
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
|
|
[Home](./index.md) > [bitburner](./bitburner.md) > [Go](./bitburner.go.md) > [passTurn](./bitburner.go.passturn.md)
|
|
|
|
## Go.passTurn() method
|
|
|
|
Pass the player's turn rather than making a move, and await the opponent's response. This ends the game if the opponent passed on the previous turn, or if the opponent passes on their following turn.
|
|
|
|
This can also be used if you pick up the game in a state where the opponent needs to play next. For example: if BitBurner was closed while waiting for the opponent to make a move, you may need to call passTurn() to get them to play their move on game start.
|
|
|
|
passAsWhite is optional, and attempts to pass while playing as the white player. Only can be used when playing against "No AI".
|
|
|
|
**Signature:**
|
|
|
|
```typescript
|
|
passTurn(passAsWhite = false): Promise<{
|
|
type: "move" | "pass" | "gameOver";
|
|
x: number | null;
|
|
y: number | null;
|
|
}>;
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Description |
|
|
| --- | --- | --- |
|
|
| passAsWhite | (not declared) | _(Optional)_ |
|
|
|
|
**Returns:**
|
|
|
|
Promise<{ type: "move" \| "pass" \| "gameOver"; x: number \| null; y: number \| null; }>
|
|
|
|
a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
|
|
|
|
## Remarks
|
|
|
|
RAM cost: 0 GB
|
|
|