first commit

README.md

@@ -0,0 +1,56 @@
+# TODO: Make readmes for entire project
+
+- Need to establish a sort of protocol like flow.
+- The idea is to be able to parse this info later to do amazing l=things like compile parts lists, sources and even full models if all STL files are there.
+
+# Open Source Ordnance
+
+Welcome to Open Source Ordnance, a repository dedicated to providing open-source 3D printed weapons, weapon parts, and modifications for self-defense. This project aims to ensure accessibility and self-defense capabilities for individuals under various circumstances.
+
+## Table of Contents
+
+1. [Weapons](weapons/README.md)
+2. [Weapon Parts and Mods](weapon_parts_and_mods/README.md)
+   - [Functional Mods](weapon_parts_and_mods/functional_mods/README.md)
+     - Add Subdirectories here...
+   - [Gear Mods](weapon_parts_and_mods/gear_mods/README.md)
+   - [Vital Parts](weapon_parts_and_mods/vital_parts/README.md)
+
+## Project Structure
+THIS IS JUST PALCEHOLDER MOSTLY FOR NOW
+### Weapons
+
+The `weapons` folder contains a collection of Markdown documents, each dedicated to a unique weapon. These documents provide detailed information, instructions, and credits for each weapon model.
+
+### Weapon Parts and Mods
+
+#### Functional Mods
+
+The `functional_mods` directory includes 3D printable modifications that enhance the functionality of weapons. Inside, you'll find a `models` folder containing the 3D models and corresponding Markdown documents with information on linked items, required items, usage instructions, and credits.
+
+#### Gear Mods
+
+The `gear_mods` directory encompasses 3D printed gear modifications for weapons. Like the functional mods, it has a `models` folder with associated Markdown documents detailing linked items, required items, usage guidelines, and credits.
+
+#### Vital Parts
+
+In the `vital_parts` directory, you'll find essential 3D printed components crucial for the proper functioning of weapons. The `models` folder contains 3D models, and the Markdown documents offer information on linked items, required items, usage instructions, and credits.
+
+## How to Contribute
+
+We welcome contributions from the community to enhance the repository. To contribute, please follow these steps:
+
+1. Fork the repository.
+2. Create a branch for your changes.
+3. Make your modifications.
+4. Submit a pull request.
+
+## Credits
+
+We appreciate the efforts of all contributors who make Open Source Ordnance possible. Please check individual Markdown documents for specific model credits.
+
+## Disclaimer
+
+This project is meant for educational purposes and lawful self-defense. Ensure compliance with local laws and regulations before using or distributing any 3D printed weapons or components.
+
+Stay safe, and exercise responsible use of technology for self-defense.

Weapon Parts & Modifications/Gear Modifications/Charging Handles/MAC-11 Charging Handle.md

