v0 source pure

1const (
2	StatusMove = 'M' // played a foot action or dropped this turn (13.61)
3	StatusRun  = 'R' // played a Run this turn (13.62)
4	StatusDown = 'D' // is DOWN (13.63)
5	StatusHead = 'H' // head counter shot at (13.64, not played)
6)

1const (
2	GunJams     = "jams"     // all shells crossed off; cannot fire until reloaded
3	GunExplodes = "explodes" // cannot fire for the rest of the game
4)

1const (
2	HandGun    = 0
3	HandOther  = 1
4	HandBoth   = 2
5	HandGround = 3
6)

1const (
2	// MaxPlanEntries bounds the number of actions in a plan; five 1-point
3	// actions already fill the budget.
4	MaxPlanEntries = MaxActionPoints
5	// MaxPlanLen bounds the plan string length.
6	MaxPlanLen = 128
7)

 1const (
 2	OptCock    = "cock"
 3	OptUncock  = "uncock"
 4	OptAim     = "aim"
 5	OptShoot   = "shoot"
 6	OptNothing = "nothing"
 7	// OptThrow is what a Throw does instead of nothing (17.1), naming its
 8	// target like a shot ("6b:throw:@1"; a bare "6b" does nothing).
 9	OptThrow = "throw"
10)

1const (
2	OptDamage = "damage"
3	OptWield  = "wield"
4)

