How jleclanche/fireplace works
Fireplace is a Python Hearthstone simulator. Its main workflow is to create a game with two players and decks, set up and advance turns, execute player/card actions, and update game entities and state. Card definitions supply the behaviors that actions execute; selectors and lazy evaluators support those behaviors. The README documents broad card-set coverage. The graph combines sampled runtime relationships with documented capabilities; card-set loading details and some internal dispatch paths were not fully sampled.
Main entry points: game.py Game lifecycle · actions.py Game actions · player.py Player state · card.py Cards and entities
Components 20
Game Runtime
- Game lifecycle
fireplace/game.py
Game Domain
- Player state
fireplace/player.py - Cards and entities
fireplace/card.py - Entity base
fireplace/entity.py - Deck
fireplace/deck.py - Game tags
fireplace/enums.py
Rules Engine
- Game actions
fireplace/actions.py - State managers
fireplace/managers.py - Aura effects
fireplace/aura.py - Targeting rules
fireplace/targeting.py - Play rules
fireplace/rules.py - Entity selectors
fireplace/dsl/selector.py - Lazy numbers
fireplace/dsl/lazynum.py - Evaluators
fireplace/dsl/evaluator.py - Random picker
fireplace/dsl/random_picker.py
Card Content
- Card database
fireplace/cards/__init__.py - Card helpers
fireplace/cards/utils.py - Card-set definitions
fireplace/cards - Brawl modes
fireplace/brawls/__init__.py
Other components
- Player
Connections 33
- Player → Game lifecycle: starts game
- Game lifecycle → Player state: sets up
fireplace/game.py - Game lifecycle → Game actions: queues actions
fireplace/game.py - Game lifecycle → Card database: loads cards
fireplace/game.py - Game lifecycle → State managers: tracks state
fireplace/game.py - Game lifecycle → Entity base: uses entities
fireplace/game.py - Player state → Game actions: executes
fireplace/player.py - Player state → Cards and entities: owns cards
fireplace/player.py - Player state → Deck: holds deck
fireplace/player.py - Player state → Game lifecycle: reads game state
fireplace/player.py - Player state → State managers: uses managers
fireplace/player.py - Cards and entities → Entity base: extends
fireplace/card.py - Cards and entities → Game actions: uses actions
fireplace/card.py - Cards and entities → Aura effects: uses aura effects
fireplace/card.py - Cards and entities → Targeting rules: checks targets
fireplace/card.py - Game actions → Entity base: acts on entities
fireplace/actions.py - Game actions → State managers: notifies observers
fireplace/actions.py - Game actions → Entity selectors: evaluates targets
fireplace/actions.py - Aura effects → State managers: registers observers
fireplace/aura.py - Lazy numbers → Evaluators: uses evaluators
fireplace/dsl/lazynum.py - Lazy numbers → Entity selectors: selects entities
fireplace/dsl/lazynum.py - Evaluators → Entity selectors: evaluates selectors
fireplace/dsl/evaluator.py - Random picker → Entity selectors: selects candidates
fireplace/dsl/random_picker.py - Random picker → Card database: reads cards
fireplace/dsl/random_picker.py - Card database → Game tags: uses game tags
fireplace/cards/__init__.py - Card helpers → Game actions: defines card behaviors
fireplace/cards/utils.py - Card helpers → Aura effects: uses aura effects
fireplace/cards/utils.py - Card helpers → Card database: looks up cards
fireplace/cards/utils.py - Card-set definitions → Card helpers: uses shared helpers
fireplace/cards/blackrock/adventure.py - Brawl modes → Game lifecycle: uses game runtime
fireplace/brawls/__init__.py - Brawl modes → Card database: uses card database
fireplace/brawls/__init__.py - Brawl modes → Card-set definitions: selects brawl cards
fireplace/brawls/__init__.py - Play rules → Card helpers: uses card helpers
fireplace/rules.py