Game Mechanics
==============

Empire Builder features deep strategic gameplay with multiple interconnected systems. This guide explains the core mechanics and how they work together.

Core Concepts
-------------

Empire Management
~~~~~~~~~~~~~~~~~

**Empire Creation**
When you first join the game, you create an empire with:
- Unique empire name
- Starting location on the world map
- Initial resources (1000 gold, 500 food, 200 materials)
- Basic infrastructure (town hall, 1 house, 1 farm)

**Resource System**
Three primary resources drive your empire:

- **Gold** 💰: Primary currency for buildings, units, and trade
- **Food** 🌾: Required to feed population and maintain armies
- **Materials** 🔨: Used for construction and military equipment

Resources are produced by buildings and consumed by population, military units, and construction projects.

City Building
~~~~~~~~~~~~~

**Building Types**

*Economic Buildings:*
- **Houses**: Increase population capacity (+10 population each)
- **Farms**: Produce food (+5 food/hour each)
- **Markets**: Generate gold (+3 gold/hour each)
- **Workshops**: Produce materials (+2 materials/hour each)

*Military Buildings:*
- **Barracks**: Train infantry units (soldiers, archers)
- **Stables**: Train cavalry units (knights, horsemen)
- **Siege Workshop**: Build siege engines (catapults, ballistas)
- **Walls**: Defensive structures (+20 defense each)

*Special Buildings:*
- **Town Hall**: Administrative center (required for city)
- **Library**: Research technologies
- **Temple**: Provides happiness bonus
- **Warehouse**: Increases resource storage capacity

**Building Mechanics**
- Each building has construction cost and time
- Buildings can be upgraded for improved efficiency
- Some buildings have prerequisites (e.g., stables require barracks)
- Building placement affects efficiency (farms near water = bonus)

Military System
~~~~~~~~~~~~~~~

**Unit Types**

*Infantry:*
- **Soldiers**: Basic melee units (Attack: 10, Defense: 8, Cost: 50 gold)
- **Archers**: Ranged units (Attack: 12, Defense: 6, Cost: 60 gold)
- **Spearmen**: Anti-cavalry specialists (Attack: 8, Defense: 12, Cost: 45 gold)

*Cavalry:*
- **Knights**: Heavy cavalry (Attack: 18, Defense: 14, Cost: 120 gold)
- **Horsemen**: Light cavalry (Attack: 14, Defense: 10, Cost: 80 gold)
- **Scouts**: Fast reconnaissance (Attack: 6, Defense: 4, Cost: 40 gold)

*Siege Engines:*
- **Catapults**: Anti-building (Attack: 25 vs buildings, Cost: 200 gold)
- **Ballistas**: Anti-personnel (Attack: 20, Defense: 8, Cost: 150 gold)

**Combat Mechanics**
Combat uses a tactical system considering:
- Unit types and their strengths/weaknesses
- Terrain advantages (hills, forests, rivers)
- Weather conditions (rain affects archers)
- Formation and positioning
- Commander bonuses and tactics

Battle System
~~~~~~~~~~~~~

**Battle Types**

*Field Battles:*
- Open combat between armies
- Terrain plays major role
- Winner takes battlefield control

*Siege Warfare:*
- Attacking fortified cities
- Defenders get wall bonuses
- Siege engines crucial for success
- Can result in city capture

*Raids:*
- Quick attacks for resources
- Lower risk but limited rewards
- Good for harassment tactics

**Battle Resolution**
1. **Pre-battle**: Armies position, weather determined
2. **Combat Rounds**: Units attack based on initiative
3. **Morale Checks**: Losing armies may retreat
4. **Resolution**: Winner determined, casualties calculated
5. **Aftermath**: Loot distributed, territory changes

**Battle Factors**
- **Unit Composition**: Balanced armies perform better
- **Terrain**: Hills favor defense, plains favor cavalry
- **Weather**: Rain reduces archer effectiveness
- **Morale**: Winning streaks boost performance
- **Leadership**: Commander skills affect outcomes

Technology System
~~~~~~~~~~~~~~~~~

**Research Trees**

*Military Technologies:*
- **Bronze Working**: Unlocks better weapons (+2 attack all units)
- **Iron Working**: Advanced metallurgy (+3 attack, +2 defense)
- **Tactics**: Improved battle formations (+10% battle effectiveness)
- **Siege Craft**: Unlocks advanced siege engines

