About this mod
Easy Item Additions is a tool for modders that automates the file creation when adding new items to the game, with the help of WolvenKit console.
- Requirements
- Permissions and credits
- Donations
Currently the app can create the necessary files for all types of clothing, including outfits and wigs. All that you need to manually manage is the mesh files and their materials and textures.
Files that are created and managed by the app:
.archive - This is the packed mod file, ready to be installed.
.yaml - The file used by TweakXL to add the item to the game.
.xl - Installed together with the .archive file. Contains the relative paths to the .csv and the localization .json files.
info.json - Required when installing the mod as a REDmod.
init.lua - Created if you have added two icons (male and female) to any item. Requires Cyber Engine Tweaks.
.csv - Has the path to the group entity file.
Group .ent - The group entity file with all the items in the project. Links to the group .app file.
Group .app - Group appearance file that links to all the individual item .ent files.
Item .ent - Item entity files with paths to the mesh files. One item can have several entity files.
.inkatlas - The .inkatlas links to the icon texture .xbm file.
.xbm - The app can launch WolvenKit.CLI to convert image files (.png, .tga, .dds, .bmp, .jpg) to .xbm icon textures.
Localization .json - These are the localization files with item names and descriptions. One for each added language.
Files that the app does not handle:
.mesh files, textures and materials. You need to add these files to the project before packing it.
.inkatlas or .xbm icons that you have created yourself. These also need to be added manually.
Updates:
Version 2.1:
- The app can now add one of the default footstep sounds to a mod, used when wearing any feet items from that mod. For now it's only one option per mod, as the app will require more rework to be able to do separate sounds for each item.
- Added missing Equipment-Ex slots.
Version 2.0.4:
- Fixed an issue with browsing for icon files.
- Fixed a crash that occurred during editing when adding a male/female option to an item that didn't have it.
Version 2.0.2:
- The app will no longer create separate item entity files for each appearance.
- For recolors of already added items, you can select an existing entity file and the app will not create new ones.
- Hold Shift when clicking a chunkMask checkbox to toggle all.
From 2.0.1: Changed renderingPlaneAnimationParam for inner torso, outer torso and outfit items, so that arms don't clip through sleeves.
CHECK STICKY COMMENT FOR INFORMATION ON EXISTING PROJECTS.
Version 1.8.4:
- Small change to app creation to prevent crash when playing the Arasaka Tower 3D arcade game while wearing female only items.
Version 1.8:
- Added the force_FlatFeet visual tag.
- Holding Ctrl when clicking Create, Finalize, Pack, or Confirm Edit prevents the console window from closing.
Version 1.7:
- Small redesign to allow for resizing of the app window.
- Added new Phantom Liberty vendors to vendors list.
Version 1.6.9:
- Cleared too much data when loading project, like the project path. Oops!
Version 1.6.6:
- Fixed the updated entity templates for items with dangle physics.
- Removed empty confirmation box when creating new items.
- Added the force_Hair visual tag.
- Some data remained from previous project when loading another project, or creating a new project.
Version 1.6:
- Updated entity templates from latest WolvenKit.
- Fixed vendor crash from 2.0 changes.
- Requires version 1.11.0 or newer of WolvenKit.CLI.
Version 1.5.1:
- When editing item, partial fpp appearance would load chunkmask from fpp appearance.
Version 1.5:
- App now supports dangle physics for all appearances. Click the drop-down next to mesh path field and add .rig and .animgraph files.
- Entity files will be recreated on edit if they are missing.
Version 1.4.2:
- Removed "Re-create initial files on finalize" option. The .csv and info.json are instead created on finalize if they are missing.
- Entity files will only be recreated on edit if any meshes have been added, edited or removed. WolvenKit.CLI is not launched if changes only affect shared files.
Version 1.4:
- App can now add overrides for meshes from other items, when worn together.
- Added the new visual tags that were added to ArchiveXL: Chest, Collarbone, Upper Abdomen, Lower Abdomen. Requires ArchiveXL version 1.4.4 or newer.
- Added a new menu button, "Prepare to share", that will copy the packaged mod to "[project folder]\_share", with the correct folder structure, and zip it.
- App will now remove .ent files, if editing an item results in fewer .ent files than before. And some icon files if needed.
Version 1.3:
- Added "Run commands from batch file" option in settings. Use this if your app paths or project paths have non-english letters or characters.
- Hair meshes and partial hair should both get the correct hair color if used together.
- Editable drop-down lists (Item Name, Icon Location, Hair meshes) should no longer automatically change on lost focus.
Requirements:
The app requires .NET Desktop Runtime 6.0 to run.
The app requires WolvenKit.CLI 1.11.0 or newer to create items.
WolvenKit.CLI requires .NET Desktop Runtime 7.0 to run.
The game requires ArchiveXL and TweakXL to load any of the created items.
Credits:
psiberx - ArchiveXL and TweakXL.
WolvenKit team.
evafan84 - For their help finding bugs.