@@ -0,0 +1,10 @@
+# MAC-11 Charging Handle
+
+## Component Type: Off The Shelf
+
+![MAC-11 Charging Handle](content/*)
+
+MAC-11s can have either a side or top charging handle depending on the manufacturer.
+Most will come included with a [MAC-11 Bolt Carrier Group](../../Vital%20Parts/Bolt%20Carrier%20Groups/MAC-11%20Bolt%20Carrier%20Group.md)
+
+### Sources

Weapon Parts & Modifications/Vital Parts/Barrels/MAC-11 Barrel.md

@@ -0,0 +1,9 @@
+# MAC-11 Barrel
+
+## Component Type: Off The Shelf
+
+![MAC-11 Barrel](content/*)
+
+MAC-11 Barrels will come included in most [Stripped Upper Receivers](../Recievers%20%26%20Slides/MAC-11%20Stripped%20Upper%20Receiver.md)
+
+### Sources

Weapon Parts & Modifications/Vital Parts/Bolt Carrier Groups/MAC-11 Bolt Carrier Group.md

@@ -0,0 +1,15 @@
+# MAC-11 Bolt Carrier Group
+
+## Component Type: Off The Shelf
+
+![MAC-11 Bolt Assembly](content/*)
+
+![MAC-11 Firing Pin](content/*)
+
+A short Description of the BCG
+
+### Sources
+
+# TODO: Add stripped upper Sources
+
+contains firing pin (sources for a firing pin nad image here)

Weapon Parts & Modifications/Vital Parts/Miscelaneous Parts/MacDaddy FeedRamp.md

@@ -0,0 +1,11 @@
+# MacDaddy FeedRamp
+
+## Component Type: Printed & Off The Shelf
+
+### Models
+
+[MacDaddy Feed Ramp](models/Aveees_Mac_Daddy_Feed_Ramp.stl)
+
+### Sources
+
+-

Weapon Parts & Modifications/Vital Parts/Recievers & Slides/MAC-11 Stripped Upper Receiver.md

@@ -0,0 +1,19 @@
+# MAC-11 Stripped Upper Receiver
+
+## Component Type: Off The Shelf
+
+![MAC-11 Stripped Upper Receiver](content/MAC-11%20Stripped%20Upper%20Receiver.png)
+
+The Mac11 Upper Reciever is distributed by a wide number of manufacturers in the US.
+
+### Sources
+
+- [AVES Rails](https://www.avesrails.com/Mac-11-Upper-Receivers-_c_24.html)
+  - includes [MAC-11 Barrel](../Barrels/MAC-11%20Barrel.md)
+- 
+
+# TODO: Add stripped upper Sources
+
+#### Linked Parts
+
+- [MAC-11 Barrel](../Barrels/MAC-11%20Barrel.md)

Weapon Parts & Modifications/Vital Parts/Recievers & Slides/MAC-11 Upper Receiver.md

@@ -0,0 +1,31 @@
+# MAC-11 Upper Receiver
+
+## Component Type: Off The Shelf
+
+![MAC-11 Upper Receiver](content/MAC-11%20Upper%20Receiver.jpg)
+
+The Mac11 Upper Reciever is distributed by a wide number of manufacturers in the US.
+
+### Sources
+
+- [Velocity Firearms](https://www.velocityfirearms.com/product-category/vmac9/vmac9-upper-kits/)
+- [AVES Rails](https://www.avesrails.com/Mac-11-Complete-54-Upper-Receiver-Assembly-Cerakote_p_61.html)
+- [GunBroker Search](https://www.gunbroker.com/All/search?Keywords=mac11%20upper%20receiver)
+
+### Mac11 Variant Manufacturers
+
+- Cobray M11
+- [MasterPiece Arms](https://masterpiecearms.com/cat/defender-series/pistols/9mm/)
+- [Velocity Firearms](https://www.velocityfirearms.com/) (VMAC9)
+
+**linked Manufacturers are currently producing firearms*
+
+---
+
+#### Linked Parts
+
+- [Stripped Upper Receiver](../Recievers%20%26%20Slides/MAC-11%20Stripped%20Upper%20Receiver.md)
+- [MAC-11 Charging Handle](../../Gear%20Modifications/Charging%20Handles/MAC-11%20Charging%20Handle.md)
+- [MAC-11 Bolt Carrier Group](../Bolt%20Carrier%20Groups/MAC-11%20Bolt%20Carrier%20Group.md)
+  - MAC-11 Firing Pin
+- [MAC-11 Barrel](../Barrels/MAC-11%20Barrel.md)

Weapon Parts & Modifications/Vital Parts/Recievers & Slides/MacDaddy Lower Receiver.md

@@ -0,0 +1,174 @@
+# MacDaddy Lower Receiver
+
+## Component Type: Printed
+
+![Mac-Daddy Lower Receiver](content/MacDaddy%20Lower%20Receiver/MacDaddy%20Lower%20Receiver.webp)
+
+The MacDaddy Lower Receiver was Originally Designed by FMDA1776 & CRTL+PEW and later revised by xYeezySZN which added an aesthetic update.
+
+## Models
+
+[MacDaddy Lower Reciever STL](models/MacDaddy%20Lower%20Receiver.stl)
+
+[MacDaddy Lower Reciever STEP](models/MacDaddy%20Lower%20Reciever.step)
+
+### Required Tools
+
+### Material Choice
+
+Material choice is PLA+/PLA Pro, from reputable brands like Polymaker or ESUN. (Note: the PolyTerra line of filaments will yield a structurally deficient frame, one user reported 4 shots before the frame broke.) Exotic filaments like Nylon, Nylon+CF/GF, Polycarbonate have reported mixed experiences so proceed with caution.
+
+### Printer Settings and Calibration
+
+Calibrating your 3D printer is paramount to producing a print that will reliably and safely function for thousands of rounds. It would behoove the end user to complete a PID auto tune on their printer, as well as calibrate ESTEPS/mm and print a 20mm calibration cube to verify that the 3D printer is producing geometrically accurate parts. Much has been said already on this topic so please look to YouTube for helpful guides on printer calibration.
+
+#### Lower Receiver
+
+This print will take up the entirety of the print bed on an Ender 3. Users have been able to use a brim of 3 or 4 0.4mm wide walls, but any more brim than this will not fit, so you may want to turn brim off completely. (Note: If you have an Ender 3, you will need to change your machine settings in Cura to reflect that of an Ender 3 Pro in order to make use of the whole print surface.)
+The stippling pattern is optimally printed at 0.12mm – 0.16mm layer height for best quality, with 0.24mm being the suggested maximum layer height.
+
+![1](content/MacDaddy%20Lower%20Receiver/Printer%20Settings%20and%20Calibration/1.png)
+
+##### Print Settings
+
+- Layer Height: 0.16-0.2
+- Wall Line Count: 8-12
+- Infill: 99%, absolutely no less
+- Supports: Everywhere
+- Support X/Y Distance: ~0.8-1.0
+- Support Z Distance: ~0.15-0.2 depending on layer height
+- Cooling Fan: on at layer 3, 100% speed
+
+## Assembly
+
+Once the main frame is complete and the user has prepped the frame by removing all support material, the next steps are to ream the holes for the various screws and pins.
+
+The hole that the grip screw gets threaded into is purposely under-sized. The best practice here is for the end user to ream this hole with a #3 (0.213") drill bit and tap with a 1/4x28 thread tap. This is arguably the most delicate part of the assembly so go slow and have a steady hand – a crack in this part of the frame will structurally jeopardize the entire assembly.
+
+![1](content/MacDaddy%20Lower%20Receiver/Assembly/1.png)
+
+The “main pin” hole is deliberately undersized as well to ensure a very snug fit. The user may need to remove a tiny bit of material before the pin will fit at all. The pin should be tapped in with a few loving taps of a brass/nylon hammer and NOT be able to be easily removed by hand. Once the pin fits in the hole without the upper receiver, remove the pin and move to the next step.
+
+![2](content/MacDaddy%20Lower%20Receiver/Assembly/2.png)
+
+The AR trigger pins and feed ramp pin are also deliberately (albeit just slightly) undersized as well to help keep the pins from moving once installed. User may need to ream these holes until the pins can be driven in with a few loving taps of a gunsmithing hammer, NOT pounded in with great force.
+
+![3](content/MacDaddy%20Lower%20Receiver/Assembly/3.png)
+*Left to right: AR trigger pin, AR hammer pin, MacDaddy Feed Ramp Pin*
+
+Once these pin holes are verified to be the correct size, move to the next step: installing the safety selector (pictured below)
+
+![4](content/MacDaddy%20Lower%20Receiver/Assembly/4.png)
+
+The safety selector hole is deliberately undersized for best retention and function. User should install the selector drum, with the arrow on the LEFT side of the frame pointing at the “SAFE” text, and push through to the right side of the frame with your hands (or a gentle tap with a gunsmithing hammer).
+
+- User should be able to rotate the drum with a small amount of resistance. If you find that you cannot rotate the drum with your bare hands, the holes are too tight, and remove a tiny amount of material from these holes with sandpaper or a small steel file and try again.
+- Once user is content with fitment of the drum, flip the frame upside down and proceed.
+
+### Installing The Grip
+
+With the frame upside down and the safety selector drum installed, place the detent pin into the frame so that it rests in the grove of the safety selector. Next, place the safety selector detent pin spring in the corresponding hole of the grip, and press the grip into place so that the spring is resting (and applying force) to the detent pin. (See Figure A)
+
+![5](content/MacDaddy%20Lower%20Receiver/Assembly/5.png)
+
+- User will need to hold the grip in place, and with a long 3/16” hex key, thread the AR grip screw with the crush washer through the top of the grip into the bottom of the frame. (see Figure B)
+
+![6](content/MacDaddy%20Lower%20Receiver/Assembly/6.png)
+
+- The installation of the grip is the most delicate part of the assembly. The builder should ensure not to over tighten this grip to the frame – overtightening could result in a cracked frame, seriously jeopardizing the structural integrity of the firearm. A steady hand and good judgement are key.
+
+### Installing the AR-15 trigger
+
+- Much has already been said about installing the AR trigger elsewhere on the internet, it is the same process on the MacDaddy as a millspec AR-15. Please reference YouTube for more information.
+
+![7](content/MacDaddy%20Lower%20Receiver/Assembly/7.png)
+![8](content/MacDaddy%20Lower%20Receiver/Assembly/8.png)
+
+Now for the step-by-step installation process:
+
+- Attach the proper springs to each component. Be sure to get the disconnector spring installed with the flared side down.
+
+![9](content/MacDaddy%20Lower%20Receiver/Assembly/9.png)
+
+- Drop the trigger into the trigger cutout of the frame. Make sure the trigger spring rest on the floor of the trigger pocket.
+- Insert a 1/8-inch punch (or small rod/screwdriver) through the trigger pinhole in the frame, passing it through the disconnector as well.
+
+If you’re using a tool like the KNS non-rotating pin set (anti walk pins), select the internally threaded trigger pin and insert it into the trigger, which will push out the 1/8-inch punch as the KNS trigger pin slides into its place.
+
+- The trigger is now installed, and you can place the hammer springs across the top of the trigger pin and bend the hammer into place, securing it with either a 1/8-inch punch or a #4 roll pin punch.
+- Just like the trigger pin, you should next push the punch out as you’re pushing the hammer pin in.
+- Install the pin connector covers over the flared ends of the hammer pin and be sure to align the threaded holes over the trigger pin.
+- Finger tighten the screws holding the whole trigger system together (if you are using an anti-walk pin set), before using wrenches to fully tighten.
+- However, do not overtighten the screws as that would risk easily stripping the screws in the trigger group.
+- To function test the trigger, first put an object between the hammer and the front of the frame. With the safety on BRRR, pull the trigger and gently guide the hammer down.
+  - Does the hammer release on its own?
+  - Does it feel right?
+- Lift the hammer and press it down into the disconnector.
+  - Does the hammer catch on the disconnector?
+  - Does the hammer stay without assistance?
+- Set the safety on SAFE and pull the trigger.
+  - Does the hammer fall?
+  - Can you make the gun fire by force?
+  - Does the safety selector “CLICK” when toggled?
+  
+### Installing the Feed Ramp
+
+The feed ramp is a small part that guides the 9MM rounds into the chamber of the barrel. The 2.0 version of the MacDaddy includes a re-vamped geometry courtesy of [Aveees](https://AvesRails.com) where the end user may purchase one that has been machined out of stainless steel.
+
+- Press the feed ramp into the frame orientated as shown below. Builder may need to use a brass hammer/brass pin to ensure the feed ramp is fully seated.
+- Drive the included 1/8” dowell pin into the frame and through the feed ramp.
+
+![10](content/MacDaddy%20Lower%20Receiver/Assembly/10.png)
+
+### Installing the Glock magazine release spring
+
+The Glock magazine release spring is sometimes tricky to install, a large flathead screwdriver is ideal to assist.
+
+- Gently place the spring in the mag spring pocket located inside of the magazine well
+- Using the sharp end of a flathead screwdriver, steadily press the spring down into the frame until the builder can look through the side of the frame and see the mag spring protruding halfway
+- Press the mag release button into the frame. Using the screwdriver, guide the spring into the mag release button.
+
+![11](content/MacDaddy%20Lower%20Receiver/Assembly/11.png)
+
+### Installing the Mac-11 upper receiver assembly
+
+The Mac-11 upper receiver (M11) fits precisely into the frame as shown below. Ensure every last bit of support material has been removed from the back pocket of the frame before you try to rock it into place.
+
+- Rock the upper receiver assembly into the frame with your hands, rear first, then press the front of the frame down into the front lug pocket with your hands.
+- User may find it necessary to flip the frame upside down and press the assembly from the rear pic rail onto a hard, firm surface. The nylon end of the gunsmithing hammer may also be necessary to give the top front of the assembly a few loving taps to help coax it into the pocket.
+- Once the assembly is in place, drive the main pin through the frame and M11 front lug. Place a retention clip through the main pin.
+- Builder may find it necessary to gently remove a small amount of material from the main pin hole for fitment. Ensure after driving the pin in that it cannot be removed by hand.
+
+![12](content/MacDaddy%20Lower%20Receiver/Assembly/12.png)
+
+*Rocking the main assembly into place.*
+
+****Congrats! At this point the builder now has a functional MacDaddy 2.0 firearm****
+
+---
+
+#### Linked Parts
+
+# TODO: LINK ALL LOWER PARTS
+
+- Glock mag spring
+- mag catch
+- [MacDaddy Feed Ramp](../Miscelaneous%20Parts/MacDaddy%20FeedRamp.md)
+- ar15 trigger group
+  - trigger
+    - disconnector
+    - disconnector spring
+  - hammer
+    - hammer spring
+- AR pistol grip
+  - grip screw
+    - screw washer
+- ar15 safety selector
+  - detent
+  - sprint
+- 1x 1/8” Dowell Pin
+- Front Pin
+
+##### Credits
+
+# TODO: Add Credit for everyone here later!

Weapons/Sub-Machine Guns/MacDaddy.md

@@ -0,0 +1,18 @@
+# The MacDaddy 
+by FMDA1776 & CRTL+PEW
+
+![Example Image](content/MacDaddy/example.png)
+
+The MacDaddy 2.0 is a 3D printable, DIY personal defense weapon (PDW) that accepts Glock mags and uses a standard AR-15 millspec fire control group as a firing mechanism. It uses a standard Mac-11 upper receiver and fires a 9MM round. It was designed to be a highly modular, highly functional and aesthetically pleasing 9MM pistol that can stow away in a small footprint and be deployed at a moment’s notice. 
+
+As of Spring 2022, the original iteration of the MacDaddy has been built by hundreds of people, with numerous builders reporting frames that have lasted between 2,000-5,000 rounds and counting.
+
+This update brings an aesthetic overhaul, as well as numerous quality of life improvements to the original design. xYeezySZN x DigitalNimbusLabs designed a spring loaded Invader brace that has been adapted to fit the MacDaddy, multiple sling mounting locations, improved feed ramp geometry courtesy of Aveees and a documentation overhaul.
+A special thank you to DigitalNimbusLabs, Aveeees (Aves Rails), P80 Ralph, AGCast4, RealQuietBryan, CTRL+Pew, FMDA1776, DB Firearms, FFFtech, nguyenkvvn and internetpizza – without these beautiful people and their big brains, this package would truly not have been possible.
+
+## Required Parts
+
+- [MacDaddy Lower Reciever](../../Weapon%20Parts%20%26%20Modifications/Vital%20Parts/Recievers%20%26%20Slides/MacDaddy%20Lower%20Receiver.md)
+- [MAC-11 Upper Reciever](../../Weapon%20Parts%20%26%20Modifications/Vital%20Parts/Recievers%20%26%20Slides/MAC-11%20Upper%20Receiver.md)
+
+## Required Tools