1const (
2	StrengthWield  = 4
3	StrengthDamage = 2
4)

 1const (
 2	EvMove         = "move"          // From, To, Facing, Down, Action (Reason "stagger" when thrown by a hit)
 3	EvTurn         = "turn"          // Facing, Action (Reason "stagger" when thrown by a hit)
 4	EvFlip         = "flip"          // Down, Action (empty for a DROP penalty)
 5	EvDelay        = "delay"         // N gained, Reason, Card drawn (0 for crawl), Result penalty, Endurance crossed off, Delay = running total once this card is counted
 6	EvCancel       = "cancel"        // Action, Reason (To = the obstacle in the way for no_los)
 7	EvDraw         = "draw"          // Gun moved from From (holster, a hand, or "ground" with N = its ground id) to To (a hand) and cocked, unless jammed (Result "jammed")
 8	EvLoad         = "load"          // a shell loaded in the gun in both hands, N shells now, uncocked; Result "unjammed" when that completes a jammed gun
 9	EvCock         = "cock"          // Gun cocked
10	EvUncock       = "uncock"        // Gun uncocked
11	EvAim          = "aim"           // N = AIM points after aiming, To = the hex they sit on, Target = the seat they follow (-1 for a hex)
12	EvLoseAim      = "lose_aim"      // Reason (To = the obstacle in the way for no_los)
13	EvNothing      = "nothing"       // a Shoot used to do nothing, or a shot held at a hex nobody stands in (Reason empty_hex, To = the hex) or at a target out of sight (Reason no_los, To = its hex, Target = its seat) or out of the fight (Reason out_of_fight, To = its hex, Target = its seat): keeps the aim
14	EvShot         = "shot"          // Card, Target = the seat shot at (whoever stood in the hex named, for a shot at a hex), To = the hex shot at, Hit (final location or Miss), Range, N = aim time, Reason "" | out_of_zone | misfire
15	EvThrow        = "throw"         // like a shot: Card, Target, To = the hex thrown at, Hit, Range, N = aim time, Chart, Status, Gun, GunID, Reason "" | out_of_zone; the weapon then lands (EvDropGun, Reason throw)
16	EvMalfunction  = "malfunction"   // Card, Result (no_effect, misfire, jams, explodes, no_penalty), Gun, GunID
17	EvWildShot     = "wild_shot"     // Gun went off without hitting anything: uncocked, one shell less
18	EvWound        = "wound"         // Player hit: Result = penalty kind (Kill, Stun...), N
19	EvDirection    = "direction"     // Card drawn as a direction card: To = its HEX line
20	EvDropGun      = "drop_gun"      // Gun fell from From (hand) to the hex To, N = its ground id; Reason throw for a thrown weapon landing, gun_move for one let go (10.22)
21	EvMoveGun      = "move_gun"      // a gun move (10.22): Gun moved from From (both hands) to To (a hand), as it was
22	EvPassOut      = "pass_out"      // end of turn: more delay than endurance two turns in a row
23	EvSeriousCheck = "serious_check" // end of showdown: Card, N = DELAY + SERIOUS points (4 kills)
24	EvVP           = "vp"            // end of turn: victory points (rule 15), N = points (< 0 for a loss), Reason = the award (VPSurvive...)
25	EvRunAway      = "run_away"      // the character moved off the map (15.5): From = the edge hex it left, Facing = the way it went, Action
26)

 1const (
 2	ReasonCrawl      = "crawl"        // moving while down (rule 9.2)
 3	ReasonSprint     = "sprint"       // sprinting draws a delay card (rule 9.23)
 4	ReasonLeap       = "leap"         // leap/drop draws two delay cards (rule 9.4)
 5	ReasonOccupied   = "occupied"     // ending a move in an occupied hex (rule 9.24)
 6	ReasonFence      = "fence"        // moving or staggering across a fence (rule 35.2)
 7	ReasonObstacle   = "obstacle"     // moving or staggering onto or off an obstacle (rule 36.4)
 8	ReasonDrop       = "drop"         // a DROP penalty draws three delay cards (rule 14.11)
 9	ReasonStun       = "stun"         // a STUN draws wound cards (14.11)
10	ReasonLight      = "light"        // a LIGHT draws fatigue cards (14.11)
11	ReasonSerious    = "serious"      // fatigue cards at the start of the turn (14.12)
12	ReasonLeg        = "leg"          // fatigue cards per hex moved upright (14.12)
13	ReasonTime       = "time"         // not executed by the end of segment 5 (rule 7.53)
14	ReasonNoGun      = "no_gun"       // no gun in the box the action needs (11.3); a gun move of a gun the character no longer has
15	ReasonNotInHand  = "not_in_hand"  // a gun move dropping a gun that is not in a hand box (10.22)
16	ReasonNotBoth    = "not_both"     // a gun move to a hand of a gun that is not in both hands (10.22)
17	ReasonGunDropped = "gun_dropped"  // a gun move dropped the gun the character aims with: its AIM points go
18	ReasonHandFull   = "hand_full"    // the destination hand already holds a gun
19	ReasonNoRoom     = "no_room"      // the character already carries MaxGuns weapons
20	ReasonNotCocked  = "not_cocked"   // shooting an uncocked gun (13.1)
21	ReasonEmpty      = "empty"        // shooting a gun without shells (13.1)
22	ReasonJammed     = "jammed"       // shooting or cocking a jammed gun not completely reloaded yet (13.31)
23	ReasonFull       = "full"         // loading a gun already holding its Ammo limit (10.42)
24	ReasonBroken     = "broken"       // using or loading an exploded gun (13.31)
25	ReasonNoTarget   = "no_target"    // the character named is out of the fight (12.6), or is the shooter, or no such seat
26	ReasonOutOfZone  = "out_of_zone"  // the target is in the blind zone (8.32, 12.41)
27	ReasonNoLOS      = "no_los"       // no line of sight to the target, an obstacle in the way by the heights (31): an aim is cancelled, a shot is held, AIM points are lost
28	ReasonReveal     = "reveal"       // revealing an action other than Turn or a gun action (12.44)
29	ReasonTransfer   = "transfer"     // a new target more than one hex from the markers (12.5)
30	ReasonOwnHex     = "own_hex"      // a new target moving the markers into or out of the character's own hex (12.5)
31	ReasonNoHex      = "no_hex"       // aiming at a hex that is not on the board
32	ReasonShot       = "shot"         // aim spent by a shot (12.43)
33	ReasonStagger    = "stagger"      // thrown by a STAGGER penalty
34	ReasonMisfire    = "misfire"      // the shot was cancelled by a MALFUNCTION
35	ReasonEmptyHex   = "empty_hex"    // a shot at a hex nobody stood in: held (EvNothing)
36	ReasonOutOfFight = "out_of_fight" // a shot at a character killed, passed out, surrendered or run away: held (EvNothing)
37	ReasonOutOfRange = "out_of_range" // a throw farther than the weapon's wielding factor (17.2)
38	ReasonThrow      = "throw"        // aim spent by a throw (16.13); a thrown weapon landing (17.4)
39	ReasonGunMove    = "gun_move"     // a gun move dropping the gun in the hex (10.22)
40)

