CSM is an in-development multiplayer mod for Cities: Skylines. The mod aims to provide a simple client-server experience. All players will share and sync the same resources such as money, costs, demand etc. Hopefully in the future roads and terrain will also be synced. Further in the future, I would like to implement the ability to have separate cities / income and make use of steams lobby / multiplayer system. Buy as this is only proof of concept for now, nothing can be guaranteed.

It should be noted that I'm currently developing this mod in my free-free time. Once the mod is more mature, contributions would be much appreciated. In the mean time, I'll try add as many notes as possible below to help any development efforts.

This project is licensed under MIT.

Initial phase for setting up the mod.

• Build Basic UI
• Allow basic connect, disconnect and host. Currently broken in game

Make the mod easier to develop for/run. Build server management (kick users, view users). Allow sending messages through chat (works both in game and for debugging.

• Automatic Build Script.
• Keep track of and view clients connected to a server.
• Client can request a list of other clients connected to the server.
• Build event system around client join, leave etc.

TBD

The mod can manually installed using the built in scripts. The following steps will guide you though this. Please note: You will need to have Visual Studio 2017 & Cities: Skylines installed, be running Windows 10 and have developer mode enabled. This script will automatically pull in the required files (after specifying a folder), build the mod and then install it.

1. Open the scripts folder.
2. Run the following command in powershell .\build.ps1 -Update -Build -Install. This will match the mod to your game, build it and then install it.
3. When you run this script, it will ask you for your steam folder. This is just the root folder of steam, e.g 'C:\Program Files\Steam'
4. Run Cities: Skylines and enable the mod. The mod can also be built and installed when the game is running (in most cases).

1. Create a new game / open an existing game.
2. Click the Show Multiplayer Menu button in the top-left of your screen.
3. To host a game click on Host Game.
4. To join a game click on Join Game and enter the required information.

This repository is split into two projects. CSM and CSM.Testing. CSM is the base project and contains all logic for the mod. CSM.Testing on the other hand helps simplify testing of multiplayer elements without having two games open.

The wiki contains more information, but I'm aiming to transfer that information to this file.

Ideally you should be running the latest version of Visual Studio 2017 on Windows 10.

This mod uses the client-server model. A user will setup their game as a server and transmit information like currency, roads, needs etc. to all connected clients. Clients will connect to the server and retrieve currency, roads, needs etc. from the server, updating the client UI.

This is all done by running a UDP server alongside Cities Skylines. This UDP server will interact with the extension methods in the ICities DLL. It is important that we extend and override the base methods for these extensions (as we override some values).

Below is information that I have jotted down about the flow of this mod.

Server:

1. Open a level (new or existing).
2. "Show Multiplayer Menu" --> "Host Game". User enters port and password (optional).
3. Server is setup and message process queue is started. (Networking/Server.cs)

Message Queue:

• Parse incoming messages and call appropriate event handlers (UpdateEconomy etc.)
• On extension changes, send a packet to all clients.

Client:

• User launches game, enabled mod, loads a level.
• Click "Show Multiplayer Menu" --> "Join Game".
• Enter game IP address / port.
  • Unload the level
  • Connect the client using Networking/Client.cs.
  • Client connects to server (try) and performs setup functions (check mods same etc.)
  • Update the client to mirror the server
  • On all events, update the server.
  • On incoming message, update client UI.

Here is a list of extensions that can be used in the ICities.dll (not much documentation elsewhere).

We can use these extension methods to sync which areas have been bought.

We can use this to find out where builds are. Looks like it may be quite complicated. Guess we will see.

This really is not that important, (I personally don't really like the "Twitter" like feature), but it can still be implemented. On Server we send the new chirper message to the clients on OnNewMessage event. Client side we ignore these chirpers.

This extension will allow us to synchronize demand across all connected clients. More research is required, but from what I understand, we need to override the OnCalculate*Demmand methods to grab the calculated demand from the server. On the server we will access the demand manager to get the current demand. The OnUpdateDemand method will also be used for server-client syncing.

Currently looking at implementing OnUpdateMoneyAmount to sync money between clients. Some basic testing showed that this was only updating the UI? Need to look further into it.

This has a different naming scheme for some reason? This would be used for syncing disasters (going to be interesting to setup)

todo

todo

todo

todo

todo

todo

todo