Author: A.Cyprus
Author Website:

Requirements: Community Base addons A3

Version: 1.6
Signed: Yes, serverkey included

Short description: Cyprus Push-to-Hear allows you to temporarily reduce in-game sound and music volume by holding down a preset key.

Date: 2015-04-09 21:59


Comments: (5)
Rating:



 



Cyprus Push-to-Hear

by
ACyprus


Description:
Have you ever found yourself in a chopper, jet or armoured vehicle, struggling to hear your teammates chatter because the engine's too loud? How about a crazy firefight where battle sounds are drowning out the comms? Cyprus Push-to-Hear allows you to temporarily reduce in-game sound and music volume by holding down a preset key or mouse button. A toggle setting is also available, and a UI icon is displayed on the in-game HUD whenever Push-to-Hear is in effect.

More info:
The HUD icon is positioned so as not to interfere with VTS Weapon Resting (which I use(d) religiously), and has been tested in various interface sizes.

Push-to-Hear key bindings may be changed in-game via: CONFIGURE > CONTROLS > CONFIGURE ADDONS. Mouse button configuration may be changed in the supplied userconfig file.

You may also independently configure the following settings via the userconfig file:
- the volume that SOUNDS will be suppressed to while Push-to-Hear is active
- the volume that MUSIC will be suppressed to while Push-to-Hear is active
- how long it takes for the volume changes and GUI icon to fade in
- how long it takes for the volume changes and GUI icon to fade out

In future, I will make this adjustable via an in-game interface, along with a host of new features.


Installation:
Extract into the ArmA 3 Directory, by default this is located in:
32-Bit - C:\Program Files\Steam/Steamapps\Common\ArmA 3\
64-Bit - C:\Program Files (x86)\Steam/Steamapps\Common\ArmA 3\
After extraction it should look like this:
Steam\Steamapps\Common\ArmA 3\@your_mod_folder_name\addons\

You can also use the "Arma 3 Alpha" folder in your "My Documents" folder. Your folder setup could than look like for example this:
mydocuments\Arma3 Alpha\@your_mod_folder_name1\addons\
mydocuments\Arma3 Alpha\@your_mod_folder_name2\addons\
mydocuments\Arma3 Alpha\@your_mod_folder_name2\addons\

When present place the "userconfig" folder into your game install folder, usually:
"C:\Program Files (x86)\Steam\steamapps\common\Arma 3".
You may already have "userconfig" folder from other addons and/or mods in which case it is safe to merge the contents from this archive.

You'll also need to add a Launch Parameter to Steam, in order to do so right-click on ArmA 3 Alpha and click Properties and then Set Launch Options. In the window that opens enter in -mod=@your_mod_folder_name
For using multiple mods you would then do so like this:
-mod=@mod_name;@mod_name2;@mod_name3;@mod_name4;@mod_name5

Note:
You can also use -nosplash to get rid of the splash art and intro videos.


And of course you can also enable and disable community made addons and mods through the in-game Options Expansions menu if you do not want to mess with startup parameters!

When the above information still does not provide you with enough to learn how to install custom addons and mods you can always ask in our Guide On Installing Mods.


Included files:
cyp_pushtohear_a3.pbo


Usage:
- Customise settings in cyp_pushtohear_a3_config.hpp if needed
- Set your Push-to-Hear key bindings in-game via: CONFIGURE > CONTROLS > CONFIGURE ADDONS

Server admins:
Cyprus Push-to-Hear is signed. In fact, it is signed twice, and I have included two sets of keys. I'm going for both granularity AND simplicity.

- cyprus.bikey : this corresponds to my personal non-specific key
- cyprus-pushtohear.bikey : this corresponds to my personal key unique for this particular addon only

In this way you may either allow all my addons or cherry pick only those you want by adding the appropriate keys to your server.


Known issues:
- Use PtH v1.41 with CBA RC4
- Use PtH v1.5 with CBA RC6 or later


Future plans:
In future, I will make this adjustable via an in-game interface, along with a host of new features.


Notes:
This is my first attempt at creating an addon for Arma 3. I chose it as a very simple introductory project to Arma 3 scripting, yet functional for me personally. Please do post constructive feedback, helpful advice, bug reports or sensible feature requests below.

It would be great to hear from those of you who add Cyprus Push-to-Hear to your server, mission, mod collection or repository, or simply enjoy using it.

Version 1.4 notes:
This update includes a reworked userconfig file. Remember to replace your current one for new features!
This update has been signed by a new key. Please update your addons and remove the existing key to ensure older addon versions are denied on your servers.


Credits & Thanks:
- [Mox] Lanski-TPF-, for the graphics, patience and of course Maya
- Taosenai and the CBA team, for their Keybinding System
- Killzone Kid, for his GUI tutorials and Hex 2 Arma GUI Colour Converter at http://killzonekid.com/
- esteldunedain, for his swift and helpful collaboration on AGM Hearing fixes, https://github.com/esteldunedain
- PabstMirror, for his considerate advice on security issues with userconfig includes
- nkey, for his curator workaround, https://github.com/michail-nikolaev
- The authors and contributors of BI Community WIKI, for such a useful reference
- Armaholic and withSix networks for hosting this addon
- My friends at the Expeditionary BattleGroup - always looking for decent members!, http://www.theexpeditionarybattlegroup.com


License / Disclaimer:
This work is released under the Arma Public License Share Alike license.

Please include the readme.txt intact when 'sharing' the addon.


Changelog:
v1.6
- NEW: Use Push-to-Hear as Zeus, in the Curator interface
- NEW: Compatible with ACE3 Hearing module
- FIX: Push-to-Hear GUI icon no longer disappears after a certain period
- FIX: CBA RC6 keybinds now save

v1.5
- Fix: Converted keybind system to CBA RC6

v1.41 (17 novemeber 2014)
- now respects userconfig settings

v1.41
- FIX: Corrected issue with players being kicked from servers for bad signature (wasn't actually the key that was the problem)
- NEW: Included addon-specific server key, in addition to the general key for all my addons

v1.4
- NEW: Push-to-Hear GUI icon now displayed over Map when active
- NEW: Suppressed volume levels can now be set via userconfig
- NEW: Suppressed volume levels can be set independently for sounds vs music
- NEW: Suppress and restore effect durations for volumes and GUI icon can now be set independently
- FIX: Corrected a potentially exploitable issue in userconfig include

v1.2
- NEW: Compatability with AGM Hearing module (requires AGM v0.94 or later)
- NEW: Introduced userconfig file for various customisable settings
- NEW: Configurable mouse buttons now useable for Push-to-Hear (no toggle)
- NEW: 'Suppressed' volume level now configurable
- NEW: Sound and music volumes checked and handled independently
- FIX: Check and restore previous sound and music volumes when Push-to-Hear deactivated
- FIX: Toggle function changed to keyup to avoid UI icon flickering when holding down toggle key
- FIX: Volume reduced only if 'suppressed' volume level is less than current music or sound volume

v1.0
- Initial release


Forum topic:
- BI forums



- Community Base addons A3




Enable javascript to be able to download from Armaholic please!



Tags: Loud,   Push-To-Hear,   Reduce