Reloadz Vehicle Exchange

This is a fairly flexible mod that can be configured in many different ways.

CONTENT:
- Cash Stack inventory item, used as currency for purchasing and modifying vehicles. Costs 10 supplies, available in the US Arsenal. Lightweight, can be equipped in hand. 

- Vehicle Document - used to store a vehicle in the form of an inventory item. Lightweight, can be equipped in hand.

- Purchased Vehicle Spawn Point - available in the Game Master entity catalog. Can be used as a general spawn location for all vehicles purchased from a Purchase Vehicle Action.

- Vehicle Exchange Station - available in the Game Master entity catalog. Used as a station for exchanging vehicles. Must be near this entity to use exchange action.

- Vehicle Exchange Shop - available in the Game Master entity catalog. Used as a station for buying vehicles with a physical currency.



What this mod does by default: (for example purposes)
- Adds a new inventory item to the US arsenal: Cash Stack - costs 10 supplies per.
- Adds a new M998 Vehicle Document inventory item, not available in arsenal, only obtainable by exchanging a M998 Utility vehicle.
- Adds new Vehicle Exchange entities to the Game Master catalog.
- Adds option to purchase an Olive M998 Utility vehicle from the Vehicle Exchange Shop using 15 Cash Stacks. Uses Purchased Vehicle Spawn Point, only visible if one has been placed by a Game Master.
- Adds option to exchange M998 Utility vehicles into Vehicle Documents. Exchanging requires a Repair Kit/Wrench tool equipped in hand. Option is visible on the front of the vehicle. Exchanging requires a Vehicle Exchange Station placed on the map by a Game Master.
- Adds option to modify the Olive M998 Utility vehicle into a Camouflage variant with an added Brushguard. Modification requires 5 Cash Stacks. Modifying requires a Repair Kit/Wrench tool equipped in hand. Modifying requires a Vehicle Exchange Station placed on the map by a Game Master.



What this mod can do:
- Purchase vehicles using a User Action. Set the price to any inventory item, or make the purchase free. Spawn the purchased vehicle at a preset location or at a spawn point placed via Game Master.
- Exchange vehicles into inventory items using a User Action. A tool required to exchange can be set. An entity can be set as the exchange station to check if the vehicle is nearby it before exchanging, or allow exchanges to take place anywhere.
- Modify vehicles into different variants, or into an entirely different vehicle. Modification can be set to require a tool. Can be set to require a cost, or allow modification for free. An entity can be set as the modify station to check if the vehicle is nearby it before modifying, or allow modifications to take place anywhere.
- All modded User Actions can be enabled or disabled individually during runtime by adjusting the Game Master attribute in the Edit panel.



How to config in Workbench:
- Attach RLZ_PurchaseVehicleAction to the ActionsManagerComponent of an entity you want to use as a vehicle shop. Entity must have a RplComponent attached (as well as MeshObject and RigidBody of course).
- Fill out the attributes for this User Action (hover over an attribute for a description of what it is for).
- Attach RLZ_ExchangeVehicleAction to the ActionsManagerComponent of the vehicle used in the Purchase Vehicle Action.
- Fill out the attributes for this User Action.
- If you want the vehicle to be modifiable, attach RLZ_ModifiyVehicleAction to the ActionsManagerComponent of the vehicle.
- Create an inherited prefab of the original vehicle, then add your modifications to that prefab.
- Add the inherited (modified) vehicle as the spawn entity prefab in RLZ_ModifyVehicleAction on the original vehicle.
- Ensure the attributes involving vehicle modifications are filled out.

This mod may be updated in the future to allow more vanilla vehicles to be exchanged for a document, and to possibly add more vehicle modification options.
Everything under "What this mod does by default" was created just as an example of how this system works. If you would like to see this mod have more functionality by default, please let me know. Otherwise, everything can be configurated via Workbench to fit your application of this mod.
I did my best to explain everything here. If you would like additional help on how to use this mod, contact me.

Feedback: ReloadzOfficial#1400 on Discord.