Build-friendly nukes with realistic effects
Version 1.8
See changelog file for changes

DESCRIPTION:
Realistic nuclear weapons, effects and radiation!

This experimental mod was made to fix several shortcomings of Gbombs-based nukes. Among the issues were no small warheads meant for building (only gigantic early bombs and one-off test articles; no modern real-life deployed models) and somewhat unrealistic and arbitrary effects and power. I forked HBOMBS and started making some new entities, then i decided to go all the way and create an entire Full Realism nuke mod. This is a modification of HBOMBS, it's more of an expansion to it than a stand-alone mod for now, i never modded for Gmod before and didn't know Lua so i started from that. Much credit to it's author, this mod owes a lot to him. 

I made small yet life-size warheads in various yields including a few selectable-yield devices and 4 types of aircraft bombs. They use totally different code from regular nukes for more realistic effects, based on real-life research and scientific models. Adjustments have been made to the scale (1:12), duration and effects of explosions to keep things reasonable for Garry's Mod, yet their retain the right power scaling and effects of real-life, miles ahead of any other nuke mod currently out. The radiation model is also much more advanced than anything else out there, using inspiration from real-life effects of radiation. 

It is in constant work and will be continually updated for better realism.
This is my first mod, so please advise me of any bugs or errors and give me feedback. 
All deserved credit for the original code and models goes to their respective authors, i just improved on their work.

REQUIRED:
Counter Strike Source
Wiremod
SProps
HBOMBS Base Pack
HBOMBS Material Pack
Hazmat Conscripts Playermodels

Bomb power: All bombs now have realistic blast and heat damage ranges from real data, converted to Gmod units and scaled down 1:12. This means that the ranges for the effects of the explosion are realistic (enough), but divided by 12 from real life ranges. A bomb will have more powerful blast effects if it is exploded in the air, but produce no fallout.

Heat damage: The incinerate/ignite code in the bombs was completely redone. Now depending on how close you are from the bomb you will now either be burned slightly, be badly burned and maybe die, be burned to a crisp and die, or even be burned down to your bones. This depends on wether or not you are directly exposed to the heat flash, so hiding behind something will protect you from the flash burns as in real life. This also affects NPC's! Props close to the bomb will catch fire and be charred (material change).

Blast damage: Blast damage now follows realistic ranges and power, props and entities very close to ground zero will simply vaporize. Work in progress.

Dial-a-yield: Some warheads and bombs have a selectable yield option just like in real life, which means you use wire to specify the power of explosion you want.

Radiation model:
Each player has a value that stores the radioactivity dose he has accumulated. Each Rad you have accumulated will deal you 0.001 damage per second. If not exposed to any radiation, this dose will decrease up to 10 units every second. To see what is your current dose, type "/dosimeter" in chat. You will be notified by your geiger counter of the current radiation level. Exposures above 200 rads will start killing you very quickly. Large doses above 1000 rads, even if you survive them, will eventually deal permanent health handicap from massive damage to your DNA and chromosomes. To mute the geiger counter sounds, type /geigersound. all radiation sources (debris, radioactive waste, bombs, prompt radiation; not fallout) now take into consideration the shielding between you and them and how much it attenuates your dose. This means you can now build shielding to protect yourself from radiation. Water and air also act as shielding. Radiation sources now have infinite range, you will always be exposed to some level of radiation. However, this will not harm you, it usually is not even detectable. This reflects how radiation behaves in real life. Props will shield you more than World (buildings, ect), which will shield you more than water, which is better than air. It also considers how much air itself absorbs radiation. 

For reference, 1 Rad is 1000 milirads, and 1 miliRad is 1000 microRads; this means 1 microrad (average background radiation in game is 1.5 microrads/min) is 1/1000000th of a Rad; so don't panic if you see those levels. Microrads = basically nothing, Milirads = not too bad, Rads = dangerous. You can wire the geiger counter entity to multiply gates (x1000 for milirads, x1,000,000 for microrads) to see low levels. 

Radiation Protection:
This is in the works, in the meanwhile you can use Gbombs hazmat suit, it will cut your radiation exposure 80%. There is also two semi-realistic drugs, Iodine and Rad-Away. Iodine will protect you from 25% of radiation for 2 minutes, and Rad-Away will accelerate your accumulated rads elimination rate at the cost of 25HP, allowing you to survive exposure to large doses. You can use props as shielding.

Prompt Radiation:
Prompt radiation is the initial blast of radiation (neutrons and gamma rays) that is produced in the first second the nuke explodes. This is subject to inverse-square law as well as absorption and scattering by the atmosphere, so it's range very rapidly falls off. It is most noticeable on smaller yield bombs, where the physical effects (blast, heat flash) are small enough that the lethal range of radiation actually outranges them. Being not in line-of-sight with the explosion will still give you half the dose you would have had if you were in direct line with it, because the atmosphere is bouncing gamma rays at you from the sky. Being shielded overhead and not in line of sight will only expose you to a fraction of the dose; gamma rays are extremely penetrative and still find a way to reach you, but it's much less. 

Fallout:
Fallout was completely reworked and now decays over time as in real life; on a 2-minute timescale. It starts falling down from the sky and the radiation level peaks about 10 seconds after the explosion, then it starts dropping off quite quickly. A slider will be added for long decay for those who want more realistic consequences. Instead of directly giving you damage, it will add to your radiation dose and you will feel the effects even if you are only exposed for a short while. You are shielded from fallout if you stay inside a building or underground, or if you have a hazmat suit (up to a certain point!). Fallout can expose you to massive doses of radiation, so it is vital that you shelter indoors or wear a hazmat suit if you are close to a bomb that explodes on the ground. Airbursts (bombs exploding in the air) do not produce fallout, the height at which it is considered an airburst depends on the size of the fireball, thus the explosion's power. 

