Difference between revisions of "Modding guide"

From Edge Of Eternity - Eternal Forge Modkit Wiki
Jump to: navigation, search
(Basic setup)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Basic setup==
+
==[[Setup build upload| Setup, build and upload]]==
1. First you have to download and install Unity 2018.2.x (the version will change as the game will progress further,
+
[[Setup build upload#Basic setup|Basic setup]]
  
we’ll update this guide and notify that we changed the Unity version)
+
[[Setup build upload#Building and testing|Building and testing]]
  
https://unity3d.com/get-unity/update
+
[[Setup build upload#Uploading to steam|Uploading to steam]]
  
 +
==[[General modding]]==
 +
[[General modding#Scripting basics|Scripting basics]]
  
2. Download the modkit content and modkit samples on GitHub (you can download directly using the clone or download
+
[[General modding#Making an additive scene|Making an additive scene]]
  
option then download as a zip but it’s highly suggested to use TortoiseGit to be able to quickly upgrade the modkit afterward)
+
==[[Specific mods]]==
 +
[[Specific mods#Model swap|Model swap]]
  
https://github.com/zelerj/eoemodworks/
+
[[Specific mods#Spell|Spell]]
  
 +
[[Specific mods#Playable character|Playable character]]
  
3. You can now open any of the sample Unity projects included in the modkit content or you can start from the empty
+
[[Specific mods#Items|Items]]
  
project but it’s better at first to start from a sample template.
+
[[Specific mods#Quests and NPCs|Quests and NPCs]]
  
 +
[[Specific mods#Dungeons|Dungeons]]
  
4. Install the databank (allow you to reuse objects of the game in custom levels or in levels modifications)(Optional Step)
+
[[Specific mods#Standalone adventure|Standalone adventure]]
  
First you need to download and install the databank from the steam workshop here:
+
[[Specific mods#Dynamic events|Dynamic events]]
  
https://steamcommunity.com/sharedfiles/filedetails/?id=1285627706
+
[[Specific mods#Auras|Auras]]
  
The databank doesn't appear in the Edge of Eternity Game Folder. So you need to go into your default Steam installation.
+
[[Specific mods#Nodes for nodal tool|Nodes for nodal tool]]
 
 
Navigate into your workshop content folder: steamapps->workshop->content. You need to locate the correct mod which can be a
 
 
 
bit tricky, but the correct one has 4 files inside with names referencing Databank.
 
 
 
Back in your Unity Project, in your root Assets Folder, Create a Folder called Databank. Inside of the Databank folder,
 
 
 
drag all four workshop files into this empty folder. Now at the top, select EOE Mods Toolkit -> Import Databank.
 
 
 
Press the Import button at the bottom. Now inside of the Databank folder you created, there should be a new eoe folder,
 
 
 
with all the necessary prefabs inside. You can use any of these in your mods, and any mod you upload to the workshop will
 
 
 
require users to download the Databank workshop item.
 
 
 
 
 
5. Install the levelkit (allow you to see in the editor the actual game levels for precise (Optional Step)
 
 
 
placement of elements during level modifications)
 
 
 
https://drive.google.com/file/d/1z9kyO33xjoSRw6LtAowpOV7fhS9H--c_/view?usp=sharing
 
 
 
Unzip the folder at the root of the Unity project that contains your mod (not in the Assets directory in the parent directory)
 
===How to setup mod settings===
 
1. Open the mod settings window by going into the menu "EOE Mods Toolkit -> Mod Settings" on the menu bar ontop of the screen
 
 
 
2. Create a unique Mod Identifier for your mod (warning : if two mods share the same Mod Identifier they will not be compatible
 
 
 
together, with the Mod Identifier you'll be able to cross-reference mods)
 
 
 
3. Fill the mods metadata like the miniature, mod name, mod description, those will be used for the ingame display of the mod
 
 
 
(not the workshop), the standalone adventure checkbox allow you to override the beginning of the adventure and set another map
 
 
 
as the default map ingame so you can create another adventure from scratch with the Edge Of Eternity Modkit using the rules
 
 
 
of the game or you custom ones using the scripting engine (the user will get a choice when trying to start the game he will
 
 
 
be able to choose between the normal game or the custom adventures mods)
 
 
 
==Building and testing==
 
1. Open the local mod build window by going into the menu "EOE Mods Toolkit -> Build Mod" on the menu bar ontop of the screen
 
 
 
2. Fill the mod directory from your game path on Steam like in the example screenshots below
 
 
 
3. Ensure that auto-tag assets is checked and click the build button
 
 
 
4. Launch your game, the mod is ready to be tested, you'll be able to find it in the mod window of the game
 
 
 
(in the main menu click on the mods button)
 
 
 
==Uploading to steam==
 
1. Open the Steam Workshop upload window by going into the menu "EOE Mods Toolkit -> Upload to Steam Workshop" on the menu bar on top of the screen
 
 
 
2. Fill the metadatas (key image, screenshots, name, description, tags, etc...) and then click create mod (if you are updating an existing one the
 
 
 
case will be update mod and if you loose the link to your mod you can reattach it in the manage my workshop section)
 
 
 
3. Click upload to the workshop and it will be visible a few minutes afterward in the Steam Workshop (please test your mods locally before uploading them to the workshop)
 
 
 
==Model swap==
 
1. Import your rigged FBX model in your Unity Project.
 
 
 
2. Set the rig type to humanoid and ensure that the T-Pose is correctly matched with the humanoid
 
 
 
3. Drag and drop the model on the scene
 
 
 
4. Scale it correctly using the reference model provided (neutral model) that is the scale of Daryon for reference
 
 
 
5. Remove the Animator component, add the component SetCustomAnimationAvatar and put the animation avatar of your character in the
 
 
 
avatar slot of the SetCustomAnimationAvatar component
 
 
 
6. Choose an unique name for your GameObject and create a prefab in the project from it
 
 
 
7. Open the Asset Override Manager located in the "EOE Mods Toolkit -> Asset Override Manager" menu
 
 
 
8. Add a new entry and choose the entity that you want to override in the source entry "builtin" dropdown
 
 
 
9. In the replacement path enter the unique name of your GameObject that you prefabed
 
 
 
(without the path, just the name of the Prefab), then in the Asset Load Method for the replacement choose
 
 
 
"Asset Bundles Mod Kit" and finally in the DLC or Mod ID enter the unique mod ID that you put in the Mod Settings Window
 
 
 
10. You are now ready to build and test your mod using the procedure described in the "Build Mod Locally" section of the guide
 
 
 
==Spell==
 
 
 
==Playable character==
 
 
 
==Items==
 
 
 
==Quests and NPCs==
 
 
 
==Dungeons==
 
 
 
==Standalone adventure==
 
 
 
==Dynamic events==
 
 
 
==Auras==
 
 
 
==Nodes for nodal tool==
 

Latest revision as of 21:24, 20 December 2018