ACE3/docs/wiki/feature/rearm.md

layout	title	description	group	category	parent
wiki	Rearm	Adds the option to rearm vehicles	feature	interaction	wiki

1. Overview

This adds the option to rearm vehicles. The module settings allow you to configure ace_rearm for both casual gaming and simulation game modes. Both the rearm speed and the availability of ammunition supply can be configured.

2. Rearming

2.1 Rearming a vehicle with setting Entire vehicle

• Interact with the ammo truck ⊞ Win (ACE3 default key bind Interact Key).
• Move over Rearm and a list of vehicles within 20 meters that can be rearmed will be shown.
• Select the vehicle from the list. It takes a few seconds to rearm the vehicle.

2.2 Rearming a vehicle with setting Entire Magazine

• Interact with the ammo truck ⊞ Win (ACE3 default key bind Interact Key).
• Move over Take ammo and a list of vehicles within 20 meters that can be rearmed will be shown.
• Select the vehicle and the magazine from the list. You will pick up an ammo box.
• Walk to the vehicle and interact with it.
• Select Rearm. You will rearm the magazine of the vehicle.

If a weapon carries multiple magazines of the same type, you have to repeat the procedure for every (partially) spent magazine.

2.3 Rearming a vehicle with setting Amount based on caliber

It's the same process as with setting Entire Magazine, but most magazines will require several ammo boxes.

Caliber in mm	6	7	8	13	19	20	25	30	35	39	40	60	70	80	82	100	105	120	122	125	155	230	250
Number of rounds per box	500	500	400	100	50	50	40	25	34	24	10	2	2	2	2	1	1	1	1	1	1	1	1

The caliber of the weapon will be rounded to the nearest number and the number of rounds is calculated using the table above. To fully rearm 2000 rounds of 7.62mm machine gun, you need five ammo boxes.

3. Limiting the ammunition supply

With ACE3 3.6.0 ammunition supply can be limited on ammo trucks.

3.1 Rearming with setting Unlimited ammo supply

All ammo trucks have an unlimited ammunition supply by default. You can rearm as many vehicles as often as you like.

3.2 Rearming with setting Limited ammo supply based on caliber

On this setting all ammo trucks have a limited ammunition supply. The supply consumption is based on "caliber points". With 1000 points worth of ammunition supply, you can rearm four magazines of 250mm caliber (i.e. bombs) or eight magazines of 120mm caliber (i.e. tank rounds) or 125 magazines of 7.62mm caliber.

3.3 Rearming with setting Only specific Magazines

On this setting, the mission creator has to use the framework to add specific magazines to the ammo truck(s). This allows you to create munition specific ammo trucks i.e. one ammo truck for missiles and one for bombs.

3.4 Checking the ammunition supply

• Interact with the fuel truck ⊞ Win (ACE3 default key bind Interact Key).
• Select Check remaining ammunition.

Depending on the module setting, you will be shown a hint containing either the remaining supply points or the remaining magazines with their remaining number of rounds.

4. FAQ

Can I drop the ammo box?

Yes, using the action menu.

I dropped the ammo box. Can I pick it up?

Yes, using the interact menu ⊞ Win (ACE3 default key bind Interact Key).

We picked up to many ammo boxes. What shall we do?

When rearming with multiple people, you may pick up more ammo boxes than needed. You can return them using the Store ammo option. When using limited supply, returning unused ammo boxes will restore their supply.

I'm carrying something - it's not an ammo box. What's wrong?

Nothing. Some objects, especially missiles and bombs, have proper static 3-D models which replace the ammo box. Mod developers can use the framework to use their custom models as ammo box replacement.

Does rearm work with vehicles from mods?

Yes, if the vehicle has the correct config entries or uses inheritance from vanilla ammo. Otherwise there is a compatibility mode.

How do I replenish the ammunition supply on an ammo truck?

Please check the framework description for more details.

The limited supply option Only specific Magazines doesn't work. What's wrong?

The mission creator has to use the framework to add specific magazines to the ammo truck(s). On this setting all ammo trucks are empty by default. For more information, please check the framework description.

5. Dependencies

{% include dependencies_list.md component="rearm" %}