v0.1.0 initial commit

parameter/game.go

@@ -0,0 +1,159 @@
+package parameter
+
+import (
+	"time"
+)
+
+// Core game grid and timing
+const (
+	// GameRenderUpdate is the frontend frame interval (~60fps). Beat
+	// quantization is owned by the engine; this only paces UI wakeups
+	GameRenderUpdate = 16 * time.Millisecond
+
+	// GameDeltaZBase is the level-1 inter-chord interval. GameDeltaZStep
+	// shortens it per level down to the GameDeltaZMin floor
+	GameDeltaZBase = 500 * time.Millisecond
+	GameDeltaZStep = 20 * time.Millisecond
+	GameDeltaZMin  = 300 * time.Millisecond
+
+	// PlayerRowResetChords chords at whatever tempo is running, so a pattern's
+	// landing chord is invariant across levels and across a Boost.
+	// 3 * GameDeltaZBase == the previous 1500ms; level 1 is unchanged.
+	// Lane (X) shifts are persistent and never auto-reset
+	PlayerRowResetChords = 3
+
+	// ItemFadeDuration is the burn-out span of a consumed positive item.
+	// Kept under GameDeltaZMin/BoostSpeedFactor so the effect always completes inside one
+	// chord and reads as consumption, not as the strip scrolling
+	ItemFadeDuration = 140 * time.Millisecond
+
+	// ItemFlashFraction is the leading white-flash portion of the burn-out
+	ItemFlashFraction = 0.25
+
+	// TransitionDuration is the level-clear interlude length
+	TransitionDuration = 2000 * time.Millisecond
+
+	// Song length ceiling
+	GamePlayIndexZMax = 256
+
+	// Chord dimensions
+	GamePlayIndexYMax = 3
+	GamePlayIndexXMax = 3
+
+	// Player spawn position (grid center)
+	GamePlayIndexYStart = GamePlayIndexYMax / 2
+	GamePlayIndexXStart = GamePlayIndexXMax / 2
+)
+
+// Song generation
+const (
+	// SongBaseLength + (level-1)*SongLengthPerLevel chords per level,
+	// capped at GamePlayIndexZMax
+	SongBaseLength     = 72
+	SongLengthPerLevel = 12
+
+	// Guaranteed empty chords at song edges (grace-in, clean finish)
+	GenIntroRest = 6
+	GenOutroRest = 4
+
+	// Rest gap between pattern chains: GenRestBase shrinks by one per level
+	// down to GenRestMin
+	GenRestBase = 7
+	GenRestMin  = 2
+
+	// Patterns chained back-to-back per burst
+	GenChainBase = 1
+	GenChainMax  = 5
+
+	// Chance of a single empty chord between chained patterns
+	GenBreatherProbability = 0.5
+)
+
+// Lookahead observation window. Window width covers every wall band; band
+// geometry and trap threshold are parameterized here
+const (
+	// PositionLookaheadWindow is how many upcoming chords (starting at the
+	// current one, distance 0) are scanned per grid position.
+	// Hard ceiling: game.TileLookaheadMaxWindow (wall bitmask width)
+	PositionLookaheadWindow = 10
+
+	// Wall proximity bands. Band 0 is the arrived wall (distance 0); bands
+	// 1..WallBandCount-1 each span WallBandSize chords. Band index selects
+	// border fill density and color
+	WallBandSize  = 3
+	WallBandCount = 4
+
+	// TrapGapMax is the largest reopen gap still flagged as a trap: a lane
+	// that clears for <= this many chords before another wall shuts it
+	TrapGapMax = 2
+
+	// ConsumeRingSize bounds the consumed-note ring the frontends read
+	// for burn-out. A magnet sweep can consume up to
+	// GamePlayIndexYMax*GamePlayIndexXMax*PositionLookaheadWindow notes; on
+	// overflow the oldest burn-out is dropped (visual-only degradation)
+	ConsumeRingSize = 64
+
+	// MorphWindow is the chord-distance over which a non-wall Value's color
+	// interpolates from distant to arrived
+	MorphWindow = 4
+)
+
+// Player effects granted by items. Both survive a level change and are cleared on restart
+const (
+	// BoostDuration is the wall-clock lifetime of a Boost. A second pickup
+	// refreshes the deadline, it does not extend it
+	BoostDuration = 10 * time.Second
+
+	// BoostSpeedFactor divides the inter-chord interval while a Boost runs.
+	// Integer divisor: the boosted interval stays exact. A slow effect would
+	// multiply in the same place
+	BoostSpeedFactor = 2
+
+	// BoostWarnRemaining is the Boost tail over which the HUD countdown blinks.
+	// Expiry inside a wall band kills on the next beat; the player
+	// needs the lead time to leave the lane
+	BoostWarnRemaining = 2 * time.Second
+
+	// ShieldCharges is the charge count a Shield pickup arms. Each charge
+	// absorbs one negative contact; charges never expire and do not stack
+	ShieldCharges = 1
+)
+
+// The burn-out must finish inside the tightest beat — the level floor divided by the Boost factor.
+// Also proves the boosted interval is > 0, which bounds the Update beat loop
+const _ = uint(GameDeltaZMin/BoostSpeedFactor - ItemFadeDuration)
+
+// Compile-time: the window must reach the far edge of the last band
+const _ = uint(PositionLookaheadWindow - (WallBandSize*(WallBandCount-1) + 1))
+
+// Tile geometry derives from the strip. PositionLookaheadWindow is
+// the only knob; width follows so the strip is 1:1 with the interior
+const (
+	RenderMarginX = 1
+	RenderMarginY = 1
+
+	// RenderHeaderRows is the chrome above the grid (LEVEL / ENERGY).
+	// No footer, no title
+	RenderHeaderRows = 1
+
+	// One interior column per lookahead chord, plus the two border columns
+	RenderNoteWidth  = PositionLookaheadWindow + 2
+	RenderNoteHeight = 5
+
+	RenderGapX = 2
+	RenderGapY = 1
+
+	// Fixed interior row offsets, relative to the tile top border
+	RenderRowTimer = 1
+	RenderRowDist  = 2
+	RenderRowStrip = 3
+
+	// Distance row: "gDD gDD" — glyph + chord-distance, positive group then negative group
+	RenderDistDigits = 2
+	RenderDistCols   = 2*(1+RenderDistDigits) + 1
+
+	// RenderBlinkPeriod is the half-cycle of the nearest-item blink. The
+	// distance-row group of the tile(s) holding the grid-wide nearest
+	// positive/negative occurrence alternates between two colors at this rate
+	RenderBlinkPeriod = 120 * time.Millisecond
+)