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