Skip to main content

Game versioning

Semantic versioning and build numbers serve different purposes, although they are both essential for managing game updates.

Semantic Version​

  • Format: MAJOR.MINOR.PATCH (e.g., 1.2.3)
  • Purpose: Communicates the nature of changes
    • MAJOR: Introduces incompatible changes or a significant update (e.g., a major redesign or overhaul).
    • MINOR: Adds backward-compatible features (e.g., new levels or mechanics in the game).
    • PATCH: Fixes bugs or makes minor backward-compatible improvements.
  • See https://semver.org/ for more info

Build Number​

  • Format: A simple integer (e.g., 69, 404, 20241119).
  • Purpose: Identifies a specific iteration of the game build for internal tracking.
Info

ShipThis will automatically increment the Build Number after each successful build, but you must manually change the Semantic Version.

Editing Version Numbers​

To show the current version information, run the game details command:

It will output the current values:

david@sal9000:~/game$ shipthis game details
GAME DETAILS
Game Engine           godot
Game Engine Version   4.3
iOS Bundle ID         com.shotgun.steve.xii
Android Package Name  N/A
Semantic Version      0.0.1
Build Number          3

Editing the Semantic Version​

Editing can be done with the --semanticVersion parameter:

Editing the Build Number​

Editing can be done with the --buildNumber parameter:

Info

After editing the version numbers, you will need to rebuild your game with shipthis game ship