Overview
The CharacterService manages the player’s character state using Angular signals and integrates with Convex for real-time database synchronization. It handles character stats, progression through stages and waves, and persists prestige-related progress.
Properties
character
character: WritableSignal<Character>
hasLoadedFromDb
hasLoadedFromDb: Signal<boolean>
Methods
updateDatabase
public updateDatabase(): void
id - Character identifierprestigeLevel - Current prestige levelprestigeMultipliers - Stat multipliers from prestigeprestigeCores - Available prestige currencygold - Current gold amountcurrentStage - Current stage numbercurrentWave - Current wave within stage
Usage:
characterService.updateDatabase();
This method is typically called by GameStateService.pushUpdatesToDatabase() rather than directly.
resetCharacter
Resets the character to base stats while preserving prestige progress. Called during prestige operations.
Preserved values:
prestigeLevelprestigeMultipliersprestigeCoresgold
Reset values:
level → 1- All base stats → 1
- All stat modifiers → 1
currentStage → 1currentWave → 1
Usage:
// Called during prestige
characterService.resetCharacter();
This method permanently resets character stats. Always call during prestige operations only.
advanceWave
Progresses the character to the next wave or stage. Increments wave number (1-10), and advances to the next stage when completing wave 10.
Logic:
- If current wave < 10: increment wave
- If current wave = 10: reset wave to 1 and increment stage
Usage:
// Called after defeating an enemy
characterService.advanceWave();
modifyStat
modifyStat(
stat: keyof Pick<
Character,
'level' | 'baseStrength' | 'baseIntelligence' | 'baseEndurance' | 'gold' | 'prestigeLevel' | 'prestigeCores'
>,
amount: number
): void
The stat to modify. Valid values: 'level', 'baseStrength', 'baseIntelligence', 'baseEndurance', 'gold', 'prestigeLevel', 'prestigeCores'
The amount to add (positive) or subtract (negative) from the stat
// Add 100 gold
characterService.modifyStat('gold', 100);
// Add 5 strength
characterService.modifyStat('baseStrength', 5);
// Add prestige cores
characterService.modifyStat('prestigeCores', 10);
If the resulting value would be negative, the stat is not modified.
spendPrestigeCores
spendPrestigeCores(cost: number): void
The number of prestige cores to spend
characterService.spendPrestigeCores(5);
This method does not validate if the character has enough prestige cores. Always check availability before calling.
spendGold
spendGold(cost: number): void
The amount of gold to spend
characterService.spendGold(150);
This method does not validate if the character has enough gold. Always check availability before calling.
Database Integration
The service uses Convex queries and mutations for real-time synchronization:
private getCharacterFromDatabase = injectQuery(api.character.getCharacter, () => ({}));
private databaseUpdateMutation = injectMutation(api.character.updateCharacter);
effect(() => {
const dbCharacter = this.getCharacterFromDatabase.data();
if (!dbCharacter) return;
if (this.hasLoadedFromDb()) {
// Merge updates after initial load
this.character.update((char) => ({ ...char, ...dbCharacter }));
} else {
// Initial load: merge with defaults
const merged = { ...defaultCharacter, ...dbCharacter };
this.character.set(merged);
this.hasLoadedFromDb.set(true);
}
});
Character interface definition.