1const (
2	MalfNoEffect  = "no_effect"  // discarded, another card drawn (13.3)
3	MalfMisfire   = "misfire"    // the shot is cancelled (13.3)
4	MalfNoPenalty = "no_penalty" // second draw was a FIRE: the gun is fine (13.32)
5)

1const (
2	StepShots  = 1
3	StepEnd    = 2
4	StepAction = 3 // + the seat acting
5)

 1const (
 2	// MaxActionPoints is the time points a plan may spend in a turn (rule 7.3).
 3	MaxActionPoints = 5
 4	// Segments is the number of segments in a turn (rule 4.1).
 5	Segments = 5
 6	// EndOfTurn is the Seg of events recorded after segment 5 (cancelled
 7	// actions, passing out, the end-of-showdown check); turn-start events
 8	// (SERIOUS fatigue, aim lost on the first reveal) have Seg 0.
 9	EndOfTurn = Segments + 1
10	// MinPlayers and MaxPlayers bound the seats of a game: the showdown's
11	// characters (Setups) fill the seats in order, each a side of its own.
12	MinPlayers = 2
13	MaxPlayers = 4
14)

 1const (
 2	VPSurvive   = "survive"         // +2: conscious and unsurrendered at the end (15.62)
 3	VPHoldField = "hold_field"      // +2: the only side with survivors (15.63)
 4	VPSurrender = "surrender"       // -2 (15.41)
 5	VPCaptured  = "captured"        // -4: passed out or surrendered when the enemy holds the field (15.63, 15.7)
 6	VPKilled    = "killed"          // -8 (15.2)
 7	VPKill      = "kill_enemy"      // +2: the enemy who killed him (15.2)
 8	VPKnockOut  = "knock_out_enemy" // +1: the enemy who crossed off most of his endurance boxes (15.3, 15.41)
 9	VPRunAway   = "run_away"        // -2: moved off the map (15.5); no end-of-showdown points (15.6)
10)

1const ActionGunMove cards.Code = "gun_move"

1const DeckSize = 108

1const DrawJammed = "jammed"

1const LoadUnjammed = "unjammed"

1const MaxAim = 8

1const MaxGuns = 3

1const NoSeat = -1

1const StartEndurance = 20

1const VPSharedKill = 1

1const (
2	Holstered GunLocation = iota
3	GunHand
4	OtherHand
5	BothHands
6)

