Go to file
SilentSpike 51a61653f4 Update spectator docs (#5362)
* Add player initilization safety to setSpectator

Public function which should wait for player unit to exist before running.
With this change an additional variable is now set on the player unit which
can be used to check whether players are spectators or not (part of
grander plans).

* Add UI initalization safety to setSpectator

Should make it so that calling the public function before the main display
has initalized will correctly wait until it has before starting spectator

* Overhaul spectator

Initial WIP overhaul of spectator component. Based on BI's End Game
Spectator and AACO's work on POTATO spectate. The essential functionality
is in place, but some things are broken and some are still to be
transferred.

* Remove redundant canInteract condition

Spectator UI will be open anyway so this is pointless.

* Fix follow camera controls

Also ensure unit camera modes have a target more consistently

* Fix widget weapon icon for unarmed

* Fix follow camera zooming

* Fix entity list not updating correctly

* Remove redundant conditions

* Fix list click behaviour

* Remove a bunch of old debug

* Alter behaviour of camera speed

* Restructure the spectator addon

* Fix camera tracking behaviour

* Fix very fast camera toggle

* Fix initial camera mode

* Fix double click behaviour

* Make AI name display consistent

* Add UI toggle

* Fix current camera mode button highlighting

* Fix focus info widget when clicked on in 3D world

* Improve key handling

Use of `inputAction` could result in weirdness when multiple keys pressed
at the same time. Hardcoded for now.

* Implement dynamic help UI element

* Remove some redundant code

* Fix follow camera jitter

* Add projectile drawing

Technically the capability to draw projectiles has been in since the
start. However it took me a bit of time to figure out how best to
add/remove the required event handlers.

I decided to add them during the process of finding things to draw, since
I'm iterating over the list of spectatable entities here anyway. With an
additional GVAR containing up to date entities, the fired EHs can remove
themselves when applicable. This avoids any granularity issues with adding
EHs en masse.

* Improve naming convention related to drawing

* Remove outdated unit and side settings

Also re-add unit whitelisting/blacklisting support

* Rename public function for consistency

Adds a deprecated warning to the old function name.

* Update stringtable

Some entries are replaced with BI translations, others are no longer
needed. I pieced together one of the camera mode settings by combining the
BI translations of the individual versions.

* Add location public functions and list population

Just need to take care of drawing and then camera interaction now

* Add location 2D and 3D drawing

* Respect whitelist and blacklist correctly

* Add location camera focus capability

* Fix local helicopters follow mode bug

* Add compatibility with `counter` template

Simply repositions the counter UI to the top of the screen out of the way

* Update respawn template

This template is only compatible with respawn types 2 & 3

* Rename compatibility function

* Add compatibility for respawn types 1,4 and 5

* Update setCameraAttributes function

* Fix draw3D for respawn types 1,4 and 5

* Fix screeching seagulls #4265

* Fix script command typo

* SQF Linter Pass

* Add obsolete warning for public func params

* Deprecate interrupt function

* Fix incorrect function call

* Make playable virtual spectator work

* Improve focus handling in public function

- User might want to reset focus for free cam, in which case objNull
  cannot be reserved for random
- Focus is still required for unit camera
- Update some function headers

* Note explicitly the use of `player`

* Remove unused base classes

* Improve seagull culling

* Add projectile drawing to vehicles

* Fix same tab selection clearing list

* Make projectile lines last 1 frame longer

* Add true zeus compatibility

- Re-opens spectator when zeus closes
- Transfers the curator module over in the respawn template
- Only handle uiForced in setSpectator to avoid issues with esc key
- Add safety to setFocus so that it only updates the UI when applicable

* Fix player moving in FPP

* Fix zeus transfer and re-opening

* Consolidate icon definitions

* Fix AI setting for player groups

* Improve handling of alive spectators

Instead of disabling simulation, just stage them automatically if alive.

* Fix respawn template for types 2 & 3

* Fix pre-set camera mode with no focus

- Improve handling of UI updates in camera related functions
- More explicit UI initalisation
- Find a focus if one wasn't pre-set for a camera mode which requires a
  focus

* Localise key names

* Fix camera mode and vision settings on init

When spectator starts the available camera modes and vision modes should
be consulted to ensure they are respected upon opening.

* Fix key localisation

* Add next/prev entity keys

* Fix vision modes update while camera active

- Updates the camera vision mode in case the current was removed

* Add public getCameraAttributes function

* Fix spectator zeus compatibility

- Camera control wasn't returned on exit due to change in fnc_ui

* Improve vision mode handling

- Curator now resets vision mode on entry
- First person also reset vision mode so that it is consistent between
  camera changes

* Improve location handling

- It makes more sense to specifiy the position ATL since the text is going
  to be rendered there and a z of 0 is then ground height.
- Updates the ui immediately if the list is already on locations

* Disable list keyboard search

* Fix handling of forced camera mode with no focus

* Fix handling of free mode removal while no target

* Fix locations respecting available modes

* Fix list entry removal code

- Replace getTargetGroups with getTargetEntities for consolidated
  filtering.
- Fix the step of the removal loops and make them go to index 0 instead of
  1

* Improve side handling of unit list

- Accounts for possibly of whitelisted random objects that belong to other
  sides
- Move the index decrement to loop, not within every loop

* Add linter ignore directive

* Fix list code

* Improve entity fetching

- Change whitelist/blacklist application to optimize the code

* Include dead units in the list

- Allow getTargetEntities to return dead units too
- Iterate over allGroups in list updates to reduce overhead

* Take care of TODOs

* Mark stageSpectator as non-public

* Fix updating list focus

* Adjust default camera speed

* Include the function file

* Generalise camera button UI

- Makes it easier to extend with future camera mode buttons
- Removes potential error when display doesn't exist

* Remove obsolete staged event

- Add vision toggle to help
- Restructure some function PREP

* Add public function to return all spectators

* Change default briefing name used on map display

* Fix the order of 4 main sides in list

* Restore non-toggle behaviour of camera speed

* Fix UI gap between list and tabs

* Force update UI list when player is staged

Hopefully this fixes any issues related to the player appearing in the
list

* Update controls strings

* Fix entity tooltips showing short name

- Also revert changes to common function and just handle in this component

* Include dead in unit switching

* Show rank and vehicle icon in list

- Rank is shown in tooltip
- Vehicle icon is used to see which units in the list are mounted

* Change default vehicle icon

* Show whether medic/engineer in tooltip

* Improve list double click behaviour

* Improve group icon handling

* Use dynamic group icons for drawing

* Fix EFUNC call

* Update all function headers

* All the changes I had staged before arma broke git

Arma managed to crash my whole system again, breaking my git repo and I
resorted to nuking it and pasting the changes I had comitted locally back
in. From memory:

- Fix icon paths
- use distanceSqr for minor speed boost
- Add setting to show map locations in the UI
- Limit location rendering based on distance
- Probably some other crap

* Fix squared comparisons

* Remove unnecessary variable publicity

* Deprecate fnc_stageSpectator

The function was a source of confusion alongside fnc_setSpectator and so
it is replaced by an additional parameter to hide the unit as part of
fnc_setSpectator. No longer is the unit moved either, to reduce complexity
and give more control to mission maker.

* Fix undefined variable

* Update spectator framework doc

* Update spectator feature doc

* Fix typos and grammar

* Revent version introduced number

* Update with new changes
2017-10-17 20:19:10 +02:00
.github Remove @ from issue template (#4933) 2017-02-26 14:59:04 +01:00
addons Update spectator docs (#5362) 2017-10-17 20:19:10 +02:00
docs Update spectator docs (#5362) 2017-10-17 20:19:10 +02:00
extensions Advanced Ballistics - Drag model revamp & Spin drift correction (#5566) 2017-10-06 13:05:20 -05:00
extras Advanced Ballistics - Drag model revamp & Spin drift correction (#5566) 2017-10-06 13:05:20 -05:00
optionals Update No Uniform Restrictions definitions for Arma 3 1.76 (#5625) 2017-10-15 03:13:16 +02:00
tools Python tool which converts ballistic coefficients into 'airFriction' values. (#5573) 2017-10-01 09:52:09 +02:00
.editorconfig Set LF line endings as default 2016-05-30 18:18:38 +02:00
.gibot.yml Ingore issues and PRs marked as stale (#5369) 2017-07-16 08:55:44 +02:00
.gitattributes Set .paa as binary 2016-05-30 18:27:40 +02:00
.github_changelog_generator Cleanup GitHub Changelog Generator config file (#4875) 2017-02-05 16:50:41 +01:00
.gitignore Add GitHub Changelog Generator configuration file (#4705) 2016-11-25 00:14:28 +01:00
.travis.yml Use Python 3.5 in Travis (#5467) 2017-09-01 05:34:24 +02:00
ace_advanced_ballistics_x64.dll Advanced Ballistics - Drag model revamp & Spin drift correction (#5566) 2017-10-06 13:05:20 -05:00
ace_advanced_ballistics.dll Advanced Ballistics - Drag model revamp & Spin drift correction (#5566) 2017-10-06 13:05:20 -05:00
ace_break_line_x64.dll Rebuild Dlls for x64 dev branch (#4765) 2016-12-15 10:51:47 -06:00
ace_break_line.dll Update extensions 2016-06-21 18:17:24 +02:00
ace_clipboard_x64.dll Rebuild Dlls for x64 dev branch (#4765) 2016-12-15 10:51:47 -06:00
ace_clipboard.dll Update extensions 2016-06-21 18:17:24 +02:00
ace_fcs_x64.dll Rebuild Dlls for x64 dev branch (#4765) 2016-12-15 10:51:47 -06:00
ace_fcs.dll Update extensions 2016-06-21 18:17:24 +02:00
ace_medical_x64.dll Rebuild Dlls for x64 dev branch (#4765) 2016-12-15 10:51:47 -06:00
ace_medical.dll Update extensions 2016-06-21 18:17:24 +02:00
ace_parse_imagepath_x64.dll Rebuild Dlls for x64 dev branch (#4765) 2016-12-15 10:51:47 -06:00
ace_parse_imagepath.dll Update extensions 2016-06-21 18:17:24 +02:00
Arma3_workshop_addon.jpg Arma3_workshop_addon.jpg 2015-07-28 15:42:09 -07:00
AUTHORS.txt Rearm bugfixing (#5411) 2017-09-29 14:53:25 -05:00
LICENSE FastRope Sounds - Fix Config, Merge PFEH, Add CC Attribution 2016-05-10 10:09:52 -05:00
logo_ace3_ca.paa add logo and mod.cpp 2015-03-15 07:23:18 +01:00
meta.cpp Add protocol version to meta.cpp 2016-02-23 12:15:51 +01:00
mod.cpp Prepare release 3.10.2 2017-07-11 00:21:09 +02:00
README.md Fix README license note 2017-10-03 19:15:37 +02:00

ACE3 Version ACE3 Issues ACE3 Downloads BIF Thread ACE3 License ACE3 Slack ACE3 Build Status

Requires the latest version of CBA A3.
Visit us on Twitter | Facebook | YouTube | Reddit

ACE3 is a joint effort by the teams behind ACE2, AGM and CSE to improve the realism and authenticity of Arma 3.

The project is entirely open-source and all contributions are welcome. Feel free to maintain your own custom version, so long as the changes you make are open to the public in accordance with the GNU General Public License (GPLv2).

The mod is built modularly, so almost any included PBO can be easily removed from the configuration. This way, a team can maintain its own tailored version of ACE3 by simply excluding any components they don't need, or those possibly in conflict with other mods. Modules themselves, e.g. the medical system, also include various customization options, allowing mission designers to tweak the overall experience.

Core features

  • Brand new 3D interaction/action system
  • Performance and reliability framework
  • Focus on modularity and customization
  • New flexible client and server settings & configuration
  • Improved medical system with various levels (basic/advanced) focus on gameplay/realism
  • Proper & consistent network-synced weather
  • Wind and weather-based ballistics
  • Captivity system
  • Explosives system, including different trigger types
  • Map screen improvements marker placement and map tools
  • Logistics
  • Advanced missile guidance and laser designation

Additional features

  • Carrying and dragging
  • Realistic names for vehicles and weapons
  • A fire control system (FCS) for armored vehicles and helicopters
  • Realistic ballistics/FCS calculated in C/C++ extensions
  • Backblast area and overpressure simulation
  • Disposable launchers
  • Realistic G-forces
  • Vehicle locking
  • Realistic night and thermal vision modes
  • Magazine repacking
  • Realistic weapon overheating mechanic
  • Combat deafness (temporary loss of hearing) simulation
  • Improved interactions for AARs and ammo bearers
  • Adjustable sniper scopes
  • No idle animation with lowered weapon
  • No talking player avatar
  • Jumping over obstacles, climbing over walls and cutting down fences
  • Vector, MicroDAGR and Kestrel devices
    and much more...

Getting started

ACE3 requires Arma 3 and the latest version of CBA A3. See the following pages for help and information on how to get started with ACE3:

Contributing

You can help out with the ongoing development by looking for potential bugs in our code base, or by contributing new features. We are always welcoming new pull requests containing bug fixes, refactors and new features. We have a list of tasks and bugs on our issue tracker on Github. Please comment on issues if you want to contribute with, to avoid duplicating effort.

Contribution guidelines

To contribute something to ACE3, simply fork this repository and submit your pull requests for review by other collaborators. Remember to add yourself to the author array of any PBO you will be editing and the AUTHORS.txt file; including a valid email address.

Submitting issues and requesting features

Please, use our Issue Tracker to report a bug, propose a feature, or suggest changes to the existing ones. See also:

Testing & building

To help us test the latest development changes, download our master branch (directly, or with git), then assemble a test build:

Get in touch

Slack We have a public Slack team that anyone can join. This is where all our developers and contributors hang out and where we make announcements
Twitter You can follow our Twitter account to get updates and various links to guides
Facebook You can follow our Facebook account to get updates and various links to guides
Bohemia Forum We have a dedicated thread on the Bohemia Forums for the ACE3 project

License

ACE3 is licensed under the GNU General Public License (GPLv2).