Skip to content

About

Procedural park generator for Cities: Skylines II

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

30 Commits

Folders and files

Repository files navigation

ParkManager

ParkManager is a Cities: Skylines II mod for designing and building custom parks and plazas directly in-game. Draw an outline, choose how the space should work, preview the planned layout, and build it from editable game assets.

What you can build

Parks

  • Draw and edit a park boundary, then mark its entrances on the outline.
  • Generate pedestrian paths that follow the shape of the site, with a choice of narrow or wide paths and a selectable ground surface.
  • Plan trees, shrubs, benches, lamps and bins with separate vegetation and furnishing density controls.
  • Choose specific Vanilla assets or let ParkManager select a coherent mix automatically; add an optional fence with automatic entrance gaps.
  • Generate another layout variation without changing the park outline or its settings.

Plazas

  • Design a plaza around one centerpiece, a mirrored pair, or a set arranged along an axis—or build without a centerpiece.
  • Place furniture arrangements around the centerpiece or along the boundary, and tune their spacing with direct controls.
  • Create an ordered arrangement of up to five chosen assets, such as bench–bush–bench or lamp–bench–bench–lamp.
  • Choose plaza surfaces and an optional fence, then preview the resulting layout before building.

Designed for in-game editing

ParkManager previews planned placements on the map before construction. Built paths, surfaces, plants and furnishings use normal game entities, so they remain available to the game's editing tools. ParkManager also tags the elements of each build so a park can be removed as a whole: with an empty workspace choose "Remove a built park", click any element of the park and confirm. Deleting or replacing a single element with another tool, including the ground surface, leaves the rest of the park in place. Unfinished outlines and previews belong to the current game session; they are not restored when a save is loaded.

Development

ParkManager is under active development. See the changelog for recent changes and development history.

In-game build requirements

  • Official Cities: Skylines II modding toolchain
  • CSII_TOOLPATH and CSII_USERDATAPATH configured by that toolchain
  • .NET SDK compatible with the installed toolchain
  • Node.js 18 or newer

The mod has no third-party runtime assembly dependencies.

Adding a translation

UI copy lives in UI/src/locales/, one file per language. en.ts defines the Texts type. Copy it to locales/<id>.ts, annotate the object as Texts, and register that id in the map in UI/src/i18n.ts. A missing or extra key fails the UI build.

The game passes its locale id through unchanged. The UI uses an exact match (pt-BR), then the language prefix before - or _ (de-DE uses de), then English. Keep {0} and {n:d} placeholders in messages.

Test without the game

The browser mock and geometry checks do not require Cities: Skylines II, its modding tools, or CSII_TOOLPATH. On a Windows development machine, install the .NET 8 SDK and Node.js 18 or newer, then run:

cd UI
npm ci
npm run mock:start

Open http://localhost:8765/. The mock uses the production C# planning sources, but simulates the game's bindings and assets. For automated UI tests, install Playwright's browser once with npx playwright install chromium, then run npm run test:ui. The test host restores UnityMathematics.NoDeps from NuGet; it does not use a DLL from a game or modding-tool installation. See tests/README.md for coverage and limitations.

Build and deploy

cd UI
npm install
cd ..
dotnet build -c Debug

When UI/node_modules is present, the C# build also builds and deploys the UI bundle.

UI tests

The browser mock renders the real UI components without launching the game. To build it and run the Playwright workflow tests:

cd UI
npm ci
npx playwright install chromium
npm run test:ui

See tests/README.md for mock and batch-test details.

Credits

The polygon interaction and entity-transfer pattern are adapted from ParkingLotTool, licensed under GPL-3.0. ParkManager has no runtime dependency on it. Continuous fence spacing follows the mesh-bounds-based fence mode in Advanced Line Tool, licensed under Apache-2.0; ParkManager has no runtime dependency on that mod either.

About

Procedural park generator for Cities: Skylines II

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages