Wielder Modding

Create your own Wielders with custom stats, sprites, portraits and even sounds.

 
 
 

Custom wielders consist of the following files

  1. Wielder Json (Required): This file serves as the cornerstone, detailing the wielder's name and statistics, providing the foundation for their presence in the game.

  2. Portrait Image: The visual representation of the wielder, presented as a portrait.

  3. Fullbody Image: This image acts as a background for the wielder's inventory.

  4. Sprite Json: This file outlines the animation frames for the wielder's sprite image.

  5. Sprite Image: Containing the artwork that used for animating the wielder.

  6. Sprite Team Color Image: This image contains the team color overlay, ensuring that wielders have the same color as their team.

 
 

MyWielder.Json

{
  "type" : "wielder",
  "name": "My cool wielder",
  "shortName" : "Mr. Cool",
  "description" : "My cool description",
  "title" : "Mr Cool",
  "sprite" : "MyWielderSprite",
  "portrait" : "MyWielderPortrait",
  "sketch" : "MyWielderFullbodySketch",
  "faction" : "Arleon",
  "class" : "Commander",
  "race" : "Human",
  "selectableInTheLevelEditor" : "true",
  "showInCodex" : "true",
  "usage" : "Campaign",
  "selectionAudio" : "MyAudioFile",
  "deselectionAudio" : "MyAudioFile",
  "deathAudio" : "MyAudioFile",
  "storeAudio" : "MyAudioFile",
  "ejectAudio" : "MyAudioFile",
  "tradeAudio" : "MyAudioFile",
  "spawnAudio" : "MyAudioFile",
  "reviveAudio" : "MyAudioFile",
  "cost" : [
    {
      "type" : "Gold",
      "value" : "2500"
    }
  ],
  "selectionAudio" : ["MyWielderAudio"],
  "defense" : "0",
  "offense" : "15",
  "movement" : "16",
  "viewRadius" : "12",
  "order" : "0",
  "creation" : "0",
  "chaos" : "0",
  "arcana" : "0",
  "destruction" : "0",
  "statuses": ["Human"],
  "skillPool" : "Commander",
  "spellDamagePowerPercent" : 0,
  "pillageBonusPercent : 0,
  "skills" : [
    {
      "type": "Fast",
      "level" : 1
    },
    {
      "type": "Command",
      "level" : 3
    }
  ],
  "specializations" : 
  [
    "SpecializationSpellDamage",
    "SpecializationTroopMove"
  ],
  "units" : [
    {
      "faction" : "Arleon",
      "unit" : 3,
      "size" : 8,
      "upgrade" : "Vanilla"
    }
  ],
  "portraitPivotOffset" : "0x0",
  "canGenerateZombies" : false
}
//        
// must be exactly "wielder"
// custom text or language key
// A shorter version of the name, custom text or language key
// custom text or language key
// custom text or language key
// link to sprite-json or built in wielder
// link to png file or built in wielder
// link to png file or built in wielder
// Arleon, Loth, Barya, Rana
// Erudite, Commander, Warden, Reaver, Magi, Chosen, Freeblade, Tinkersmith, Mercenary, Raider, Seer, Awakened
// Human, Faey, Undead, Rana, Beast, Harima
// let other players use it in their levels?
// does it show up in the codex?
// Normal, Campaign (don't show up on skirmish levels)
// (Optional) The audio file to play when selected
// (Optional) The audio file to play when deselected
// (Optional) The audio file to play when dying
// (Optional) The audio file to play when stored in a building
// (Optional) The audio file to play when ejected from a building
// (Optional) The audio file to play when trading
// (Optional) The audio file to play when spawned
// (Optional) The audio file to play when revived
// the cost of purchasing the wielder (can contain multiple entries, e.g Gold and AncientAmber)
//
// Gold, Wood, Stone, AncientAmber, Glimmerweave, CelestialOre
// the amount
//
//
// link to an ogg audio file
// the defense stat
// the offense stat
// movement on the adventure map
// view radius on the adventure map
// order essence
// creation essence
// chaos essence
// arcana essence
// destruction essence
// Human, Faey, Undead, Musician, Rana, Beast, Harima,
// Awakened, Cecilia, Chosen, Commander, Empty, Erudite, Freeblade, Magi, Mercenary, Raider, Reaver, Seer, Tinkersmith, Warden
// The damage power bonus to spell (1=100%)
// The pillage bonus (1=100%)
//
//
// Arcana, Archery, Attuned, Brutal, Channeling, Chaos, Command, Creation, Cunning, Destruction Diplomacy, EssenceBurst, EssenceLeech, Fast, Guard, HandToHand, Learning, Levy, MagicResistance, March Melee, Order, Positioning, PowerRange, PowerShielded, Prepared, ProduceAmber, ProduceCelestial, ProduceGlimmer, ProduceStone, ProduceWood, Raider, Rigor, Scouting, SpeedOfWinds, Taxes, Tutor
// the level of the skill
//
//
// the Command skill determines troop slot count
// 3 troops
//
//
// A list of specializations (see more below)
//
// The exact name of a specialization
// The exact name of a specialization
// 
// can be as many as the current command skill
// 
// Arleon, Loth, Barya, Rana, Neutral
// 0-7 depending on the faction
// the stack size of this unit
// Vanilla, Upgraded, SuperUpgraded (not applicable for all units)
//
//
// The added offset of the portrait used to fine tune portrait placement
// if true the wielder can generate zombies after battle (defaults to true if faction is Loth))
//
 


