diff --git a/README.md b/README.md index e22e5f5..ee4c9eb 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,8 @@ limitations under the License. 1. Clone the Repo 1. Open ModSkeleton.uproject 1. Be sure to select "View Options" -> "Show Plugin Content" in the Content browser to see Example Plugin Content +1. Follow [Instruction to Build Custom Launcher Profiles](docs/build_profiles/build_profiles.md) 1. Disable the ModSkeletonExamplePluginA plugin (Edit -> Plugins -> "ModSkeleton" section) -1. Create "Project Launcher" Custom profiles, as detailed in: https://wiki.unrealengine.com/Modding:_Adding_mod-support_to_your_Unreal_Engine_4_project -1. Be sure the "Name of the dlc to build." in the second (plugin) profile is set to "ModSkeletonExamplePluginA" 1. Execute the Full Game launch profile for your platform 1. Enable the ModSkeletonExamplePluginA plugin 1. Execute the Mod launch profile for you platform - note this may fail, but not before generating the needed .pak and AssetRegistry files diff --git a/doc/build_profiles/build_profiles.md b/doc/build_profiles/build_profiles.md new file mode 100644 index 0000000..29f35ec --- /dev/null +++ b/doc/build_profiles/build_profiles.md @@ -0,0 +1,102 @@ +# Custom Build Profile For Generating ModSkeleton Mods + +ModSkeleton Mods build on top of Unreal Engine 4's DLC system. In order to cook and package a Mod, we're going to create two Custom Project Launcher Profiles. First, one to build the base game. Second, we're going to create a Profile for our DLC / Plugin / Mod, referencing the base game version. + +## 1 - The Base Game + +#### 1.1 - Open the Project Launcher + +![Open Project Launcher](open_project_launcher.jpg) + +#### 1.2 - Create a New Custom Profile + +![Create Custom Profile](new_profile.jpg) + +#### 1.3 - Give Your Profile A Name + +![Name Profile](main_1_name.jpg) + +#### 1.4 - Tell the Profile to Build + +![Build](main_2_build.jpg) + +#### 1.5 - Tell it to Cook "By the Book" + +- pick the platform you would like to cook for + +![Cook By the Book](main_3_cook_book.jpg) + +#### 1.6 - Cooking "Release" Settings + +- Check "Create a release version of the game for distribution" +- Give a version name under "Name of the new release to create" + +![Cook Release Settings](main_4_cook_release.jpg) + +#### 1.7 - Cooking "Advanced" Settings + +- Uncheck "Save packages without versions" +- Check "Store all contents in a single file (UnrealPak)" + +![Cook Advanced Settings](main_5_cook_advanced.jpg) + +#### 1.8 - Package Locally + +- Set to Package and Store Locally + +![Package and Store Locally](main_6_package.jpg) + +#### 1.9 - Do Not Deploy + +![Do Not Deploy](main_7_deploy.jpg) + +## 1 - The Mod (ModSkeletonExamplePluginA) + +#### 1.1 - Open the Project Launcher + +![Open Project Launcher](open_project_launcher.jpg) + +#### 1.2 - Create a New Custom Profile + +![Create Custom Profile](new_profile.jpg) + +#### 1.3 - Give Your Profile A Name + +![Name Profile](plugin_1_name.jpg) + +#### 1.4 - Tell the Profile to Build + +![Build](main_2_build.jpg) + +#### 1.5 - Tell it to Cook "By the Book" + +- pick the platform you would like to cook for + +![Cook By the Book](main_3_cook_book.jpg) + +#### 1.6 - Cooking "Release" Settings + +- Un-Check "Create a release version of the game for distribution" +- Leave "Name of the new release to create" blank +- Set "Release version this is based on." the same version string as in your base profile +- Check "Build DLC" +- Set "Name of the DLC to build." to "ModSkeletonExamplePluginA" + +![Cook Release Settings](plugin_4_cook_release.jpg) + +#### 1.7 - Cooking "Advanced" Settings + +- Uncheck "Save packages without versions" +- Check "Store all contents in a single file (UnrealPak)" + +![Cook Advanced Settings](main_5_cook_advanced.jpg) + +#### 1.8 - Package Locally + +- Set to Package and Store Locally + +![Package and Store Locally](main_6_package.jpg) + +#### 1.9 - Do Not Deploy + +![Do Not Deploy](main_7_deploy.jpg) diff --git a/doc/build_profiles/main_1_name.jpg b/doc/build_profiles/main_1_name.jpg new file mode 100644 index 0000000..f9a48ee Binary files /dev/null and b/doc/build_profiles/main_1_name.jpg differ diff --git a/doc/build_profiles/main_2_build.jpg b/doc/build_profiles/main_2_build.jpg new file mode 100644 index 0000000..8f65a7d Binary files /dev/null and b/doc/build_profiles/main_2_build.jpg differ diff --git a/doc/build_profiles/main_3_cook_book.jpg b/doc/build_profiles/main_3_cook_book.jpg new file mode 100644 index 0000000..89e7f01 Binary files /dev/null and b/doc/build_profiles/main_3_cook_book.jpg differ diff --git a/doc/build_profiles/main_4_cook_release.jpg b/doc/build_profiles/main_4_cook_release.jpg new file mode 100644 index 0000000..f964ab1 Binary files /dev/null and b/doc/build_profiles/main_4_cook_release.jpg differ diff --git a/doc/build_profiles/main_5_cook_advanced.jpg b/doc/build_profiles/main_5_cook_advanced.jpg new file mode 100644 index 0000000..65d0972 Binary files /dev/null and b/doc/build_profiles/main_5_cook_advanced.jpg differ diff --git a/doc/build_profiles/main_6_package.jpg b/doc/build_profiles/main_6_package.jpg new file mode 100644 index 0000000..a6d1eaf Binary files /dev/null and b/doc/build_profiles/main_6_package.jpg differ diff --git a/doc/build_profiles/main_7_deploy.jpg b/doc/build_profiles/main_7_deploy.jpg new file mode 100644 index 0000000..21c8bf7 Binary files /dev/null and b/doc/build_profiles/main_7_deploy.jpg differ diff --git a/doc/build_profiles/new_profile.jpg b/doc/build_profiles/new_profile.jpg new file mode 100644 index 0000000..82db3a4 Binary files /dev/null and b/doc/build_profiles/new_profile.jpg differ diff --git a/doc/build_profiles/open_project_launcher.jpg b/doc/build_profiles/open_project_launcher.jpg new file mode 100644 index 0000000..0d649f7 Binary files /dev/null and b/doc/build_profiles/open_project_launcher.jpg differ diff --git a/doc/build_profiles/plugin_1_name.jpg b/doc/build_profiles/plugin_1_name.jpg new file mode 100644 index 0000000..2650444 Binary files /dev/null and b/doc/build_profiles/plugin_1_name.jpg differ diff --git a/doc/build_profiles/plugin_4_cook_release.jpg b/doc/build_profiles/plugin_4_cook_release.jpg new file mode 100644 index 0000000..6183dbf Binary files /dev/null and b/doc/build_profiles/plugin_4_cook_release.jpg differ