CityVille .NET

A .NET 10 backend recreation of the classic CityVille (2012) flash game

Beta status: the game is playable and most core systems work, but many features are still being implemented.

Features

• Three worlds: Main city, Downtown and Lakefront
• Building & farming: construction sites, businesses, residences, plots, greenhouse, remodel, upgrades
• City expansion: expansion licenses and incentivized expansions
• Quests: hundreds of quests and task actions
• Franchises: headquarters, supply, daily bonus, Samantha's city
• Trains & ships, zoo animals, factory workers, crew members and gates, mastery gates
• Cops & bandits, weather effects
• Collections & wishlist, inventory, consumables, bundles
• Friends: requests, visits, helping neighbors, energy
• Multi languages: english, spanish, french, italian, portuguese
• Embedded ruffle flash emulator: no need to install Flash

Implementation progress

Last update: 2026-10-31 · 🟡 = partial

	Progress
Client transactions	31%	72 ✅ · 19 🟡 · 141 ❌
World actions	57%	21 ✅ · 2 🟡 · 14 ❌
Quest task actions	92%	72 ✅ · 0 🟡 · 109 ❌ (% weighted by use)
Completable quests	74%	975 / 1312

Getting Started

Prerequisites

• Docker & Docker Compose, or
• .NET 10 SDK and MS SQL Server
• The game assets (see Assets)

Run with Docker

1. Clone the repository

   git clone https://github.com/besuper/CityVilleDotnet
   cd CityVilleDotnet

2. Create the wwwroot/ and logs/ folders at the repository root, and put the game assets in wwwroot/.

3. Start the stack

   docker-compose up --build

4. Play at http://localhost:5221/Game

Run locally

The default connection string targets a local SQL Server with Windows authentication (appsettings.json). The database is created and migrated on startup.

dotnet run --project CityVilleDotnet.Api

Then open http://localhost:5221. Assets go in CityVilleDotnet.Api/wwwroot/.

Prebuilt releases

Self-contained builds for Windows, Linux and macOS are published weekly as pre-releases on the releases page.

Assets

Important notice: game assets (images, sounds, sprites, SWF, settings) are not included in this repository as they are copyrighted material owned by Zynga Inc.

1. Get the assets from the Raise the Empires Discord

2. Place them in the wwwroot folder:

   wwwroot/
   ├── assets/
   ├── lang/
   ├── Game.2012.swf
   ├── Preloader.swf
   ├── EmbeddedArt.swf
   ├── FontMapper.swf
   ├── gameSettings.xml
   ├── questSettings.xml
   ├── effectsConfig.xml
   ├── bootstrap.xml
   └── settings.amf.z
   

Note: this project is for educational purposes only. All game assets remain the property of Zynga Inc.

Tests

dotnet test

• test/CityVilleDotnet.Test.Domain: domain entity unit tests
• test/CityVilleDotnet.Test.Integration: transaction tests against a real SQL Server (requires Docker, via Testcontainers)
• test/CityVilleDotnet.Factory: bogus factories shared by both

Project Structure

CityVilleDotnet/
├── CityVilleDotnet.Api/          # AMF gateway, transaction handlers (Services/), Razor Pages
├── CityVilleDotnet.Common/       # Game & quest settings (XML), enums, utilities
├── CityVilleDotnet.Domain/       # Entities and business logic, DTOs
├── CityVilleDotnet.Persistence/  # EF Core DbContext, configurations, migrations
├── FluorineFX/                   # AMF serialization library
├── test/                         # Unit & integration tests, factories
├── docker-compose.yml
└── Dockerfile

Credits

Thanks to everyone who helped bring CityVille back:

• xmohamedX1 huge contribution on the assets: recovery, fixes
• Captain Rusty helped build the first prototype in 2011 and scraped assets from the wiki
• MissTery hosts the raise the Empires Discord server & helping with assets
• Antonio225 carried on maintaining the first prototype and helps a lot on discord
• nidzo helped recreate Samantha's city and with the assets

License

This project is licensed under the GPL-3.0 license - see the LICENSE file for details.