Enhanced Radiation Weapons:
New in 1.4, this is a small tactical warhead that uses an Enhanced Radiation device, commonly known as a Neutron Bomb. This bomb trades blast and heat power for a stronger burst of radiation, making it more lethal against players or NPC's while not having as powerful an explosion as normal bombs. A 1kt ERW has only half the power of a normal 1kt bomb, but the radiation power of a 5kt device; 5kt has the radiation power of a 10kt; and a 10kt that of a 20kt. They tend to be on the smaller scale of nukes, being intended for battlefield use, so 10kt is about the most powerful they come. The REN-ERTAC has 3 modes, 1kt, 5kt and 10kt.

Reactor core:
New in 1.8, this is a nuclear reactor core that emits high levels of radiation. You can power it up for extremely high levels, but beyond 110% power it risks exploding. This is not the complete reactor, this is the EXPOSED CORE, NO SHIELDING. This thing creates enough radiation when operating at full power to instantly kill you, you must building shielding around it just like a real reactor. If you power it up too high and it explodes, you are in BIG trouble. It creates a massive (non-nuclear) explosion and shoots radioactive fallout and debris everywhere. And i mean literal debris, extremely radioactive rocks that you have to somehow remove from the area.  But the core is still there, destroyed but still shooting out insanely lethal amounts of radiation. You now have to explain to your boss how an RBMK reactor explodes.


REFERENCES:
Nukemap by Alex Wellerstein nuclearsecrecy.com/nukemap/
"The Effects of Nuclear Weapons" by S. Glasstone and P. J. Dolan

Note:
kt = kilotons (1000 tons of TNT)
mt = megatons (1000 kilotons)

In this mod you will find the following:
REN-1 warhead (1 kiloton) (visuals of Davy Crockett, no flash)
REN-5 warhead (5 kilotons) (visuals of Davy Crockett, with flash)
REN-10 warhead (10 kilotons) (visuals of Artillery shell)
REN-20 warhead (20 kilotons) (visuals of Fat Man)
REN-50 warhead (50 kilotons) (visuals of Ivy King)
REN-100 warhead (100 kilotons) (visuals of Gadget)
REN-250 warhead (250 kilotons) (visuals of Little Boy)
REN-500 warhead (500 kilotons) (visuals of Ivy Mike)
REN-1000 warhead (1 megaton) (visuals of Castle Bravo)
REN-5000 warhead (5 megatons) (visuals of Tsar Bomba)
REN-TAC warhead - Tactical warhead with selectable yield, Modes are 0=1kt, 1=5kt, 2=10kt, 3=20kt, 4=50kt, default (0)=1kt
REN-STRAT warhead - Strategic warhead with selectable yield, Modes are 0=100kt, 1=250kt, 2=500kt, 3=1mt, default (0)=100kt
REN-ERTAC warhead - Enhanced Radiation tactical warhead (neutron bomb), Modes are 0=1kt, 1=5kt, 2=10kt, default (0)=1kt
Mk12 Bomb - Tactical bomb, same thing as REN-10
B61 Mod 7 bomb - Strategic bomb with selectable yield, Modes are 1=20kt, 2=50kt, 3=100kt, 4=250kt; default (0)=100kt
B61 Mod 12 bomb - Tactical bomb with selectable yield, Modes are 1=1kt, 2=5kt, 3=10kt, 4=20kt, 5=50kt, default (0)=50kt
B83 bomb - Strategic bomb with selectable yield, Modes are 1=100kt, 2=250kt, 3=500kt, 4=1mt, default (0)=1mt
Dirty bomb - Conventional 500lb bomb but with radioactive material inside, creates lots of fallout
Nuclear waste barrel - A highly radioactive barrel of nuclear waste
Radioactive debris - Spicy rocks from an RBMK reactor
Nuclea reactor core - Highly radioactive core that can be powered up to massive levels of radiation, and potentially explode with catastrophic consequences

FAQ
Q: Why are the warheads so tiny?
A: Because that's about how big they are in real life when you remove the bomb or missile warhead casing that holds them. They are meant to be easy to fit and weld into a contraption you make, such as a missile.

Q: Why are the bombs so small?
A: Because that's about how big they are in real life. You don't need a bomb the size of a freaking 18-wheeler trailer to reach megatons of power, it's not 1952 anymore.

Q: Why are they all just boring cylinders?
That's the point. They're small, handy little things you can fit on to anything you build. The bombs are there if you want something more exciting-looking.

Q: Why are the yields you give so scaled down? IE: why does the Tsar Bomba equivalent only say it's 5 megatons?
A: The Tsar Bomba in, say GBombs, is about visually equivalent to the real Little Boy. In effects, it's about really equivalent to just a 8-10 kiloton nuke in real life. The Tsar Bomba's power, 57 megatons (57,000 kilotons) is just mindboggling, like the wrath of god. The biggest GMod map i can find is about 860 meters diagonally, it would fit entirely within the fireball of a real 400 kiloton explosion. This is how big these things are. With the 1:12 scale i'm now using, 5 megatons is about as big as you can get without everything on the map being instantly vaporized (just barely). The new realistic power calculation give the bombs good and realistic power for our use.

Q: The bombs are overpowered!
A: Overpowered... realistic... nuclear... weapons... Think about that for a second. If you think there's something that could be adjusted for better effects and playability, tell me about it, but being overpowered is kind of the entire thing with nukes. 

Q: Can you make the Tsar Bomba/This specific bomb/Some fantasy bomb?
A: No. The point of this mod is realism and to leave it up to you to make anything you want instead of making specific weapons.

Code and more info on Github: https://github.com/snow-frog/EnduringStockpile/