[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 broadly necessary for ACH's 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]
* Hitsound previews do not play while in the menu if the game is paused (applies to singleplayer offline games only). This is done intentionally to avoid a bug where hitsound previews would queue but not play until the game was unpaused, at which point all sounds would play simultaneously at deafening volume. [status: investigating solutions]
* Dragging the Hitsound volume sliders with the mouse results in sounds stacking once per frame at hideously loud volume. Users are strongly advised to 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: no fix planned yet]
* 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 filter 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: investigating solutions]
* [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.]
-----
### [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, depending on which type of addon it is:
`/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.
If you wish, you may opt to create the appropriate folders yourself, however.
----
#### [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 small dev-art 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/29864) 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
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: Can I disable some of the features but keep the others?
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: 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.
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! You can get the 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.
Comments