Contributing / Writing Code

The most important rules:

• Committed Code must compile with Java 21 (system requirement by MATSim, current as of MATSim 2025.x)
• Only commit to your personal playground, unless you are a contrib maintainer or you have been given the rights to commit in other locations.

The following sections contain more information for writing code for MATSim:

• Coding Conventions
• Naming Conventions
• Committing to the Repository
• Data in the source repository
• Configuration conventions
• Documenting your code
• IDE Configuration
• Java-related Information
• MATSim Extensions
• Prefer composition / delegation over inheritance
• Using Generics