KumoAddon: MobExtra

KumoAddon: MobExtra

An addon mod for KumoDesu: Ascension that extends the evolution and skill system to vanilla Minecraft mobs. Any entity with a JSON data file becomes a KumodesuMob with full stat tracking, leveling, skill usage, and growth — no code changes required.

Overview

KumoAddon: MobExtra lets you turn ordinary mobs (zombies, skeletons, creepers, etc.) into fully-featured Kumodesu creatures that participate in the Spider/Stats/Skills systems. Each mob gets its own stats, levels up, gains skill points, and can even use skills via GenericMasterSkillGoal.

Features

• Universal Mob System: Any LivingEntity can be converted by adding a JSON file — no entity registration or code needed
• Configurable Stats: Set base HP, MP, SP, Attack, Defense, Magic, Resistance, Speed via datapack JSON
• Growth Per Level: Define stat increases per level through growth_per_level in JSON
• Spawn Level Range: Roll a random spawn level with level_range (min/max) and apply growth_per_level for each level above 1
• Uncapped Leveling: Max level configurable (defaults to 99999), with can_level_up toggle
• Random Skill Points: Grant a random number of skill points on spawn using a min-max range
• Skill Usage: Enable GenericMasterSkillGoal for mobs to cast skills defined in mob_skills/ JSON configs
• Selective Stat Sync: Control which vanilla attributes to sync (health, speed, attack) — only syncs what you configure
• NBT Persistence: Level, stats, skills, cooldowns, and skill points persist across game saves
• Vanilla Attribute Fallback: Mobs without addon data still report their actual vanilla stats (health, attack, armor, speed) for appraisal and combat calculations
• No Main Mod Changes: Loads from its own kumo_mobextra data namespace, works alongside the main mod without conflicts

Requirements

• Minecraft: 1.20.1
• Forge: 1.20.1-47.x (47.2.0+)
• KumoDesu: Ascension 0.3.9+

JSON File Formats

Mob Data (mob_data)

Location: data/kumo_mobextra/mob_data/{namespace}/{entity}.json

{
  "evolution_id": "",
  "race_id": "",
  "max_level": 99999,
  "level_range": { "min": 1, "max": 10 },
  "can_level_up": true,
  "skill_points_per_level": { "min": 1, "max": 5 },
  "base_stats": {
    "raw_hp": 40,
    "raw_mp": 20,
    "raw_sp_yellow": 20,
    "raw_sp_red": 20,
    "raw_attack": 10,
    "raw_defense": 5,
    "raw_magic": 5,
    "raw_resistance": 5,
    "raw_speed": 10
  },
  "growth_per_level": {
    "hp": 5,
    "mp": 2,
    "sp_yellow": 2,
    "sp_red": 2,
    "attack": 3,
    "defense": 2,
    "magic": 2,
    "resistance": 2,
    "speed": 1
  },
  "can_use_skills": true,
  "sync_stats": ["health", "speed", "attack"]
}

level_range is optional (defaults to 1-1). On fresh spawn, the addon rolls an inclusive random level between min and max (clamped to max_level) and applies growth_per_level once per level above 1. Saved mobs keep their NBT level.

Mob Skills (mob_skills)

Location: data/kumo_mobextra/mob_skills/{namespace}/{entity}.json

{
  "mob_id": "minecraft:zombie",
  "global_cooldown": 20,
  "skills": [
    {
      "skill_id": "poison_fang",
      "level": 1,
      "frequency": 1.0
    },
    {
      "skill_id": "hit",
      "level": 1,
      "frequency": 2.0
    }
  ],
  "custom_mp_costs": {},
  "custom_sp_costs": {},
  "custom_cooldowns": {},
  "custom_casting_times": {}
}

Example: Converting Zombies

1. Create data/kumo_mobextra/mob_data/minecraft/zombie.json with your desired stats and config
2. (Optional) Create data/kumo_mobextra/mob_skills/minecraft/zombie.json to enable skill usage
3. Spawn zombies — they will spawn with the configured stats, health, skill points, and skills

How It Works

1. Capability Attachment: AddonMobCapability attaches a AddonMobData capability to any LivingEntity that has a matching mob_data JSON entry, looked up by entity type ID (e.g., minecraft:zombie)
2. Mixin Integration: LivingEntityMixin implements KumodesuMob on all LivingEntity instances, delegating to the capability data when present, or falling back to vanilla attributes
3. Skill Loading: AddonMobSkillLoader loads skill configs from kumo_mobextra:mob_skills/ and provides lookup by entity type ID
4. Spawning: On spawn (EntityJoinLevelEvent), the addon initializes resources (MP/SP to max), grants random skill points, loads skills, syncs configured attributes, and optionally injects GenericMasterSkillGoal
5. Leveling: Mobs gain EXP, level up with stat growth, and gain capacity bonuses from skill tiers — max level is capped at the configured max_level
6. Ticking: Every 10 ticks, syncs configured attributes. Skill cooldowns tick down. Regen follows the same MP/SP regen as player mobs.