Jesse.Markowitz/station-master
1
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

Implement Enhancements, Mainline modifiers and Maneuvers; fix unplayable track

Browse Source
This commit is contained in:
Jesse
2026-07-31 11:02:54 -04:00
parent 401b879140
commit b085d5a0bb
20 changed files with 1853 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/engine/content.ts
+128 -17
View File
@@ -145,13 +145,23 @@ export type IndustryProfile = {
copies: number;
};
/**
* Industry density (Gap 12). The recovered sheet lists 9 industries in a 115-card deck; the
* prototype ran 10 in 52. At 9-in-115 a game saw 1.6 Freight Facilities, freight was 10% of gross
* revenue, and `carsCoupled` fired 4 times per 100 games — the freight loop, which is the point of
* the game, effectively never ran.
*
* Each industry's `copies` is TRIPLED, giving 27 in 133. That restores roughly the prototype's
* ratio while preserving the sheet's proportions exactly: the outbound/inbound balance and the
* lockout structure are unchanged, because every kind scales by the same factor.
*/
export const INDUSTRY_PROFILES: readonly IndustryProfile[] = [
{ kind: 'freightHouse', name: 'Freight House', carTypes: ['boxcar'], flow: 'both', baseOut: 1, baseIn: 1, baseLoaders: 1, lockouts: ['grocersWarehouse'], copies: 2 },
{ kind: 'mineTipple', name: 'Mine Tipple', carTypes: ['hopper'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['powerPlant'], copies: 2 },
{ kind: 'refinery', name: 'Refinery', carTypes: ['tank'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['powerPlant'], copies: 1 },
{ kind: 'powerPlant', name: 'Power Plant', carTypes: ['hopper', 'tank'], flow: 'inbound', baseOut: 0, baseIn: 1, baseLoaders: 1, lockouts: ['mineTipple', 'refinery'], copies: 2 },
{ kind: 'packingSheds', name: 'Packing Sheds', carTypes: ['reefer'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['grocersWarehouse'], copies: 1 },
{ kind: 'grocersWarehouse', name: "Grocer's Warehouse", carTypes: ['boxcar', 'reefer'], flow: 'inbound', baseOut: 0, baseIn: 1, baseLoaders: 1, lockouts: ['packingSheds', 'freightHouse'], copies: 1 },
{ kind: 'freightHouse', name: 'Freight House', carTypes: ['boxcar'], flow: 'both', baseOut: 1, baseIn: 1, baseLoaders: 1, lockouts: ['grocersWarehouse'], copies: 6 },
{ kind: 'mineTipple', name: 'Mine Tipple', carTypes: ['hopper'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['powerPlant'], copies: 6 },
{ kind: 'refinery', name: 'Refinery', carTypes: ['tank'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['powerPlant'], copies: 3 },
{ kind: 'powerPlant', name: 'Power Plant', carTypes: ['hopper', 'tank'], flow: 'inbound', baseOut: 0, baseIn: 1, baseLoaders: 1, lockouts: ['mineTipple', 'refinery'], copies: 6 },
{ kind: 'packingSheds', name: 'Packing Sheds', carTypes: ['reefer'], flow: 'outbound', baseOut: 1, baseIn: 0, baseLoaders: 1, lockouts: ['grocersWarehouse'], copies: 3 },
{ kind: 'grocersWarehouse', name: "Grocer's Warehouse", carTypes: ['boxcar', 'reefer'], flow: 'inbound', baseOut: 0, baseIn: 1, baseLoaders: 1, lockouts: ['packingSheds', 'freightHouse'], copies: 3 },
];
/** Legacy alias; the engine still reads FREIGHT_PROFILES in places. */
@@ -381,6 +391,8 @@ export function crossingStages(
kind: MainlineKind,
trainSpeed: TrainSpeed,
carriesPassengers: boolean,
modifiers: readonly string[] = [],
direction: Direction = 'east',
): number {
const profile = MAINLINE_PROFILES.find((m) => m.kind === kind);
if (!profile) throw new Error(`unknown mainline card: ${kind}`);
@@ -394,14 +406,66 @@ export function crossingStages(
mph = carriesPassengers ? profile.speed.passenger : profile.speed.freight;
break;
case 'grade':
// Heavy Grade has no printed number; the modifier cards (Brakeman/Airbrakes/Helpers) are what
// improve it. Treated as a 30 until those are implemented.
// Heavy Grade has no printed number; the modifier cards are what improve it, so it is a 30
// until one is placed.
mph = 30;
break;
}
const base = mph >= 60 ? 1 : 2;
return base + (trainSpeed === 'slow' ? 1 : 0);
const stages = base + (trainSpeed === 'slow' ? 1 : 0);
return Math.max(1, stages - gradeReduction(profile, modifiers, direction));
}
/**
* ASSUMPTION, flagged (§10 Q11): the recovered sheet says Brakeman and Airbrakes give "faster
* passage downhill" and Helpers "faster passage uphill", but never says which way a Heavy Grade
* climbs. Modelled as **climbing eastward** — an eastbound train is going uphill, a westbound one
* downhill. Needs confirming; if grades instead carry their own direction, this becomes a property
* of the Mainline node rather than a constant.
*
* Each applicable card takes a Stage off, never below one: a train cannot cross in no time.
* Airbrakes only counts when Brakeman is already there, which the placement rule enforces.
*/
function gradeReduction(
profile: MainlineProfile,
modifiers: readonly string[],
direction: Direction,
): number {
if (profile.speed.kind !== 'grade') return 0;
const downhill = direction === 'west';
let n = 0;
if (downhill) {
if (modifiers.includes('brakeman')) n++;
if (modifiers.includes('airbrakes')) n++;
} else if (modifiers.includes('helpers')) {
n++;
}
return n;
}
export function mainlineProfile(kind: MainlineKind): MainlineProfile {
const p = MAINLINE_PROFILES.find((m) => m.kind === kind);
if (!p) throw new Error(`unknown mainline card: ${kind}`);
return p;
}
/** Which Mainline modifiers may sit on `kind`, and what each additionally requires. */
export const MAINLINE_MODIFIER_RULES: readonly {
key: string;
/** Only placeable on a card whose speed is a grade. */
gradeOnly: boolean;
/** Another modifier that must already be on the same card. */
requiresOnCard?: string;
}[] = [
{ key: 'brakeman', gradeOnly: true },
{ key: 'airbrakes', gradeOnly: true, requiresOnCard: 'brakeman' },
{ key: 'helpers', gradeOnly: true },
{ key: 'realignment', gradeOnly: false },
];
export function mainlineModifierRule(key: string) {
return MAINLINE_MODIFIER_RULES.find((r) => r.key === key) ?? null;
}
/** `Realignment` converts one Mainline card into another. */
@@ -431,6 +495,45 @@ export const SPACE_USE_CARDS: readonly SimpleCard[] = [
{ key: 'engineerCemetery', name: 'Engineer cemetery', copies: 1, placement: 'adjacent to any straight, curve, turnout, Limit', effect: 'Burns tablespace.' },
];
export type EnhancementKey =
| 'interlocking' | 'facingPointLocks' | 'yardOffice' | 'smallYard'
| 'waterColumn' | 'overpass' | 'telegraph' | 'telephone' | 'radio' | 'absSignals';
/** Where an Enhancement may be laid. */
export type EnhancementPlacement =
| 'runningTrackStraight'
| 'secondaryTrackStraight'
| 'mainlineCard'
| 'onCard';
export type EnhancementRule = {
key: EnhancementKey;
placement: EnhancementPlacement;
/** Must sit on a card already carrying this enhancement (Telephone on Telegraph, etc.). */
requiresOnSameCard?: EnhancementKey;
/** Must exist somewhere in the district (Facing Point Locks needs Interlocking). */
requiresInDistrict?: EnhancementKey;
/** Bonus added to an opposing train's number when resolving a meet, once a Day. */
dispatchBonus?: number;
};
export const ENHANCEMENT_RULES: readonly EnhancementRule[] = [
{ key: 'interlocking', placement: 'runningTrackStraight' },
{ key: 'facingPointLocks', placement: 'onCard', requiresInDistrict: 'interlocking' },
{ key: 'yardOffice', placement: 'secondaryTrackStraight' },
{ key: 'smallYard', placement: 'secondaryTrackStraight' },
{ key: 'waterColumn', placement: 'runningTrackStraight' },
{ key: 'overpass', placement: 'onCard' },
{ key: 'telegraph', placement: 'runningTrackStraight', dispatchBonus: 4 },
{ key: 'telephone', placement: 'onCard', requiresOnSameCard: 'telegraph', dispatchBonus: 8 },
{ key: 'radio', placement: 'onCard', requiresOnSameCard: 'telephone', dispatchBonus: 12 },
{ key: 'absSignals', placement: 'mainlineCard' },
];
export function enhancementRule(key: string): EnhancementRule | null {
return ENHANCEMENT_RULES.find((r) => r.key === key) ?? null;
}
export const ENHANCEMENT_CARDS: readonly SimpleCard[] = [
{ key: 'interlocking', name: 'Interlocking', copies: 2, placement: 'any Running Track Straight', effect: 'May stop an inbound train on the Limit Track.' },
{ key: 'facingPointLocks', name: 'Facing Point Locks', copies: 2, placement: 'adjacent to Interlocking', effect: 'Must have Interlocking. Prevents Derail being played on you.' },
@@ -484,13 +587,21 @@ export const ACTION_CARDS: readonly SimpleCard[] = [
export type StockSupply = { type: CarType; loaded: number; empty: number };
/** NOT in the recovered files — still the provisional figure. */
/**
* NOT in the recovered files — still the provisional figure.
*
* Scaled up alongside the Gap 12 industry increase. Worst-case demand (every copy of every
* industry in play at full capacity) is boxcar 15, hopper 12, tank 9, reefer 6; the supply must
* cover that, since a Division Yard that runs dry starves the freight loop the increase exists to
* feed. Lockouts and district size mean the worst case cannot actually occur, so this carries
* deliberate headroom.
*/
export const ROLLING_STOCK_SUPPLY: readonly StockSupply[] = [
{ type: 'coach', loaded: 8, empty: 8 },
{ type: 'boxcar', loaded: 6, empty: 6 },
{ type: 'hopper', loaded: 6, empty: 6 },
{ type: 'reefer', loaded: 4, empty: 4 },
{ type: 'tank', loaded: 4, empty: 4 },
{ type: 'boxcar', loaded: 10, empty: 10 },
{ type: 'hopper', loaded: 8, empty: 8 },
{ type: 'reefer', loaded: 5, empty: 5 },
{ type: 'tank', loaded: 6, empty: 6 },
{ type: 'caboose', loaded: 6, empty: 0 },
];
@@ -537,7 +648,7 @@ export function lengthProfile(length: GameLength): LengthProfile {
}
// ---------------------------------------------------------------------------
// Deck composition — 115 cards
// Deck composition — 133 cards
// ---------------------------------------------------------------------------
/**
@@ -565,9 +676,9 @@ export function deckComposition(): { category: string; count: number }[] {
];
}
export const DECK_SIZE = deckComposition().reduce((n, c) => n + c.count, 0); // 115
export const DECK_SIZE = deckComposition().reduce((n, c) => n + c.count, 0); // 133
/** The solitaire deck drops the 22 opponent-directed cards, leaving 93. */
/** The solitaire deck drops the 22 opponent-directed cards, leaving 111. */
export const SOLITAIRE_DECK_SIZE = deckComposition()
.filter((c) => !isOpponentOnly(c.category))
.reduce((n, c) => n + c.count, 0);