GZDOOM 3D WEAPON MODEL TUTORIAL
Note: The README File Contains Same Steps Outlined.
Link To Files: Moddb.com
Steps:
1. Installation
Introduction: One Of The Biggest Headscratchers For GZDoom Modders And Causes Huge Divides In The GZDOOM Community Is The Creation Of 3D Models. A Lot Of Us Have Seen The Incredible Projects Made With 3D Models, But Don't Know Where To Start. This Tutorial Aims To Rectify This Dilemma.
Requirements: Doom 2 IWAD Windows 10/11 GZDoom 4.10.0 or Higher 65 MB Minimum Hard Drive Space 3D Acceleration Card With OpenGL Support OpenGL 4.0 or Higher Slade 3 And Blender 4.0 (Blender 4.1 Untested) Noesis Highly Recommended Full Screen Mode Highly Recommended
Begin The Tutorial: To Begin, Download And Extract The Contents Of The GZDoom 3D Weapon Model Tutorial Archive. Verify That Each Component Listed Above Meets The Requirements Before Continuing, Then Open The Tutorial Files Folder.
2. Setup Blender
a. You Will Need To Setup Blender Before Getting To The Juicy Parts Of This Tutorial. Copy The io_export_gzdoom_md3.py File Into The Addons Folder Then Open The Blender File Provided.
b. Select Edit -> Preferences Then Click On The Addons Tab. Scroll Down To Find Import-Export: GZDoom .MD3 Then Click On The Checkbox On The Left.
3. Export Blender Model As A .MD3 File
a. After Opening The Model In Blender, You Will Want To Export It As A .MD3 Model. Watch The Animation, Then Export The Model By Selecting File -> Export -> ID3 MD3 (.md3).
b. Select The Location You Want To Save The Model At, Then Type 0 In The Start Frame Box And 205 In The End Frame Box.
c. Name It pistol.md3 And Click On The Blue Export Box On The Bottom Right To Start Exporting.
4. Setup .pk3 In Slade 3
a. You Have Now Exported The Model, Congratulations! You Will Now Need To Setup Your .pk3 In Slade3. Open Slade 3 And Click On The Page Icon On The Top To Create A New Archive.
b. Select Zip Archive In The Type Box And Click Create.
5. Create .pk3 Folder Hierarchy
In Our Newly Created Zip Archive, We Will Need To Create A Hierarchy Of Folders And Subfolders For Our Files
Create The Following Hierarchy Structure In Your Zip Archive (Click On The Folder + Icon To Create A New Folder) Then
Import The Specified Files:
6. Define The MODELDEF File
a. We Will Need A MODELDEF File To Define Our Model And It's Animations. Create A New Text File (Click On The Page Icon And Select Text In The Type Box) Then Select GZDoom ModelDef In The Text Language Box. b. Type The Following In The MODELDEF File:
7. Define The DECORATE Files
a. For This Tutorial, We Will Use DECORATE For Our Simplified Weapon Scripts. Create The DECORATE Text File Outside The Decorate Folder As Well As The M1911.txt And Player.txt Text Files Inside The Decorate Folder. Select The Text Language As ZDoom Decorate.
b. Type The Following In The DECORATE File:
#include "decorate/M1911.txt"
#include "decorate/PLAYER.txt"
c. Now Type The Following In The M1911.txt File:
d. Now Type The Following In The Player.txt File:
ACTOR PlayerCharacter: DoomPlayer
{
Player.Displayname Player_Character
Player.StartItem "M1911" Player.StartItem
"PistolAmmo", 15
Player.StartItem "FIST"
}
//Note: Some Mods Are Incompatible With This Setup (such as MyHouse.pk3)
8. Define Miscellaneous Files
a. These Other Files Are Crucial For This Project To Compile And Run Correctly. First Create A SNDINFO Text File (Text Language Is ZDoom SndInfo) And Type The Following:
weapons/pistoldeploy DEPLOY
weapons/pistolshoot FIRE
weapons/pistolout OUT
weapons/pistolin IN
weapons/pistollock LOCKED
weapons/pistolslide SLIDE
b. Next, Create A KEYCONF Text File (Text Language Is ZDoom KeyConf) And Type The Following:
clearplayerclasses
addplayerclass PlayerCharacter
c. Finally, Create A TEXTURES Text File (Text Language Is ZDoom Textures) And Type The Following:
// Texture definitions generated by SLADE3// on Thu Jun 6 21:01:34 2024
Sprite "191IA0", 1, 1
{
Patch "TNT1A0", 0, 0
}
// End of texture definitions
9. Final Project Results
Click On The Floppy Disk Icon To Save Your Project As A .pk3 File And Name It Something Cool.
10. Test And Refine
a. Test Your Project And Verify That It Is Working As It Should. Refer To The Example File For Tips And How To Create A 3D Weapon Worldmodel For Your Project.
b. Leave Any Comments If You Have Any Questions.
A1. Credits
All Scripts Created By ISIGHTGAMESDEV (AKA IVEGOTSOMEWATER)
Weapon Model And Sounds Taken From Left 4 Dead (With Custom Hand Models Created By ISIGHTGAMESDEV)
© 2008 Valve Corporation
Blender MD3 Export Plugin By Nash
A2. License Notice
The Example.pk3 file runs on the GZDOOM Engine. Do not copy the application or code for GZDOOM or the Example.pk3 file.
If you are going to use the weapons scripts in the Example.pk3 file, please credit me for the use of these scripts.
Example:
-ISIGHTGAMESDEV, GZDoom 3D Weapon Model Scripts
Thanks For Reading!