1const (
2	// NoGun marks an empty gun slot.
3	NoGun GunType = ""
4	// Colt45 is the one-handed six-shooter every character starts with.
5	Colt45 GunType = "colt45"
6)

 1const (
 2	Miss     HitLoc = "-"
 3	Bullseye HitLoc = "BE" // the shooter picks the location (13.7)
 4	LegHit   HitLoc = "LEG"
 5	GunHit   HitLoc = "GUN"  // the gun arm
 6	ArmHit   HitLoc = "ARM"  // the other arm
 7	SideHit  HitLoc = "SIDE" // a flesh wound
 8	BodyHit  HitLoc = "BODY"
 9	CritHit  HitLoc = "CRIT"
10	VitalHit HitLoc = "VITAL"
11	HeadHit  HitLoc = "HEAD"
12)

 1const (
 2	Kill          PenaltyKind = "kill"       // killed, out of the game
 3	Stun          PenaltyKind = "stun"       // draws N wound cards and loses aim
 4	Stagger       PenaltyKind = "stagger"    // thrown to a hex and facing drawn on two direction cards, then drops
 5	Serious       PenaltyKind = "serious"    // N fatigue cards at the start of every turn; may kill at the end
 6	DropGunHand   PenaltyKind = "gun_hand"   // the weapon in the gun hand drops in the hex
 7	GunArm        PenaltyKind = "gun_arm"    // -N aim time with the gun hand
 8	DropOtherHand PenaltyKind = "other_hand" // the weapon in the other hand drops in the hex
 9	OtherArm      PenaltyKind = "other_arm"  // -N aim time with the other hand
10	LegWound      PenaltyKind = "leg"        // N fatigue cards per hex moved while upright
11	Light         PenaltyKind = "light"      // draws N fatigue cards
12	LoseAimHit    PenaltyKind = "lose_aim"   // loses the aim (STRIKING TABLE)
13)

 1const (
 2	// LoseAim: the character loses its aim (no aim is tracked yet).
 3	LoseAim Result = -1
 4	// WildShot: every cocked gun goes off without hitting anything, is
 5	// uncocked and loses a shell; the aim is lost.
 6	WildShot Result = -2
 7	// Drop: an upright character turns DOWN, draws 3 delay cards and loses
 8	// its aim; no effect when already DOWN.
 9	Drop Result = -3
10)

 1const (
 2	// Alive characters plan and act.
 3	Alive Status = iota
 4	// Out characters (surrendered, or out of time) are skipped by Resolve.
 5	Out
 6	// Killed characters are out of the game (14.6).
 7	Killed
 8	// PassedOut characters carried more delay than endurance for two turns (14.2).
 9	PassedOut
10	// RanAway characters moved off the map (15.5): out of the showdown,
11	// their hex the edge hex they left from.
12	RanAway
13)

1var Cards = buildCards()

 1var CharKeys = []string{
 2	"andy", "axe", "banker", "barkeep", "border_rider", "cattle_baron",
 3	"chief", "clerk", "driver", "dude", "eagle", "el_jefe", "fast_draw",
 4	"fast_eddie", "floozy", "foreman", "gambler", "guard", "gun_artist",
 5	"happy", "hawk", "ike", "innocente", "john_henry", "lady", "lightning",
 6	"ling_ho", "little_ernie", "lucky", "marshal", "mountain_man", "nco",
 7	"old_man", "owner", "prospector", "quiet_man", "reb", "running_boy",
 8	"slim", "smith", "sodbuster", "texas", "the_drifter", "the_kid",
 9	"u_s_scout", "veteran", "woman", "yankee",
10}

1var Setups = []CharSetup{
2	{Char: "marshal", Hexes: []string{"A-D5", "A-D6", "A-D7", "A-E6", "A-E7"}, Facing: hex.SE},
3	{Char: "the_kid", Hexes: []string{"A-H5", "A-H6", "A-H7", "A-G6", "A-G7"}, Facing: hex.NW},
4	{Char: "reb", Hexes: []string{"A-E8", "A-F7", "A-F8", "A-G8"}, Facing: hex.N},
5	{Char: "yankee", Hexes: []string{"A-E5", "A-F5", "A-F4", "A-G5"}, Facing: hex.S},
6}

 1var VPPoints = map[string]int{
 2	VPSurvive:   2,
 3	VPHoldField: 2,
 4	VPSurrender: -2,
 5	VPCaptured:  -4,
 6	VPKilled:    -8,
 7	VPKill:      2,
 8	VPKnockOut:  1,
 9	VPRunAway:   -2,
10}

1func AliveCount(s State) int

1func CanSetUp(charKey, id string) bool

1func DecodeInts(s string) []int

1func EncodeCharacter(c Character) string

1func EncodeChars(cs []Character) string

