Files
Bullosseum/game_version.gd
T

34 lines
1.2 KiB
GDScript

class_name GameVersion
extends RefCounted
## Single source of truth for the game's version string.
##
## The numeric version lives in project.godot (application/config/version) so it
## also feeds export metadata; here we read it back and layer on the pre-release
## CHANNEL and a human-readable STAGE label. We're pre-1.0 — every 0.x build is
## understood to be unstable, in-development software (see the recommendations in
## the commit / PR notes for why 0.x is the convention for early game dev).
## Pre-release channel appended to the number, SemVer-style (e.g. 0.1.0-alpha).
const CHANNEL: String = "alpha"
## Friendly stage banner shown to players so it's unmistakably an early build.
const STAGE: String = "Early Development Build"
## Bare numeric version, e.g. "0.1.0". Read from project settings.
static func number() -> String:
return str(ProjectSettings.get_setting("application/config/version", "0.0.0"))
## Full version tag, e.g. "v0.1.0-alpha".
static func string() -> String:
var s := "v" + number()
if not CHANNEL.is_empty():
s += "-" + CHANNEL
return s
## Version tag + stage banner, e.g. "v0.1.0-alpha · Early Development Build".
static func full() -> String:
return "%s · %s" % [string(), STAGE]