Skip to main content

Game versioning

When ShipThis builds and publishes your Godot mobile games, two version numbers are associated with each build. These are the Semantic Version and the Build Number.

info

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

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

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

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

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

Editing the Semantic Version​

Editing can be done with the --semanticVersion parameter:

Build Number​

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

Editing the Build Number​

Editing can be done with the --buildNumber parameter: