[b]Read what users have to say about [color=ffd700][i]Advanced Crosshairs, Hitsounds, and Hitmarkers![/i][/color][/b]
[color=00ffff]"crosshair? i 'ardly even know 'er"[/color] [size=small]-xXbongslammer420Xx[/size]
[color=d7d13b]"wait a minute this isn't the soup store"[/color] [size=small]-chadheister mcsexhaver[/size]
[color=fa32bb]"its a cheat mod"[/color] [size=small]-some guy[/size]
[color=ff4300]"two dongs way up"[/color] [size=small]-qfburglar69[/size]
[color=f39fe3]"Now i can see how bad my aim actually is, 10/10-IGN"[/color] [size=small]-c0ntriL[/size]
[color=777777]"put me in the quotes lol"[/color] [size=small]-ReggenZz[/size]
----
[b][color=ffd700]Advanced Crosshairs, Hitsounds, and Hitmarkers[/color][/b] [color=777777](also known as: "Advanced Crosshairs and Hitmarkers", "Advanced Crosshairs", or simply "ACH")[/color] is a mod that adds the capability to display custom reticles, and visual/auditory feedback upon hitting an enemy, as well as making it relatively simple for users to add their own crosshairs, hitmarkers, and hitsounds.
Compatible with TdlQ's [Enhanced Hitmarkers](https://pd2mods.z77.fr/enhanced_hitmarkers.html), in case you wanted to use the non-hitmarker aspects of ACH while also using TdlQ's Enhanced Hitmarkers.
#### [color=ff0000]REQUIREMENTS:[/color]
* [BeardLib](https://modwork.shop/14924) is REQUIRED
* [SuperBLT](https://superblt.znix.xyz/) is REQUIRED
* [ColorPicker](https://modworkshop.net/mod/29641) is needed to change crosshair/hitmarker colors in settings, but is not required for ACH's main functionality.
## [color=ffd700][b]Features:[/b][/color]
#### [color=ff6666]Crosshairs[/color]
- Customize crosshairs by weapon type/firemode
- ...or use one crosshair for all weapons
- Customizable image
- Bloom (cosmetic, does not reflect weapon accuracy due to the lack of bloom)
- Dynamic Color: Crosshair can optionally change color based on targeted unit (eg. red when aiming at enemies, blue when aiming at teammates, green at civies, etc; these colors can also be customized*)
- Compatible with all custom weapons
#### [color=66ff66]Hitmarkers[/color]
- Can display animated hitmarkers
- Can display hitmarkers in "3D space," similar to [GTFO](https://gtfothegame.com/)
- Customizable hitmarker image for hits versus kills
- Customizable hitmarker colors* for headshots, crits, kills, nonlethal hits, or combinations thereof
#### [color=6666ff]Hitsounds[/color]
- Customizable hitsound for headshots, crits, kills, nonlethal hits, or combinations thereof
- Customizable volume
#### [color=ff66ff]General[/color]
- Modular features- you can choose to disable Hitsounds, Hitmarkers, or Crosshairs, or keep any combination of these features enabled, as you like
- Add-on support for custom crosshairs, hitmarkers, or hitsounds- make your own!
- sooper secret april fool's joke
*[i]All color customization options require [ColorPicker](https://modworkshop.net/mod/29641) to change specific colors[/i]
---
### [color=ff4444]Known Issues (and possible solutions):[/color]
* Dragging the Hitsound volume sliders with the mouse results in sounds stacking once per frame at hideously loud volume. Users are strongly advised to enable the hitsound limit setting, use the arrow keys to adjust the volume slider instead, or use BeardLib's right-click feature for exact values.
* Crosshair bloom and hitmarker previews may not display in the menu if the game is paused (applies to singleplayer offline games only) [status: tentative fix implemented in v19]
* Poison and Fire damage may not reliably activate hitmarkers or hitsounds, depending on whether or not you are host. This is due to the way that networking code is done in PD2. [status: no fix planned]
* Blue menu background from base game obscures the mod menu when in-game (as opposed to at main menu), effectively rendering the crosshair/hitmarker preview unusable if in-game [status: Fix implemented.]
* [IREnFIST - Reloaded](https://modworkshop.net/mod/28585) has a minor conflict with ACH, preventing the "ADS Hides Crosshairs" option from functioning. (Interferes with ACH functionality, does **not** cause crashes) [status: Fix implemented. Please navigate to the mod settings to enable the fix if you have IREnFIST installed.]
* [Restoration Mod](https://modworkshop.net/mod/428) has a minor conflict with ACH, causing Hitmarkers and Hitsounds not to trigger. (Interferes with ACH functionality, does **not** cause crashes) [status: Fix implemented. Please navigate to the mod settings to enable the fix if you have Restoration Mod installed.]
* Some users report that hitsounds do not work in VR. [status: investigating solutions]
* Some users report issues running ACH on Linux. [status: investigating solutions]
-----
#### [color=ff00d7]Addons:[/color]
I'm hoping other people will start to design their own addons for this mod, but in the meantime, here's a few examples I made to get you started, in addition to the ones that come with this mod:
* [Crosshairs Pack 1](https://modworkshop.net/mod/29819)
* [Crosshairs Pack 2: Halo](https://modworkshop.net/mod/29903)
* [Crosshairs Pack 3: Destiny 2](https://modworkshop.net/mod/30020)
* [Hitsounds Pack 1](https://modworkshop.net/mod/29820)
* [Hitmarkers Pack 1](https://modworkshop.net/mod/29821)
And here are some great addons that other members of the community have created:
* [BO3 HITMARKERS (ACH)](https://modworkshop.net/mod/29863) by FrenchyAU - (Hitmarkers) Addon from Call of Duty: Black Ops 3
* [Grand Theft Auto V Reticules (Advanced Crosshairs)](https://modworkshop.net/mod/29865) by VxWolf - (Crosshairs) Addon from Grand Theft Auto
* [ACH ADDON: Man Screams at Yellow Paint](https://modworkshop.net/mod/29864) by wekk - (meme Hitsounds) Addon from [here](https://youtu.be/RWqr9DsEd9Q)
* [[ACH] Bad Company 2 Headshot](https://modworkshop.net/mod/29870) by Sokolov - (Hitsound) Addon from Bad Company 2
* [[ACH] Frenchy's Hitsound Pack (details within)](https://modworkshop.net/mod/29871) by FrenchyAU - (Hitsounds) A wide variety of hitsounds from various games
* [[ACH] ADDON: Battlefield 1 Kill Sounds](https://modworkshop.net/mod/29886) by Wenzelony - (Hitsound) Addon from Battlefield 1
* [Titanfall 2 Crosshair Pack (ACH)](https://modworkshop.net/mod/29902) by FrenchyAU - (Crosshairs) Addon from Titanfall 2
* [Titanfall 2 Hitmarker (ACH)](https://modworkshop.net/mod/29912) by FrenchyAU - (Hitmarkers) Addon from Titanfall 2
* [Quake Crosshair Pack (ACH)](https://modworkshop.net/mod/30067) by Dr. Dryels - (Crosshairs) Addon from Quake Live
* [Satisfying and Brutal Hitsounds (ACH)](https://modworkshop.net/mod/31130) by Klimann - (Hitsounds) A wide variety of visceral hitsounds
For a tutorial on creating addons, see the GitHub wiki link below.
-----
#### [color=66ffff]FAQ:[/color]
[spoiler]
Q: I found a bug! What do I do?
A: Report it to me! Leave a comment here, contact me on the ModWorkshop discord, or open a ticket on the GitHub page. Try to be descriptive about the issue so that I can find it and fix it! If the issue is severe enough (eg. crashing), you may wish to try an earlier version from GitHub if I'm not online and available to fix it immediately.
-
Q: Crosshairs are cheating.
A: That's nice, dear.
-
Q: I only want to use the Crosshairs/I only want to use the Hitmarkers/I only want to use the Hitsounds. Can I disable the other features?
A: Yes! Look in the mod options.
-
Q: Can I add my own crosshairs/hitmarkers/hitsounds?
A: Yes! See the guide here: https://github.com/offyerrocker/PD2-AdvancedCrosshairs/wiki
-
Q: Can you add [whatever] crosshair/hitmarker/hitsound?
A: You can feel free to make a request. However, whether or not I'll actually *do* it depends on many factors, including how busy I am, how interesting the request is/how much I like it/how much free time I have/what I had for breakfast that morning. In other words, I might or might not, and even if I like the idea, it might take a while for me to get around to it. I've made it extremely easy for users to make their own crosshairs/hitmarkers/hitsounds, and you'll probably do a better job than I would anyway. Plus, I like seeing the creative stuff that the modding community (that's you!) can do.
-
Q: Can I help translate this mod into [whatever] language?
A: Yes, please do! The best way to do this is by sending a pull request on GitHub, or by contacting me on Discord or on ModWorkshop.
-
Q: Is this mod compatible with [whatever] mod?
A: Generally speaking, I have no idea. Try it, find out, and report back in the comments!
-
Q: Does this work in VR?
A: ACH has limited VR support. The hitsounds are currently bugged (working on a fix, stay tuned!), but hitmarkers should work fine, and the crosshair works to some extent if you enable crosshair shake in the ACH mod options.
-
Q: You abbreviated the mod to ACH. What about "Hitsounds?"
A: Feature creep. Originally it started as Advanced Crosshairs as a standalone of NobleHUD's crosshairs, but then I decided to add Hitmarkers. Then I decided to add world-position hitmarkers, and then I decided to add hitsounds... I just never bothered to change the name/acronym afterward.
-
Q: Why?
A: Yes.
[/spoiler]
-----
[i]For more information, including:[/i]
* More in-depth usage manual
* Documentation and tutorials on creating your own addons
* Addons installation guide
* The latest development version
* ~~Moral support~~
...please see the GitHub! https://github.com/offyerrocker/PD2-AdvancedCrosshairs/wiki/Getting-Started-Using-ACH
-----
Please feel free to leave a comment on this mod page, or contact me in the ModWorkshop Discord, if you would like to report a bug, give feedback, or request help with this mod or with creating or installing addons for this mod.
You may also submit bug reports by opening tickets (or pull requests, if you have a fix) to the GitHub page.
Tell me if you like the mod!
This changelog includes mostly front-end changes and features. For a more complete list of changes, please see the GitHub repository.
22 Dec 2021 v19
- Fixed a bug where hitsounds would not play if the game was paused, ie. when playing in offline mode.
- Added an option to detect melee headshots; like the other features in the mod, this is only cosmetic, and will not affect damage calculations. This menu option can be found in the "Misc..." section in ACH's menu. Other mods that enable bonus damage for melee headshots will also still function as normal.
- Added additional compatibility options on a per-function basis to cover the remaining points of compatibility failure (all disabled by default); this mod should now be quite robust in terms of compatibility with other mods- both for known cases such as Restoration Mod, and unforeseen cases of potential incompatibilities. This also addresses several known compatibility issues such as melee hits not proccing hitmarkers or hitsounds when using Restoration Mod, as well as numerous other unspecified cases.
- Added an option to auto-detect and resolve potential compatibility issues (enabled by default)
- Minor localization fixes
- Cleaned some unused files and code
- Slight adjustments to the ~sooper secret easter egg~
13 Dec 2021 v18
- Fixed a bug where toggling the underbarrel off would cause ACH to display the crosshair for the weapon type of the base weapon, but the firemode of the underbarrel
- Fixed a bug where hitmarker previews were not properly being removed after exiting the hitmarker menu
- Fixed Hitmarker options menu not hiding the blue menu bg
- Added a menu option and accompanying localization for the new Positional Hitsounds option (feature was already otherwise implemented; disabled by default)
- Added local shortcuts to mvector3 functions for a slight optimization improvement
- use_shake is now false by default; this applies primarily to fresh installations or restoring settings to default
- Replaced references to SystemFS with Linux-compatible BeardLib FileIO util equivalents
- Removed some leftover debug logs from "weak hit" out of range detection code
30 Aug 2021 v17
- Added support for PNG textures, and framework to easily add other supported textures should sBLT/BeardLib add the ability to load other image formats.
- Fixed a bug where changing the master crosshair setting would hide the crosshair regardless of the actual checkbox value
12 Aug 2021 v16
- Fixed broken Simplified Chinese localization
4 Aug 2021 v14-15 (combined)
- Possible fix for a rare crash caused by detection of an extant but invalid ColorPicker installation
- Localization fixes
25 Jul 2021 v12-13 (combined)
- Possible fix for crash at: ActivateHitmarker() @mods/PD2-AdvancedCrosshairs-main/lua/menumanager.lua:2473
- Various minor fixes/safety checks
- Added options to change the size of the crosshair or the hitmarker when out of weapon range, using the new weapon range mechanic added in U204.
- Implemented "none" area_bg for menus, in order to better see crosshair/hitmarker customization; temporary, until such time as this feature is added either to BeardLib or to SuperBLT
- Added Logs Enabled setting (hidden, disabled by default) which determines whether or not debug logs are enabled
- Copied missing localizations from english to chinese (needs actual translation)
19 Mar 2021 v11
- Fixed vanilla hitmarkers becoming "stuck" onscreen and never disappearing if ACH's Hitmarkers are disabled
21 Feb 2021 v10
- Fixed global crosshair settings applying incorrectly due to a legacy setting that was unavailable via the menu
- Added separate options to allow or disallow melee hits from triggering hitsounds or hitmarkers (note: localization in the Chinese translation for this newly added menu option is missing, and will temporarily use the English localization for these two menu options in the meantime until they are translated)
- Hitsounds and Hitmarkers now proc on fire damage kills
- Hitsounds and Hitmarkers now proc properly for both melee hits and kills (respective of the Allow Melee Triggers option added in this update)
22 Dec 2020 v9
- Possible fix for crashing upon entering custody (`SetCrosshairColor() @mods/PD2-AdvancedCrosshairs/lua/menumanager.lua:2169`)
- Added compatibility toggle for mods that also affect `PlayerStandard:_start_action_steelsight()` or `_end_action_steelsight`, such as [IREnFIST - Reloaded](https://modworkshop.net/mod/28585). You can find this option in `Mod Options -> Advanced Crosshairs and Hitmarkers -> Misc... -> Compatibility: PlayerStandard: steelsight`.
29 Nov 2020 v8
- Fixed a typo that caused simple Hitmarkers' scaling to break
28 Nov 2020 v7
- Fixed incorrect mod id in main.xml, which was preventing auto-updates from functioning correctly
26 Nov 2020 v6
- Fixed rare crash when shooting an enemy during the switch to endscreen
- Crosshair, Hitmarker, and Hitsound selections are now sorted alphabetically
24 Nov 2020
v5 hotfix
- Fixed broken scaling/sizing for crosshairs and hitmarkers with defined `texture_rect` tables
v4
- Added Crosshair and Hitmarker size scale slider; Addons of these types may need updating by their authors to accommodate the new scaling feature, if the addons have bloom/hit functions
- Added "None" crosshair option
- Added compatibility toggle for mods that also affect `PlayerManager:check_skills()`, such as [Restoration Mod](https://modworkshop.net/mod/428). You can find this option in `Mod Options -> Advanced Crosshairs and Hitmarkers -> Misc... -> Compatibility: PlayerManager:CheckSkill()`.
- Hitmarker preview now loops automatically (can be toggled off via a menu toggle)
- Hitsound menu now plays a hitsound preview upon changing the volume slider (subject to hitsound count limits as per your settings)
- Crosshair preview now shows immediately upon entering the Crosshairs category/firemode menu
- Bloom for the Classic Crosshair (PDTH crosshair) has been reduced to a more manageable value; crosshair bloom now visually resets to the proper 0-bloom position after bloom animation
- Fixed melee kills not activating hitmarkers or hitsounds
- Fixed crosshairs becoming "stuck" on screen and not updating properly upon returning from custody
- Fixed potential crashing related to ACH HUD animations occuring during game transitions (eg. heist restarts, loading game, etc.)
- Fixed crash potentially caused by incompatibility with [Hyper Heisting](https://modworkshop.net/mod/24337)
- Fixed hitsound volume sliders not saving to settings
- Removed AddFile entry for now-removed crosshair_circle_64.texture, which was causing annoying but otherwise harmless error notifications from BeardLib
- Added Chinese localization - thanks, 啊这
- Miscellaneous code fixes, improvements, and localization tweaks
19 Nov 2020 v3
- Fixed the setting for hiding the crosshair on ADS not saving for global crosshairs
- Removed all Halo/NobleHUD crosshairs and separated them into a standalone addon to reduce clutter and mod filesize. If you had those selected- sorry! This was done to reduce overall file size of the mod, since many users may not wish to use Halo/NobleHUD crosshairs. You can get them back from here: https://modworkshop.net/mod/29903 . This is the last time I'll remove selectable crosshairs/hitmarkers/hitsounds bundled from the mod.
- Added PDTH crosshair ("Classic"). This crosshair is now the default instead of the MA37.
- Added submenu for resetting all or only some categories of settings
- Previewing a crosshair or hitmarker now shows the name of the crosshair or hitmarker on the preview screen, if a localization is available, instead of just "PREVIEW"
- Advanced addons can now load megapacks (of a single addon type) as multiple separate selectable options by returning `true` as the first value, and a table containing data for each addon (with addon id as the key within this table) as the second returned value.
- Updated Destiny hitmarkers
16 Nov 2020 v2
- Added option (per crosshair) to hide crosshair when ADS
- Fixed not saving/loading color correctly when changing crosshair color
- Added hitsound volume sliders to menu
- Added hitsound/hitmarker cap slider (individually)
- Added multiplechoice option to enable cap (don't play if too many are currently playing), remove oldest object to make room to play current, or delimit hitmarkers/hitsounds
- Advanced Addons with syntax errors in their lua files will now be skipped instead of being loaded as Simple Addons, and output the error to the log
15 Nov 2020 v1
- First public release
29 Oct 2020 v0
- Fixed a bug where the mod did not yet exist
You may not re-upload this mod without permission.
Dependencies
-
-
-
Instructions
**Make sure to first have SuperBLT installed. Click the link in the dependency list.**
Optional video tutorial for installing SuperBLT, BeardLib, and mod_overrides mods: https://youtu.be/rin_sjSJIkg
1. After downloading the mod, use a program such as [7zip](https://www.7-zip.org/download.html) or [WinRAR](https://www.rarlab.com/download.htm) to extract the main folder of the mod.
2. Drop that folder into the `mods` folder which is supposed to be in the game's installation folder (don't know where that is? click [here](https://wiki.modworkshop.net/books/payday-2/page/finding-payday-2s-install-folder))
### [color=ffd700]Installation:[/color]
[i]Installing ACH:[/i]
1. Follow the download link
2. Unzip the .zip file into your `mods` folder using the archive utility of your choice (I recommend [7zip](https://www.7-zip.org/))
3. Launch the game. You are now ready to use ACH and install addons.
[i]Installing addons:[/i]
Addon folders should be installed in one of the following folders, according to the type of addon:
`/mods/saves/ACH Addons/Crosshairs/`
`/mods/saves/ACH Addons/Hitmarkers/`
`/mods/saves/ACH Addons/Hitsounds/`
Please note that the `ACH Addons` folder does not exist until you launch the game with ACH installed for the first time.
If you wish, you may opt to create the appropriate folders yourself, however.
Comments