Import Custom Character โ
Assumes you already have your custom character defined in a Chara sheet. You can take reference from existing mods or Elin Sources.
CWL utilizes the tag cell of the Chara row to add features, you can add as many tags as you want. Remember, tags are separated by , (comma) with no spaces in between.
Test Your Changes โ
After loading a save and checked your character's data, you can make changes to the excel sheet while the game is running. After saving the changes, use the following console command:
cwl.remove_all charaId
cwl.data.load_sources trueReplace the charaId with your Chara's ID. After reloading sources, you can load the same save again and see the new changes applied.
Spawn on game load โ
To let CWL spawn the character to a zone, use tag addZone_* and replace the * (asterisk) with zone id or keep the asterisk for a random zone. You may also specify zone level with /n.
For example, to spawn the chara in little garden, use addZone_little_garden. To also spawn in derphy underground, use another tag addZone_derphy/-1. Check the SourceGame/Zone and reference the id column.
For each addZone tag used, an instance of the Chara will be spawned there. For example, addZone_lumiest,addZone_little_garden,addZone_specwing,addZone_* will make sure all three selected zones plus a random zone will have this character spawned (as duplicates).
Note that spawning characters in player's current zone (such as meadow when creating new game), characters will not appear until re-entering zone or reloading game.
WARNING
Starting from CWL 1.20.11, previous tags addZone_TypeName are now deprecated by the addZone_id tags shown above, but still accepted for compatibility.
Add equipment/thing โ
When CWL spawns your character, you may also define the starting equipments and things for this character, using tag addEq_ItemID#Rarity and/or addThing_ItemID#Count.
To assign specific equipment to the character, use tag addEq_ItemID#Rarity, where ItemID is replaced by the item's ID, and Rarity being one of the following: Random, Crude, Normal, Superior, Legendary, Mythical, Artifact. If #Rarity is omitted, the default rarity #Random will be used.
For example, to set a legendary BS_Flydragonsword and a random axe_machine as the main weapons for the character: addZone_Palmia,addEq_BS_Flydragonsword#Legendary,addEq_axe_machine
To add starting items to the character, use tag addThing_ItemID#Count. If #Count is omitted, a default of 1 item will be generated.
For example, to add padoru_gift x10 and scroll of ally x5 to the character: addZone_Palmia,addThing_padoru_gift#10,addThing_1174#5
Make an adventurer โ
Credits to 105gun.
If your character has trait AdventurerBacker, CWL will import the character as an adventurer, which will appear on the adventurer ranking list.
Prevent random visiting โ
Global characters randomly visit other towns if they are not in player's faction. You can use tag addFlag_StayHomeZone to make them stay in the home zone.
This flag can be changed in drama sheet using invoke* action and mod_flag(StayHomeZone, 0) method, with actor cell filled in target character's ID (or tg as the drama target).
Allow human speak โ
Instead of adding human or humanSpeak tag in the Race sheet, you can also use humanSpeak tag in Chara sheet to allow your character talk without parentheses.
Override Gender โ
You can use n instead of m or f in bio column to set character as ??? gender.
CWL also provides a comprehensive biography override which includes background edits.
WARNING
CWL used to provide a ? gender to represent ??? in bio column, Elin has added a n gender which does the same thing after 23.214 Nightly.
Define custom merchant stock โ
Use custom merchant stock data defined here: Custom Merchant.
Add Talks/Dialog โ
3 types of talks can be added here: Dialog & Drama.