*Economic Technologies:*
- **Agriculture**: Improved farming (+2 food per farm)
- **Currency**: Better trade systems (+1 gold per market)
- **Construction**: Faster building (+25% construction speed)
- **Engineering**: Advanced buildings (aqueducts, roads)

*Social Technologies:*
- **Writing**: Enables diplomacy and advanced government
- **Mathematics**: Improves resource calculations
- **Philosophy**: Increases happiness and reduces unrest
- **Medicine**: Reduces population loss from disease

**Research Mechanics**
- Research requires libraries and scholars
- Each technology has prerequisites
- Research points generated by libraries
- Some technologies unlock new building types

Diplomacy and Alliances
~~~~~~~~~~~~~~~~~~~~~~~

**Diplomatic Relations**
- **War**: Active hostilities, can attack freely
- **Peace**: Non-aggression, trade possible
- **Alliance**: Military cooperation, shared vision
- **Vassal**: Subordinate relationship, tribute system

**Alliance System**
- Form alliances with other players
- Share resources and military support
- Coordinate attacks and defense
- Alliance chat and planning tools

**Diplomatic Actions**
- Send messages and proposals
- Negotiate trade agreements
- Declare war or peace
- Form defensive pacts

Advanced Mechanics
------------------

Population and Happiness
~~~~~~~~~~~~~~~~~~~~~~~~~

**Population Growth**
- Population grows naturally over time
- Growth rate affected by food availability
- Houses determine maximum population
- Population provides tax income

**Happiness System**
- Happy populations are more productive
- Unhappiness can lead to revolts
- Affected by: taxes, military losses, buildings
- Temples and entertainment improve happiness

Trade and Economics
~~~~~~~~~~~~~~~~~~~

**Trade Routes**
- Establish trade with other empires
- Exchange resources at negotiated rates
- Trade routes can be disrupted by war
- Markets improve trade efficiency

**Economic Management**
- Set tax rates (affects happiness vs income)
- Manage resource stockpiles
- Plan construction projects
- Balance military and economic spending

Weather and Seasons
~~~~~~~~~~~~~~~~~~~

**Seasonal Effects**
- **Spring**: Bonus to farm production
- **Summer**: Normal production, best for campaigns
- **Autumn**: Harvest bonuses, preparation time
- **Winter**: Reduced movement, higher food consumption

**Weather Events**
- **Drought**: Reduces farm output
- **Floods**: Can damage buildings
- **Storms**: Affect naval operations
- **Plague**: Reduces population

Victory Conditions
------------------

**Conquest Victory**
- Control 60% of the world map
- Eliminate all rival empires
- Maintain control for 10 game days

**Economic Victory**
- Accumulate 100,000 gold
- Control 50% of world trade routes
- Maintain economic dominance

**Cultural Victory**
- Research all technologies
- Build all wonder buildings
- Achieve maximum happiness in all cities

**Alliance Victory**
- Form alliance controlling 70% of map
- Maintain alliance for 15 game days
- All alliance members share victory

Game Balance
------------

**Resource Balance**
The game maintains balance through:
- Diminishing returns on building spam
- Upkeep costs for large armies
- Trade-offs between military and economy
- Random events that affect all players

**Power Scaling**
- Early game focuses on expansion
- Mid game emphasizes military buildup
- Late game requires strategic coordination
- Technology provides long-term advantages

**Anti-Snowball Mechanics**
- Larger empires have higher upkeep costs
- Rebellions more likely in distant territories
- Diplomatic coalitions against dominant players
- Random events can level the playing field

Tips for New Players
--------------------

**Starting Strategy**
1. Build 2-3 farms immediately for food security
2. Construct houses to increase population
3. Build markets for steady gold income
4. Train basic military for defense

**Early Game Focus**
- Secure your starting area
- Establish resource production
- Scout nearby territories
- Make contact with neighbors

**Mid Game Transition**
- Specialize your cities (military vs economic)
- Research key technologies
- Form strategic alliances
- Plan expansion campaigns

**Late Game Mastery**
- Coordinate with allies
- Manage large-scale logistics
- Adapt to changing diplomatic situations
- Execute victory condition strategies

This comprehensive system creates deep, engaging gameplay where every decision matters and multiple paths to victory exist. Master these mechanics to build a lasting empire! 🏰