Difference between revisions of "Radio Support"

From Savage Game Design Wiki
Jump to navigation Jump to search
m (Update pastebin link)
Line 16: Line 16:
 
This module works off a single config class, this can either be one located in the CDLC, or one located in the missions '''description.ext'''.
 
This module works off a single config class, this can either be one located in the CDLC, or one located in the missions '''description.ext'''.
  
Use the [https://pastebin.com/embed_iframe/Nx1eWuX3 '''default CDLC config'''] as a starting point for your own config.
+
Use the [https://pastebin.com/embed_iframe/KU3uc5UT '''default CDLC config'''] as a starting point for your own config.
  
 
Starting from the top of the example config there are seven values which can be changed,
 
Starting from the top of the example config there are seven values which can be changed,

Revision as of 02:36, 25 January 2023

Radio Support Module

This page will guide you through adding the Radio Support module to your mission.

This module allows players to request radio support to assist them with taking out enemies. Mission creators can setup their own callsigns including custom names, icons, descriptions, conditions, and more.


Eden Editor

To add the module to your mission all you need to do is place the module Radio Support into your mission.


Configuration Files

This module works off a single config class, this can either be one located in the CDLC, or one located in the missions description.ext.

Use the default CDLC config as a starting point for your own config.

Starting from the top of the example config there are seven values which can be changed,

  • cost_variable
    • This is the name of a number variable which can be used to make players 'pay' for each request, each callsign will have a 'cost' value which players will need to have a higher or equal cost variable to request successfully.
  • availability
    • This is the main availability array, this lets you quickly and easily determine how players should have access to the radio support action.
    • Each item in the array can either be true '1' or false '0', each index in the array will change when the action is shown
    • {Action will always be avaliable, Unit's backpack is in the `radio_backpacks` array, Unit's vehicle is in the `radio_vehicles` array, Unit's classname is in the `player_types` array, Unit has the `vn_artillery` unit trait}
  • danger_distance
    • This is the minimum distance to respawn markers that a request can be called. Requests that fall within this distance will not be completed.
  • delay_max
    • Maximum delay for the support to arrive, regardless of the time calculated from distance to support module.
  • captive
    • Determines if the support planes/helicopters will be set to captive.
  • unit_trait_required
    • Set this to 1 to only show the option to units that have the vn_artillery unit trait, does the same thing as setting the last value in the availability array to 1.
  • radio_backpacks
    • This is a list of backpacks which will be considered radio backpacks for the availability array above.
  • radio_vehicles
    • This is a list of vehicles which will be considered vehicles with radios for the availability array above.
  • player_types
    • This is a list of unit class names which will be given the action when setup in the availability array above.

After these options there are two child classes, aircraft and artillery, these child classes will contain the options that will be available to players.

Classes in the aircraft class will be shown to players when they select the "Air Support" option on the radio.

Classes in the artillery class will be shown to players when they select the "Fire Support" option on the radio.

Inside these classes there are sub category classes, these classes will be the option on the left hand side of the radio support menu.

Each sub category class needs a displayname attribute which will be the name of the category.

Within the sub category class you can add the options that will be available to players.

Artillery Attributes

Each artillery option can have the following attributes,

  • displayname
    • This is the name of the option that will be shown to the user
  • icon
    • This is the icon which will be shown beside the option, can be left empty if you don't want an icon for this option.
  • description
    • This is the description of the option, this will usually consist of a sentence which goes into detail about the weapons and vehicle used in the option.
  • ammo
    • This is an array of ammo classes which will be spawned and then explode when hitting the ground
  • divergence
    • This is the distance for in both x & y directions that the position can differ from the users selected position
  • delay_max
    • Maximum delay for the support to arrive, regardless of the time calculated from distance to support module. Overwrites main config.
  • allow_double
    • This will allow the user to fire the ammo twice, doubling the amount of explosives
  • count
    • This is how many times each ammo class will be spawned
  • cooldown
    • This is how long users will need to wait before requesting this again
  • tickets
    • This is how many times the user can call this before it cannot be called again
  • cost
    • This is the cost of this option if using the cost variable
  • illumination
    • Is this an illumination round, affects the voice when requesting
  • function
    • If a function is defined then the function will run instead of any explosive being spawned
  • condition
    • The condition which must return true for this option to be shown in the list
  • speed
    • This is the speed of the request, used to determine how long the user should wait before the ammo starts to explode.

Aircraft Attributes

Each aircraft option can have the following attributes,

  • displayname
    • This is the name of the option that will be shown to the user
  • icon
    • This is the icon which will be shown beside the option, can be left empty if you don't want an icon for this option.
  • description
    • This is the description of the option, this will usually consist of a sentence which goes into detail about the weapons and vehicle used in the option.
  • vehicleclass
    • This is the classname of the vehicle which will be used to complete the request, should be either a helicopter or a plane
  • divergence
    • This is the danger distance for the request, used to let users know how large of an area will be hit by the aircraft
  • allow_double
    • This will allow the user to request two aircraft at the same time
  • cooldown
    • This is how long users will need to wait before requesting this again
  • tickets
    • This is how many times the user can call this before it cannot be called again
  • cost
    • This is the cost of this option if using the cost variable
  • illumination
    • Is this an illumination request, affects the voice when requesting
  • function
    • If a function is defined then the function will run instead of any vehicles being spawned
  • condition
    • The condition which must return true for this option to be shown in the list
  • magazines
    • This is the array of pylon magazines which will be added to the vehicles pylons


During Gameplay

Players can access the radio support menu through the scroll wheel action menu.

The radio at the top of the menu has an interactable knob which switches between "Air Support", "Fire Support", "Transport", and "Resupply".

Players can then select the category and callsign of their request, then left click and drag on the map to select the:
Air Support: Position and direction for the aircraft's run
Fire Support: Start and end location for the artillery run.
Transport: Pickup and original drop off location.
Resupply: Position and direction of the resupply run.

Then they can choose between a normal or heavy request for options which have allow_double set to true, then press the confirm button to send the request.