automatic

package

v0.12.4 Latest Latest Go to latest Published: Apr 3, 2026 License: GPL-3.0 Imports: 36 Imported by: 1

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/domino14/macondo

Links

Open Source Insights

Documentation ¶

Overview ¶

Package automatic contains all the logic for the actual gameplay of Crossword Game, which, as we said before, features all sorts of things like wingos and blonks.

Index ¶

Variables
func AnalyzeLogFile(filepath string) (string, error)
func ExportGCG(cfg *config.Config, filename, letterdist, lexicon, boardlayout, gid string, ...) error
func GenerateSeeds(n int) ([][32]byte, error)
func LoadSeeds(path string) ([][32]byte, error)
func SaveSeeds(seeds [][32]byte, path string) error
func StartCompVCompStaticGames(ctx context.Context, cfg *config.Config, numGames int, block bool, threads int, ...) error
type AutomaticRunnerPlayer
type DeterministicConfig
type GameRunner
- func NewGameRunner(logchan chan string, cfg *config.Config) *GameRunner
type Job
type ShadowAgreementResult
- func RunShadowAgreementTest(cfg *config.Config, numGames int) (*ShadowAgreementResult, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	CVCCounter *expvar.Int
	IsPlaying  *expvar.Int
)

View Source

var MaxTimePerEndgame = 15 * time.Second

View Source

var MaxTimePerTurn = 30 * time.Second

Functions ¶

func AnalyzeLogFile ¶ added in v0.4.2

func AnalyzeLogFile(filepath string) (string, error)

AnalyzeLogFile analyzes the given game CSV file and spits out a bunch of statistics.

func ExportGCG ¶ added in v0.4.10

func ExportGCG(cfg *config.Config, filename, letterdist, lexicon, boardlayout, gid string,
	out io.Writer) error

func GenerateSeeds ¶ added in v0.11.8

func GenerateSeeds(n int) ([][32]byte, error)

GenerateSeeds creates n random 32-byte seeds for deterministic game runs

func LoadSeeds ¶ added in v0.11.8

func LoadSeeds(path string) ([][32]byte, error)

LoadSeeds reads seeds from a file in base64 format

func SaveSeeds ¶ added in v0.11.8

func SaveSeeds(seeds [][32]byte, path string) error

SaveSeeds writes seeds to a file in base64 format (one per line)

func StartCompVCompStaticGames ¶

func StartCompVCompStaticGames(ctx context.Context, cfg *config.Config,
	numGames int, block bool, threads int,
	outputFilename, lexicon, letterDistribution string,
	players []AutomaticRunnerPlayer, detConfig *DeterministicConfig) error

Types ¶

type AutomaticRunnerPlayer ¶ added in v0.5.0

type AutomaticRunnerPlayer struct {
	LeaveFile            string
	PEGFile              string
	BotCode              pb.BotRequest_BotCode
	MinSimPlies          int
	StochasticStaticEval bool
}

type DeterministicConfig ¶ added in v0.11.8

type DeterministicConfig struct {
	Seeds    [][32]byte // Pre-generated seeds (nil = generate new)
	SeedFile string     // File to read/write seeds
	NumGames int        // Number of games (used when generating seeds)
}

DeterministicConfig holds configuration for deterministic autoplay runs

type GameRunner ¶

type GameRunner struct {
	// contains filtered or unexported fields
}

GameRunner is the master struct here for the automatic game logic.

func NewGameRunner ¶ added in v0.4.2

func NewGameRunner(logchan chan string, cfg *config.Config) *GameRunner

NewGameRunner just instantiates and initializes a game runner.

func (*GameRunner) CompVsCompStatic ¶

func (r *GameRunner) CompVsCompStatic(addToHistory bool) error

CompVsCompStatic plays out a game to the end using best static turns.

func (*GameRunner) Game ¶ added in v0.4.5

func (r *GameRunner) Game() *game.Game

func (*GameRunner) Init ¶

func (r *GameRunner) Init(players []AutomaticRunnerPlayer) error

Init initializes the runner

func (*GameRunner) PlayBestTurn ¶ added in v0.5.0

func (r *GameRunner) PlayBestTurn(playerIdx int, addToHistory bool) error

PlayBestTurn generates the best move for the player and plays it on the board.

func (*GameRunner) StartGame ¶

func (r *GameRunner) StartGame(gidx int)

func (*GameRunner) StartGameWithSeed ¶ added in v0.11.8

func (r *GameRunner) StartGameWithSeed(gidx int, seed [32]byte)

type Job ¶

type Job struct {
	// contains filtered or unexported fields
}

type ShadowAgreementResult ¶ added in v0.12.4

type ShadowAgreementResult struct {
	GamesPlayed   int
	TurnsPlayed   int
	Disagreements int
	Details       []string
}

ShadowAgreementResult holds the results of a shadow agreement test.

func RunShadowAgreementTest ¶ added in v0.12.4

func RunShadowAgreementTest(cfg *config.Config, numGames int) (*ShadowAgreementResult, error)

RunShadowAgreementTest plays numGames game pairs, comparing moves generated with and without shadow. Both algorithms must produce the same top move by score on every turn. Games use deterministic seeds for reproducibility.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL