Adding Moves to Pokestar

Quick Reference

Files to modify:

1. src/enums/battleEnums.js - Add moveIdEnum.YOUR_MOVE entry (ONLY if not exists)
2. src/battle/data/moves.js - Add the move implementation

DO NOT modify other moves or battleConfig.js unless explicitly asked.

Move Structure

javascript
1[moveIdEnum.MOVE_NAME]: new Move({
2  id: moveIdEnum.MOVE_NAME,
3  name: "Move Name",
4  type: pokemonTypes.TYPE,           // FIRE, WATER, GRASS, etc.
5  power: 80,                         // Base damage (null for non-damaging)
6  accuracy: 100,                     // Hit chance % (null = always hits)
7  cooldown: 3,                       // Turns before reusable
8  targetType: targetTypes.ENEMY,     // ENEMY, ALLY, ANY
9  targetPosition: targetPositions.FRONT, // FRONT, BACK, ANY, SELF, NON_SELF
10  targetPattern: targetPatterns.SINGLE,  // See references/target-patterns.md
11  tier: moveTiers.POWER,             // BASIC, POWER, ULTIMATE
12  damageType: damageTypes.PHYSICAL,  // PHYSICAL, SPECIAL, OTHER
13  description: "Move description",
14  execute() { /* implementation */ },
15}),

Execute Context

NOTE: The execute function binds this to the MoveInstance.js MoveInstance class, with properties such as:

Example Properties:

• this.source - User of the move
• this.primaryTarget - Main target selected
• this.allTargets - All affected targets (based on pattern)
• this.missedTargets - Targets that were missed
• this.battle - Battle instance
• this.power, this.type, this.id - Move properties

Example Generic Methods

All generic methods are available in MoveInstance.js. These are some common examples:

javascript
1// Deal damage to all targets
2this.genericDealAllDamage();
3// Returns { damageInstances: {targetId: damage}, totalDamageDealt: number }
4
5// Custom damage calculation
6this.genericDealAllDamage({
7  calculateDamageFunction: (args) =>
8    this.source.calculateMoveDamage(args) * 1.5,
9  offTargetDamageMultiplier: 0.5,
10  backTargetDamageMultiplier: 0.7,
11  attackOverride: this.source.getStat("def"),
12});
13
14// Apply status (BURN, PARALYSIS, FROZEN, SLEEP, POISON)
15this.genericApplyAllStatus({
16  statusId: statusConditions.BURN,
17  probability: 0.3,
18});
19
20// Apply effect (see references/effects.md)
21this.genericApplyAllEffects({
22  effectId: "atkUp",
23  duration: 3,
24  probability: 0.5,
25});
26
27// Single target effect
28this.genericApplySingleEffect({
29  target: this.primaryTarget,
30  effectId: "shield",
31  duration: 3,
32  initialArgs: { shield: 100 },
33});
34
35// Combat readiness
36this.genericChangeAllCombatReadiness({ amount: 25, action: "boost" }); // or "reduce"
37
38// Healing
39this.genericHealAllTargets({ healPercent: 25 });
40this.genericHealSingleTarget({ target, healAmount: 100 });

Move Tags

Optional tags array for ability interactions:

• "punch" - Boosted by Iron Fist ability
• "slice" - Boosted by Sharpness ability
• "charge" - Two-turn move

Dynamic Move Properties

Use overrideFields to change properties based on context:

javascript
1overrideFields: (options) => {
2  if (options.source?.speciesId === pokemonIdEnum.SPECIAL_FORM) {
3    return { power: 120, description: "Enhanced version" };
4  }
5},

Useful BattlePokemon Methods

• pokemon.getStat("atk") - Get effective stat
• pokemon.hasType(pokemonTypes.FIRE) - Check type
• pokemon.applyEffect(id, duration, source, initialArgs)
• pokemon.dispellEffect(effectId) - Remove effect
• pokemon.removeStatus() - Clear status condition
• pokemon.dealDamage(amount, target, info) - Deal damage
• pokemon.giveHeal(amount, target, info) - Heal
• pokemon.boostCombatReadiness(source, amount)
• pokemon.getPartyPokemon() - Get ally array
• pokemon.isFainted - Check if fainted

References

• references/target-patterns.md - Visual guide to target patterns
• references/effects.md - List of all buff/debuff effect IDs
• references/pattern-*.md - Code examples for common move types