jutsu-creator

Skill Creator - SHINOBI WAY Jutsu Generator

This skill helps create new game skills (jutsu) for the SHINOBI WAY: THE INFINITE TOWER roguelike game.

When to Use

Activate when the user wants to:

• Create a new jutsu or skill
• Add a new ability or technique
• Design a combat skill
• Balance or modify existing skills

Workflow

Step 1: Gather Basic Info

Ask the user for:

1. Skill Name - The jutsu name (e.g., "Fireball Jutsu", "Chidori")
2. Skill ID - Lowercase with underscores (e.g., fireball, chidori_stream)
3. Tier - BASIC, ADVANCED, HIDDEN, FORBIDDEN, or KINJUTSU
4. Description - Flavor text explaining what the skill does

Tier Guidelines:

Step 2: Determine Action Type

Ask the user which action type:

• MAIN: Ends your turn - primary attacks and jutsu (default)
• TOGGLE: Activate once (ends turn), pays upkeep cost per turn
• SIDE: Free action BEFORE Main, max 2 per turn (setup/​utility)
• PASSIVE: Always active, no action required (permanent bonuses)

Action Type Rules:

Step 3: Determine Element & Damage Type

Element (for elemental interactions):

• FIRE, WIND, LIGHTNING, EARTH, WATER (elemental cycle: Fire > Wind > Lightning > Earth > Water > Fire)
• PHYSICAL (taijutsu)
• MENTAL (genjutsu)

Damage Type (determines which defense applies):

• PHYSICAL - mitigated by Strength
• ELEMENTAL - mitigated by Spirit
• MENTAL - mitigated by Calmness
• TRUE - bypasses ALL defenses (FORBIDDEN/​KINJUTSU only)

Damage Property:

• NORMAL - subject to both flat and % defenses
• PIERCING - ignores flat defense, only % applies
• ARMOR_BREAK - ignores % defense, only flat applies

Attack Method:

• MELEE - hit chance uses Speed vs Speed
• RANGED - hit chance uses Accuracy vs Speed
• AUTO - always hits (genjutsu, some DoTs)

Step 4: Set Costs & Cooldown

• chakraCost: Chakra consumed (0 for taijutsu, 15-150 for jutsu)
• hpCost: HP sacrificed (usually 0, used for forbidden/​physical techniques)
• cooldown: Turns before reuse (0-10, higher for powerful skills)
• upkeepCost: For TOGGLE skills, CP or HP paid each turn while active

Step 5: Damage Scaling

• damageMult: Base multiplier (1.5-10.0 range based on tier)

• scalingStat: Which stat scales damage
  • STRENGTH - taijutsu
  • SPIRIT - ninjutsu/​elemental
  • SPEED - fast attacks
  • ACCURACY - ranged/​precision
  • CALMNESS - genjutsu
  • INTELLIGENCE - complex jutsu

Step 6: Effects (Optional)

Add status effects on hit. See skill-interface.md for all effect types.

Common patterns:

• DoT: BURN, BLEED, POISON with value (damage), duration, chance
• CC: STUN, CONFUSION, SILENCE with duration, chance
• Buff: BUFF with targetStat, value (multiplier), duration
• Debuff: DEBUFF with targetStat, value (reduction), duration
• Shield: SHIELD with value (HP absorbed), duration
• Drain: CHAKRA_DRAIN with value

Step 7: Requirements (Optional)

• intelligence: Minimum INT to learn (see tier guidelines)
• clan: Restrict to specific clan (Clan.UCHIHA, etc.)

Step 8: Special Properties (Optional)

• critBonus: Extra crit chance % (5-30)
• penetration: % defense ignored (0-0.5)
• isToggle: True for stance skills (auto-set if actionType is TOGGLE)
• upkeepCost: Chakra/​HP per turn while toggle active
• sideActionLimit: Max uses per turn for SIDE skills (default 1)
• passiveEffect: For PASSIVE skills, define stat bonuses

Step 9: Skill Image (Optional)

Ask if the user has a background image for the skill.

• image: Path to the skill image relative to project root
• Format: /​assets/​skill_[skill_id].png
• Example: /​assets/​skill_fireball.png

Output Format

Generate TypeScript code ready to add to src/​game/​constants/​index.ts:

SKILL_NAME: {
  id: 'skill_id',
  name: 'Skill Display Name',
  tier: SkillTier.TIER,
  description: 'Flavor text description.',
  actionType: ActionType.MAIN,  // MAIN/​TOGGLE/​SIDE/​PASSIVE
  chakraCost: 0,
  hpCost: 0,
  cooldown: 0,
  currentCooldown: 0,
  damageMult: 0.0,
  scalingStat: PrimaryStat.STAT,
  damageType: DamageType.TYPE,
  damageProperty: DamageProperty.PROPERTY,
  attackMethod: AttackMethod.METHOD,
  element: ElementType.ELEMENT,
  requirements: { intelligence: 0 },
  effects: [{ type: EffectType.TYPE, value: 0, duration: 0, chance: 0.0 }],
  image: '/​assets/​skill_skill_id.png'
},

TOGGLE Skill Output

TOGGLE_SKILL: {
  id: 'toggle_id',
  name: 'Toggle Skill Name',
  tier: SkillTier.HIDDEN,
  description: 'Toggle description.',
  actionType: ActionType.TOGGLE,
  chakraCost: 10,        // Activation cost
  hpCost: 0,
  cooldown: 5,
  currentCooldown: 0,
  damageMult: 0,
  scalingStat: PrimaryStat.INTELLIGENCE,
  damageType: DamageType.PHYSICAL,
  damageProperty: DamageProperty.NORMAL,
  attackMethod: AttackMethod.AUTO,
  element: ElementType.PHYSICAL,
  isToggle: true,
  upkeepCost: 5,         // Cost per turn while active
  effects: [
    { type: EffectType.BUFF, targetStat: PrimaryStat.SPEED, value: 0.3, duration: -1, chance: 1.0 }
  ]
},

SIDE Skill Output

SIDE_SKILL: {
  id: 'side_id',
  name: 'Side Skill Name',
  tier: SkillTier.BASIC,
  description: 'Setup/​utility description.',
  actionType: ActionType.SIDE,
  chakraCost: 5,
  hpCost: 0,
  cooldown: 3,
  currentCooldown: 0,
  damageMult: 0,         // Usually 0 for SIDE skills
  scalingStat: PrimaryStat.DEXTERITY,
  damageType: DamageType.PHYSICAL,
  damageProperty: DamageProperty.NORMAL,
  attackMethod: AttackMethod.AUTO,
  element: ElementType.PHYSICAL,
  effects: [{ type: EffectType.SHIELD, value: 30, duration: 1, chance: 1.0 }]
},

PASSIVE Skill Output

PASSIVE_SKILL: {
  id: 'passive_id',
  name: 'Passive Skill Name',
  tier: SkillTier.BASIC,
  description: 'Permanent bonus description.',
  actionType: ActionType.PASSIVE,
  chakraCost: 0,
  hpCost: 0,
  cooldown: 0,
  currentCooldown: 0,
  damageMult: 0,
  scalingStat: PrimaryStat.STRENGTH,
  damageType: DamageType.PHYSICAL,
  damageProperty: DamageProperty.NORMAL,
  attackMethod: AttackMethod.AUTO,
  element: ElementType.PHYSICAL,
  passiveEffect: {
    damageBonus: 0.1,    // +10% damage
    regenBonus: { chakra: 3 }  // +3 CP/​turn
  }
},

Reference Files

• skill-interface.md - Full Skill interface and enum definitions
• examples.md - Example skills from the game

Balance Guidelines

Damage by Tier

Cooldown Standards

SIDE Action Rules

1. No direct damage - Exception: Phoenix Flower (weak chip)
2. Max 2 per turn - Prevents infinite buff stacking
3. Setup focus - Designed to enhance MAIN actions
4. Long cooldowns (3-5 turns) - Can't spam same buff

TOGGLE Balance

1. Activation costs turn - Opportunity cost to enable
2. Meaningful upkeep - 5-10 CP or HP per turn
3. Counter-play exists - Silence/​Chakra Drain shuts them down
4. Strong but unsustainable - Resource drain forces decisions

PASSIVE Balance

1. Small but meaningful bonuses - +5-10% stats, +3-5 regen
2. Stat requirements - Gate powerful passives behind stat thresholds
3. Slot-limited - Players can only equip 2-3 passives