Modding:Creating Race Mods: Difference between revisions

From bg3.wiki
Jump to navigation Jump to search
(Created page with "<templatestyles src="Module:Message box/ombox.css"></templatestyles><table class="ombox ombox-notice plainlinks" role="presentation"><tr><td class="mbox-image">35px|link=</td><td class="mbox-text">This page is a modding page, and follows its own rules and standards separate from the rest of the wiki.</td></tr></table> <templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module...")
 
No edit summary
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
<templatestyles src="Module:Message box/ombox.css"></templatestyles><table class="ombox ombox-notice plainlinks" role="presentation"><tr><td class="mbox-image">[[File:Bliss_Spores_Condition_Icon.webp|35px|link=]]</td><td class="mbox-text">This page is a [[Modding:Modding resources|modding page]], and follows its own rules and standards separate from the rest of the wiki.</td></tr></table>
{{Modding box}}{{Modding sidebar}}
<templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Sidebar/styles.css"></templatestyles><table class="sidebar nomobile nowraplinks"><tr><th class="sidebar-title">bg3.wiki modding</th></tr><tr><th class="sidebar-heading">
So, you wanna make a custom race for BG3. How do you do that, though? This guide will show you how.
Modding homepage</th></tr><tr><td class="sidebar-content hlist">
 