DEFAULT VALUES

Values missing from the above json will be replaced by the default values of Cecilia Stoutheart unless the sprite points toward another build in wielder. In that case values will be replaced by that wielder instead.

 SPECIALIZATIONS

Specializations can’t currently be freely specified but must be from the following list:

SpecializationArcana, SpecializationChaos, SpecializationCreation, SpecializationDestruction, SpecializationDreathDamage, SpecializationFaeyOffense, SpecializationHarimaOffense, SpecializationHumanDefense, SpecializationHumanOffense, SpecializationHunterDamage, SpecializationIncome, SpecializationOrder, SpecializationRanaDefense, SpecializationRanaOffense, SpecializationRangedDamage, SpecializationRangedResistance, SpecializationRatsHP, SpecializationRavagerMove, SpecializationSpellDamage, SpecializationSpellResistance, SpecializationTroopMove, SpecializationTroopRangedRange, SpecializationUndeadOffense

 
 

MODDING BUILD IN WIELDERS

It's not possible to overwrite a build in wielders values, but you can base your own wielders artwork and values on them by writing a build in wielders identifier as your sprite. The same goes for portrait and sketch as well, which can either point to another wielder or be completely left out of the file.

Here is a list of all currently build in wielders: (please note that their identifiers and in-game name might not be the same)

Aleah, Ambertina, BaronAldus, BaronSilverlink, Bihgli, BrotherHillar, Cecilia, Cheekham, Coral, DoctorMarjatta, EthylleErnaline, Everthink, GiandraStormspire, Gnaw, Itchamo, LadyElisaHammond, MagnoliaSilverlink, MagnoliaSilverlinkVanilla, Mehry, Merkoth, Msugna, Nimander, Pcha, Peradine, Rasc, RascVanilla, Ravenfayre, RikTap, Rlac, Roderick, Rosewater, Sanaz, Silkspool, SlaKin, Soughtfor, Tchyra, ViljaOfThornecliff, Wiesh

 
 

Artwork

 

PORTRAIT

A portrait with a transparent background, preferably masked using a circle to fit the Wielder frames.

Recommended size: Square (e.g 320x320px or 512x512px)

FULLBODY SKETCH

An image used in the background of the inventory screen. A completely white background and dark features works best.

Recommended size: 768x1024px

 
 

MYWIELDERSPRITE.JSON

{
  "type" : "sprite",
  "scale" : "1.0",
  "layers": [
    {
      "name" : "Default",
      "tags" : ["billboard"],
      "subLayers" : [
        {
          "material" : "Default",
          "texture" : "MyWielder"
        }
      ],
      "animations" : [
        {
          "name" : "Idle",
          "playMode" : "LOOP",
          "rate" : "6",
          "frames" : [
            {
              "uv" : [0, 64, 64, 64]
            },
            ...
          ]
        },
        ...
      ]
    }
  ]
}
//        
// must be exactly "sprite"
// the scale of the artwork (usuall 1.0)
// a sprite can have multiple layers
// 
// the name of the layer (usually Default)
// billboard indicates that the sprite should always face the camera
// there can be any number of sub layers
// 
// Default, TeamColorMaterial
// link to png file
//
//
// a list of animations
//
// Idle, MoveDown, MoveUp, MoveLeft
// Default, LOOP, STOP
// the speed of the animation in frames per second
// the frames of the animation
//
// the location of the frame inside the texture
// 
// more frames
//
//
// more animations
//
//
//
//
 
 

SPRITE SHEET

A sprite sheet containing the animation frames of the Wielder.

Recommended size: Any

TEAM COLORS

The exact same size and layout as the sprite but containing grayscale team colors that will be replaced in-game.

This template shows what greyscale value will result in what color.