Complete Game Guide
Comprehensive reference for all current ChoiceFlow systems
Alpha Notice: This game is in active development. Features, balance, and content are subject to change.
Alpha version - ChoiceFlow is in active development. This guide is based on the current repository code and should be updated whenever systems, balance, or content change.
This guide summarizes the main systems players interact with. Some details, such as tournament schedules, market prices, and city conditions, can change during play.
Getting Started
Starting Age
| Start As | Age | What It Means |
|---|---|---|
| Baby | 0 | Full life path from infancy |
| Child | 8 | Starts during elementary school |
| Teen | 16 | Starts in high school with teen activities and some paid activities |
| Adult | 18+ | Starts with adult activities, jobs, dating, banking, housing, and more |
Personality
ChoiceFlow uses six unified personalities: Ambitious, Charming, Intellectual, Creative, Disciplined, and Adventurous. Personality affects skill modifiers, NPC interaction modifiers, compatibility, and some generated scenes.
Personality bonuses are not a separate career system. They modify how well a character fits certain skills, actions, or relationship dynamics.
Skills
The current leveling skills are:
| Skill | Used For |
|---|---|
| Fitness | Physical activities, sports, combat, health-related performance |
| Discipline | Training consistency, school/work habits, combat preparation |
| Resilience | Stress resistance, hard physical challenges, adversity |
| Intelligence | Education, research, technical and analytical activity |
| Looks | Appearance, selfies, posing, attraction-related checks |
| Creativity | Art, music, writing, creative work, streaming niches |
| Charisma | Social activities, dating, interviews, public-facing careers |
| Technical Skills | Coding, tech career, technical projects |
| Business Skills | Management, business activity, entrepreneurship |
| Happiness | Mood and wellbeing, tracked on the same skill framework |
| Martial Arts | Combat training and fighting |
| Tennis | Tennis training and tennis career progression |
Health is a stat, not a leveling skill.
XP Curve
Skills use an exponential XP curve, so early levels come quickly and higher levels take much more dedication.
| Level Transition | XP Required |
|---|---|
| Level 1 to 2 | 83 XP |
| Level 10 to 11 | 1,154 XP |
| Level 50 to 51 | 101,333 XP |
| Level 99 to 100 | 13,034,431 XP |
Level 100 is the maximum skill level.
Activity Performance
Activities can fail, land below average, succeed normally, or perform excellently.
| Outcome | Roll Range | XP Multiplier |
|---|---|---|
| Failure | 0% to 5% | 0x |
| Below Average | 5% to 15% | 0.75x |
| Normal | 15% to 75% | 1.0x |
| Excellent | 75% to 100% | 1.5x |
Age protection matters:
- Ages 0-2: baby activities cannot fail.
- Ages 3-7: failure is capped very low.
- Ages 8-12: reduced failure and no adult skill penalty.
- Ages 13-17: teen failure rules with reduced penalties.
- Ages 18+: full activity outcome system.
After two consecutive failures, the next activity is protected from failure.
Diminishing Returns
Repeating the same activity reduces XP. Babies are exempt. Children, teens, and adults have progressively stricter repeat penalties. Adults can drop as low as 10% XP from extreme repetition.
Variety helps. Trying different activities can grant a +15% variety bonus, capped by the activity system.
Activities
There are 83 player-selectable activities, each with its own age rules, energy cost, XP rewards, and possible cash rewards.
Age Groups
| Group | Examples |
|---|---|
| Baby and toddler | Tummy Time, Babbling and Sounds, Peek-a-Boo, First Steps, Comfort After Crying |
| Children | Play with Toys, Story Time, Outdoor Play, Drawing and Coloring, Playground Challenge, Try Something New |
| Teens | Social Media Time, Hang Out with Other Kids, Casual Sports, Video Games, Stand Your Ground, Push Through Tough Workout |
| Teen income | Lemonade Stand, Extra Chores, Car Washing, Pet Sitting, Peer Tutoring, Flyer/Newspaper Delivery, Grocery Helper, Online Reselling, Dog Walking |
| Adults | Physical, social, intellectual, creative, professional, technical, income, gated, elite, and crime activities |
Important Current Additions
The guide previously missed or understated these current activities:
- Work Analytics exists for active business owners.
- Private Chef Dinner, Celebrity Networking, and Private Island Retreat exist as gated/elite activities.
- Dog Walking starts at age 14 and Lawn Care starts at age 15.
- Pet Sitting and Babysitting can start before adulthood.
- Crime activities are live, not just planned.
Activity Requirements
Some activities require items or conditions. Examples:
- Reading needs books or a library card.
- Social Meetups needs a phone to coordinate events.
- Creative Projects need art supplies, a musical instrument, or a computer.
- Freelance Projects need a computer.
- Coding activities need a phone/computer or computer, depending on the activity.
- Gated elite activities require specific wealth, fame, items, friends, careers, or skill levels.
For exact XP ranges, energy costs, and cash rewards, check the activity details in the game.
Education
Education covers K-12 schooling, private school options, scholarships, and higher education programs.
K-12 Progression
| School | Ages | Final Exam Available | Graduation Age | Per-Year Activity Limit |
|---|---|---|---|---|
| Elementary School | 5-11 | 10 | 11 | 10 |
| Middle School | 11-14 | 13 | 14 | 12 |
| High School | 14-18 | 17 | 18 | 14 |
K-12 Grades
K-12 GPA is based on education activity points.
| School | A | B | C | D | F |
|---|---|---|---|---|---|
| Elementary | 8+ | 6-7 | 3-5 | 1-2 | 0 |
| Middle | 10+ | 8-9 | 4-7 | 2-3 | 0-1 |
| High | 12+ | 9-11 | 5-8 | 2-4 | 0-1 |
High school expulsion uses the code threshold of GPA below 1.0.
Final Exams
Final GPA uses:
- 70% coursework GPA
- 30% exam GPA
- applicable private school bonus
Passing exam score is 60.
Scholarships
| Tier | GPA | Tuition Discount |
|---|---|---|
| Full Academic Scholarship | 3.8+ | 100% |
| Partial Academic Scholarship | 3.5+ | 50% |
| No Scholarship | below 3.5 | 0% |
Private Schools
Middle/high private schools require GPA 3.0 and charge upfront tuition.
| School | Focus | Tuition Per Year | Upfront Tuition | GPA Bonus | Salary Boost |
|---|---|---|---|---|---|
| Wellington Academy | Academic | $40,000 | $160,000 | +0.5 | 10% |
| Riverside Sports Academy | Athletic | $35,000 | $140,000 | +0.3 | 8% |
| Harrington School of the Arts | Arts | $38,000 | $152,000 | +0.4 | 7% |
Elementary private tiers also exist:
| School | Focus | Tuition Per Year | Upfront Tuition | GPA Bonus | Salary Boost |
|---|---|---|---|---|---|
| Oakwood Preparatory Academy | Academic | $18,000 | $108,000 | +0.5 | 2% |
| Riverside Junior Academy | Athletic | $15,000 | $90,000 | +0.42 | 1.5% |
| Harrington Junior Arts School | Arts | $16,000 | $96,000 | +0.45 | 1% |
Higher Education
| Program ID | Credits Required |
|---|---|
| community_college | 60 |
| state_college | 120 |
| grad_school | 60 |
| medical | 160 |
| law | 120 |
Higher education graduation is credit-gated. When enough credits are earned, the player must graduate from the Education screen.
Careers
The current standard career tracks are:
- Food Service
- Retail
- Technology
- Business
- Education
- Medicine
- Law
Each job checks age, education, field, relevant skills, experience, and company availability.
Standard Career Summary
| Track | Entry Role | Top Role | Top Base Salary |
|---|---|---|---|
| Food Service | Dishwasher | Restaurant Manager | $45,000-$65,000 |
| Retail | Sales Associate | Store Manager | $45,000-$65,000 |
| Technology | Junior Developer | Tech Lead | $160,000-$220,000 |
| Business | Business Analyst | Director of Operations | $140,000-$200,000 |
| Education | Student Teacher | Principal | $100,000-$140,000 |
| Medicine | Medical Receptionist or Medical Resident | Chief of Medicine | $350,000-$500,000 |
| Law | Legal Secretary or Junior Associate Attorney | Managing Partner | $500,000-$1,000,000 |
Actual salary can change by company multiplier, interview score, private school bonuses, performance, and other systems.
Interviews
The interview system uses:
- 4 base questions
- +1 question per career level above 1
- +1 question per company tier above 1
- minimum 4 questions, maximum 8
- pass threshold of 60%
Modifiers include Charisma, role-relevant Intelligence for tech roles, education, reputation, and homelessness penalties.
Performance and Termination
New jobs start at 50% performance. Work quality changes performance. Skipping work can decay performance annually.
The warning threshold depends on reputation:
| Reputation | Warning Threshold |
|---|---|
| Famous | 25% |
| Popular | 30% |
| Respectable | 35% |
| Average | 40% |
| Sketchy | 45% |
| Outcast | 50% |
If performance stays below the threshold after the warning year, the player can be fired.
Streaming Career
Streaming is a full career system, separate from the standard job ladder.
Niches
| Niche | Strong Skills | Growth Modifier |
|---|---|---|
| Gaming | Intelligence, Discipline, Charisma | 1.0 |
| IRL / Vlog | Charisma, Looks, Creativity | 0.9 |
| Creative | Creativity, Discipline, Intelligence | 0.7 |
| React / Commentary | Charisma, Intelligence, Looks | 1.2 |
Platforms
| Platform | Type | Main Path |
|---|---|---|
| Streamz | Live | Affiliate at 50 followers, 3 avg viewers, 7 stream days. Partner at 5,000 followers, 75 avg viewers, 12 stream days. |
| ViewTube | VOD | Monetized at 1,000 subscribers and 4,000 watch hours. Premium at 100,000 subscribers. |
| ShortForm | Short videos | Creator Fund at 10,000 followers and 100,000 views. Verified at 1,000,000 followers. |
Streaming Equipment
Streaming equipment categories are camera, microphone, lighting, computer, capture card, and backdrop.
Fame Tiers
Streaming fame score tiers are Hobbyist, Micro Creator, Small Creator, Large Creator, Major Influencer, Star, Celebrity, and Legend.
Sponsor tiers unlock by followers:
| Sponsor Tier | Minimum Followers | Max Monthly Pay |
|---|---|---|
| Micro | 1,000 | $200 |
| Small | 10,000 | $800 |
| Medium | 100,000 | $4,000 |
| Large | 500,000 | $12,000 |
| Mega | 1,000,000 | $25,000 |
Follower gains are capped by streaming limits: 500,000 per stream, 5,000,000 per year, and 500,000,000 total followers.
Martial Arts & MMA
ChoiceFlow has two related fighting systems:
- Martial arts classes by discipline
- MMA career and league systems
Martial Arts Disciplines
| Discipline | Cost Per Class | Progression |
|---|---|---|
| Brazilian Jiu-Jitsu | $150 | White, Blue, Purple, Brown, Black |
| Karate | $120 | White through kyu ranks to 1st Dan and Black |
| Taekwondo | $120 | White, Yellow, Green, Blue, Red, Black |
| Judo | $130 | White, Yellow, Orange, Green, Blue, Brown, Black |
| Muay Thai | $140 | Beginner, Intermediate, Advanced, Expert, Master |
| Boxing | $100 | Novice, Amateur, Professional, Champion, Legend |
| Wrestling | $110 | Beginner, Intermediate, Varsity, Collegiate, Olympic |
MMA Divisions and Gyms
MMA divisions are Rookie, Regional, National, and World. The current max fight cap is 12 fights per season.
| Gym Tier | Base Pay | Win Bonus | Contract Cut | XP Bonus |
|---|---|---|---|---|
| Budget | $500 | $250 | 40% | 0% |
| Standard | $1,000 | $500 | 30% | 15% |
| Elite | $2,000 | $1,000 | 20% | 30% |
Championship belts exist for Rookie, Regional, National, and World divisions. Belt item values are $5,000, $15,000, $50,000, and $150,000 respectively, with increasing happiness, charisma, discipline, resilience, and fame effects.
Tennis
Tennis is now a leveling skill and has a dedicated sports career system with clubs, training, rivals, amateur events, tour progression, rankings, tournaments, match flow, income, seasons, and condition management.
Use the Tennis career screen for exact tournament and club state because those systems are season and ranking driven.
Business
Business ownership is a standalone system in the Career tab.
| Type | Starting Capital | Difficulty | Base Revenue | Notes |
|---|---|---|---|---|
| Cafe / Coffee Shop | $15,000-$60,000 | Easy | $10,000 | Throughput model |
| Retail Store | $25,000-$100,000 | Medium | $10,000 | Stock model |
| Salon and Spa | $30,000-$120,000 | Medium | $10,000 | Service model |
| Auto Repair Shop | $40,000-$150,000 | Medium | $12,000 | Service model |
| Fitness Gym | $75,000-$250,000 | Medium | $13,000 | Service model |
| Restaurant | $50,000-$200,000 | Hard | $18,000 | Throughput model |
| Franchise | $100,000-$500,000 | Easy | $15,000 | Currently disabled in code |
Revenue changes with economy, staff, customer satisfaction, products/services, marketing, equipment, and business level.
Economy modifiers:
| Economy | Revenue Multiplier |
|---|---|
| Boom | 1.4x |
| Normal | 1.0x |
| Recession | 0.75x |
| Crash | 0.5x |
The current system supports competitors, suppliers, equipment, marketing channels, staff, products/services, tasks, profit management, business loans, bankruptcy, and multi-location operations.
Money & Banking
Banks offer different account access, savings rates, loan rates, and borrowing limits.
| Bank | Minimum Credit Score | Savings APY | Loan APR | Loan Max | Notes |
|---|---|---|---|---|---|
| Community Bank | 300 | 2.5% | 8% | $50,000 | No monthly fee, low minimum balance |
| Digital Bank | 400 | 3.5% | 7% | $100,000 | Online access, high interest, no monthly fee |
| National Bank | 500 | 2% | 6.5% | $200,000 | Monthly fee, branch network, better loan rates |
| Premium Bank | 700 | 4% | 4.5% | $1,000,000 | $10,000 minimum balance, no fees, personal banker |
Account Limits
- Checking: 1 per bank
- Savings: 1 per bank
- Business: 1 per bank, 1 business account globally
Your credit score affects account access, loan access, loan rates, and financial consequences.
Investing
Investing requires an internet-capable trading device. Current code accepts budget laptop, MacBook Pro, gaming PC, basic phone, premium smartphone, and smart watch.
Investments use live market prices. Starting prices seed the market, then stock and crypto prices continue evolving each year even if you do not currently own any holdings.
Stocks
| Risk | Symbols |
|---|---|
| Low | SNB, PGU, EGC |
| Medium | TGI, HCP, SMG, HMI |
| Medium-high | GEC, GWS, SHA |
| High | GUV, BGL, NAI, SBA, GGF |
Crypto
| Asset | Symbol | Risk |
|---|---|---|
| Bitcoin | BTC | Very high |
| Ethereum | ETH | Very high |
| StableCoin | USDS | Low |
| DogeMoon | DGMN | Extreme |
Real Estate Investments
| Asset | Minimum Investment | Risk |
|---|---|---|
| Diversified REIT Fund | $1,000 | Medium |
| Rental Property | $50,000 | Medium |
| Commercial Property | $200,000 | Medium-high |
Annual returns are affected by market simulation, world events, economy, and the asset's risk settings.
Housing
Housing utilities distinguish rentals from owned property. Current recognized rental IDs are studio apartment, one bedroom, and two bedroom. Current owned property IDs include condo, townhouse, ranch house, colonial house, victorian house, luxury penthouse, modern mansion, and private estate.
The shop data defines prices, rent, maintenance, appreciation, and unlock requirements. Owned property contributes to net worth and can affect activity requirements.
Rental pet limits are enforced by the pet housing policy:
- Studio: 1 pet
- One bedroom: 2 pets
- Two bedroom: 3 pets
- Owned homes: no rental cap
Relationships
Relationships are tracked through social and family connections rather than a single simple friendship number.
Relationships use trust, affection, respect, and resentment to compute a relationship score. Some older helper code also tracks intimacy and relationship history for progression.
Relationship Labels
| Score | Label |
|---|---|
| 81 to 100 | Best Friends / Family Level |
| 61 to 80 | Close Friends |
| 41 to 60 | Good Friends |
| 21 to 40 | Casual Friends |
| -20 to 20 | Strangers / Acquaintances |
| -49 to -21 | Hostile |
| -100 to -50 | Enemies |
Romance Progression
Current romance stages include:
- Dating
- Boyfriend/Girlfriend or partner equivalent
- Engaged
- Married
NPCs can initiate flirting, ask for dates, ask to become exclusive, hint at marriage, propose, ask about children, or initiate breakup depending on relationship stage and relationship score.
Romance checks block invalid relationships, including close family relationships, existing marriage conflicts, and underage marriage.
Marriage & Family
Marriage
Marriage requires both people to be eligible adults, legally available to marry, and not blocked by family relationship rules. Prenups are attached to the marriage.
Divorce
Divorce can include:
- happiness loss
- asset split
- pension split
- alimony
- child support
- custody arrangement
A prenup protects income, pension, and assets in the divorce flow.
Pregnancy and Children
Pregnancy and children currently support:
- player pregnancy and partner pregnancy resolution
- twins
- baby naming
- per-baby involvement decisions
- keep child
- co-parent custody or walking away with child support
- adoption
- affair pregnancy reactions
- children aging into adults
- reconnecting later through co-parent profiles in some paths
Custody
Custody types are full, joint, limited, and none.
| Custody | Meaning |
|---|---|
| Full | Children live with the player |
| Joint | Shared custody with visitation |
| Limited | Supervised/limited visitation |
| None | No visitation rights |
Missed visitation, blocked visitation, late child support, and new relationship jealousy can affect feelings.
Crime & Prison
Crime is active in the current code.
Repeatable Crime Activities
| Crime | Energy | Cash | Base Arrest Chance | Police Heat |
|---|---|---|---|---|
| Vandalism | 8 | $50-$200 | 5% | +3 |
| Car Theft | 20 | $800-$3,000 | 10% | +8 |
| Burglary | 25 | $500-$2,000 | 12% | +10 |
| Robbery | 30 | $1,000-$5,000 | 18% | +12 |
| Jewelry Heist | 35 | $2,000-$8,000 | 20% | +15 |
Crime money goes to the wallet.
At 150 police heat, the system starts a police investigation/raid flow and resets heat through the reputation system. The player can defend themselves instead of being automatically convicted.
At the 10th committed crime, the game can trigger a gang recruitment offer if the criminal career is not active.
Criminal Career
The criminal career includes:
- gang recruitment
- gang safe balance
- lieutenants
- soldiers and associates
- force strength
- reputation
- territory control
- rival gangs
- passive territory income
- police raids and rival attacks
Organization tasks include robbery, burglary, car theft, jewelry heists, drug deals/distribution/smuggling, extortion, protection rackets, contraband smuggling, and counterfeit money.
Territory Operations
Controlled territory operations have different risk/reward settings.
| Operation | Income Multiplier | Raid Chance | Heat Per Year |
|---|---|---|---|
| Protection Racket | 0.6x | 5% | 1 |
| Gambling Ring | 0.85x | 12% | 3 |
| Smuggling | 1.0x | 20% | 5 |
| Extortion | 1.2x | 30% | 8 |
| Drug Trade | 1.5x | 45% | 12 |
Prison
Prison supports sentence serving, prison activities, inmates, prison gang systems, parole, riots, release handling, and isolation from normal systems while incarcerated.
Health & Energy
Health
Health affects work, skill gains, illness risk, and death probability.
Medical systems include:
- doctor consultations
- acute illnesses
- chronic illnesses
- treatment plans
- injury treatment
- insurance and billing modifiers
- emergency health events at critical health
Doctor visits can improve health and reduce illness duration. Successful treatment can remove illness and improve health.
Natural Death
The death step uses age, health, and lifespan.
| Age | Base Annual Death Chance |
|---|---|
| Under 40 | 0.1% |
| 40-50 | 0.3% |
| 50-60 | 0.8% |
| 60-70 | 2% |
| 70-80 | 5% |
| 80-90 | 15% |
| 90-100 | 30% |
| 100-110 | 50% |
| 110-120 | 75% |
| 120+ | 95% |
Low health increases the chance when health is below 50. A character also dies if health reaches 0 or they reach their effective max lifespan.
Energy
Activities cost energy. Low energy reduces work and skill effectiveness.
Current health display logic includes:
- Exhausted: -75% skill gain, -50% work performance
- Tired: reduced skill gain and work performance
- Healthy/energetic states can improve performance
Lifestyle choices affect health. Healthy diet can add +3 health per year; unhealthy diet can reduce health by 3 to 5 per year. Addictions and drug levels can lower health.
Pets
The game includes dog, cat, and companion pet systems.
Current pet systems include:
- dog ownership
- cat ownership
- companion pet ownership
- breed/personality data
- training equipment
- housing policy
- vet care and treatment
- competitions
- breeding/litters
- stud service panels
- pet death/runaway events
- pet minigames for companion pets
Pet housing limits apply to rentals, and pets can interact with housing wear systems.
Shop & Items
Shop categories are:
- Electronics
- Vehicles
- Real Estate
- Lifestyle
- Education
- Health
- Clothing
- Promotional
- Merchandise
- Pet Supplies
Electronics Examples
| Item | Price | Current Key Effects |
|---|---|---|
| Sung Galaxy A15 | $299 | Phone access, +1 Charisma, +5 Happiness |
| PearPhone 15 Pro | $1,199 | Phone access, +2 Charisma, +2 Creativity, +2 Looks, +15 Happiness |
| Hawk Pavilion Laptop | $599 | Computer access, +3 Intelligence, +2 Discipline, +1 Technical Skills |
| PearBook Pro 14 inch | $1,999 | Computer access, +4 Intelligence, +3 Discipline, +3 Technical Skills, +3 Creativity, +2 Looks |
| Custom Gaming PC | $2,499 | Computer access, +3 Creativity, +3 Technical Skills, +2 Intelligence, +25 Happiness, -2 Discipline |
| PlayBox 5 | $499 | Console access, +20 Happiness, +1 Creativity, -1 Discipline |
| Nexus Quest 3 | $499 | VR access, +3 Creativity, +2 Technical Skills, +20 Happiness, -2 Discipline |
| Pear Vision Pro | $3,499 | VR access, +5 Creativity, +4 Technical Skills, +3 Intelligence, +30 Happiness, +2 Looks |
Items can unlock activities, improve XP tiers, add maintenance costs, depreciate, and affect yearly costs.
Life Events
Events are action-triggered, age-triggered, relationship-triggered, school/career-triggered, health-triggered, crime-triggered, or annual summary items.
The event queue prioritizes critical events such as death, prison, eviction, inheritance, medical emergencies, and pet death above lower-priority summaries.
Narrative systems aim to reference current game state, including parents, jobs, housing, pets, pregnancy, relationships, prison, and life stage.
Tips & Strategy
Build Skills
- Train varied activities to avoid diminishing returns.
- Match personality, items, and activities where possible.
- Use higher-tier activities only after meeting the real requirements.
- Remember Tennis is now a skill.
Build Money
- Education supports high-paying jobs, especially medicine and law.
- Standard careers are stable and can provide benefits.
- Business can scale but has overhead, competitors, staff, equipment, and bankruptcy risk.
- Investing includes stocks, crypto, and real estate investments with live yearly market movement.
- Crime can pay quickly but adds heat, records, raids, prison risk, and gang complications.
Build Relationships
- Treat people well to build trust, affection, and respect. Hurtful choices can create resentment.
- Interact regularly so relationships do not fade over time.
- Close family members and unavailable partners cannot become valid romance options.
- Prenups matter before marriage.
- Custody and support decisions continue affecting family relationships.
Survive
- Keep health above 50 where possible.
- Treat illnesses and injuries.
- Keep energy out of exhausted range.
- Pay rent, loans, support, and business obligations.
- Avoid stacking police heat unless you are ready for investigation and prison risk.