*[[Modding:Modding resources|Modding resources]]</td>
[https://github.com/BG3-Community-Library-Team/BG3-Community-Library/wiki/Building-a-Race-Mod Building a Race Mod Guide]
</tr><tr><th class="sidebar-heading">
 
Modding resources</th></tr><tr><td class="sidebar-content hlist">
[https://www.nexusmods.com/baldursgate3/mods/4515 Whispers of the Resource - Custom Race and Subrace Template]
<div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding resources</categorytree></div></td>
 
</tr><tr><th class="sidebar-heading">
== CharacterVisuals _merged.lsf.lsx ==
Modding guides</th></tr><tr><td class="sidebar-content hlist">
Here is where you're going to set up the default look for your race, aka how it looks when the player first selects them on the race menu. This can include hair, head, eyes, tattoos, makeup, and more.
<div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding guides</categorytree></div></td>
 
</tr><tr><th class="sidebar-heading">
Here are some nodes you'll find in the file, and what they do.<syntaxhighlight lang="xml">
Hair modding</th></tr><tr><td class="sidebar-content hlist">
<node id="Object">
<div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Hair modding</categorytree></div></td>
    <attribute id="ForcePresetValues" type="bool" value="True" />
</tr><tr><th class="sidebar-heading">
    <attribute id="GroupName" type="FixedString" value="02Skin Properties" />
Head modding</th></tr><tr><td class="sidebar-content hlist">
    <attribute id="MapKey" type="FixedString" value="02Skin Properties" />
<div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Head modding</categorytree></div></td>
    <attribute id="MaterialPresetResource" type="FixedString" value="7b0d0147-72f1-6b22-b32b-0bfebd47cb85" /> This sets default skin color
</tr><tr><th class="sidebar-heading">
</node>
Armor/clothing modding</th></tr><tr><td class="sidebar-content hlist">
</syntaxhighlight>Skin Color<syntaxhighlight lang="xml">
<div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Armor modding</categorytree></div></td>
<node id="Object">
</tr><tr><td class="sidebar-navbar"><templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Navbar/styles.css"></templatestyles><div class="navbar plainlinks hlist navbar-mini"><ul><li class="nv-view">[[Template:Modding sidebar|<abbr title="View this template">v</abbr>]]</li><li class="nv-talk">[[Template talk:Modding sidebar|<abbr title="Discuss this template">t</abbr>]]</li><li class="nv-edit">[[Special:EditPage/Template:Modding sidebar|<abbr title="Edit this template">e</abbr>]]</li></ul></div></td></tr></table>
    <attribute id="ForcePresetValues" type="bool" value="True" />
<templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Sidebar/styles.css"></templatestyles><table class="sidebar sidebar-collapse nomobile nowraplinks"><tr><th class="sidebar-title">bg3.wiki modding</th></tr><tr><th class="sidebar-heading">
    <attribute id="GroupName" type="FixedString" value="06Eyes" />
Modding namespace</th></tr><tr><td class="sidebar-content">
    <attribute id="MapKey" type="FixedString" value="06Eyes" />
<div class="sidebar-list mw-collapsible mw-collapsed hlist"><div class="sidebar-list-title">Modding</div><div class="sidebar-list-content mw-collapsible-content">
    <attribute id="MaterialPresetResource" type="FixedString" value="da5e8c41-2f06-213f-855b-41291f26e3a6" /> This sets default eye color
*[[Modding:Modding resources|Modding resources]]</div></div></td>
</node>
</tr><tr><td class="sidebar-content">
</syntaxhighlight>Eye Color<syntaxhighlight lang="xml">
<div class="sidebar-list mw-collapsible mw-collapsed hlist"><div class="sidebar-list-title">Modding resources</div><div class="sidebar-list-content mw-collapsible-content"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding resources</categorytree></div></div></div></td>
<node id="Object">
</tr><tr><td class="sidebar-content">
    <attribute id="ForcePresetValues" type="bool" value="True" />
<div class="sidebar-list mw-collapsible mw-collapsed hlist"><div class="sidebar-list-title">Modding guides</div><div class="sidebar-list-content mw-collapsible-content"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding guides</categorytree></div></div></div></td>
    <attribute id="GroupName" type="FixedString" value="05Makeup" />
</tr><tr><td class="sidebar-navbar"><templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Navbar/styles.css"></templatestyles><div class="navbar plainlinks hlist navbar-mini"><ul><li class="nv-view">[[Template:Modding sidebar|<abbr title="View this template">v</abbr>]]</li><li class="nv-talk">[[Template talk:Modding sidebar|<abbr title="Discuss this template">t</abbr>]]</li><li class="nv-edit">[[Special:EditPage/Template:Modding sidebar|<abbr title="Edit this template">e</abbr>]]</li></ul></div></td></tr></table>
<attribute id="MapKey" type="FixedString" value="05Makeup" />
<div class="navbox-styles"><templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Navbox/styles.css"></templatestyles></div><div role="navigation" class="navbox" aria-labelledby="Modding_homepage" style="padding:3px"><table class="nowraplinks mw-collapsible expanded navbox-inner" style="border-spacing:0;background:transparent;color:inherit"><tr><th colspan="2" scope="col" class="navbox-title"><templatestyles src="Hlist/styles.css"></templatestyles><templatestyles src="Module:Navbar/styles.css"></templatestyles><div class="navbar plainlinks hlist navbar-mini"><ul><li class="nv-view">[[Template:Modding navbox|<abbr title="View this template" style=";;background:none transparent;border:none;box-shadow:none;padding:0;">v</abbr>]]</li><li class="nv-talk">[[Template talk:Modding navbox|<abbr title="Discuss this template" style=";;background:none transparent;border:none;box-shadow:none;padding:0;">t</abbr>]]</li><li class="nv-edit">[[Special:EditPage/Template:Modding navbox|<abbr title="Edit this template" style=";;background:none transparent;border:none;box-shadow:none;padding:0;">e</abbr>]]</li></ul></div><div id="Modding_homepage" style="font-size:114%;margin:0 4em">[[Modding:Modding resources|Modding homepage]]</div></th></tr><tr><th scope="row" class="navbox-group" style="width:1%">Modding homepage</th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<attribute id="MaterialPresetResource" type="FixedString" value="d4bf8e65-39c8-f87b-7e2a-ef5d4756aaca" /> This sets default makeup
*[[Modding:Modding resources|Modding homepage]]
</node>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Modding resources</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding resources</categorytree></div></div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Modding guides</th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Modding guides</categorytree></div></div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Hair modding</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Hair modding</categorytree></div></div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Head modding</th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Head modding</categorytree></div></div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Armor/clothing modding</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em"><div class="navcat" ;><categorytree hideprefix="1" hideroot="1" mode="pages">Armor modding</categorytree></div></div></td></tr></table></div>
</syntaxhighlight>Makeup<syntaxhighlight lang="xml">
<node id="Object">
    <attribute id="ForcePresetValues" type="bool" value="True" />
    <attribute id="GroupName" type="FixedString" value="03Hair" />
<attribute id="MapKey" type="FixedString" value="03Hair" />
<attribute id="MaterialPresetResource" type="FixedString" value="536e441f-3fee-c04a-9698-6608ebe70824" /> This sets default hair color
</node>
</syntaxhighlight>Hair Color<syntaxhighlight lang="xml">
<node id="Slots">
    <attribute id="Bone" type="FixedString" value="" />
    <attribute id="Slot" type="FixedString" value="Head" />
    <attribute id="VisualResource" type="FixedString" value="555b1e26-9a79-c11b-134d-a557b317bd93" /> This sets default head
</node>
</syntaxhighlight>Head<syntaxhighlight lang="xml">
<node id="Slots">
<attribute id="Bone" type="FixedString" value="" />
<attribute id="Slot" type="FixedString" value="Hair" />
<attribute id="VisualResource" type="FixedString" value="1dc629c7-382c-3090-e72f-c7f4d44d5e3d" /> This sets default hair style
</node>
</syntaxhighlight>Hair Style
 
== CharacterCreationAppearanceVisuals.lsx ==
Here is where you'll define all of the heads you want your race to use.<syntaxhighlight lang="xml">
<node id="CharacterCreationAppearanceVisual">
    <attribute id="BodyShape" type="uint8" value="0"/>
    <attribute id="BodyType" type="uint8" value="0"/>
    <attribute id="DefaultSkinColor" type="guid" value="fbfbdac7-b88b-840d-2601-e37aa45663ae"/>
    <attribute id="DisplayName" type="TranslatedString" handle="DISPLAYHANDLEHERE" version="3"/>
    <attribute id="RaceUUID" type="guid" value="RACEUUIDHERE"/>
    <attribute id="SlotName" type="FixedString" value="Head"/>
    <attribute id="UUID" type="guid" value="UNIQUEUUIDHERE"/>
    <attribute id="VisualResource" type="guid" value="VISUALRESOURCEUUIDHERE"/>
</node>
</syntaxhighlight>Here is an example node for adding one head. To find the correct Race UUID, see [https://bg3.wiki/wiki/Modding:Race_UUID this page].
{{Modding navbox}}
[[Category:Race and class modding]]

Latest revision as of 14:54, 11 January 2024

bg3.wiki modding
Modding homepage
Modding resources - Meshes, Models, Tools, etc.
Armor/Clothing Texture Maps
Body Models
Custom polymorph
Dependencies
Face and body textures
Fixing bone errors
Fixing neck seams
Fixing UV errors
Getting Started with BG3 Modding
Hair Meshes
Head Models
Mod troubleshooting
Modding class icons
NPC Head Models
Tiefling Horn Models
Non-VT Shaders
Race UUID
Sample Templates
Texture formatting
Tools
TreasureTables References
Tutorials
VertexColorMaskSlots
Working with LSX files
Modding guides
BG3 Mini Tool
Blender Export Settings
Code Snippets
Coding An Item
Compatibility Framework
Creating a custom cloth collider
Creating and Exporting Meshes in Blender
Creating Item Icons
Creating meta.lsx
Creating mods
Editing a Character Creation Preset
Editing Equipment.txt
Hotloading
How To Find A Virtual Texture
Installing mods
Localization
Modding resources
Packaging mods
Texture formatting
Understanding Mod Folder Structure
Unpacking and converting files
Working with LSX files
Hair modding
Creating Custom Hair with Hair Tool
Creating hair merged.lsf with custom texture
Creating Hair Mods
Creating meta.lsx
Custom Hair Highlights
Hair Meshes
Hair Mod File Setup
Hair Mod Mesh Setup
Head modding
Creating meta.lsx
Face and body textures
Fixing neck seams
Head Modding
Head Models
Head Troubleshooting
NPC Head Models
Item modding - Armours, Outfits, Weapons etc.
Armor/Clothing Texture Maps
Coding An Item
Creating and Exporting Meshes in Blender
Creating Armor Mods
Creating Item Icons
Creating meta.lsx
Creating Outfit Textures
Fixing bone errors
How To Find A Virtual Texture
Texture formatting
TreasureTables References
Use Outfit Builder To Refit Outfits
VertexColorMaskSlots
Race/class modding
Creating Race Mods
Editing a Character Creation Preset

So, you wanna make a custom race for BG3. How do you do that, though? This guide will show you how.

Building a Race Mod Guide

Whispers of the Resource - Custom Race and Subrace Template

CharacterVisuals _merged.lsf.lsx[edit | edit source]

Here is where you're going to set up the default look for your race, aka how it looks when the player first selects them on the race menu. This can include hair, head, eyes, tattoos, makeup, and more.

Here are some nodes you'll find in the file, and what they do.
<node id="Object">
    <attribute id="ForcePresetValues" type="bool" value="True" />
    <attribute id="GroupName" type="FixedString" value="02Skin Properties" />
    <attribute id="MapKey" type="FixedString" value="02Skin Properties" />
    <attribute id="MaterialPresetResource" type="FixedString" value="7b0d0147-72f1-6b22-b32b-0bfebd47cb85" /> This sets default skin color
</node>
Skin Color
<node id="Object">
    <attribute id="ForcePresetValues" type="bool" value="True" />
    <attribute id="GroupName" type="FixedString" value="06Eyes" />
    <attribute id="MapKey" type="FixedString" value="06Eyes" />
    <attribute id="MaterialPresetResource" type="FixedString" value="da5e8c41-2f06-213f-855b-41291f26e3a6" /> This sets default eye color
</node>
Eye Color
<node id="Object">
    <attribute id="ForcePresetValues" type="bool" value="True" />
    <attribute id="GroupName" type="FixedString" value="05Makeup" />
	<attribute id="MapKey" type="FixedString" value="05Makeup" />
	<attribute id="MaterialPresetResource" type="FixedString" value="d4bf8e65-39c8-f87b-7e2a-ef5d4756aaca" /> This sets default makeup
</node>
Makeup
<node id="Object">
    <attribute id="ForcePresetValues" type="bool" value="True" />
    <attribute id="GroupName" type="FixedString" value="03Hair" />
	<attribute id="MapKey" type="FixedString" value="03Hair" />
	<attribute id="MaterialPresetResource" type="FixedString" value="536e441f-3fee-c04a-9698-6608ebe70824" /> This sets default hair color
</node>
Hair Color
<node id="Slots">
    <attribute id="Bone" type="FixedString" value="" />
    <attribute id="Slot" type="FixedString" value="Head" />
    <attribute id="VisualResource" type="FixedString" value="555b1e26-9a79-c11b-134d-a557b317bd93" /> This sets default head
</node>
Head
<node id="Slots">
	<attribute id="Bone" type="FixedString" value="" />
	<attribute id="Slot" type="FixedString" value="Hair" />
	<attribute id="VisualResource" type="FixedString" value="1dc629c7-382c-3090-e72f-c7f4d44d5e3d" /> This sets default hair style
</node>
Hair Style

CharacterCreationAppearanceVisuals.lsx[edit | edit source]

Here is where you'll define all of the heads you want your race to use.
<node id="CharacterCreationAppearanceVisual">
    <attribute id="BodyShape" type="uint8" value="0"/>
    <attribute id="BodyType" type="uint8" value="0"/>
    <attribute id="DefaultSkinColor" type="guid" value="fbfbdac7-b88b-840d-2601-e37aa45663ae"/>
    <attribute id="DisplayName" type="TranslatedString" handle="DISPLAYHANDLEHERE" version="3"/>
    <attribute id="RaceUUID" type="guid" value="RACEUUIDHERE"/>
    <attribute id="SlotName" type="FixedString" value="Head"/>
    <attribute id="UUID" type="guid" value="UNIQUEUUIDHERE"/>
    <attribute id="VisualResource" type="guid" value="VISUALRESOURCEUUIDHERE"/>
</node>
Here is an example node for adding one head. To find the correct Race UUID, see this page.
Retrieved from "https://dev.bg3.wiki/w/index.php?title=Modding:Creating_Race_Mods&oldid=142580"