crucible

crucible

n. a vessel in which substances are melted down and fused at great heat. Also: the engine the rest of the family melted into.

The shared Ebitengine app/game engine behind the tool family — the GUI panels, world generation, title screens, and window plumbing that rubix, gambit, vivarium, galapagos, hegemony, pandemonium, and nemesis were each carrying copies of.

Install

go get github.com/danielriddell21/crucible@latest

Packages

One package per engine concern, flat at the module root. App-specific vocabularies (messages, events, cues, tiles, textures) stay in each app; packages that carry them are generic.

Only menu and camera import Ebiten; everything else is plain Go and runs headless.

Quick start

import (
    "github.com/danielriddell21/crucible/level"
    "github.com/danielriddell21/crucible/raycast"
)

// Generate a furnished level: rooms, corridors, heights, half walls,
// doors, vents, themes, sky — retried until the exit is reachable.
l, rooms, err := level.Generate(level.GenerateConfig{Width: 64, Height: 48, Seed: seed},
    []level.Pass{
        func(l *level.Level, rng *worldgen.RNG, rooms []geom.Rect) {
            level.AssignHeights(l, rng, rooms, level.HeightsConfig{})
            level.PlaceDoors(l, rng, level.DoorConfig{})
            level.CarveVents(l, rooms, level.VentConfig{})
        },
    }, nil)

// Cast a ray for every screen column; WalkColumn handles variable
// heights and half walls, painting through your renderer.
cam := raycast.NewCamera(playerPos, playerAngle, fov)
for x := range screenW {
    res := raycast.WalkColumn(cam, screenW, screenH, x, eyeZ, l, myPainter)
    zbuf[x] = res.Depth
}

See each package's godoc for the full surface, and docs/provenance.md for exactly which files in which repos each package replaces.

The family, migrated

All seven apps — rubix, gambit, vivarium, galapagos, hegemony, pandemonium, and nemesis — now build on crucible. docs/provenance.md maps every package to the files it replaced, and records what was deliberately left app-side and why. ordinex needs no migration — crucible consumes it as a dependency (the hub sorts window ids with it) — and retrievium stays app-side, its sorted-slice search a linear scan's-worth of value away from being worth a dependency.

Why a library, not a framework

Each game keeps its own internal/gui, ebiten.Game, renderer, and simulation — crucible supplies the shared machinery behind that seam, not a scene graph. The family's CONVENTIONS.md still governs the shape of each app; crucible is the code those conventions kept describing.