Skip to content

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

61 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Euro Startup - Beta v1.0

Simulazione strategica satirica del mondo startup italiano, con meccaniche da grand strategy e gestione del board aziendale.

🎯 Features Beta v1.0

  • Multiplayer Hot-Seat: 2-4 giocatori su un singolo device
  • AI Opponents: Avversari AI con difficoltà configurabile
  • Sistema Traits Unificato: Tratti centralizzati applicati automaticamente da startup, CEO, board members ed eventi
  • Action Points System: Pool unificato di azioni per turno (default: 3 AP)
  • Dynamic Metrics: Cash, traction, morale, confidence, tech debt, workforce
  • Market Dynamics: 6 mercati con stati dinamici e crescita automatica
  • Work Mode System: Office/Hybrid/Remote con drift permanenti su morale, confidence e costi workforce
  • Card-Driven Gameplay: 100+ carte divise in categorie (policies, assets, projects, instants, events, board members)
  • Board Management: Assumi CEO, CTO, CFO, HR, CMO, COO con tratti e effetti unici
  • Competitive Cards: Carte che targetano altri giocatori o mercati per interazioni PvP
  • Event Validation: Eventi intelligenti validati contro CEO, mercato, tratti e stati di mercato
  • Tutorial Interattivo: Guida step-by-step per imparare tutte le meccaniche
  • Active Effects Panel: Display real-time di tutti i modificatori attivi con tracciamento sorgente
  • Deterministic Engine: RNG con seed per partite riproducibili
  • Event Log Architecture: Sistema a eventi per futura espansione multiplayer online

Tech Stack

  • Next.js 15 (App Router)
  • TypeScript
  • Tailwind CSS 4
  • shadcn/ui components
  • Zustand + Immer for state management
  • Vitest for testing

Getting Started

Install Dependencies

pnpm install

Run Development Server

pnpm dev

Open http://localhost:3000 to start playing.

Run Tests

pnpm test

Build for Production

pnpm build
pnpm start

🎮 Regole di Gioco

Obiettivo

Costruisci la startup di maggior successo nell'arco di 24 settimane gestendo risorse, giocando carte strategicamente, assumendo i giusti membri del board e dominando il mercato.

Ogni Turno

  1. Draw Phase: Pesca 2 carte automaticamente
  2. Event Phase: Dopo il turno 1, può triggerare un evento validato contro il tuo stato (CEO, mercato, tratti)
  3. Action Phase: Hai 3 Action Points (AP) per turno da spendere in:
    • 🎴 Giocare carte (1 AP ciascuna) - Policy, Asset, Project, Instant
    • 👥 Assumere dipendenti (1 AP)
    • 👋Licenziare dipendenti (1 AP)
    • 👔 Assumere board members (1 AP)
    • 🏢 Cambiare work mode (1 AP)
    • ⚠️ Eventi sono GRATUITI (0 AP) - Puoi giocare tutti gli eventi che vuoi
  4. Allocation Phase: Imposta allocazione capacità (Product/Sales/Ops)
  5. End Turn: Conferma e passa al giocatore successivo

Week Resolution

Dopo che tutti i giocatori hanno finito il turno:

  • 💰 Calcoli economici (burn rate, revenue da market share)
  • 📊 Effetti dell'allocazione capacità (breakthrough prodotto, crescita traction)
  • 🔨 Progresso progetti
  • 😊 Aggiustamenti morale e confidence
  • ⏳ Countdown effetti attivi
  • 🌍 Crescita automatica mercati (basata su market state)

Scoring

Alla fine della Settimana 24:

  • Score = Traction × 2 + Cash ÷ 1000 + Confidence × 0.5 + Morale × 0.3 - Tech Debt × 0.8

🎴 Tipi di Carte

  • Policy (max 2 attive): Effetti ongoing permanenti o a durata. Costo: 1 AP
  • Asset (max 2 attivi): Benefici permanenti o temporanei. Costo: 1 AP
  • Project (max 2 attivi): Completamento progressivo, blocca capacità. Costo: 1 AP
  • Instant: Effetti immediati one-shot. Costo: 1 AP
  • Event: Scelte narrative con conseguenze multiple. Costo: 0 AP (GRATIS) ✅
  • Board Member: Assumi dirigenti con tratti e effetti permanenti. Costo: 1 AP

🎯 Carte con Targeting

Alcune carte possono essere giocate su:

  • Altri giocatori: Rubare board members, traction, cash; copiare effetti
  • Mercati specifici: Manipolare dimensioni mercato (boom/crash)

👔 Board Members & Sistema Traits

Ogni ruolo ha 2+ opzioni con personalità ed effetti distinti. I tratti sono centralizzati e si applicano automaticamente.

🎯 Come Funzionano i Traits

  • Ogni Startup, CEO e Board Member ha dei Traits
  • I Traits sono definiti centralmente e applicano effetti meccanici automatici
  • I Traits si sommano tra loro e sono sempre attivi
  • Quando assumi/licenzi un board member, i suoi traits vengono aggiunti/rimossi automaticamente

Composizione Traits:

  • 🏢 Startup: contribuisce 2-3 tratti base
  • 👤 CEO: aggiunge 2-3 tratti personali
  • 👔 Board Members: ognuno aggiunge 1-2 tratti
  • Tutti i tratti si sommano per modificare le tue metriche!

Ruoli Board Disponibili

  • CEO: Il Pitchatore vs Bootstrap Monk
  • CTO: Il Monolite vs Framework Hoarder
  • CFO: Il Dottore vs Excel Warlord
  • HR: La Zen Coach vs Il Crunch Evangelist
  • CMO: Influencer Whisperer vs Growth Hacker 2007
  • COO: Il Processino vs Hero Operator

🎲 Eventi Validati

Eventi intelligenti che si triggerano SOLO se:

  • ✅ CEO richiesto: Hai il CEO specificato nella carta
  • ✅ Mercato richiesto: Operi nel mercato specificato
  • ✅ Traits richiesti: Hai almeno uno dei tratti richiesti
  • ✅ Market State: Il mercato è nello stato specificato (crisis, growing, etc.)

Se un evento non è valido, viene scartato e se ne pesca uno nuovo.

🎨 UI/UX Features

🎓 Tutorial Interattivo

  • 12 step guidati che introducono tutte le meccaniche
  • Navigazione con tastiera (Arrow keys, Enter, Escape)
  • Messaggio di completamento con bottone "Inizia Partita"
  • Può essere saltato o rigiocato

📊 Status Bar (Top)

  • 👥 Team: Workforce (dipendenti) con capacità e costi
  • 💰 Cassa: Cash con revenue/burn breakdown
  • ⏱️ Runway: Settimane rimanenti con color-coding
  • 📈 Trazione: Crescita utenti con effetti allocazione
  • 😊 Morale: Felicità team che influenza produttività
  • 💪 Fiducia: Confidence investitori per risk checks
  • 🔧 Debito Tecnico: Qualità codice che influenza produttività

⚡ Active Effects Panel

  • 🔥 Multipliers: Modificatori produttività, revenue, crescita
  • 🔄 Weekly Changes: Delta settimanali morale, confidence, debt, traction
  • 💸 Burn Rate: Costi aggiuntivi settimanali
  • 👔 Board Traits: Tratti cumulativi di tutti i board members
  • 📍 Source Tracking: Ogni effetto mostra la sua origine (carta, trait, evento, etc.)

🎴 Hand Display

  • ⚡ Action Points Counter: Mostra "AP: X/3" con color coding
  • 📊 Card Sections: Eventi (priorità), Azioni, Board Members
  • ✅ Playability Indicators: Motivi chiari per cui le carte non possono essere giocate
  • 🎯 Target Selection: UI per selezionare player/market target quando richiesto

🗂️ Tabs System

  • 🎴 Mano: Le tue carte giocabili
  • 🌍 Mercati: Overview globale con crescita e stati
  • 👥 Giocatori: Classifica con dettagli comparativi
  • 🎯 Tratti: Visualizzazione tratti stile HOI4

🏢 Work Mode Panel

  • Office / Hybrid / Remote con trade-off chiari
  • Drift Permanenti: Morale e Confidence modificati settimanalmente
  • Costi Workforce: Office +20%, Hybrid neutro, Remote -20%
  • Validazione restrizioni mercato (alcuni mercati non supportano Remote)
  • Malus temporaneo durante transizioni (-10 morale per 1 week)
  • Consumo 1 AP per cambio, solo 1 livello alla volta

📂 Data-Driven Design

Tutti i contenuti di gioco sono definiti in file JSON - nessuna modifica al codice richiesta!

File di Contenuto

  • /src/data/startups.json - Definizioni startup iniziali
  • /src/data/ceos.json - CEO selezionabili con tratti
  • /src/data/traits.json - Libreria centralizzata tratti (22 tratti)
  • /src/data/markets.json - 6 mercati con proprietà
  • /src/data/marketStates.json - Stati mercato con effetti
  • /src/data/boardMembers.json - Board members assumibili
  • /src/data/events.json - Eventi narrativi con validazione
  • /src/data/instants.json - Carte instant (include targeting)
  • /src/data/policys.json - Policy cards
  • /src/data/assets.json - Asset cards
  • /src/data/projects.json - Project cards

📘 Guida Contenuti

Consulta GUIDA_CONTENUTI.md per:

  • Template per creare nuovi eventi
  • Template per creare nuovi CEO
  • Come usare il sistema traits centralizzato
  • Esempi completi e best practices

🏗️ Architettura

Engine Core

  • Deterministic: Tutta la randomness usa seeded RNG riproducibile
  • Action-Based: Ogni interazione è un'action con event log
  • Replay-Ready: Event log può ricostruire qualsiasi game state
  • Effect System: DSL flessibile per effetti carte con conditionals
  • Traits System: Tratti centralizzati applicati automaticamente via applyTraitsToPlayer()
  • Source Tracking: Ogni effetto attivo traccia la sua origine
  • Targeting System: Carte possono targetare player e mercati specifici

Future V2 Multiplayer

L'architettura supporta migrazione facile a multiplayer online:

  • Sostituire local store con connessione server
  • Server applica actions e broadcasta state
  • Event log fornisce rollback/replay capabilities
  • Nessuna modifica UI richiesta

License

MIT

Credits

Built with Claude Code by Anthropic.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages