NiceneNerd at 14:59, 13 July 2020

2020-07-13T14:59:14Z

← Older revision		Revision as of 14:59, 13 July 2020
Line 1:		Line 1:
			[[Category:Guides]]
	Making changes to an [[Actor\|actor's]] [[ActorParam\|parameters]] is one of the most basic and common types of editing in BOTW modding. This brief guide will introduce the process in its simplest form.		Making changes to an [[Actor\|actor's]] [[ActorParam\|parameters]] is one of the most basic and common types of editing in BOTW modding. This brief guide will introduce the process in its simplest form.

NiceneNerd: /* Prerequisites */

2020-07-10T03:01:13Z

Prerequisites

← Older revision		Revision as of 03:01, 10 July 2020
Line 2:		Line 2:

	== Prerequisites ==		== Prerequisites ==
	* Python 3.6+ 64 bit (more details at [[Help:Setting up tools]])		* Python 3.7+ 64 bit (more details at [[Help:Setting up tools]])
	* [[Help:Tools/Wild_Bits\|Wild Bits]]		* [[Help:Tools/Wild_Bits\|Wild Bits]]

NiceneNerd: Initial post

2020-07-10T02:48:52Z

Initial post

New page

Making changes to an [[Actor|actor's]] [[ActorParam|parameters]] is one of the most basic and common types of editing in BOTW modding. This brief guide will introduce the process in its simplest form.

== Prerequisites ==
* Python 3.6+ 64 bit (more details at [[Help:Setting up tools]])
* [[Help:Tools/Wild_Bits|Wild Bits]]

== Mod Preparation ==

=== Folder Setup ===
First you will need to create a folder structure for your mod. For Wii U/Cemu, the format is pretty well standardized. To make a simple parameter edit for an actor, create a setup like this:
<pre>
MyMod
└── content
└── Actor
└── Pack
</pre>

For Switch, format conventions vary. This guide will use the format expected by [[Help:Tools/BCML|BCML]] and [[Help:Tools/Hyrule_Builder|Hyrule Builder]]:
<pre>
MyMod
└── 01007EF00011E000
└── romfs
└── Actor
└── Pack
</pre>

=== File Setup ===
Next, you will need to copy the [[Actor pack|actor pack(s)]] for the actor(s) you want to edit from your [[Help:Dumping games|game dump]] into your project. <em>Be sure to use the latest update files</em>—version 1.5.0 for Wii U or 1.6.0 for Switch—to ensure general compatibility. If you don't know the name of the actor you want to edit, use [https://github.com/MrCheeze/botw-tools/blob/master/botw_names.json this actor ID reference] to look it up. For example, if you wanted to edit the torch, <code>Weapon_Sword_023</code>, you would copy <code>Actor/Pack/Weapon_Sword_023.sbactorpack</code> into you mod's <code>Actor/Pack</code> content folder.

Actor parameters which appear somewhere in the game's UI (e.g. the armor rating in the inventory, the price in a shop) will generally have a corresponding value in the actor's entry in [[ActorInfo.product.sbyml]]. If you are editing one of these values, you will also need to copy this actor info file from your update files into your mod as <code>Actor/ActorInfo.product.sbyml</code>.

== Editing Parameters ==
Now that the mod's basic structure is set up with the original files, you can proceed to making edits. Open Wild Bits to the SARC tab, and then open the actor pack you want to edit.

The SARC view will present you with a tree of the files and folders inside the actor pack. To edit parameters, expand the tree to the file you would like to edit. Often this will be in the [[bgparamlist|general parameter list]], e.g. <code>Actor/GeneralParams/Weapon_Sword_024.bgparamlist</code>. Select the file and then click Edit, which will open the file in YAML tab.

In the YAML tab, all of the parameters will be easily viewable and editable. For information on what the individual parameters are or mean, check [[Category:Actor parameter files]]. Once you have made your edits, click Save in the YAML tab. Once you have saved all of the files you want to edit, click Save in the SARC tab as well.

If any of the edits you have made involve values which would appear in the UI, next open <code>Actor/ActorInfo.product.sbyml</code> in the Wild Bits YAML tab, find the actor you edited, and update the relevant parameters to match the changes you made in the actor pack.

== Using the Mod ==
At this point, you've completed the actual modding part of the process. The next step would be simply packaging your mod files into the format you wish to use, whether BNP or graphic pack or Atmosphere mod. Usually, for Cemu you will want to add a <code>rules.txt</code> file or use the BNP maker in BCML. For Wii U, you don't need to add anything; just place the results in the correct SDCafiine folder. For Switch, you will want to copy the output into your Atmosphere titles or contents folder. For more on this process, see [[Help:Using mods]].

Help:Editing Actor Parameters - Revision history

NiceneNerd at 14:59, 13 July 2020

NiceneNerd: /* Prerequisites */

NiceneNerd: Initial post