You are viewing a potentially older version of this package. View all versions.
WackyMole-WackysDatabase-2.0.3 icon

WackysDatabase

WackysDatabase allows you to control all items/recipes/pieces/creatures/materials/textures via YML files with ServerSync and so much more.

Date uploaded a year ago
Version 2.0.3
Download link WackyMole-WackysDatabase-2.0.3.zip
Downloads 2494
Dependency string WackyMole-WackysDatabase-2.0.3

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2200 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2200

README

WackysDatabase

WackysDatabase is a mod for Valheim created by Wackymole & Rexabyte.

BlueMan BlueMan

Version: 2.0.3 Features

SetEffects: All of them!
4x more item configurations for Primary and Secondary Attacks
CustomIcons: Autogenerated or JPEG/PNG (64x64)
Add or remove conversions on smelter pieces
MaxCraftingStationLevel: YAML support
Mainscreen cloned items
Water Resistance is back
Slow Reload!
Visuals Modifier by Rexabit!
Seteffect by Azu!
Basic Creature cloning or replacing/renaming
Most components can be removed from YAML
sizeMultiplier: Make a small or HUGE world
Future Proof: Can add or remove components without much fuss

Description

WackysDatabase, or Wackydb, allows you to modify and customize items, pieces, recipes, effects, materials and creatures in Valheim without coding. With this mod, you can clone items, change their colors, create new items, and even translate language. It offers a wide range of possibilities for customization.

YML Knowledge

YML is easier to edit and change without getting confused on the syntac. 

You can use https://www.yamllint.com/ to validate any yml code

Almost every component of items/pieces/recipes/effects/creatures can be deleted.

Some components are multilined where you can actually add your own stuff the ymls.
Installation ### Installation****
Download and extract the latest version of WackysDatabase into the BepInEx plugin folder (usually Valheim/BepInEx/plugins).
Run Valheim and join a world.
Go to Valheim/BepInEx/config/ and locate the "wackysDatabase" folder.
Inside the "wackysDatabase" folder, you will find three subfolders: "Items," "Recipes," and "Pieces."
Put the mod on the server to force server sync. The YAML files only need to be on the server. There's no need to share the YAML files.

For multiplayer, the mod has been locked down to prevent easy cheating. However, it is recommended to use the AzuAntiCheat and ServerCharacters mods for additional security. AzuAntiCheat ServerCharacters

General Knowledge
There are five (6) Objects that WackyDB touches. Items, Recipes, Pieces, Creatures,  Materials and Textures

Items are things in your inventory, you can pickup and maybe equip them.

