02. Passive Skills

📄 JSON Structure & Schema

You can add passive abilities directly to a weapon category via JSON.

{
  "passive_skill": "namespace:skill_id"
}

⚠️ CRITICAL WARNING: Some weapon passives explicitly require an accompanying Innate Skill to function (Like WoM Passive Skills). Mapping incompatible combinations or missing required skills may lead to immediate game crashes.

Note: This feature is strictly designed for "Weapons Passive Skills". Applying other skill archetypes here will yield no effect.

---

⚔️ Combat Application

Adding the passive ability of a katana, which allows the player to sheath their katana after a certain amount of time.

In this complete example, we see how to assign the passive ability in the Weapon Type Datapack, and we also see that to use this passive ability, we need to work with the Skills Datakeys (see Skill Datakeys & Styles).

{
  "collider": {
    "number": 5,
    "size": [0.4, 0.4, 0.7],
    "center": [0.0, 0.0, -0.7]
  },
  "category": "uchigatana",
  "passive_skill": "epicfight:battojutsu_passive",
  "hit_particle": "epicfight:hit_blade",
  "hit_sound": "epicfight:entity.hit.blade",
  "swing_sound": "epicfight:entity.weapon.whoosh",
  "styles": {
    "default": "two_hand",
    "cases": [
      {
        "style": "two_hand",
        "conditions": [
          {
            "predicate": "epicfight:offhand_item_category",
            "category": "not_weapon"
          }
        ]
      },
      {
        "style": "sheath",
        "conditions": [
          {
            "predicate": "epicfight:passive_skill_boolean_data_key",
            "skill_data_key": "epicfight:sheath",
            "expected_value": true
          }
        ]
      }
    ]
  },
  "livingmotion_modifier": {
    "two_hand": {
      "swim": "epicfight:biped/living/hold_uchigatana",
      "kneel": "epicfight:biped/living/hold_uchigatana",
      "float": "epicfight:biped/living/hold_uchigatana",
      "sneak": "epicfight:biped/living/walk_uchigatana",
      "idle": "epicfight:biped/living/hold_uchigatana",
      "fall": "epicfight:biped/living/hold_uchigatana",
      "run": "epicfight:biped/living/run_uchigatana",
      "walk": "epicfight:biped/living/walk_uchigatana"
    },
    "sheath": {
      "swim": "epicfight:biped/living/hold_uchigatana_sheath",
      "kneel": "epicfight:biped/living/hold_uchigatana_sheath",
      "float": "epicfight:biped/living/hold_uchigatana_sheath",
      "sneak": "epicfight:biped/living/hold_uchigatana_sheath",
      "idle": "epicfight:biped/living/hold_uchigatana_sheath",
      "fall": "epicfight:biped/living/hold_uchigatana_sheath",
      "run": "epicfight:biped/living/hold_uchigatana_sheath",
      "walk": "epicfight:biped/living/hold_uchigatana_sheath"
    }
  },
  "combos": {
    "two_hand": [
      "epicfight:biped/combat/uchigatana_auto1",
      "epicfight:biped/combat/uchigatana_auto2",
      "epicfight:biped/combat/uchigatana_auto3",
      "epicfight:biped/combat/uchigatana_dash",
      "epicfight:biped/combat/uchigatana_airslash"
    ],
    "sheath": [
      "epicfight:biped/combat/uchigatana_sheath_auto",
      "epicfight:biped/combat/uchigatana_sheath_dash",
      "epicfight:biped/combat/uchigatana_sheath_airslash"
    ]
  },
  "innate_skills": {
    "two_hand": "epicfight:battojutsu",
    "sheath": "epicfight:battojutsu"
  },
  "usable_in_offhand": false
}