GS - Player Class
A Godot asset for handling player classes.
Player classes (health, speed, loadout, abilities) as a small document a dedicated server can check without loading any content.
A class change is recorded and applied on the next spawn, so nobody changes health or weapons mid-fight. A dead player gets the change immediately.
Install
- Copy
addons/dot_player_class/,addons/dot_player/andaddons/dot_core/into your project. - Enable all three in Project > Project Settings > Plugins.
Needs Godot 4.7 or newer.
Use
var classes := DotPlayerClassManager.new()
classes.catalogue = DotPlayerClassCatalogue.team_shooter()
classes.rules = DotPlayerClassRules.standard()
classes.team_fn = func(key): return teams.team_of(key)
classes.alive_fn = func(key): return roster.get_record(key).alive
add_child(classes)
classes.setup()
var res := classes.request("ada", &"sniper")
if not res.ok:
hud.say(res.error.message) # "Your side already has 2 Sniper."
classes.pending_of("ada") # &"sniper", not active yet
classes.class_of("ada") # still the old class
classes.apply_pending("ada") # call on spawn
A class names its loadout, model, animation set and abilities; it does not contain them. A client resolves the ids to content through a catalogue.
Why a request is refused
Every refusal is a DotResult with a message for the player.
| Rule | Message |
|---|---|
limit_per_team |
"Your side already has 2 Sniper." |
teams |
"Breacher is not available to your side." |
requires_entitlement |
"You do not have Heavy." The check is supplied by your game. |
allow_midround_change |
"Classes are locked once the round has started." |
options_for(key) lists every class with available, why, taken and limit, for a class-select screen.
Classes
| Class | Purpose |
|---|---|
DotPlayerClassDef |
One class: health, armour and absorption, movement multipliers, mass, content ids, abilities, team restrictions, limits, entitlement. |
DotPlayerClassCatalogue |
The set of classes. Presets: single, team_shooter (six classes), asymmetric. |
DotPlayerClassRules |
When a choice may be made and when it lands. Presets: standard, instant, competitive, fixed. Layered like every DotConfig. |
DotPlayerClassManager |
Current and pending class, limits, entitlements, and a mirror for clients. |
Use single() for a game without classes, so health and speed come from the same place as in every other mode.
Armour: var hit := def.absorb(50.0, current_armour) returns health_damage and armour_left.
See docs/design.md.
Status and licence
Part of the Gamespice platform: a family of Godot addons. Written with Claude Code and maintained by gamemann. Every addon has headless tests, but little of this has been played by real users yet, so expect rough edges and please open an issue when you hit one.
MIT licence, see LICENSE. The only closed part of the Gamespice platform is the web back end; you can use your own instead of Gamespice's.
Engagement Over Time
GS - Player Class is a Godot asset. It has 2 downloads, 34 views, and 0 favorites. This item belongs to 1 collection and 2 tags.
Reviews
Log in to leave a review.
Comments (0)
Log in to comment.