1func EncodeEvents(evs []Event) string

1func EncodeGround(ground []GroundGun) string

1func EncodeInts(ns []int) string

1func EndShowdown(s State, d Drawer) (State, []Event)

1func EndTurn(s State) (State, []Event)

1func IsCharKey(s string) bool

1func Resolve(board *hex.Board, st State, plans []Plan, d Drawer) (State, []Event)

1func SeatChar(seat int) string

1func Seed(parts ...string) [32]byte

1func ShowdownChars() []string

1func VPTotals(awards []Award, n int) []int

1func EndVictoryPoints(s State) []Award

1func TurnVictoryPoints(before, after State) []Award

1func SetupOf(charKey string) *CharSetup

1func CloneChars(cs []Character) []Character

1func DecodeCharacter(s string) Character

1func DecodeChars(s string) []Character

1func NewDeck(seed [32]byte) *Deck

1func DecodeEvents(s string) []Event

1func VPEvents(awards []Award) []Event

1func DecodeGround(s string) []GroundGun

1func HandLocation(code int) (GunLocation, bool)

1func StrikingBullseye(line byte) HitLoc

1func Impact(line byte, loc HitLoc) []Penalty

1func Strengthen(pens []Penalty, n int) []Penalty

1func Striking(line byte, loc HitLoc) []Penalty

1func ParsePlan(s string) (Plan, error)

1func Card(n int) ResultCard

1func NewState(n int) State

 1type Action struct {
 2	Card   int
 3	Side   byte // cards.FrontSide or cards.BackSide
 4	Code   cards.Code
 5	Cost   int
 6	Dir    hex.Rel // committed relative direction, "" when the side takes none
 7	Gun    int     // id of the character's gun for a gun choice (Draw & Cock), 0 when none
 8	Ground int     // id of the gun on the ground to pick up (Draw & Cock, "g<id>"), 0 when none
 9	Hand   int     // destination hand code for a gun choice (HandGun...), -1 when the side takes none
10	Opt    string  // option of Cock/Aim/Shoot, Shoot and Throw (OptCock...) or Strength (OptDamage, OptWield), "" when the side takes none
11	Hex    string  // the hex named by an aim, a shot or a throw at a hex
12	Target int     // the seat named by an aim, a shot or a throw at a character; -1 otherwise
13	// Wield and Damage are what the STRENGTHs played on top of a Throw add
14	// to the weapon's wielding factor and to the penalties (20.2), set by
15	// Combine.
16	Wield  int
17	Damage int
18	// Moves are the gun moves done when the action is revealed (10.22),
19	// written before it in the plan string.
20	Moves []GunMove
21}

1type Award struct {
2	Player int
3	Reason string // one of the VP* names
4	Points int
5}

1type Band struct{ Lo, Hi int }

1type CharSetup struct {
2	Char   string
3	Hexes  []string
4	Facing hex.Dir
5}

 1type Character struct {
 2	Hex    string
 3	Facing hex.Dir
 4	Down   bool
 5	Delay  int // delay points on the sheet (rule 6)
 6	Status Status
 7	// PlayedFoot and PlayedRun record whether the current turn's plan holds
 8	// a foot action / a Run, whether or not it executes ([H12], rules 13.61-62).
 9	PlayedFoot bool
10	PlayedRun  bool
11	// RanLastTurn is PlayedRun carried over from the previous turn: Sprint
12	// needs a Run on the previous turn as well (rule 9.23, "build up speed").
13	RanLastTurn bool
14	// Dropped records a DROP penalty this turn ("Move" target status, 13.61).
15	Dropped bool
16	// Guns carried (section 10).
17	Guns Guns
18	// Aim is the AIM points on the target (12.2). AimAt is the seat of the
19	// character the markers follow, wherever it goes (12.3), NoSeat when
20	// they sit on the hex AimHex. Both are meaningless while Aim is 0.
21	Aim    int
22	AimAt  int
23	AimHex string
24	// Endurance is the boxes left on the sheet (14.2); wound and fatigue
25	// cards cross them off.
26	Endurance int
27	// Exhausted counts the consecutive turn ends with more delay than
28	// endurance; two in a row pass the character out (14.2).
29	Exhausted int
30	// Permanent wounds (14.12): fatigue cards per turn, aim time penalties
31	// per hand, fatigue cards per hex moved upright.
32	Serious  int
33	GunArm   int
34	OtherArm int
35	Leg      int
36	// Who did it, for the victory points (15.2, 15.21, 15.3), by seat: the
37	// seats credited with the kill (several when their KILLs landed in the
38	// same segment, or tied for the most SERIOUS points), the SERIOUS and
39	// LEG points each seat's wounds gave (the fatigue those wounds cost
40	// later is put down to it), and the endurance boxes each seat's hits
41	// crossed off.
42	Killers     [MaxPlayers]bool
43	SeriousFrom [MaxPlayers]int
44	LegFrom     [MaxPlayers]int
45	Hurt        [MaxPlayers]int
46}

1type Chart struct {
2	Cols []Band
3	Rows []ChartRow
4}

1type ChartRow struct {
2	Aim   Band
3	Cells []HitLoc
4}

1type Deck struct {
2	r     *rand.Rand
3	order [DeckSize]int // card numbers in deal order
4	next  int
5	drawn []int // every card dealt so far, in order
6}

1type Drawer interface {
2	// Draw returns the next result card.
3	Draw() ResultCard
4}

 1type Event struct {
 2	Seg       int
 3	Player    int
 4	Kind      string
 5	Action    cards.Code
 6	From      string
 7	To        string
 8	Facing    hex.Dir
 9	Down      bool
10	N         int
11	Delay     int
12	Reason    string
13	Card      int     // the result card drawn (0 when none)
14	Result    string  // a card's penalty, a malfunction result or a wound's penalty kind
15	Endurance int     // endurance boxes crossed off by a wound or fatigue card
16	Target    int     // the seat shot at, for shots
17	Hit       string  // the final hit location of a shot (Miss "-")
18	Range     int     // the range of a shot, in hexes
19	Gun       GunType // the gun's model, for gun events
20	GunID     int     // the gun's id, for gun events
21	Step      int     // which part of the segment it belongs to (StepShots, StepEnd, StepAction+seat), 0 outside the segments
22	Chart     string  // a shot's preliminary hit read on the FIRE card's chart, before Target Status ("" when no chart was read)
23	Status    string  // the Target Status letters (StatusMove...) that changed a shot's hit, "" when none did
24}

1type Fixed int

1type GroundGun struct {
2	ID  int
3	Hex string
4	Gun Gun
5}

1type Gun struct {
2	ID       int
3	Type     GunType
4	Location GunLocation
5	Cocked   bool
6	Shells   int
7	Jammed   bool // every shell crossed off; fires again once completely reloaded (13.31)
8	Exploded bool // cannot fire for the rest of the game (13.31)
9}

1type GunLocation int

1type GunMove struct {
2	Gun int // id of the gun on the character's sheet
3	To  int // HandGun, HandOther or HandGround
4}

1type GunSpec struct {
2	Name      string
3	Capacity  int
4	OneHanded bool
5	Impact    byte // its line of the IMPACT TABLE (see Impact)
6	Wielding  int  // its wielding factor: how far it can be thrown (16.21, 17.2)
7	Striking  byte // its line of the STRIKING TABLE (see Striking)
8}

1type GunType string

1type Guns [MaxGuns]Gun

1type HitLoc string

1type Malfunction struct {
2	Storebought bool // misfire with storebought shells
3	Handloaded  bool // misfire with handloaded shells (the Colt 45's)
4	CapAndBall  bool // misfire with cap-and-ball shells
5	Second      string
6}

1type Penalty struct {
2	Kind PenaltyKind
3	N    int
4}

1type PenaltyKind string