Difference between revisions of "HPL3/Modding/Mod Dependencies"
< HPL3
Jump to navigation
Jump to search
m |
|||
Line 1: | Line 1: | ||
{{shortPageTitle}} | {{shortPageTitle}} | ||
− | + | Mod dependencies provide a solution sharing mod content across multiple other mods. A few mods could depend on a parent mod to derive assets and other content from, instead of including it in their own mod. | |
− | |||
==When to Use Mod Dependencies== | ==When to Use Mod Dependencies== | ||
− | The main occasion to use Mod Dependencies is when you want to distribute assets packs which include models, textures, materials, scripts, etc for people to use freely in their own mods. | + | [[File:Mod-dependencies-diagarm.png|thumb|A simple diagram showing the process of a mod dependency. Several mods take resources from one source. Both mods can use the castle assets pack.|500x500px]] |
+ | *The main occasion to use Mod Dependencies is when you want to distribute assets packs which include models, textures, materials, scripts, etc for people to use freely in their own mods. | ||
+ | *Mod dependencies can help to reduce the mod size you want to distribute, as a big portion of the assets themselves are not actually included in the mod, but come from an external source. | ||
+ | {{clr}} | ||
==Setting Up a Mod Dependency== | ==Setting Up a Mod Dependency== | ||
− | In order to | + | In order to turn a regular mod into a mod dependency, the mod's [[HPL3/SOMA/Modding/Creating_a_Mod#Mod_Entry_File|entry file]] needs to have a special attribute called <code>UID</code>. This is used so other mods can reference your mod as a dependency. The convention of naming a UID is the form <code>provider_name.mod_name</code>. For example, if the mod creator is named <code>steve</code> and the mod name is called <code>Castle Assets Pack</code>, the <code>UID</code> for the mod will be <code>steve.castle_assets_pack</code>. |
+ | |||
+ | In order to set a <code>UID</code> manually for a mod: | ||
+ | |||
+ | #Open the mod's entry [[HPL3/SOMA/Modding/Creating_a_Mod#Mod_Entry_File|entry file]]. | ||
+ | #Inside, add an attribute called <code>UID</code> and give it a name.: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <?xml version="1.0" encoding="UTF-8"?> | ||
+ | <Content Version="1.0" | ||
+ | Type="StandAlone" | ||
+ | Title="Your mod name here" | ||
+ | Author="Your name here" | ||
+ | Description="Mod description here" | ||
+ | |||
+ | UID="steve.castle_assets_pack" | ||
+ | |||
+ | LauncherPic="LauncherPic.png" | ||
+ | InitCfg="config/main_init.cfg" | ||
+ | /> | ||
+ | </syntaxhighlight> | ||
+ | |||
==Using a Mod Dependency== | ==Using a Mod Dependency== | ||
just use it idk | just use it idk | ||
+ | |||
+ | ==See Also== | ||
+ | *[[HPL3/SOMA/Modding/Creating_a_Mod|Creating a Mod]] | ||
+ | *[[HPL3/Resources_Configuration|Resources Configuration]] | ||
[[Category:Modding]] | [[Category:Modding]] | ||
[[Category:English]] | [[Category:English]] |
Revision as of 20:29, 26 August 2020
Mod dependencies provide a solution sharing mod content across multiple other mods. A few mods could depend on a parent mod to derive assets and other content from, instead of including it in their own mod.
Contents
When to Use Mod Dependencies
- The main occasion to use Mod Dependencies is when you want to distribute assets packs which include models, textures, materials, scripts, etc for people to use freely in their own mods.
- Mod dependencies can help to reduce the mod size you want to distribute, as a big portion of the assets themselves are not actually included in the mod, but come from an external source.
Setting Up a Mod Dependency
In order to turn a regular mod into a mod dependency, the mod's entry file needs to have a special attribute called UID
. This is used so other mods can reference your mod as a dependency. The convention of naming a UID is the form provider_name.mod_name
. For example, if the mod creator is named steve
and the mod name is called Castle Assets Pack
, the UID
for the mod will be steve.castle_assets_pack
.
In order to set a UID
manually for a mod:
- Open the mod's entry entry file.
- Inside, add an attribute called
UID
and give it a name.:
<?xml version="1.0" encoding="UTF-8"?>
<Content Version="1.0"
Type="StandAlone"
Title="Your mod name here"
Author="Your name here"
Description="Mod description here"
UID="steve.castle_assets_pack"
LauncherPic="LauncherPic.png"
InitCfg="config/main_init.cfg"
/>
Using a Mod Dependency
just use it idk