Skip to content

jekyllgrim/Beautiful-Doom

Repository files navigation

Beautiful-Doom

Beautiful Doom © Jekyll Grim Payne aka Agent Ash. All rights reserved.

☕ Support me on Boosty: https://boosty.to/agent_ash

General information

Beautiful Doom is an all-encompassing total enhancement mod for GZDoom, aimed at making Doom feel, look and sound better, while keeping the original balance and gameplay intact (or tweaking it with some of the available options). Smoother animations, some improved sprites, particle effects, physics-based gibbing, as well as high compatibility with other mods—those are some of the features.

Beautiful Doom's code is licensed under GPLv3. Permissions for assets may vary. If you want to use Beautiful Doom in your work, please obtain a permission from the author. See more details below.

Beautiful Doom mod thread at ZDoom Forums: https://forum.zdoom.org/viewtopic.php?f=43&t=50004&sid=1c1118c879d5317400aba8752ec93aed

Requires GZDoom.

How to play the latest stable release

Releases aren't always super-stable or bug-free, but they should be playable. Some releases are development versions which don't have all the planned features implemented yet.

  1. Navigate to the "Releases" tab at the top or following this URL: https://github.com/jekyllgrim/Beautiful-Doom/releases

  2. Download the attached PK3 file. Run it as you'd run any .wad or .pk3:

    gzdoom.exe -file Beautiful_Doom.pk3
    

How to play the freshest dev build

It's possible to play the version that is currently in the repository but hasn't been made into a separate release yet:

  1. Click here, or click the green "Code" button at the top right of this page and choose "Download ZIP". This will download a file called Beautiful-doom-master.zip.

  2. Do not unpack the downloaded archive!

  3. (Optional) Rename the downloaded .zip to .pk3 to remember that you don't need to unpack it.

  4. Run the archive as you would run any mod; from command line or a bat file in the GZDoom directory:

    gzdoom.exe -file Beautiful-Doom-master.zip 
    

    Or, if you renamed it:

    gzdoom.exe -file Beautiful-Doom-master.pk3
    
  5. If you're getting errors, make sure you're running the latest version of GZDoom.

  6. Enjoy!

Use of resources and permissions

If you want to use any of my resources, please contact me:

Email: [email protected]

Discord server: https://discord.gg/MJGdYjk

The code part of Beautiful Doom is licensed under GPLv3, which means all derivative code also has to comply with GPLv3. Please see LICENSE.txt for details.

Regarding assets, permissions may vary for different resources, since some of these are 100% original, others are edits, and some come from other people. You will need to obtain a permission before using any of them. If a permission is granted, you'll need to credit me and all other people involved in the creation of a specific resource.

Before asking if you can borrow an asset for your own project, make sure your work adheres to the following requirements:

  • It's not and will never be commercial in any way
  • It's not affiliated in any way with projects or authors that are unwelcome in the Doom community (there are several, and you probably know who they are)
  • It's not a low-effort repack/rehash/edit of other people's works
  • The resource you want to use is already available in one of the stable RELEASE versions of Beautiful Doom (if it's only on GitHub, it's not free to use)

Mods that go well with Beautiful Doom

Here are a few recommendations on stuff that plays well with Beautiful Doom and matches the concept of overall enhancement:

  • Universal Weapon Sway by Boondorl: adds natural-looking sway to weapon sprites based on mouse movement
  • Tilt++ by Nash Muhandes: adds customizable camera tilting

CREDITS

If you feel anyone was forgotten, or that I'm using somebody's assets without permisssion — please contact me, and I'll make sure to resolve it as soon as possible:

Email: [email protected]

Discord server: https://discord.gg/MJGdYjk

  • Gifty: Smooth Doom and smooth monsters animations which are widely used, both edited and unedited, in Beautiful Doom
  • 3saster, Accensus, Arctangent, Caligari87, D2JK, Gutawer, josh771, Lewisk3, Marisa the Magician (formerly Marisa Kirisame), Nash Muhandes, phantombeta, Zombie: scripting help and contributions
  • kodi: BFG model-based beam code
  • 3saster: animated texture handler, DEHACKED parser, code contributions, various fixes and improvements
  • Nero: menu tool tips
  • Mike12: original assault rifle sprites (edited versions are used in Modern Assault Rifle)
  • Revenant100: Minor Sprite Fixing project
  • perkristian: Doom HD sound pack (included in Vanilla Guns), Original Smooth Weapons
  • The Zombie Killer aka Zombie: footsteps
  • Nash Muhandes:
    • Nashgore (some gib sprites are still being used)
    • SpriteShadows (was included in several versions, currently excluded)
    • GZDoom contributions (CopyBloodColor() function and opaqueblood ANIMDEFS keyword which made the current blood system possible)
  • Enjay: new switches and TERRAIN splashes, various help
  • Michael Henderson: Ultra Heavy Laser sound effect (used in Enhanced BFG alternative attack)
  • David G., DenisBelmondo, alando1: additional death sprites
  • WildWeasel: several special effects
  • Blox, Eriance, ItsNatureToDie, Kinsie, Minigunner, Neoworm, Phi108, Vader, osjclatchford: alternative monster death sprites

Some features of the ZScript version

Modern Guns

One of the main new features of the ZScript version of Beautiful Doom is a third weapon set. All weapons require reloading, weapons that aren't automatic require pressing trigger manually. All bullet weapons use projectile bullets instead of hitscans. Weapons have different sway and recoil. Also all of them use varied and realistic sounds, mostly from real weapons.

  • Quick Kick: a melee attack that can be used while handling or reloading other weapons. Affected by Berserk.
  • Fist: has a combo system with finishers and stuff. Supports combos; the longer you're punching an enemy, the higher is the chance of stun-locking them. The Quick Kick is uniquely modified to be a part of the combo for this weapon.
  • Chainsaw: very powerful but gets clogged with blood while used and may jam (the chance increases with clogging). Needs to be restarted manually. The more clogged it is, the harder it is to restart. While on, Alt Fire will push blood out, unclogging it.
  • Pistol: pretty darn fast
  • Shotgun: faster and altered animation
  • Super Shotgun: more powerful but also more slow to reload than vanilla SSG. You reload by pressing Reload button, so you have precise control of when it'll happen. Also, it's the only weapon that can penetrate enemies. After penetration the pellet's damage is decreased proportionally to how big the penetrated monster was.
  • Assault Rifle: you know how Doom has a chaingun that fires pistol ammo, with 6 barrels, but pretty slow... in other words, a chaingun that makes no sense? Yeah, I replaced it. Assault Rifle does basically the same things but it has a magazine. Also alt fire allows to aim down sights for decreased fire speed and bullet spread.
  • Rocket Launcher: basically faster and can also work as a grenade launcher.
  • Plasma Rifle: similar to original but builds up heat that needs to be dissipated manually (with Alt Fire or Reload buttons). Also deals damage in tiny explosions, so it's AOE.
  • BFG 9000: the orb explodes and damages monsters with railguns, without taking the shooter's position into account. Can be charged by holding the Fire button; the higher the charge, the more damage it deals and the further it'll fly. It's possible to spend between 10 and 80 cells on one shot. Warning: overcharging is possible and will damage you.

High Compatibility

A huge amount of effort has been put into making Beautiful Doom as compatible as possible. You can disable almost any feature of the mod (special effects, monster replacements, weapon replacements, decorations), play with various options, and as such play it with almost any other mod or map set available.