Arma3_Epoch/ACE3
1
0
Fork 0
mirror of https://github.com/acemod/ACE3.git synced 2024-08-30 18:23:18 +00:00
Code Issues Packages Projects Releases Wiki Activity
41d6cae93b
ACE3/docs/wiki/feature/arsenal.md
Grim d33a158e2e
Arsenal - Favorites System (#9307) 
* improve page handling

* drop MAX_STATS_PER_PAGE for now

* hide stats box when empty

* improve hiding

* improve _fnc_hideUnused

* condition

* prevent page overflow

Co-authored-by: PabstMirror <pabstmirror@gmail.com>

* favorites var

* function prep

* favorites only

* improve favorites adding, add include

* fix stupid

* fix color setting (todo: lnb color)

* add button, finalize

* setting tooltip

* stringtable again

* fix setting overwrite, improve tooltip

* fix losing weapon items

* fix macro

* fix setting to intended overwrite

* remove unnecessary private

* docs

* more docs

* is

* improve button text

* docs

* fix tooltip not showing unless menuBar was clicked

* improve weapon accessory lookup

* empty line

* update refresh calls

* fix left panel

* cleanup currentCargo

* use BI string for favorites

* BI strings again

* no favorites for face/voice/insignia

* stringtable again

* add missing setColorRight

* Add comment for favorites setup

---------

Co-authored-by: PabstMirror <pabstmirror@gmail.com>
2023-08-19 23:56:59 -04:00

5.0 KiB
Raw Blame History

layout title component description group category parent mod version
wiki ACE Arsenal arsenal Adds an interface that allow player to edit their loadouts. feature general wiki ace
major minor patch
3 12 0

1. Overview

1.1 Features

ACE Arsenal has a pretty large number of improvements over BI Virtual Arsenal, here is a non exhaustive list:

  • The ability to select the magazine loaded into your primary / secondary / handgun without leaving ACE Arsenal.
  • Search bars for both the left and right panels.
  • New tabs to add weapon accessories to a container.
  • A "Clear container" button to remove all items from a container.
  • Unique items support.*
  • Loadouts can be shared with other players.
  • Mission makers can save "Default loadouts" that will be available in their own tab independently from player saved loadouts.
  • A setting to disable mod icons to increase performance even further.
  • An other setting to invert horizontal camera controls.
  • Settings to disable the "Default loadouts" and "Public loadouts" tabs.
  • Custom sub item categories for misc items
  • Items can be saved as favorites to filter for your preferences.

* Items not currently available in ACE Arsenal but in the unit's inventory, unique items will be omitted when loading loadouts and they can only be removed from containers.

1.2 Loadouts

Loadouts from BI Virtual Arsenal will not show up in ACE Arsenal and vice versa. Insignias, faces, and voices are NOT saved

The loadouts screen is separated into 3 tabs:

  • "My loadouts" for loadouts saved into your profile.
  • "Default loadouts" for loadouts saved in the mission.
  • "Public loadouts" for loadouts made public by other players (does not persist after the owner disconnects).

"Default loadouts" and "Public loadouts" tabs can be disabled by the mission maker.

Loadout names are unique, you cannot have two loadouts with the same name, however you are able to rename loadouts.

Saving loadouts from the default and public tabs will save them in your profile, they will show up in the "My loadouts" tab if you switch back to it.

All loadouts can be loaded, however items not available or missing, will NOT be added. This limitation applies to all tabs as well as imported loadouts.

The color coding for loadouts is as follows:

  • White: All items are available and will be loaded.
  • Grey: Some items in that loadout are not available in that box.
  • Red: Missing mods / class not defined, this takes precedence over grey if there is also unavailable items.

1.2.1 Importing loadouts from Virtual Arsenal

You can import loadouts from Virtual Arsenal into ACE Arsenal, face, voice, insignias, and items from mods that aren't loaded won't be ported.

  • Go in 3DEN
  • Place down a player unit
  • In the 3DEN top toolbar, click on the TOOLS tab
  • Click on Import BI VA Loadouts to Ace Arsenal

2. Favorites

To switch between displaying all items or just favorites, press the Items: button on the bottom of the interface.

Items can be saved to favorites by pressing Shift + 2x LMB. Favorites are saved to your profile, along with loadouts, and persist between missions and mod changes.

Favorited items will be shown in a light gold color by default, but this can be changed under ACE Arsenal -> Favorites Color in CBA Settings.

It is also possible to toggle between showing all items or favorites by default upon opening the arsenal via ACE Arsenal -> Default to Favorites in CBA Settings.

Those settings cannot be overwritten by mission makers and are exclusively player preference.

3. Shortcuts

Note:

Ctrl + V does NOT work in multiplayer due to a BI safety, however Ctrl + C does since it's using the ACE3 clipboard extension.

3.1 Outside of search bars

  • Ctrl + C: Export current loadout to clipboard.
  • Ctrl + V: Import loadout from clipboard.
  • Backspace: Hide / show the UI (does not work on loadouts screen).
  • Arrow keys can be used to naviguate the left and right panels.
  • Shift + LMB on the + or - buttons on the right panel to add or remove 5 of the selected item.
  • Ctrl + F Selects the left search bar.
  • Shift + 2x LMB on an item will add or remove it from favorites.
Note:

Shift + arrow keys can be used to add or remove a large amount of items in a short amount of time from the right panel.

3.2 Inside of search bars

  • Search bars support copy / cut and paste (same limitations as importing apply in multiplayer).
  • Ctrl + A is supported.
  • Enter validates the search.
  • RMB clears the text field.
  • Arrow keys can be used to move the caret.
  • Ctrl + F switches which search bar is selected.