Recipes are used to construct items, CraftingStations can be workbench, forge, or hand crafted (craftingStation": "")

Pieces are what you use in your hammer and hoe to construct or plant. piecehammers

Creatures are mobs, bosses ect.

Materials are the basic "colors" in the game, but hold a lot more than just RBG, can they can be tricky to get just right.

Textures are .pngs that hold the feel, appearance, or consistency of a surface or substance.

Nost lines in the YAMLS can be deleted. Only the required ones need to be in the files, when the line is deleted the computer interprets that as a null value.

Null is like I don't know, so I don't care, use the orginal values. 

To delete the existing values you will use either '' for strings, "delete" for SE Effects or "-" for multiliners. 

jpeg or png. 64 x 64 px - name like wacky.png, Must be in Icon Folder (Not ServerSynced)
FAQ

Frequently Asked Questions

Q: Can I use custom icons for items?
    A: Yes, you can use autogenerated icons or provide JPEG/PNG icons (64x64) for customization.

Q: Can I add new items with this mod?
    A: Yes, you can create new items and make them exclusive.

Q: Can I remove components from YAML files?
    A: Yes, most components can be removed from the YAML files.

Q: Is the mod future-proof?
    A: Yes, you can add or remove components without much hassle.

Q: Does the Water resistant not work on set effect? Like m_mods: m_type: Water
    A: Water is a DamageModifiers that I added from Aedenthorn mod.  I don't have plans to add it to m_mods.
    
Q: Do you have a Video;
    A: Not yet, but YOU could make one!

Q: Is it possible to add a recipe for each upgrade of an item?
    A: Recipes are at a weird place in wackydb. I might split it out into a submod, but I am not sure yet. 

Q: My weapon clones are speedup/speed down. 
    A: The clones speed can change a little bit from their parents. Custom_AttackSpeed should always be 1 on a save. 
    If you notice a speed up or down a +- 0.1 should fix it.  
    FYI reminder that SpeedFactor deals with character movement speed while swinging/attacking and has nothing to do with speed of animation.

Q: What Folders do I need to give to my users?
    A: Textures, Objects, Icons will NOT SYNC. I also recommend including the cache folder. Cache keeps track of Item/mock clones and materials

Q: How can I export material without _mat suffix ? I succeeded to export draugr_mat, but how for goblin or greydwarves ? 
    A: It's is unfortunely not possible right now to get all of the mats because of how the devs named and made different things.
        If you have access to Unity you could look at the files themselves. 

Q: What lines can I delete or how can I make somethings empty?
    A: This is a long answer, but most lines in the YAMLS can be deleted. Only the required ones need to be in the files, when the line is deleted the computer interprets that as a null value.
        Null is like I don't know, so I don't care, use the orginal values. To delete the existing values you will use either '' for strings, "delete" for SE Effects or "-" for multiliners. 

Q: How do I make custom Icons?
    A: Make a png or jpeg 64 x 64 px. Put it in Icons folder. In the customIcon line, put the filename. ie. wacky.png

Q: Will there be even MORE features and can I edit effects?
    A: No, probably not. 

Q: Why are some of the SE Effects empty? Like SeData?
    A: Well its complicated, I am having to grab them in a weird way, and not all SEs have SeData. Nothing to be done about it. 

Q: What about Attack Projectile?
    A: I need to look at projectiles in the future, for now they are disabled.

Q: Would it be possible to have one item take 2+ different item slots ? (say weapon + pants)
    A: No, but you can edit two parts and one effect, which is effective when combined!
    If one of them is missing, then the two pieces of equipment have no effect, which can be regarded as a limitation
Configuration

Configuration

The configuration file for WackysDatabase is located at BepInEx/config/WackyMole.WackysDatabase.cfg. The available configurations and their default values are as follows:

  • Force Server Config: true (forces server sync)
  • Enable this mod: true
  • IsDebug: true (enables debug information)
  • StringisDebug: false (enables string debugging)
  • IsAutoReload: false (enables auto-reload instead of using wackydb_reload command)
  • NexusModID: 1825 (does not have much functionality)
  • DedServer load Memory: false (dedicated server loads objects into the game like a client)
  • ExtraSecurity on Servers: true (prevents loading into singleplayer and then loading into multiplayer)
  • FileWatcher for YMLs: true (reloads the mod on any changes to the wackydatabase folder on the server)
  • List of Extra Effects: "lightningAOE" (extra effects to look for from the base game or mods)
Console Commands

Console Commands

You will can reference https://valheim-modding.github.io/Jotunn/data/objects/item-list.html for Prefab names. Thank you JVL team

To use the console commands, press F5 in the game to open the game console. Make sure to enable the console for Valheim by adding "-console" to the launch options.

  • wackydb_reload: Reloads all the YML files in the wackysDatabase folder. : This now works for admins on server now. So you could turn off Filewatcher and just do a manual reload on your client and forces all clients to reload.
  • wackydb_reload_fast: Fast reload that may cause game stutter.
  • wackydb_save_recipe [ItemName]: Saves a recipe YML in the wackysDatabase Recipe folder.
  • wackydb_save_piece [PieceName]: Saves a piece YML in the wackysDatabase Piece folder.
  • wackydb_save_item [ItemName]: Saves an item YML in the wackysDatabase Item folder.
  • wackydb_save_creature [CreatureName]: Saves a Creature YML in the wackysDatabase Creature folder.
  • wackydb_save_material[MaterialName]: Saves a Material clone YML in the wackysDatabase Material folder. Usually has a _mat at end end.
  • wackydb_all_items: Saves all items in the game into wackyDatabase-BulkYML.
  • wackydb_all_recipes: Saves all recipes in the game into wackyDatabase-BulkYML.
  • wackydb_all_pieces [Hammer] [Optionally: Category]: Saves all pieces in the game into wackyDatabase-BulkYML. Use 'Hammer' for default, or specify a different hammer name. Optionally, you can set a category to only get specific pieces in a cat.
  • wackydb_all_se: Retrieves almost all status effects in the game (including modded effects) and saves them into the Effects folder.
  • wackydb_se [effectname]: Retrieves a specific status effect and saves it into the Effect folder.
  • wackydb_se_create: Creates a clone of SetEffect_FenringArmor in the Status folder. You can edit it as needed.
  • wackydb_help: Shows a list of commands.
  • wackydb_clone [recipe/item/piece/creatures/mat/materials] [Prefab to clone] [Unique name for the clone]: Clones an object and changes it differently than a base game object. For example: wackydb_clone item SwordIron WackySword.

--There is a optional 4th parameter for clone RECIPES ONLY [original item prefab to use for recipe](Optional 4th parameter for a cloned item's recipes ONLY) --For example you can already have item WackySword loaded in game, but now want a recipe. WackySword Uses SwordIron - wackydb_clone recipe WackySword RWackySword SwordIron - otherwise manually edit

  • wackydb_clone_recipeitem [Prefab to clone] [clone name]: Clones an item and recipe at the same time. The recipe name will be Rname.
  • wackydb_vfx: Saves a vfx.txt file with all vfx effects
  • wackydb_sfx: Saves a sfx.txt file with all sfx effects
  • wackydb_fx: Saves a fx.txt file with all fx effects
  • wackydb_help: command list
  • wackydb_describe[ObjectName]: Saves describe of an object, so you have an idea of the structure of the object for materials and customVisuals
  • wackydb_sendtheload : Experimental command that will send pngs and objs to clients utilizing ServerSync. I recommend the Network mod to uncap datarates.
  • wackydb_get_piecehammers: Saves all hammers, currently in your game to Hammer.txt file
  • wackydb_material : Generate a text file of all <Material> Gameobjects in vanilla game. Saves to text
  • wackydb_clearcache: Clears the current cache, materials and textures. Only do this after big yaml changes, cache is important - This command works on menu screen
Get Wacky

LongSwordBlueRed

Changing the SwordSilver to Blue and Increasing the size to 3

JustMaterials

This is just chaning the materials, not messing with CustomVisuals

Crazy Power

Setting the Class: AEffects and GEffects. This YML Spawn_On_Trigger: Boar spawn_on_hit: Neck spawn_on_terrain_hit: Deer - Trigger_Effect: - sfx_dragon_death

SwordIron YML

Fast attack

Custom_AttackSpeed: 5 . 500% faster goes brrr


Cache System

Cache Folder

The cache system is very important for Item/mock clones.

It allows material colors to show up on main menu and allows cloned items to be touched by other mods and treated like normal items.

It is so important now that I recommend including your cache folder on updates to your modpack, along with Textures, Objects, Icons

If a cloned is not cached for the first run, errors may appear for users as other mods try to touch a item that wasn't created until very late.

The next load logon should fix the issues.

Feel free to removed the cache folder for big changes, but try to leave it for normal usage


Materials and CustomVisuals

Materials and Custom

Please be patient with this documentation. There is a lot to this one and I am slowly trying to learn from Rexabyte. There may be inaccurate information here.

Useful tools

https://rgbcolorpicker.com/0-1

https://github.com/Wacky-Mole/WackysDatabase/tree/master/Documentation - You Are GOING TO NEED TO STUDY THIS!

Structures

Welcome to Rexabyte's Guide on Understanding Material Management by Wacky!

A Material is a powerful combination of a shader, texture, and color. For most items, a single material is sufficient, but more complex things like armors can utilize multiple materials.

To create a basic material, simply use the 'material' section and combine various _mats. Oh, by the way, "mat" or "mats" refer to materials and are often appended at the end of their names.

When describing an item's render using "wackydb_describe," you'll find the materials section with the current name of the mat.

To save or clone a material, employ the functions "wackydb_save_material [mat]" or "wackydb_clone [mat/material] [mat] [clonename]" The newly created material file can be found in the materials folder.

Now, let's get creative with adjustments! Most commonly, you'll be working with colors. Use https://rgbcolorpicker.com/0-1 to find the 0-1 values RGBA.

Textures play a vital role, particularly with armors and creatures. Remember, they are saved along with the material in PNG format. However, WackyDB won't automatically sync them, so you'll need to manually color or edit the texture files. Textures may use base vanilla ones like Red or Blue

Excitingly, changes to materials automatically update without requiring a reload. Icons, too, reflect these changes unless you opt for a custom icon.

For a shortcut, you can use vanilla materials by selecting one from the generated wackydb_material materials.txt file.

Lastly, a single material YAML (yml) can be applied to multiple items, creatures, or pieces. Keep in mind that some objects might need more information than others for proper display.

Now go forth, and let your creativity run wild with Rex's Material Management!

Materials and Custom

Materials and CustomVisuals

  • material (string, optional): The name of the material
  • customVisual (CustomVisual, optional): A more specific targetting for materials, generally only useful for player armors.

Material Definition

  • name (string, required): The name of the new material created
  • original (string, required): The name of the material to clone from
  • overwrite (boolean, optional): True to overwrite the original material.
  • changes (MaterialChanges, required): The set of changes to apply to the material

Material Changes Definition

  • colors (Dictionary<MaterialProperty: string, MaterialValue: Array<int>[4]>, optional) : A collection of keys (property names) and their associated value. The value is in array format [RED, GREEN, BLUE, ALPHA]. Values should range from 0 to 1 but can exceed 1.
  • floats (Dictionary<MaterialProperty: string, MaterialValue: float>, optional): A collection of keys (property names) and their associated float value. The value can be any float value but it is recommended to stay within the range specified by describing the prefab that has this material.
  • textures (Dictionary<MaterialProperty: string, MaterialValue: string>, optional): A collection of keys (property names) and their associated string value. The string value is the name of the texture to be used. The image should be a .png file stores in the 'Textures' section in the configuration folder. Do not include '.png', if the file is my_texture.png specify my_texture as the value here.

Custom Visual Definition

  • base_mat: (string, optional): The name of the material, generally this applies to the model for the prefab.
  • chest: (string, optional): The name of the material, generally this is only useful for chest armor. It will use the texture assigned to the "_ChestTex" property of the material.
  • legs: (string. optional): The name of the material, generally this is only useful for leg armor. It will use the texture assigned to the "_LegsTex" property of the material.

Materials and Custom

Materials and Custom


Item components

Item Config

Glowing Red BronzeSword

Properties

  • name (string, required): The name of the item.
  • m_weight (float, required): The weight of the item.
  • m_name (string):The in game name.
  • m_description (string): The description of the item.
  • clonePrefabName (string): The name of the prefab to clone.
  • mockName (string): The name of the mock object.
  • customIcon (string): The custom icon for the item. PNG 64x64, Icon needs to be in the Icon folder ( doesn't server sync)
  • material (string): The material of the item. Images on nexus https://www.nexusmods.com/valheim/mods/1825 of the various changes you can make.
    Visit the Material and CustomVisual Section to understand this complex system.
  • customVisual (CustomVisual): The custom visual data of the item.
  • sizeMultiplier (float): The size multiplier of the item. You can go from .01 to 1000.5 if you want. Have fun!****
  • scale_weight_by_quality (float): The scaling factor for weight based on quality.

LongSwordBlueRed

Changing material or CustomVisual automatically calls snapshot to generate a new Icon or give it a customIcon

CustomVisual

  • base_mat (string): The base material of the custom visual.
  • chest (string): The chest visual.
  • legs (string): The legs visual.
  • realtime (string): The realtime visual.

Primary_Attack (AttackArm): The primary attack data.

Primary Attack

  • AttackType (Attack.AttackType): The type of attack.
  • Attack_Animation (string): The animation for the attack.
  • Attack_Random_Animation (int): The random animation for the attack.
  • Chain_Attacks (int): The number of chain attacks.
  • Hit_Terrain (bool): Indicates whether the attack can hit terrain.
  • Custom_AttackSpeed (float): This mod keeps track of this adjustment 1.0 is normal speed. 2.0 is twice as fast. Should be compatible with most other mods that increase speed.
  • m_attackStamina (float): The stamina cost of the attack.
  • m_eitrCost (float): The eitr cost of the attack.
  • AttackHealthCost (float): The health cost of the attack.
  • m_attackHealthPercentage (float): The health cost percentage of the attack.
  • SpeedFactor (float): The speed up of a character's movements when they are actively attacking.
  • DmgMultiplier (float): The damage multiplier of the attack.
  • ForceMultiplier (float): The force multiplier of the attack.
  • StaggerMultiplier (float): The stagger multiplier of the attack.
  • RecoilMultiplier (float): The recoil multiplier of the attack.
  • AttackRange (float): The range of the attack.
  • AttackHeight (float): The height of the attack.
  • Spawn_On_Trigger (string): The spawn-on-trigger effect of the attack.
  • Requires_Reload (bool): Indicates whether the attack requires reloading.
  • Reload_Animation (string): The animation for reloading.
  • ReloadTime (float): The time it takes to reload.
  • Reload_Stamina_Drain (float): The stamina drain during reloading.
  • Bow_Draw (bool): Indicates whether the bow is drawn for the attack.
  • Bow_Duration_Min (float): The minimum duration of the bow.
  • Bow_Stamina_Drain (float): The stamina drain during bow usage.
  • Bow_Animation_State (string): The animation state for the bow.
  • Attack_Angle (float): The angle of the attack.
  • Attack_Ray_Width (float): The width of the attack ray.
  • Lower_Dmg_Per_Hit (bool): Indicates whether the attack lowers damage per hit.
  • Hit_Through_Walls (bool): Indicates whether the attack can hit through walls.
  • Multi_Hit (bool): Indicates whether the attack can hit multiple times.
  • Pickaxe_Special (bool): Indicates whether it is a special pickaxe attack.
  • Last_Chain_Dmg_Multiplier (float): The damage multiplier for the last chain attack.
  • Attack_Projectile (string): The Gameobject projectile has to have Projectile Componenent. Disabled for now.
  • Projectile_Vel (float): The velocity of the projectile.
  • Projectile_Accuraccy (float): The accuracy of the projectile.
  • Projectiles (int): The number of projectiles.
  • AEffects (AEffects): The additional effects of the attack.

Class: AEffects

  • Hit_Effects (string[]): The hit effects of the attack.
  • Hit_Terrain_Effects (string[]): The effects when hitting terrain.
  • Start_Effect (string[]): The starting effect of the attack.
  • Trigger_Effect (string[]): The triggered effect of the attack.
  • Trail_Effect (string[]): The effect trail of the attack.
  • Burst_Effect (string[]): The burst effect of the attack.

Delete To delete existing Effects


Secondary Attack

Is the same as Primary just for the secondary attack.

Damage (WDamages): The damage values of the item. Damage_Per_Level (WDamages): The damage values per level of the item.

Damages

  • Blunt (float): The blunt damage value.
  • Chop (float): The chop damage value.
  • Damage (float): The general damage value.
  • Fire (float): The fire damage value.
  • Frost (float): The frost damage value.
  • Lightning (float): The lightning damage value.
  • Pickaxe (float): The pickaxe damage value.
  • Pierce (float): The pierce damage value.
  • Poison (float): The poison damage value.
  • Slash (float): The slash damage value.
  • Spirit (float): The spirit damage value.

Armor (ArmorData): The armor data of the item.

Armor

  • armor (float): The armor value.
  • armorPerLevel (float): The armor value per level.

FoodStats (FoodData): The food-related statistics of the item.

FoodData

  • m_foodHealth (float): The health provided by the food.
  • m_foodStamina (float): The stamina provided by the food.
  • m_foodRegen (float): The regeneration rate of the food.
  • m_foodBurnTime (float): The burn time of the food.
  • m_FoodEitr (float): The eitr provided by the food.

Moddifiers (StatMods): The stat modifiers of the item.

StatMods

  • m_movementModifier (float): The movement modifier.
  • m_EitrRegen (float): The eitr regeneration modifier.

SE_Equip (SE_Equip): The special effect data for equipping the item.
If you want an Item to have an Effect by itself, put the effect name here
SE_SET_Equip (SE_SET_Equip): All of this should be the same accross all items that have this set
You can delete an SE_Equip or SE_SET_Equip from item using EffectName : delete

SE_Equip

  • EffectName (string): The name of the effect for equipping.

SE_SET_Equip

  • SetName (string): The name of the set.
  • Size (int): The size of the set.
  • EffectName (string): The name of the effect for equipping the set.

Delete To delete existing

Delete To delete existing


ShieldStats (ShieldData): The shield statistics of the item.

  • Shield

  • m_blockPower (float): The block power of the shield.

  • m_blockPowerPerLevel (float): The block power per level of the shield.

  • m_timedBlockBonus (float): The timed block bonus of the shield.

  • m_deflectionForce (float): The deflection force of the shield.

  • m_deflectionForcePerLevel (float): The deflection force per level of the shield.

Properties Continued

  • m_maxStackSize (int): The maximum stack size of the item.
  • m_canBeReparied (bool): Indicates whether the item can be repaired.
  • m_destroyBroken (bool): Indicates whether the item gets destroyed when broken.
  • m_dodgeable (bool): Indicates whether the item can be dodged.
  • Attack_status_effect (string): The attack status effect of the item.
  • spawn_on_hit (string): The spawn-on-hit effect of the item.
  • spawn_on_terrain_hit (string): The spawn-on-terrain-hit effect of the item.
  • m_questItem (bool): Indicates whether the item is a quest item.
  • m_teleportable (bool): Indicates whether the item is teleportable.
  • m_backstabbonus (float): The backstab bonus of the item.
  • m_knockback (float): The knockback value of the item.
  • m_useDurability (bool): Indicates whether the item uses durability.
  • m_useDurabilityDrain (float): The durability drain when the item is used.
  • m_durabilityDrain (float): The durability drain of the item.
  • m_maxDurability (float): The maximum durability of the item.
  • m_durabilityPerLevel (float): The durability increase per level of the item.
  • m_equipDuration (float): The equip duration of the item.
  • m_skillType (Skills.SkillType): The skill type of the item.
  • m_animationState (ItemDrop.ItemData.AnimationState): The animation state of the item.
  • m_itemType (ItemDrop.ItemData.ItemType): The item type of the item.
  • m_toolTier (int): The tool tier of the item.
  • m_maxQuality (int): The maximum quality of the item.
  • m_value (int): The value of the item. The value of the item. if value is >0. Then the object becomes salable at Trader. The Object Description gets a yellow Valuable notice. Just like base game you don't know what object you are selling to Trader.
  • damageModifiers (List<string>): The list of damage modifiers for the item.

DamageModifiers

The first value is the damage type, the second value is the resistance level.
Blunt Slash Pierce Chop Pickaxe Physical Fire Frost Lightning Elemental Poison Spirit Water

Normal - no change
Resistant - increases status countdown speed by 100%
Weak - Decreases status countdown speed by 1/3
Immune - prevents status effect
Ignore - prevents status effect
VeryResistant - Prevent status effect application except when actively in, and increases status countdown speed by 100%
VeryWeak - Decreases status countdown speed by 2/3

Delete all Damage Mod To delete all existing Damage modifiers

GEffects (GEffects): The additional game effects of the item.

GEffects

Ice Video

  • Hit_Effects (string[]): The hit effects.
  • Hit_Terrain_Effects (string[]): The effects when hitting terrain.
  • Start_Effect (string[]): The starting effect.
  • Hold_Start_Effects (string[]): The hold starting effects.
  • Trigger_Effect (string[]): The triggered effect.
  • Trail_Effect (string[]): The effect trail.
Piece components

Glowing Red BronzeSword

Pieces

  • name (string, required): The name of the piece.
  • piecehammer (string, required): The piece hammer required to build the piece.
  • m_name (string): The In Game Piece Name
  • sizeMultiplier (float): The size multiplier of the piece. Any float range 1.0 is normal size, 2.0 is v^3
  • m_description (string): The description of the piece.
  • customIcon (string): The custom icon for the piece. PNG or JPEG, 64 x 64, Must be in Icon Folder (Icons do not Synced)
  • clonePrefabName (string): The name of the prefab to clone.
  • material (string): Visit Material Section and Custom Visual Section
  • damagedMaterial (string): The material of the piece when damaged.
  • craftingStation (string): The crafting station required to craft the piece.
  • piecehammerCategory (string): The category of the piece hammer.
  • minStationLevel (int): The minimum level of the crafting station required.
  • amount (int): The amount of the piece.
  • disabled (bool): Indicates whether the piece is disabled.
  • adminonly (bool): Indicates whether the piece is admin-only.
  • comfort (ComfortData): The comfort data of the piece.
  • groundPiece (bool): Indicates whether the piece is a ground piece.
  • ground (bool): Indicates whether the piece can be placed on the ground.
  • waterPiece (bool): Indicates whether the piece is a water piece.
  • noInWater (bool): Indicates whether the piece cannot be placed in water.
  • notOnFloor (bool): Indicates whether the piece cannot be placed on the floor.
  • onlyinTeleportArea (bool): Indicates whether the piece can only be placed in teleport areas. Stone Groups making a Circle
  • allowedInDungeons (bool): Indicates whether the piece is allowed in dungeons.
  • canBeRemoved (bool): Indicates whether the piece can be removed.
  • wearNTearData (WearNTearData): The wear and tear data of the piece.
  • craftingStationData (CraftingStationData): The crafting station data of the piece.
  • cSExtensionData (CSExtensionData): The crafting station extension data of the piece.
  • contData (ContainerData): The container data of the piece.
  • smelterData (SmelterData): The smelter data of the piece.
  • build (List<string>): The list of requirement items for the piece.

build: requirements to build: Item:amount:amountPerLevel:refundable,

ComfortData

  • comfort (int): The comfort value of the piece.
  • comfortGroup (Piece.ComfortGroup): The comfort group of the piece.
  • comfortObject (GameObject): The comfort object of the piece.

WearNTearData

  • health (float): The health of the piece.
  • damageModifiers (HitData.DamageModifiers): The damage modifiers for wear and tear.
  • noRoofWear (bool): Indicates whether the piece does not wear when under a roof.
  • noSupportWear (bool): Indicates whether the piece does not wear when supported.
  • supports (bool): Indicates whether the piece provides support.
  • triggerPrivateArea (bool): Indicates whether the piece triggers the private area.

CraftingStationData

  • cStationCustomIcon (string): The custom icon for the crafting station. May remove - Not really useful
  • discoveryRange (float): The discovery range of the crafting station. Range that you discovery the piece for the first time
  • buildRange (float): The build range of the crafting station.
  • craftRequiresRoof (bool): Indicates whether crafting at the station requires a roof.
  • craftRequiresFire (bool): Indicates whether crafting at the station requires a fire.
  • showBasicRecipes (bool): Indicates whether to show basic recipes at the station.
  • useDistance (float): The use distance of the station.
  • useAnimation (int): The animation to use for station usage.

CSExtensionData

  • MainCraftingStationName (string): The name of the main crafting station.
  • maxStationDistance (float): The maximum distance for the extension to connect to the main station.
  • continousConnection (bool): Indicates whether the extension provides continuous connection.
  • stack (bool): Indicates whether the extension can stack.

ContainerData

  • Width (int): The width of the container.
  • Height (int): The height of the container.
  • CheckWard (bool): Indicates whether the container checks for ward placement.
  • AutoDestoryIfEmpty (bool): Indicates whether the container auto-destroys if empty.

SmelterData

  • smelterName (string): The name of the smelter.
  • addOreTooltip (string): The tooltip for adding ore to the smelter.
  • emptyOreTooltip (string): The tooltip for emptying ore from the smelter.
  • fuelItem (fuelItemData): The fuel item for the smelter.
  • maxOre (int): The maximum ore capacity of the smelter.
  • maxFuel (int): The maximum fuel capacity of the smelter.
  • fuelPerProduct (int): The amount of fuel required per product.
  • secPerProduct (float): The time taken per product.
  • spawnStack (bool): Indicates whether the smelter spawns stacked products.
  • requiresRoof (bool): Indicates whether the smelter requires a roof.
  • addOreAnimationLength (float): The length of the animation for adding ore.
  • smelterConversion (List<SmelterConversionList>): The list of smelter conversions.

CookingStationData

Warning changing to new CookConversions items can trigger minor errors as well as food items not appearing in oven

  • addItemTooltip (string): The tooltip for adding items to the cooking station.
  • overcookedItem (string): The item produced when cooking is overdone.
  • fuelItem (string): The fuel item used in the cooking station.
  • requireFire (bool): Indicates whether the cooking station requires fire.
  • maxFuel (int): The maximum fuel capacity of the cooking station.
  • secPerFuel (int): The time, in seconds, per unit of fuel.
  • cookConversion (List<CookStationConversionList>): A list of cooking conversions.

CookStationConversionList

  • FromName (string): The name of the item to convert from.
  • ToName (string): The name of the item to convert to.
  • CookTime (float): The cooking time for the conversion.

fuelItemData

  • name (string): The name of the fuel item.

SmelterConversionList

  • FromName (string): The name of the item to convert from.
  • ToName (string): The name of the item to convert to.

Delete all by using "-"

Marble Sizes

Change the size of any Piece, make adminonly and build HUGE or TINY structures.

Recipe Components

Recipes

  • name (string, required): The name of the recipe.
  • clonePrefabName (string): The name of the prefab to clone.
  • craftingStation (string): The crafting station required to craft the recipe. "" is hand crafted
  • minStationLevel (int): The minimum level of the crafting station required.
  • maxStationLevelCap (int): The maximum level cap of the crafting station.
  • repairStation (string): The repair station required to repair the recipe.
  • amount (int): The amount of the recipe.
  • disabled (bool): Indicates whether the recipe is disabled.
  • requireOnlyOneIngredient (bool): Indicates whether the recipe requires only one ingredient.
  • reqs (List<string>, required): The list of required ingredients for the recipe.

(Required) requirements to build: Item:amount:amountPerLevel:refundable:quality,

Quality is a requirement of what quality of item you need to be able to use this recipe. Like a 2* Bronze Sword to upgrade to Bronze Sword Superd *1

Recipe Quality


Arrows x50 will be put above Arrow x20

Creatures

CreatureData

Materials and Custom

You can replace all Boars in the game with this Dude.


  • name (string, required): The name of the creature.
  • mob_display_name (string, required): The display name of the creature in game.
  • custom_material (string): The custom material for the creature. - Disabled for now - Will not work
  • clone_creature (string): The name of the creature to clone.
  • creature_replacer (string): The creature replacer. This will replace this creature with the one named here. All spawns will be replaced with this creature.
SE_Effects

SE_Effects

  • Name (string): The name of the status effect.
  • Status_m_name (string): In Game Name
  • Category (string): The category of the status effect.
  • IconName (string): The name of the icon for the status effect.
  • CustomIcon (string): The custom icon for the status effect. customIcon, jpeg or png. ie wacky.png 64 x 64
  • FlashIcon (bool): Indicates whether the icon should flash.
  • CooldownIcon (bool): Indicates whether the icon is for a cooldown.
  • Tooltip (string): The tooltip for the status effect.
  • Attributes (StatusEffect.StatusAttribute): The attributes of the status effect.
  • StartMessageLoc (MessageHud.MessageType): The localization message type for the start message.
  • StartMessage (string): The start message of the status effect.
  • StopMessageLoc (MessageHud.MessageType): The localization message type for the stop message.
  • StopMessage (string): The stop message of the status effect.
  • RepeatMessageLoc (MessageHud.MessageType): The localization message type for the repeat message.
  • RepeatMessage (string): The repeat message of the status effect.
  • RepeatInterval (float): The repeat interval of the status effect.
  • TimeToLive (float): The time to live of the status effect.
  • StartEffect_ (string[]): The string of start effects for the status effect.
  • StopEffect_ (string[]): The string of stop effects for the status effect.
  • Cooldown (float): The cooldown of the status effect.
  • ActivationAnimation (string): The animation for the activation of the status effect.
  • SeData (SEdata): The additional data for the status effect.

Class: SEdata

  • m_tickInterval (float): The tick interval for the status effect.
  • m_healthPerTickMinHealthPercentage (float): The minimum health percentage per tick.
  • m_healthPerTick (float): The health per tick.
  • m_healthOverTime (float): The health over time value.
  • m_healthOverTimeDuration (float): The duration of health over time.
  • m_healthOverTimeInterval (float): The time interval for health over time.
  • m_staminaOverTime (float): The stamina over time value.
  • m_staminaOverTimeDuration (float): The duration of stamina over time.
  • m_staminaDrainPerSec (float): The stamina drain per second.
  • m_runStaminaDrainModifier (float): The stamina drain modifier for running.
  • m_jumpStaminaUseModifier (float): The stamina use modifier for jumping.
  • m_eitrOverTime (float): The eitr over time value.
  • m_eitrOverTimeDuration (float): The duration of eitr over time.
  • m_healthRegenMultiplier (float): The health regeneration multiplier.
  • m_staminaRegenMultiplier (float): The stamina regeneration multiplier.
  • m_eitrRegenMultiplier (float): The eitr regeneration multiplier.
  • m_raiseSkill (Skills.SkillType): The skill type to raise as a multiplier or %
  • m_raiseSkillModifier (float): The skill modifier to raise as a multiplier.
  • m_skillLevel (Skills.SkillType): The skill type to modify the level.- Flat Rate
  • m_skillLevelModifier (float): The skill level modifier.
  • m_skillLevel2 (Skills.SkillType): Another skill type to modify the level.Flat Rate
  • m_skillLevelModifier2 (float): Another skill level modifier.
  • m_mods (List<HitData.DamageModPair>): The list of damage modifiers for hit.
  • m_modifyAttackSkill (Skills.SkillType): The skill type to modify the attack.
  • m_damageModifier (float): The damage modifier for the attack.
  • m_noiseModifier (float): The noise modifier for sneaking.
  • m_stealthModifier (float): The stealth modifier for sneaking.
  • m_addMaxCarryWeight (float): The additional maximum carry weight.
  • m_speedModifier (float): The speed modifier.
  • m_maxMaxFallSpeed (float): The maximum maximum fall speed.
  • m_fallDamageModifier (float): The fall damage modifier.
  • m_tickTimer (float): The tick timer.
  • m_healthOverTimeTimer (float): The health over time timer.
  • m_healthOverTimeTicks (float): The health over time ticks.
  • m_healthOverTimeTickHP (float): The health over time tick health points.

You should be able to delete existing m_mods, by
m_mods:
-

Delete all m_mods

Use wackydb_se_create as a "template" to create a new status effect

MOCK System

Bike Model Import

All credits to @KG for making this incredible system.

In the Wackydatabase folder, there is the Object Folder.

Objects can only be items that you can pick up/trade at the moment, but mocks are limitless in the possibilities of what you can add.

Pick an object like bike.obj and bike_albedo.png and put them into the Object folder. It should load up the new GameObject at the start. You can then use wackydb_save_item to customize and/or create a recipe.

The object folder matches based on the preceding name, so bike_ matches to bike.

It looks for PNGs with "_albedo", "_metallic", and "_normal".

This system is not well tested, so please give me feedback and submit bug reports for any bugs.

1.xx ChangeLog
    Version 1.4.2
        Had to disable Piece snapshot because of hovering pieces stacking up on each other, hopefully someone fixes it someday.
        You might have to destroy the existing pieces at (0,0) with infinity hammer quite a lot depending on reloads and players joining.    
    Version 1.4.1
        Some items don't like snapshot icons - Added extra checks and only items with material changes get new icons
    Version 1.4.0
        Added DedServer load Memory config to allow people to see if loading Wackydb on DedServer helps or hinders. 
        extraSecurity - Allows people who don't want the extra cheat protection to disable it and not get 0.0.1 Error
        Big News! Added auto Icon Generation to cloned Items, and all Pieces with custom material(pieces angles are a little wonky or wacky if you will) - Thx Blaxx for code
    Version 1.3.6
        Added m_attackHealthPercentage and m_secAttackHealthPercentage- Warning any Items that uses this Must be recreated. s
        Otherwise default will go to 0. These items include the staffs that use a percentage of player health to power. 
    Version 1.3.5
        I have decided to add more parameters to Json file, so please do not use older version of Wackydb after upgrading. Wackydb 2.0 is not coming soon
        Existing Jsons are fine to use, you can regenerate them to get new values. 
        Added m_EitrCost, m_secEitrCost - These are attack costs for primary and secondary weapon attacks, no Eitr, no swing. 
        m_FoodEitr - Food Eitr amount, m_EitrRegen- Modifier to Eitr Regen - Very powerful on clothes, weapons, added more warnings. 
        Seperated out m_attackStamina and secondary m_attackStamina
    Version 1.3.2
        Mistlands Update: Removed extra Wet effect/restance since Mistlands adds its own. 
        Removed FoodColor, as it was removed from game and didn't really do anything.
    Version 1.3.0
        Hopefully fixed Co-Op hosting bug again..
    Version 1.2.9
        Updated ServerSync for 211.11
    Version 1.2.8
        Hopefully fixed issue with Co-op hosting. Added 0.0.1 Custom message back. 
    Version 1.2.7
        Updated ServerSync for crossplay - Custom Message for Ver 0.0.1 is not displayed. No Singleplayer before multiplayer without restart.
        Known issue of TrophyDraugr is not able to be set (targets TrophyDraugrFem) use Fem or clone TrophyDraugr. 
        Destroyer is spelled with "troy", also now a loginfo instead of warning
    Version 1.2.5
        Moved wackysDatabase to Config instead of Plugins folder to stop r2mod from deleting folder on updates.
        Warning 1.2.4 and Lower will delete wackysDatabase folder in Plugins on Update, please backup.
    Version 1.2.4 
        Expanded Recipe Compatibility to Recipe_ ( Modification only, no cloning),  Can now change any material's type,
        category, craftingstation instead of just clones. Cannot change piecehammer of non clones. You can now set the piece's 
        material at 50% health. If you only set 1 it sets to both "full health" and "half health" otherwise,
        "material1, material2" (full, half health). "same_mat" or "no_wear" sets pieces to have no wear material. 
        Updated ServerSync and PieceManager
    Version 1.1.9
        Bug Fixes. Cleaned up Logs
    Version 1.1.8
        Fixed two main bugs,
        Properly unloading cloned assets on logout.
        Made it so some errors are caught better.
        Incorporated Water Resistance as done by aedenthorn.
    Version 1.1.5
        Cleaned up the code a lot. Fixed Pieces from getting null values from Server.
        Fixed the piece disable/admin for custom pieces.
        Made it so you can clone stone_floor (4x4 stone prefab) - editing it probably won't make it add to Hammer
        Added special case list for objects that have multiple Gameobjects. (Bow, SpearBronze)
    Version 1.10
        All About Pieces with this Update!
        Adds ability to clone an existing CraftingStation piece and make it a new CraftingStation 
            - The CraftingStation name is "name", add recipes to it with this name.
        Fixed other mods custom pieces. You should be able access and even clone other mods pieces now.
        Added piecehammerCategory so you can change the category where piece appears on the hammer. 
            - Mods might use numbers instead of words though.
        Added m_knockback Added m_backstabbonus Made m_attackStamina set both Primary and Secondary attacks.
    Version 1.05
        Mod Release
Last notes

Last notes:

This mod should load last. It needs to so it can touch all other mods.

You can make changes to that OP bow and make it more realistic on damage or build requirements. Or even set a build piece to adminonly.

Clone the Item and change the material to make it a more appealing color.

Submit pull requests to https://github.com/Wacky-Mole/WackysDatabase . The primary purpose of this mod is to edit objects, not to create clones/mocks.

A mispelling like "Like <colorz = blue> Hi</color>?" or dmg modifier that is wrong can break Azu show container contents

(Note!: If you want the game to have default values, close the game and delete the wackysDatabase folder).

Full Features

Planned features

  • [x] Able to modify item data.
  • [x] Able to modify recipes.
  • [x] Able to modify pieces.
  • [x] Able to modify materials on clones
  • [x] Custom items/pieces
  • [x] Custom recipes
  • [x] Able to modify Set effects
  • [x] Cloned Items show up on MainScreen
  • [x] Adjust attack values of items
  • [x] Able to add or remove conversions on smelter pieces
  • [x] Able to change the size of anything Wackymole
2.xx ChangeLog
Version Changes
2.0.0 - 2.0.0 - Lots of betas
2.0.1 - First Release of 2.0
2.0.2 - Bug fix for cloned pieces being deleted at logout and login -sorry
2.0.3 Bug fix for cloned items being deleted for some people.
Feedback

For questions or suggestions please join discord channel: Odin Plus Team or my discord at Wolf Den

Support me at https://www.buymeacoffee.com/WackyMole or https://ko-fi.com/wackymole

Buy Me A Coffee

Buy Me a Coffee at ko-fi.com

Credits

Credits: Aedenthorn and all of his Many Mods! https://github.com/aedenthorn/ValheimMods
Thank you AzumattDev for the template. It is very good https://github.com/AzumattDev/ItemManagerModTemplate
Also thanks to Blaxx and Azu for code like Snapshot and Piece Categories.
Thanks to the Odin Discord server, for being active and good for the valheim community.
CustomArmor code from https://github.com/aedenthorn/ValheimMods/blob/master/CustomArmorStats/BepInExPlugin.cs
An extra thank you to Azumatt and the Odin team.
Special thank you to @KG for Mock System
A Huge thank you to Rexabit and his Visual Modifier https://github.com/Rexabit/valheim-visuals-modifier
Azumatt for Status Editor contributions.
This mod was the culmination of hundreds of hours. Do whatever you want with this mod.

Known issues:

CHANGELOG

Version Changes
2.4.44 Bug fix for cSExtensionDataList
2.4.43 Update for PieceManager
2.4.42 Bug fix.
2.4.41 Bog The Witch Update
Add support for multiple Piece CSExtensionData. You can now also make (almost) any piece into an extension for a craftingstation.
Added support for Pieces to become craftingstations.
Added Pickable m_extraDrops stuff
Removed unnecessary warning for disabled pieces.
Added Hit_Friendly to attack
2.4.31 Expanded upgrade_reqs for recipes levels! You can now specify completely different recipes for all upgrades. Rejoice, no more hacks.
2.4.28 Renamed a field to Damage_Multiplier_By_Health_Deficit_Percent
Updated Readme with some (light) video tutorial links.
2.4.27 Fix for Primary/Secondary Status Effect.
Added Attack_Start_Noise(float), Attack_Hit_Noise(float), Dmg_Multiplier_Per_Missing_Health(float), Dmg_Multiplier_Per_Total_Health(float), Stamina_Return_Per_Missing_HP(float), SelfDamage(int), Attack_Kills_Self(bool)
2.4.26 Fix for rare unarmed attack causing error and no dmg.
2.4.25 Coop sync fix
Rewrote how 'ExtraSecurity on Servers' works. Should sync from Servers to clients better now.
Send logs for any issues
2.4.24 PerBurst_Resource_usage bug fix.
2.4.23 Updated PerBurst_Resource_usage and Destroy_Previous_Projectile for misspellings. If you use these, please regenerate your yaml files or rename fields, otherwise can be ignored.
Bug fixes for pickables with other plant mods.
2.4.22 Bug fixes for materials.
AlanDrake added filterMode to textures for advanced texturing.
2.4.21 Incoming Big Update sponsored by Lughbaloo: Pickables and Plants!
PlantData is saved in pieces, which point to either Pickable or Treebase when matured. When you pick a pickable it becomes an item. You can of course clone and change size/material. Enjoy this wacky expansion.
2.4.13 Bug fix for attack_status_effect
2.4.12 Rexabyte fix for darker textures than intended. Also you can now save materials with spaces in the name, using underscores '_' in place of a space.
Bug fix for unarmed hits
2.4.11 Added 'delete' to spawn_on_hit and spawn_on_terrain_hit for items.
Added command to save all mobs wackydb_all_creatures in Bulk Folder
Separated out attack_status_effect into primary and secondary, custom wackydb patch for it. The normal attack_status_effect will be overwritten if a primary or secondary is set.
Added m_jumpModifier as a Vector3. Unnecessary lines can be deleted.
Added some more logs for debugmode
IG forgot to add a check for zero stamina for staminaReload, added
2.3.9 Added Attack_status_effect_chance
Fixed COOP servers again. I even verfied with Gamepass PC.
2.3.8 Added SE/se to wackydb_clone, rejoice, you can now change which SE you clone. Allows you to clone SEShield now.
Added the ability to delete Attack_status_effect with "delete"
2.3.7 Changed disabled recipes code again
Added back ReloadTime, might work for some things.
Added Reload_Eitr_Drain
Fix for DedServer load Memory = false.
Added Reset_Chain_If_hit, SpawnOnHit, SpawnOnHit_Chance, Raise_Skill_Amount, Skill_Hit_Type, Special_Hit_Skill, Special_Hit_Type to Attack.
Added Attach_Override for items
2.3.6 Possible bug fix for disabled recipes.
2.3.5 Bug fixes for recipes, disabled and disabledUpgrade
Bug fix for double serversync issue, was probably causing server admins a lot of problems on pushing updates without restarts.
Changed singleplayer loading yml files to be more consistent with how multiplayer client receives them. Required fields are required.
Removed unnecessarily log on respawn
2.3.4 Bug Fix for recipe.
2.3.3 Added values for Staff of protection SE or SE Staff_
Updated PieceManager
Officially added upgrade_reqs and disabledUpgrade for Recipe goodness. Say thank you to Blaxx and Item Manager
Added warning if Recipes don't find req item
Fixed using actual recipes like Recipe_Bronze5
Added notOnWood for pieces
2.3.1 Adjust font sizeMin for Categories.
Added AllowAllItems for portal Pieces
Added Fireplace for pieces - Infinite Fuel now
Fixed Mock System again.
2.3.0 Update for Ashlands.
Removed m_baseItemsStaminaModifier, added a lot of other StaminaModfiers.
Updated PieceManager
2.2.6 Removed Reloadtime(broken) and replaced it with ReloadTimeMultiplier for crossbow.
2.2.5 Added snapshotRotation and snapshotOnMaterialChange for items.
Fix for some cloned pieces
Fix for reloading RecipeMaxStationLvl
Added incineratorData conversion for obliterator, you can now make obliterator into a recycler if you want.
2.2.2 Bug Fix for SE_Effects with generated PLUS effects
2.2.1 Added BaseItemStamina for statmods
Add StaffSkelton attack
Fix Bug on PLUS effects
2.2.0 Decent sized Update: Fix for cloned creatures replacing main creatures name
Enabled piece snapshot again, hopefully it works well this time. Added a command wackydb_snapshot for pieces
Vastly expanded effect capabilities. Old Effects will work, but generate new yamls for more features.
Added Remove to piece conversion list allows you to disable an input and not forcing me to clear the whole list. Now the list shouldn't conflict with additional mods.
2.1.7 Update Readme a bit.
Made it so some pieces didn't reload twice.
2.1.6 Bug fix for cloned pieces on relog.
Thx to OrianaVenture for updated icon
2.1.5 Added API for Clone mapping to orginal prefab.
Adjustment for Epicloot+wackydb on quitting
2.1.4 Happy Halloween, this update is for the spooky people that use "," as decimal delimiters, resulting in crazy big sizes of items/pieces.
SizeMultiplier is now seperated with |
Updated a Priority for loading
2.1.3 Added custom SS messsage back
added a 4th layer to piece search
Separated out sizeMultiplier for x,y,z or just one value
Added a check for transplier at closeout for a few people that hang.
Updated Refs for new Bepinex
Changed loading order again
2.1.2 Updated recipeGet, Removed recipe quality (it's a good idea, but I didn't like how it was implemented**).**
Took out my custom ServerSync temporarily to test a bug, it won't display message 0.0.1
2.1.1 Change a priorty.
Minimized the chance of a recipe consuming double resources with cfc. It will still happen with cfc, if a recipe has quality of > 1
2.1.0 Bug fix, changed color on messages from lime to red
2.0.9 Bug Fix
2.0.8 Updated ServerSync, Piecemanger, Patch update for 217.24
Fix bug for recipes consuming resources twice.
2.0.7 Fixed effects not following you.
Add beehive data to pieces.
Fix for dedicated servers not loading data. Moved up reload for dedicated servers.
Changed log messages, added more warnings.
Added more checks for cloned cache.
Fix for mock items.
2.0.6 Big bug fix for servers. Moved main loading to an even later point. Added SizeMultiplier to cache, for extra sized cached weapons.
2.0.5 Bug fix for a cache item error on updateitemhash.
2.0.4 Added ConsumableStatusEffect to items.
Hovernames for cloned doors.
Added Sap and Fermentor Section to pieces.
BIG - Moved main loading to a later point for more pieces to be found.
Reduced bug counts with disabling pieces.
Known bug: moving from one hammer to another hammer, might require disabling orginal and cloning.
Fixed Mock items for the adventurous few, added example for mock bike.
2.0.3 Bug fix for cloned items being deleted for some people. Fix for piece disabling, disabling already placed pieces - whoops
2.0.2 Bug fix for cloned pieces being deleted at logout and login -sorry
2.0.1 First Release of 2.0
2.0.0 2.0.0 - Lots of betas