Modding:Debugging Content: Difference between revisions

From Vintage Story Wiki
(Created content debugging page.)
 
mNo edit summary
Line 3: Line 3:


In progress.
In progress.
== Common Issues & Solutions ==
Some issues are a lot more common than other issues, and when it comes to content modding, it's likely that someone else has had the exact same issue you are trying to fix. 
=== My mod does not appear in the Mod Manager list. ===
* Your mod is likely in the wrong folder. Ensure your mod is placed inside the "Mods" directory of your game installation, or inside the folder shown when "Open Mods Folder" is clicked on the mod manager.
=== "Unable to load mod. Check log files." in Mod Manager list. ===
[[File:UnableToLoadModImage.png|frameless|680x680px]]
* Your [[modinfo]] file may be formatted wrong.
* You may have two mods with the same modid.
* Your mod structure is not setup correctly. See [[Modding:Developing a Content Mod#Template/Example Mod Setup|Developing a Content Mod]].
** The modinfo, assets, and (optionally) modicon file must be found inside the top-level folder of your mod.
=== My Block/Item/Entity is not appearing in game! ===
* There is likely a mistake in your asset's json file. See the '''Debugging & Logs''' section below.
* Check you have added your asset to the correct creative menu.
** Or, see if the object exists by using ''/giveitem itemcode'' or ''/giveblock blockcode.''
== Debugging & Logs ==
Vintage Story logs... pretty much everything. If there is a particular issue inside a json file, the logs will tell you what file it is.


{{navbox/contentmodding}}
{{navbox/contentmodding}}

Revision as of 13:17, 31 March 2024

In progress.

Common Issues & Solutions

Some issues are a lot more common than other issues, and when it comes to content modding, it's likely that someone else has had the exact same issue you are trying to fix.

My mod does not appear in the Mod Manager list.

  • Your mod is likely in the wrong folder. Ensure your mod is placed inside the "Mods" directory of your game installation, or inside the folder shown when "Open Mods Folder" is clicked on the mod manager.

"Unable to load mod. Check log files." in Mod Manager list.

UnableToLoadModImage.png

  • Your modinfo file may be formatted wrong.
  • You may have two mods with the same modid.
  • Your mod structure is not setup correctly. See Developing a Content Mod.
    • The modinfo, assets, and (optionally) modicon file must be found inside the top-level folder of your mod.

My Block/Item/Entity is not appearing in game!

  • There is likely a mistake in your asset's json file. See the Debugging & Logs section below.
  • Check you have added your asset to the correct creative menu.
    • Or, see if the object exists by using /giveitem itemcode or /giveblock blockcode.

Debugging & Logs

Vintage Story logs... pretty much everything. If there is a particular issue inside a json file, the logs will tell you what file it is.


Content Modding
Basics Content Mods Developing a Content Mod
Tutorials
Concepts Modding Concepts Variants Domains Patching Remapping World Properties
Uncategorized
Icon Sign.png

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.

Modding
Modding Introduction Getting Started Theme Pack
Content Modding Content Mods Developing a Content Mod Basic Tutorials Intermediate Tutorials Advanced Tutorials Content Mod Concepts
Code Modding Code Mods Setting up your Development Environment
Property Overview ItemEntityBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository