Freelancer Community Network
Reminder: Internet Explorer 6 or below are NOT supported.
HomeHome
ForumForum
WikiWiki
DownloadsDownloads
ForgeForge
Multiplayer Connection Tutorial
Collapse/Expand Random Image
Collapse/Expand Login
Username:

Password:

Remember me



Lost Password?

Register now!
Collapse/Expand Chat
Collapse/Expand Who's Online
35 user(s) are online (13 user(s) are browsing Forum)

Members: 0
Guests: 35

more...
Collapse/Expand Donations
Monthly costs: -30€
Income (ads): +5€
Donations (last month): +30€

Current balance: -35€
(last updated 05/2019)

Please make a donation if you want to help keeping The-Starport online:

Bitcoin address:
Thanks!
Collapse/Expand Links
Collapse/Expand Advertisement
There are currently 61 users playing Freelancer on 38 servers.
May. 20, 2019

Browsing this Thread:   1 Anonymous Users



 Bottom   Previous Topic   Next Topic  Register To Post



[General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/2/9 19:57
From United Kingdom
Group:
Registered Users
FLServer Admins
Senior Members
Posts: 1118
Offline
Coding Custom Weapons



[br /]
Files you will need,[br /]
[br /]
all are in the DATAEQUIPMENT directory of Freelancer [br /]
weapon_equip.ini -all specifications of weapons [br /]
weapon_good.ini -here u make the guns available for sale [br /]
market_misc.ini -location of guns/stuff being sold [br /]
[br /]
A bit of theory: [br /]
All guns and ammo types are specified in weapon_equip.ini. [br /]
Sections are: [br /]
[br /]
[Motor] - this is the "engine" of the missile [br /]
[br /]
[Explosion] - this specifies if your gun has area effect. only works if you also have a [Motor section.[br /]
[br /]
[Munition] - this is the actual shot of your gun, damage values, ranges,... are all defined here [br /]
[br /]
[Mine] - use this instead of [Munition] for Mines [br /]
[br /]
[Gun] - this is the gun/launcher mounted on your ship [br /]
[br /]
[MineDropper] - use this instead of [Gun] for mines [br /]
[br /]
[LOD] - defines LevelOfDetail ranges for bigger gun models[br /]
[br /]
[Munition] and [Gun] are required, the others are optional. [br /]
You can make a missile without an explosion, a gun with an explosion, ... [br /]
I'm not sure if you can change the order how they are defined, i would always keep it as they were. [br /]
A simple weapon only needs the [Munition] and [Gun] sections. [br /]
[br /]
This example is based on the energy missiles I made. I added an explosion effect to make this tutorial as complete as possible. [br /]
Below that you can also find a Mine example. [br /]
[br /]
Weapon_Equip.ini [br /]
[br /]
Explanation of all entries [br /]
[br /]
[Motor] [br /]
Optional, specifies if your weapon will have some form of "engine". [br /]
[br /]
[br /]
Motor nickname = energy_missile01_motor lifetime = 3.000000 accel = 200.0000 delay = 0 [br /]
[br /]
nickname [br /]
Reference for [Munition]. Pick a name of your choice that fits to the general scheme <gunname>_motor. [br /]
[br /]
lifetime [br /]
Time in seconds where the engine will be active. [br /]
[br /]
accel [br /]
Acceleration provided by the engine (not the gun). [br /]
I think this is a meter/sec^2 value. [br /]
[br /]
delay [br /]
Time in seconds after launch where the engine will activate. [br /]
[br /]
[Explosion][br /]
Optional, specifies if the impact of the projectile is followed by an explosion. [br /]
[br /]
[br /]
Explosion nickname = energy_missile01_explosion effect = gf_piratestationexplode lifetime = 0.000000, 0.000000 process = disappear strength = 100 radius = 50 hull_damage = 100.000000 energy_damage = 20.00 impulse = 0[br /]
[br /]
nickname [br /]
Reference for [Munition. Pick a name of your choice that fits to the general scheme <gunname>_explosion. [br /]
[br /]
effect [br /]
Visual effect of the explosion. You can basically use every impact/explosion effect in the game. Example: battleship explosions for guns-impacts. [br /]
[br /]
lifetime [br /]
Two values, both in seconds - min max duration of explosion FX. [br /]
[br /]
process [br /]
??? always has 'disappear' as a value. I guess this is the effect after the explosion, i.e. it vanishes after blowing up [br /]
[br /]
strength [br /]
??? [br /]
[br /]
radius [br /]
Area effect of damage values in meters. [br /]
[br /]
hull_damage [br /]
The explosion damage. This also adds shield damage, according to the [ShieldEquipConsts][br /]
HULL_DAMAGE_FACTOR = 0.500000[br /]
entries in constants.ini.[br /]
[br /]
energy_damage [br /]
Extra shield damage. Can have a negative value to make hull-only damaging weapons. [br /]
The total shield damage is calculated by:[br /]
total emp damage = energy_damage + HULL_FACTOR_DAMAGE * hull_damage[br /]
see constants.ini for the entry.[br /]
[br /]
impulse [br /]
Kinetic effect on the target. Depends also on target's mass.

?



Required. This will specify the projectile of your weapon. [br /]
[br /]
[br /]
Munition nickname = energy_missile01_ammo explosion_arch = energy_missile01_explosion loot_appearance = ammo_crate units_per_container = 10 hp_type = hp_gun requires_ammo = false hit_pts = 2 hull_damage = 400 energy_damage = 200 weapon_type = W_Photon01 one_shot_sound = fire_plasma2 detonation_dist = 2.00000 munition_hit_effect = li_missile01_impact lifetime = 3.0000 Motor = energy_missile01_motor force_gun_ori = false const_effect = li_missile01_drive HP_trail_parent = HPExhaust seeker = LOCK time_to_lock = 0 seeker_range = 2000 seeker_fov_deg = 35 max_angular_velocity = 5.000000 cruise_disruptor = true ids_name = 459791 ids_info = 459721 mass = 1 volume = 0.000000 [br /]
[br /]
nickname [br /]
Reference for [Gun]. Pick a name of your choice that fits to the general scheme <gunname>_ammo. [br /]
[br /]
explosion_arch [br /]
Optional. Reference from [Explosion] [br /]
[br /]
loot_appearance [br /]
Specifies how 'dropped ammo' will look like. [br /]
[br /]
units_per_container [br /]
Number of ammo units in a container. [br /]
[br /]
hp_type [br /]
Use hp_gun for guns & missiles, hp_torpedo for torpedoes. [br /]
[br /]
requires_ammo [br /]
true/false - Specifies if the Gun uses ammo or not. [br /]
[br /]
hit_pts [br /]
Damage required to shoot down the projectile. Only important for missiles and torpedoes. [br /]
[br /]
hull_damage [br /]
The damage caused on impact. same calculations for emp damage as in [Explosion][br /]
[br /]
energy_damage [br /]
Extra shield damage. Can have a negative value to make hull-only damaging weapons. same calculations for emp damage as in [Explosion][br /]
[br /]
weapon_type [br /]
Type of the weapon to create different affectivity against the shield types. See list below. [br /]
[br /]
detonation_dist [br /]
Only important if the Weapon has an [Explosion]. At this distance (in meters) to the target the projectile will blow up. [br /]
[br /]
munition_hit_effect [br /]
The visual effect of the projectile impact. See list below. [br /]
[br /]
lifetime [br /]
The lifetime of the projectile in seconds. This combined with the speed will specify the range of the gun. [br /]
[br /]
motor [br /]
Optional. Reference from [Motor] [br /]
[br /]
force_gun_ori [br /]
true/false Specifies if the launcher is swivel or not. [br /]
[br /]
const_effect [br /]
Visual look of the projectile. See list below. [br /]
[br /]
HP_trail_parent [br /]
??? is always HPExhaust [br /]
[br /]
seeker [br /]
Optional, only for seekers. Set to 'LOCK' if you want to make a homing projectile. "DUMB" for nonseeking weapons. [br /]
[br /]
time_to_lock [br /]
Optional, only for seekers. Changes have no effect here. [br /]
[br /]
seeker_range [br /]
Optional, only for seekers. Within this range, the projectile will home in. [br /]
[br /]
seeker_fov_deg [br /]
Optional, only for seekers. Field of view of the seeker where it will lock in degree. [br /]
[br /]
max_angular_velocity [br /]
Optional, only for seekers. This is the "agility" of the projectile. [br /]
[br /]
cruise_disruptor [br /]
Optional. The projectile will disrupt cruise engines on impact. [br /]
[br /]
ids_name [br /]
ID reference [br /]
[br /]
ids_info [br /]
infocard reference [br /]
[br /]
mass [br /]
Mass of the projectile. You can increase this to have a kinetic effect on impact. [br /]
[br /]
volume [br /]
Amount of cargo space the ammo will use in the cargo hold per unit. [br /]
[br /]
[Gun][br /]
This is the launcher/gun itself. [br /]
[br /]
[br /]
Gun nickname = energy_missile01 ids_name = 459789 ids_info = 459790 DA_archetype = equipmentmodelsweaponsli_rad_launcher.cmp material_library = equipmentmodelsli_equip.mat HP_child = HPConnect hit_pts = 400 explosion_resistance = 1.000000 debris_type = debris_normal parent_impulse = 20 child_impulse = 80 volume = 0.000000 mass = 10 hp_gun_type = hp_gun_special_7 damage_per_fire = 0 power_usage = 200 refire_delay = 1.000 muzzle_velocity = 300.000000 toughness = 2.400000 flash_particle_name = ci_capgun_01_flash flash_radius = 15 light_anim = l_gun01_flash projectile_archetype = energy_missile01_ammo dry_fire_sound = fire_dry separation_explosion = sever_debris auto_turret = false turn_rate = 90 lootable = true LODranges = 0, 20, 60, 100 [br /]
[br /]
nickname [br /]
Reference for market_misc.ini. Pick a name of your choice that fits to the general scheme <gunname>. [br /]
[br /]
ids_name [br /]
ID reference [br /]
[br /]
ids_info [br /]
infocard reference[br /]
[br /]
DA_archetype [br /]
Visual look of the launcher/gun. See list below. [br /]
[br /]
material_library [br /]
Skin for the launcher/gun. You have to take one that fits to the DA_archetype you chose. [br /]
[br /]
HP_child [br /]
??? all guns have HPConnect here. [br /]
[br /]
hit_pts [br /]
The damage the gun can take until it is destroyed. [br /]
[br /]
explosion_resistance [br /]
Value 0-1. Explosion damage reduction. 1 means complete immunity, all built in guns have 1. [br /]
[br /]
debris_type [br /]
??? all guns have debris_normal here. Guess this is the remaining debris when the gun was destroyed. [br /]
[br /]
parent_impulse [br /]
??? [br /]
[br /]
child_impulse [br /]
??? [br /]
[br /]
volume [br /]
Amount of cargo space the gun will need. [br /]
[br /]
mass [br /]
Mass of the gun. This will be added to the total mass of the ship. Units are unknown. [br /]
[br /]
hp_gun_type [br /]
This specifies the mount-type and/or level of the gun. See list below. [br /]
[br /]
damage_per_fire [br /]
??? Probably damage to the gun itself per shot. Didn't work at first tests. [br /]
[br /]
power_usage [br /]
Energy used per shot. [br /]
[br /]
refire_delay [br /]
Delay between two shots in seconds. [br /]
[br /]
muzzle_velocity [br /]
Speed of the projectile at launch. A [Motor] can change the speed after launch. [br /]
[br /]
toughness [br /]
??? [br /]
[br /]
flash_particle_name [br /]
The flash effect at firing the gun (can be deleted if not used), a list will be added later as this is not that important. Until then, look up the effect of your favourite gun. [br /]
[br /]
flash_radius [br /]
Flash radius in meters. [br /]
[br /]
light_anim [br /]
Flash animation. [br /]
[br /]
projectile_archetype [br /]
Reference to the [Munition] that the gun will use. [br /]
[br /]
dry_fire_sound [br /]
Sound the gun makes when it is fired but it cant fire (on cruise, in lanes) [br /]
[br /]
seperation_explosion [br /]
Explosion when destroyed. [br /]
[br /]
auto_turret [br /]
Turrets have all true. Seems to be a part of a not-finished autoturret function. NPCs will use this as an autoturret if set to true. [br /]
[br /]
turn_rate [br /]
The turn-speed of the launcher/gun in degree/second. [br /]
[br /]
lootable [br /]
Is the launcher/gun lootable? true/false [br /]
[br /]
LODranges [br /]
Level of detail entries for the launcher. Use the same values as a gun with the same DA_archetype.



Very similar to [Munition] / [Gun]. Most have an [Explosion] section ahead, it's the same as for guns, so i leave that away here. [br /]
I will only comment the things here that are different to [Munition] or [Gun] [br /]
[br /]
[Mine] [br /]
Almost the same as [Munition] [br /]
[br /]
[br /]
Mine nickname = mine01_mark01_ammo explosion_arch = mine01_mark01_explosion loot_appearance = ammo_crate units_per_container = 10 requires_ammo = true hit_pts = 2 one_shot_sound = fire_mine_regular detonation_dist = 4 lifetime = 10 force_gun_ori = true DA_archetype = equipmentmodelsminesr_plasma_mine.3db material_library = equipmentmodelsr_equip.mat ids_name = 265165 ids_info = 266165 mass = 0.100000 volume = 0.000000 owner_safe_time = 4 linear_drag = 0.400000 seek_dist = 400 top_speed = 60 acceleration = 200 const_effect = li_mine01[br /]
[br /]
owner_safe_time [br /]
The time in seconds where the owner can't trigger the mine. [br /]
[br /]
linear_drag [br /]
This is the 'agility' of the mine. [br /]
[br /]
seek_dist [br /]
The distance in meters where the mine will start to move. [br /]
[br /]
top_speed [br /]
The top-speed of the mine. This is independent from the ships's speed. ('normal' projectile speeds are added to the current moving speed of the firing ship) [br /]
[br /]
acceleration [br /]
Acceleration of the mine in meters/secs^2 until it reaches top_speed. [br /]
[br /]
[br /]
[Minedropper] [br /]
Almost the same as [Gun] [br /]
[br /]
[br /]
MineDropper nickname = mine01_mark01 ids_name = 263165 ids_info = 264165 DA_archetype = equipmentmodelsweaponsli_cm_dropper01.cmp material_library = equipmentmodelsli_equip.mat HP_child = HPConnect hit_pts = 400 explosion_resistance = 1.000000 debris_type = debris_normal parent_impulse = 20 child_impulse = 80 volume = 0.000000 mass = 10 damage_per_fire = 0 power_usage = 0 refire_delay = 1 muzzle_velocity = 20 toughness = 3.300000 projectile_archetype = mine01_mark01_ammo dry_fire_sound = fire_dry separation_explosion = sever_debris lootable = true LODranges = 0, 20, 60, 100[br /]
[br /]
Difference to a normal gun: [br /]
no 'hp_gun_type = ' entry [br /]
The hardpoint type is hardcoded in the section name, so FL knows that it is mounted on Minedropper hardpoints by the [Mine section itself. [br /]
[br /]
[br /]
Now the hard work is finished. To the easy part: [br /]
weapon_good.ini [br /]
[br /]
[Good][br /]
The gun as an item on the market. [br /]
[br /]
[br /]
Good nickname = energy_missile01 equipment = energy_missile01 category = equipment price = 400000 item_icon = equipmentmodelscommodities
n_iconsEQUIPICON_to rplauncher.3db combinable = false free_ammo = energy_missile01_ammo, 10 ids_name = 459789 ids_info = 459790 shop_archetype = equipmentmodelsweaponsli_rad_launcher.cmp material_library = equipmentmodelsge_equip.mat[br /]
[br /]
nickname [br /]
Name reference to market_misc.ini. [br /]
[br /]
equipment [br /]
Weapon-nickname from weapon_equip.ini. [br /]
[br /]
category [br /]
Location where it is sold: 'equipment' is equipment dealer, 'commodity' is the market. [br /]
[br /]
price [br /]
Price of the gun. Note that the price of the ammo specified in free_ammo will be added to this. [br /]
[br /]
item_icon [br /]
The icon of the weapon in the shop. [br /]
[br /]
combinable [br /]
Stackable or not? true/false [br /]
[br /]
free_ammo [br /]
Amount of ammo that comes with the launcher when you buy it. [br /]
[br /]
ids_name [br /]
ID-reference [br /]
[br /]
ids_info [br /]
Infocard reference [br /]
[br /]
shop_archetype [br /]
Model of the launcher. [br /]
[br /]
material_library [br /]
Skin of the launcher. [br /]
[br /]
[br /]
; enery_missile ammo (only needed if 'requires_ammo = true' in [Munition) [br /]
[br /]
[Good][br /]
The ammo on the market. [br /]
[br /]
[br /]
Good nickname = energy_missile01_ammo equipment = energy_missile01_ammo shop_archetype = equipmentmodelsweaponsli_rad_missile.3db material_library = equipmentmodelsli_equip.mat category = equipment price = 1000.00 item_icon = equipmentmodelscommodities
n_iconsEQUIPICON_mi ssiles.3db combinable = true[br /]
[br /]
It is getting easier and easier, now we just have to add it to a base that should sell the stuff. [br /]
market_misc.ini [br /]
Look up your favourite base, take Ca01_01_base for Ottawa. [br /]
Add following lines under the listed items: [br /]
[br /]
[br /]
MarketGood = energy_missile01, 0, -1, 10, 10, 0, 1 [br /]
MarketGood = energy_missile01_ammo, 0, -1, 50, 50, 0, 1[br /]
[br /]
to the format: [br /]
MarkerGood = <package>,<min. player level>, <min. reputation>, < unknown >, < unknown >, <0 = sell item>, <price multiplier> [br /]
[br /]
To the < unknown > [br /]
Set these to 10 if it is a gun, 50 if it's ammo. I guess this specifies where at the equipment dealer it is sold (Weapons, ammo, equipment,...) [br /]
[br /]
Now activate your mod, start a FLserver, start FL, join your server and enjoy!!!



- Very useful lists of variable values - [br /]
A note to the format: <1-4> means enter a value here, in this case 1 to 4, i.e.: fire_photon1 is a valid entry for fire_photon<1-5>, while fire_photon6 is not. [br /]
************************************************** *** [br /]
[br /]
[Munition][br /]
'one_shot_sound = ' [br /]
This is the soundeffect used if u pull the trigger [br /]
[br /]
fire_missile_regular [br /]
fire_missile_homing [br /]
fire_missile_emp [br /]
fire_cruise_disruptor[br /]
fire_torpedo [br /]
fire_mine_regular [br /]
fire_mine_tracking [br /]
fire_photon<1-5> [br /]
fire_laser<1-5> [br /]
fire_tachyon<2-5> (1 is never used) [br /]
fire_particle<1-5> [br /]
fire_neutron<2-5> (1 isnever used) [br /]
fire_pulse<1-5> [br /]
fire_plasma<1-5> [br /]
fire_capship [br /]
fire_capship_forward_gun [br /]
fire_no1 [br /]
fire_no_cruise_disruptor [br /]
[br /]
fire_no_torpedo [br /]
fire_no_capship[br /]
[br /]
************************************************** *** [br /]
[Munition] [br /]
'munition_hit_effect = ' [br /]
This is the effect of the impact. [br /]
These all can also be used in the [Explosion section in the 'effect = ' entry.[br /]
[br /]
Pirates: [br /]
pi_photon_<01-04>_impact [br /]
pi_laser_<01-04>_impact [br /]
pi_tachyon_<01-04>_impact [br /]
pi_particle_<01-04>_impact [br /]
pi_neutron_<01-04>_impact [br /]
pi_pulse_<01-03>_impact [br /]
pi_plasma_<01-03>_impact [br /]
pi_capgun_01_impact [br /]
[br /]
Liberty: [br /]
li_laser_<01-04>_impact [br /]
li_plasma_<01-04>_impact [br /]
li_capgun_01_impact [br /]
[br /]
Bretonia: [br /]
br_tachyon_<01-04>_impact [br /]
br_particle_<01-03>_impact [br /]
br_capgun_01_impact [br /]
[br /]
Kusari: [br /]
ku_neutron_<01-04>_impact [br /]
ku_photon_<01-04>_impact [br /]
ku_capgun_01_impact [br /]
Rheinland: [br /]
rh_tachyon_<01-04>_impact [br /]
rh_plasma_<01-04>_impact [br /]
rh_capgun_01_impact [br /]
[br /]
Civilian: [br /]
ci_laser_<01-03>_impact [br /]
ci_pulse_<01-04>_impact [br /]
ci_photon_<01-04>_impact [br /]
ci_tachyon_<01-04>_impact [br /]
ci_capgun_01_impact [br /]
[br /]
Nomad: [br /]
rtc_nomadtorpedo_impact [br /]
no_capgun01_impact [br /]
no_gun01_rank01_impact [br /]
[br /]
codenames: [br /]
sp_annihilator_<01-03>_impact [br /]
sp_bloodhound_<01-03>_impact [br /]
sp_destabilizer_<01-03>_impact [br /]
sp_distortion_<01-03>_impact [br /]
sp_doomsday_<01-03>_impact [br /]
[br /]
************************************************** *** [br /]
[Munition] [br /]
'const_effect = ' [br /]
This is the "look" of the projectile, mostly you will only notice this one in a firefight. [br /]
[br /]
Liberty: [br /]
li_laser_<01-04>_proj [br /]
li_plasma_<01-04>_proj [br /]
li_missile<01-02>_drive [br /]
li_empmissile_drive [br /]
li_cruisedis01_drive [br /]
li_torpedo01_drive [br /]
li_mine<01-02> [br /]
li_capgun_01_proj [br /]
li_cruiser_maingun [br /]
li_flakcannon01_proj [br /]
[br /]
Bretonia: [br /]
br_tachyon_<01-04>_proj [br /]
br_particle_<01-04>_proj [br /]
br_missile<01-02>_drive [br /]
br_empmissile_drive [br /]
br_mine<01-02> [br /]
br_gunboat_maingun [br /]
br_capgun_01_proj [br /]
br_flakcannon01_proj [br /]
[br /]
Kusari: [br /]
ku_neutron_<01-04>_proj [br /]
ku_photon_<01-04>_proj [br /]
ku_missile<01-02>_drive [br /]
ku_empmissile_drive [br /]
ku_cruisedis01_drive [br /]
ku_torpedo01_drive [br /]
ku_mine<01-02> [br /]
ku_gunboat_maingun [br /]
ku_capgun_01_proj [br /]
ku_flakcannon01_proj [br /]
[br /]
Rheinland: [br /]
rh_tachyon_<01-04>_proj [br /]
rh_plasma_<01-04>_proj [br /]
rh_missile<01-02>_drive [br /]
rh_empmissile_drive [br /]
rh_mine<01-02> [br /]
rh_gunboat_maingun [br /]
rh_capgun_01_proj [br /]
rh_flakcannon01_proj [br /]
[br /]
Pirate: [br /]
pi_missile<01-02>_drive [br /]
pi_mine<01-02> [br /]
pi_photon_<01-04>_proj [br /]
pi_laser_<01-04>_proj [br /]
pi_tachyon_<01-04>_proj [br /]
pi_particle_<01-04>_proj [br /]
pi_neutron_<01-04>_proj [br /]
pi_pulse_<01-03>_proj [br /]
pi_plasma_<01-03>_proj [br /]
pi_capgun_01_proj [br /]
[br /]
Civilian: [br /]
ci_photon_<01-04>_proj [br /]
ci_tachyon_<01-04>_proj [br /]
ci_laser_<01-04>_proj [br /]
ci_pulse_<01-04>_proj [br /]
ci_capgun_01_proj [br /]
[br /]
Nomad: [br /]
no_gun01_rank01_proj [br /]
no_cruisedis01_drive [br /]
rtc_nomadtorpedo_proj [br /]
no_capgun01_proj [br /]
[br /]
Codenames: [br /]
sp_annihilator_<01-03>_proj [br /]
sp_bloodhound_<01-03>_proj [br /]
sp_destabilizer_<01-03>_proj [br /]
sp_distortion_<01-03>_proj [br /]
sp_doomsday_<01-03>_proj[br /]
[br /]
************************************************** *** [br /]
[Munition] [br /]
'DA_archetype = '(.3db files) and 'material_library = '(.mat files) [br /]
These are the icons for ammo in the stores. Don't mix these! [br /]
[br /]
equipmentmodelsweaponsli_rad_missile.3db [br /]
equipmentmodelsli_equip.mat [br /]
[br /]
equipmentmodels orpedoesge_torpedo.3db [br /]
equipmentmodelsge_equip.mat [br /]
[br /]
equipmentmodelsminesr_plasma_mine.3db [br /]
equipmentmodelsr_equip.mat [br /]
[br /]
************************************************** *** [br /]
[Gun] [br /]
'DA_archetype = '(.cmp files) and 'material_library = '(.mat files) [br /]
This is the model and skin of the gun. Don't mix these! [br /]
Note: one .mat file can contain skins for several guns! [br /]
[br /]
Liberty: [br /]
equipmentmodelsweaponsli_rad_launcher.cmp [br /]
equipmentmodelsweaponsli_cm_dropper01.cmp [br /]
equipmentmodelsweaponsli_auto_cannon.cmp [br /]
equipmentmodelsweaponsli_laser_beam.cmp [br /]
equipmentmodelsweaponsli_smlturret.cmp [br /]
equipmentmodelsweaponsli_heavy_ion_blaster.cmp [br /]
equipmentmodelsweaponsli_plasma_blaster.cmp [br /]
equipmentmodelsli_equip.mat [br /]
[br /]
equipmentmodels urretli_turret<01-04>.cmp [br /]
equipmentmodels urretli_turret04b.cmp [br /]
equipmentmodels urretli_turret05.cmp [br /]
equipmentmodels urretli_turret05b.cmp [br /]
equipmentmodels urretli_cruiser_gun01.cmp [br /]
equipmentmodelsli_turret.mat [br /]
[br /]
Generic: [br /]
equipmentmodelsweaponsco_proton_cooker.cmp , these have funny names [br /]
equipmentmodelsweaponsco_raildaddy.cmp [br /]
equipmentmodelsweaponsco_shock_therapy.cmp [br /]
equipmentmodelsweaponsge_shredder_shotgun.cmp [br /]
equipmentmodelsge_equip.mat [br /]
[br /]
equipmentmodels urretutility_turret<01-03>.cmp [br /]
equipmentmodels urretprison_turret01.cmp [br /]
equipmentmodels urretliner_turret01.cmp [br /]
equipmentmodels urretweapons_platform_turret.cm p [br /]
equipmentmodels urretweapons_platform_mturret.c mp [br /]
equipmentmodelsge_turret.mat [br /]
[br /]
equipmentmodels urretsp_turret<01-02>.cmp ;station turrets [br /]
equipmentmodelssp_turret.mat [br /]
[br /]
Equipmentmodelsweapons
o_fighter_gun.cmp [br /]
Equipmentmodelshardware.mat [br /]
[br /]
Bretonia: [br /]
equipmentmodelsweaponsr_mass_driver.cmp [br /]
equipmentmodelsweaponsr_railgun.cmp [br /]
equipmentmodelsr_equip.mat [br /]
[br /]
equipmentmodels urretr_turret<01-04>.cmp [br /]
equipmentmodels urretr_turret04b.cmp [br /]
equipmentmodels urretr_gunboat_gun01.cmp [br /]
equipmentmodelsr_turret.mat [br /]
[br /]
Kusari: [br /]
[br /]
equipmentmodelsweaponsku_ion_blaster.cmp [br /]
equipmentmodelsku_equip.mat [br /]
[br /]
equipmentmodels urretku_turret<01-04>.cmp [br /]
equipmentmodels urretku_gunboat_gun01.cmp [br /]
equipmentmodelsku_turret.mat [br /]
[br /]
Rheinland: [br /]
equipmentmodelsweapons
h_gamma_beamer.cmp [br /]
equipmentmodelsweapons
h_proton_blaster.cmp [br /]
equipmentmodels
h_equip.mat [br /]
[br /]
equipmentmodels urret
h_turret<01-04>.cmp [br /]
equipmentmodels urret
h_gunboat_gun01.cmp [br /]
equipmentmodels
h_turret.mat [br /]
[br /]
Weird stuff: [br /]
Equipmentmodels urretdyson_turret01.cmp ;now it's getting freaky [br /]
SolarSolar_mat_dyson_city.mat [br /]
[br /]
Solardockable
omad_lair_turret<01-02>.cmp [br /]
material_library = solar
omad.mat [br /]
solar
omad.mat [br /]
[br /]
************************************************** *** [br /]
Hardpoints [br /]
'hp_gun_type = ' [br /]
[br /]
[br /]
hp_gun_special_<1-10> ; 'normal' gun/missile hardpoints. You set level of the gun here. hp_turret_special_<1-10> ; 'normal' turret hardpoint. You set level of the turret here. hp_torpedo_special_1 ; torpedo hp_torpedo_special_2 ; cruise disruptor [br /]
[br /]
************************************************** *** [br /]
Weapon types [br /]
'weapon_type = ' [br /]
This specifies as what kind of projectile your ammo will be treated. Important for different effectivity against different shield types. [br /]
[br /]
[br /]
W_Photon01 W_Laser01 W_Tachyon01 W_Particle01 W_Neutron01 W_Pulse01 W_Plasma01[br /]
[br /]
************************************************** *******[br /]
[br /]
Also a quick HP tutorial and the functions;[br /]
[br /]
HpMount - It's for the height of the ship about this kind of hover pad when landed.[br /]
HpContrails - It's for this dust trails which are created when you fly through space.[br /]
HpRunningLight - It's for the blinking or glowing lights all over your ship.[br /]
HpWeapon - It's for the place where a weapon is attached to the ship ans the weapons orientation.[br /]
HpTurret - Same as Weapons, but fpr turrets.[br /]
HpShield - It's to define the place where the shield generator is mounted.[br /]
HpCockpit - It's for the point where you look from if you are in cockpit view.[br /]
HpHeadlight - It's for the headlight on your ship.[br /]
HpCM - This defines the place where a countermeasure dropper can be mounted.[br /]
HpMine - Same as HpCM, but for mine layers.[br /]
HpTorpedo - Defines the place where a torpedo or cruise disruptor can be mounted.[br /]
HpCloak - Defines the place where a cloak generator can be mounted.[br /]
HpDocklight - This is for the lights which only glows or blink when you dock to a base.[br /]
HpEngine - This defines where an engine exhaust is.[br /]
HpFX - Effects form effects.ini can be applied to this HP.[br /]
HpPilot - This is where the pilot model is mounted into the ship.[br /]
HpThruster - This HP defines the place where a thruster can be mounted.[br /]
HpTractor_Source = This is the place, where the tractor beam is mounted. The graphical effect, when tractoring is also coming from here.[br /]
HpBayDoor = This has something to do with Baydoors (animated?), but I'm not sure, what it is needed for. However in the shiparch.ini are also references to the HpBaydoors, so that they might be useful.[br /]
[br /]
The only other hardpoint, which the original FL ships have is a HpEngineGlow hardpoint, but I'm again not sure, what it is needed for.[br /]
Most of the custom ships I know do not have hpBayDoor and HpEngineGlow hardpoints, but they function perfectly. Therefore it seems, as if these hardpoints are not absolutely necessary![br /]
[br /]
One more thing: If you have ships with several parts, which can be destroyed partly (like flying around with only one wing, because the other one was blown up) need to have some Dpzzz hardpoints (For parts that can be damaged or blown off).




Posted on: 2008/5/16 17:59
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/2/10 22:00
Group:
Registered Users
FLServer Admins
Senior Members
Posts: 1281
Offline
The HpBayDoor stuff is used when ejecting cargo. As I discovered recently these 2 HPs can't be the same HP or in the same position or you run the risk of a crash when jettisoning cargo.

The HpEngineGlow is for adding a nice glow around the engine when moving. I usually use it for Star Trek style ships to simulate the warp core glow.

Posted on: 2008/5/16 19:47
Galaxy Empire
Youtube Videos
Facebook
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/5/13 15:48
Group:
Registered Users
FLServer Admins
$$$ Supporters $$$
Senior Members
Posts: 663
Offline
Quote:

The HpBayDoor stuff is used when ejecting cargo. As I discovered recently these 2 HPs can't be the same HP or in the same position or you run the risk of a crash when jettisoning cargo.
..


yes - the cargo is thrown out via HpBayDoor01 -> HpBayDoor02.
You will usually find
----------------
....
HP_bay_surface = HpBayDoor01
HP_bay_external = HpBayDoor02
....
-----------
in your shiparch.ini.

So your models should have a HpBayDoor01 on the surface of the model and HpBayDoor02 a bit outside in the space.
Otherwise you will have crashes, when jettison cargo.

And a additional note about (ship!) hardpoints:

Usually you can name you HP in the model, what you like.
You just have to define in the shiparch, what you want to use the HP for.
So 4 example someone might want to use the HpCM01 to mount an additional minedropper oder a turret.

Posted on: 2008/5/17 12:16
Open in new window
Top
Re: [General Tutorials] Coding Custom Weapons
Just can't stay away
Joined:
2008/2/22 13:33
From that dark place in the back of your mind..
Group:
Registered Users
Senior Members
Posts: 330
Offline
Quote:

Otherwise you will have crashes, when jettison cargo.


90% of the models we have would CTD a mod every time if that was true, it does throw up internal errors, but FL will jettison things from either the HpMount or 0,0,0 of the model if it can't find a baydoor hardpoint.

Posted on: 2008/5/17 16:40
**shuffles of with a new headache**
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/5/13 15:48
Group:
Registered Users
FLServer Admins
$$$ Supporters $$$
Senior Members
Posts: 663
Offline
...... you r right (tested atm) - missing HPBayDoor doesn't crash client or server,
even with HpBayDoor entries in the shiparch.


Posted on: 2008/5/17 16:53
Open in new window
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/2/10 22:00
Group:
Registered Users
FLServer Admins
Senior Members
Posts: 1281
Offline
It is true that you don't have to have the HpBayDoor hardpoints, alot of my ships don't have it either. But if you do have them and the are either the same point or occupy the same position, it will crash everytime. I can't speak for other MODs but that is exactly what happens in mine. I move them to separate positions and the crashing stops.

Posted on: 2008/5/17 20:33
Galaxy Empire
Youtube Videos
Facebook
Top
Re: [General Tutorials] Coding Custom Weapons
Just popping in
Joined:
2014/6/28 19:21
Group:
Registered Users
Posts: 10
Offline
Hey

toughness parametre, what it do ???
somebody knows ?

Posted on: 2014/7/3 12:07
Top
Re: [General Tutorials] Coding Custom Weapons
Just can't stay away
Joined:
2010/2/17 20:45
From Germany
Group:
Registered Users
Senior Members
Posts: 469
Offline
toughness is responsible for NPCs. It tells them how powerful your equipment is. If it is too powerful, NPCs will retreat.

Freelancer default calculation:
toughness = hull_damage / 100 / ( 1 * refire_delay)

Posted on: 2014/7/3 12:49
How to create .SUR files - Tutorial
Top
Re: [General Tutorials] Coding Custom Weapons
Just popping in
Joined:
2014/6/28 19:21
Group:
Registered Users
Posts: 10
Offline
tnx Skotty.

Posted on: 2014/7/3 21:45
Top
Re: [General Tutorials] Coding Custom Weapons
Just popping in
Joined:
2014/12/30 5:47
Group:
Registered Users
Posts: 1
Offline
Returning to the fine arts of Milkshape and all things mod. Created and collected textures. Watched a few tutorials to get a better grip on extruding. Time for a line-up worth sharing for sake of future feedback. It's ineffable to be at Starport.

Posted on: 2014/12/30 6:44
"Give me a lever long enough and a fulcrum on which to place it, and I shall move the world." - Archimedes
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/6/2 10:17
Group:
Registered Users
$$$ Supporters $$$
Senior Members
Posts: 1847
Offline
Meaning what?

Posted on: 2015/1/2 3:55
"C" for "Caterpillar"... "Cool"... "Cheesey"!
Top
Re: [General Tutorials] Coding Custom Weapons
Home away from home
Joined:
2008/6/2 10:17
Group:
Registered Users
$$$ Supporters $$$
Senior Members
Posts: 1847
Offline
There is a lot of good info in the first post by Roo Avery so I decided to clean it up to make it a bit more readable, despite its age and subsequent findings.

I didn't check all the content for errors but just corrected the ones which were evident as I reformatted it.

Here it is:


Files you will need

All are in the DATA\EQUIPMENT directory of Freelancer:-

weapon_equip.ini - all specifications of weapons
weapon_good.ini - here you make the guns available for sale
market_misc.ini - location of guns/stuff being sold

A bit of theory:
All guns and ammo types are specified in weapon_equip.ini.

Sections are:

[Motor] - this is the "engine" of the missile
[Explosion] - this specifies if your gun has area effect. Only works if you also have a [Motor] section.
[Munition] - this is the actual shot of your gun, damage values, ranges... are all defined here
[Mine] - use this instead of [Munition] for Mines
[Gun] - this is the gun/launcher mounted on your ship
[MineDropper] - use this instead of [Gun] for mines
[LOD] - defines LevelOfDetail ranges for bigger gun models

[Munition] and [Gun] are required, the others are optional.
You can make a missile without an explosion, a gun with an explosion...
I'm not sure if you can change the order how they are defined, I would always keep it as they were.
A simple weapon only needs the [Munition] and [Gun] sections.

This example is based on the energy missiles I made. I added an explosion effect to make this tutorial as complete as possible. Below that you can also find a Mine example.

Weapon_Equip.ini

Explanation of all entries:

[Motor]
Optional, specifies if your weapon will have some form of "engine".

nickname=energy_missile01_motor
lifetime=3.000000
accel=200.0000
delay=0

nickname
Reference for [Munition]. Pick a name of your choice that fits to the general scheme <gunname>_motor.

lifetime
Time in seconds where the engine will be active.

accel
Acceleration provided by the engine (not the gun).
I think this is a meter/sec^2 value.

delay
Time in seconds after launch where the engine will activate.

[Explosion]
Optional, specifies if the impact of the projectile is followed by an explosion.

nickname=energy_missile01_explosion
effect=gf_piratestationexplode
lifetime=0.000000, 0.000000
process=disappear
strength=100
radius=50
hull_damage=100.000000
energy_damage=20.00
impulse=0

nickname
Reference for [Explosion]. Pick a name of your choice that fits to the general scheme <gunname>_explosion.

effect
Visual effect of the explosion. You can basically use every impact/explosion effect in the game. Example: battleship explosions for guns-impacts.

lifetime
Two values, both in seconds - min max duration of explosion FX.

process
??? always has 'disappear' as a value. I guess this is the effect after the explosion, i.e. it vanishes after blowing up

strength
???

radius
Area effect of damage values in meters.

hull_damage
The explosion damage. This also adds shield damage, according to the [ShieldEquipConsts] HULL_DAMAGE_FACTOR=0.500000 entries in constants.ini.

energy_damage
Extra shield damage. Can have a negative value to make hull-only damaging weapons.
The total shield damage is calculated by:
total emp damage=energy_damage + HULL_FACTOR_DAMAGE * hull_damage

See constants.ini for the entry.

impulse
Kinetic effect on the target. Depends also on target's mass.
?
Required. This will specify the projectile of your weapon.

[Munition]
Optional - Ammunition definition if used

nickname=energy_missile01_ammo
explosion_arch=energy_missile01_explosion
loot_appearance=ammo_crate
units_per_container=10
hp_type=hp_gun
requires_ammo=false
hit_pts=2 hull_damage=400
energy_damage=200
weapon_type=W_Photon01
one_shot_sound=fire_plasma2
detonation_dist=2.00000
munition_hit_effect=li_missile01_impact
lifetime=3.0000
Motor=energy_missile01_motor
force_gun_ori=false
const_effect=li_missile01_drive
HP_trail_parent=HPExhaust
seeker=LOCK
time_to_lock=0
seeker_range=2000
seeker_fov_deg=35
max_angular_velocity=5.000000
cruise_disruptor=true
ids_name=459791
ids_info=459721
mass=1
volume=0.000000

nickname
Reference for [Munition]. Pick a name of your choice that fits to the general scheme <gunname>_ammo.

explosion_arch
Optional. Reference from [Explosion]

loot_appearance
Specifies how 'dropped ammo' will look like.

units_per_container
Number of ammo units in a container.

hp_type
Use hp_gun for guns & missiles, hp_torpedo for torpedoes.

requires_ammo
true/false - Specifies if the Gun uses ammo or not.

hit_pts
Damage required to shoot down the projectile. Only important for missiles and torpedoes.

hull_damage
The damage caused on impact. Same calculations for emp damage as in [Explosion]

energy_damage
Extra shield damage. Can have a negative value to make hull-only damaging weapons. same calculations for emp damage as in [Explosion]

weapon_type
Type of the weapon to create different affectivity against the shield types. See list below.

detonation_dist
Only important if the Weapon has an [Explosion]. At this distance (in meters) to the target the projectile will blow up.

munition_hit_effect
The visual effect of the projectile impact. See list below.

lifetime
The lifetime of the projectile in seconds. This combined with the speed will specify the range of the gun.

motor
Optional. Reference from [Motor]

force_gun_ori
true/false Specifies if the launcher is swivel or not.

const_effect
Visual look of the projectile. See list below.

HP_trail_parent
??? is always HPExhaust

seeker
Optional, only for seekers. Set to 'LOCK' if you want to make a homing projectile. "DUMB" for nonseeking weapons.

time_to_lock
Optional, only for seekers. Changes have no effect here.

seeker_range
Optional, only for seekers. Within this range, the projectile will home in.

seeker_fov_deg
Optional, only for seekers. Field of view of the seeker where it will lock in degree.

max_angular_velocity
Optional, only for seekers. This is the "agility" of the projectile.

cruise_disruptor
Optional. The projectile will disrupt cruise engines on impact.

ids_name
ID reference

ids_info
infocard reference

mass
Mass of the projectile. You can increase this to have a kinetic effect on impact.

volume
Amount of cargo space the ammo will use in the cargo hold per unit.

[Gun]
This is the launcher/gun itself.

Gun nickname=energy_missile01
ids_name=459789
ids_info=459790
DA_archetype=equipment\models\weapons\li_rad_launcher.cmp
material_library=equipment\models\li_equip.mat
HP_child=HPConnect
hit_pts=400
explosion_resistance=1.000000
debris_type=debris_normal
parent_impulse=20
child_impulse=80
volume=0.000000
mass=10
hp_gun_type=hp_gun_special_7
damage_per_fire=0
power_usage=200
refire_delay=1.000
muzzle_velocity=300.000000
toughness=2.400000
flash_particle_name=ci_capgun_01_flash
flash_radius=15
light_anim=l_gun01_flash
projectile_archetype=energy_missile01_ammo
dry_fire_sound=fire_dry
separation_explosion=sever_debris
auto_turret=false
turn_rate=90
lootable=true
LODranges=0,20,60,100

nickname
Reference for market_misc.ini. Pick a name of your choice that fits to the general scheme <gunname>.

ids_name
ID reference

ids_info
infocard reference

DA_archetype
Visual look of the launcher/gun. See list below.

material_library
Skin for the launcher/gun. You have to take one that fits to the DA_archetype you chose.

HP_child
??? all guns have HPConnect here.

hit_pts
The damage the gun can take until it is destroyed.

explosion_resistance
Value 0-1. Explosion damage reduction. 1 means complete immunity, all built in guns have 1.

debris_type
??? all guns have debris_normal here. Guess this is the remaining debris when the gun was destroyed.

parent_impulse
???

child_impulse
???

volume
Amount of cargo space the gun will need.

mass
Mass of the gun. This will be added to the total mass of the ship. Units are unknown.

hp_gun_type
This specifies the mount-type and/or level of the gun. See list below.

damage_per_fire
??? Probably damage to the gun itself per shot. Didn't work at first tests.

power_usage
Energy used per shot.

refire_delay
Delay between two shots in seconds.

muzzle_velocity
Speed of the projectile at launch. A [Motor] can change the speed after launch.

toughness
???

flash_particle_name
The flash effect at firing the gun (can be deleted if not used), a list will be added later as this is not that important. Until then, look up the effect of your favourite gun.

flash_radius
Flash radius in meters.

light_anim
Flash animation.

projectile_archetype
Reference to the [Munition] that the gun will use.

dry_fire_sound
Sound the gun makes when it is fired but it cant fire (on cruise, in lanes)

separation_explosion
Explosion when destroyed.

auto_turret
Turrets have all true. Seems to be a part of a not-finished autoturret function. NPCs will use this as an autoturret if set to true.

turn_rate
The turn-speed of the launcher/gun in degree/second.

lootable
Is the launcher/gun lootable? true/false

LODranges
Level of detail entries for the launcher. Use the same values as a gun with the same DA_archetype.

Very similar to [Munition] / [Gun]. Most have an [Explosion] section ahead, it's the same as for guns, so i leave that away here. I will only comment the things here that are different to [Munition] or [Gun]

[Mine]
Almost the same as [Munition]

Mine
nickname=mine01_mark01_ammo
explosion_arch=mine01_mark01_explosion
loot_appearance=ammo_crate
units_per_container=10
requires_ammo=true
hit_pts=2
one_shot_sound=fire_mine_regular
detonation_dist=4
lifetime=10
force_gun_ori=true
DA_archetype=equipment\models\mines\r_plasma_mine.3db
material_library=equipment\models\r_equip.mat
ids_name=265165
ids_info=266165
mass=0.100000
volume=0.000000
owner_safe_time=4
linear_drag=0.400000
seek_dist=400
top_speed=60
acceleration=200
const_effect=li_mine01

owner_safe_time
The time in seconds where the owner can't trigger the mine.

linear_drag
This is the 'agility' of the mine.

seek_dist
The distance in meters where the mine will start to move.

top_speed
The top-speed of the mine. This is independent from the ships's speed. ('normal' projectile speeds are added to the current moving speed of the firing ship)

acceleration
Acceleration of the mine in meters/secs^2 until it reaches top_speed.

[Minedropper]
Almost the same as [Gun]

MineDropper
nickname=mine01_mark01
ids_name=263165
ids_info=264165
DA_archetype=equipment\models\weapons\li_cm_dropper01.cmp
material_library=equipment\models\li_equip.mat
HP_child=HPConnect
hit_pts=400
explosion_resistance=1.000000
debris_type=debris_normal
parent_impulse=20
child_impulse=80
volume=0.000000
mass=10
damage_per_fire=0
power_usage=0
refire_delay=1
muzzle_velocity=20
toughness=3.300000
projectile_archetype=mine01_mark01_ammo
dry_fire_sound=fire_dry
separation_explosion=sever_debris
lootable=true
LODranges=0,20,60,100

Difference to a normal gun:
no 'hp_gun_type=' entry
The hardpoint type is hardcoded in the section name, so FL knows that it is mounted on Minedropper hardpoints by the [Mine] section itself.

Now the hard work is finished. To the easy part:
weapon_good.ini

[Good]
The gun as an item on the market.

Good
nickname=energy_missile01
equipment=energy_missile01
category=equipment
price=400000
item_icon=equipment\models\commodities\n_icons\EQUIPICON_torplauncher.3db
combinable=false
free_ammo=energy_missile01_ammo, 10
ids_name=459789
ids_info=459790
shop_archetype=equipment\models\weapons\li_rad_launcher.cmp
material_library=equipment\models\ge_equip.mat

nickname
Name reference to market_misc.ini.

equipment
Weapon-nickname from weapon_equip.ini.

category
Location where it is sold: 'equipment' is equipment dealer, 'commodity' is the market.

price
Price of the gun. Note that the price of the ammo specified in free_ammo will be added to this.

item_icon
The icon of the weapon in the shop.

combinable
Stackable or not? true/false

free_ammo
Amount of ammo that comes with the launcher when you buy it.

ids_name
ID-reference

ids_info
Infocard reference

shop_archetype
Model of the launcher.

material_library
Skin of the launcher.

; energy_missile ammo (only needed if 'requires_ammo=true' in [Munition)

[Good]
The ammo on the market.

nickname=energy_missile01_ammo
equipment=energy_missile01_ammo
shop_archetype=equipment\models\weapons\li_rad_missile.3db
material_library=equipment\models\li_equip.mat
category=equipment
price=1000.00
item_icon=equipment\models\commodities\n_iconsEQUIPICON_missiles.3db
combinable=true

It is getting easier and easier, now we just have to add it to a base that should sell the stuff.

market_misc.ini
Look up your favourite base, take Ca01_01_base for Ottawa.
Add following lines under the listed items:

MarketGood=energy_missile01, 0, -1, 10, 10, 0, 1
MarketGood=energy_missile01_ammo, 0, -1, 50, 50, 0, 1

To the format:
MarketGood=<package>,<min. player level>, <min. reputation>, < unknown >, < unknown >, <0=sell item>, <price multiplier>

To the < unknown >
Set these to 10 if it is a gun, 50 if it's ammo. I guess this specifies where at the equipment dealer it is sold (Weapons, ammo, equipment...)

Now activate your mod, start a FLserver, start FL, join your server and enjoy!!!


- Very useful lists of variable values -
A note to the format: <1-4> means enter a value here, in this case 1 to 4, i.e.: fire_photon1 is a valid entry for fire_photon<1-5>, while fire_photon6 is not.
************************************************** ***

[Munition]
'one_shot_sound='
This is the soundeffect used if you pull the trigger

fire_missile_regular
fire_missile_homing
fire_missile_emp
fire_cruise_disruptor
fire_torpedo
fire_mine_regular
fire_mine_tracking
fire_photon<1-5>
fire_laser<1-5>
fire_tachyon<2-5> (1 is never used)
fire_particle<1-5>
fire_neutron<2-5> (1 isnever used)
fire_pulse<1-5>
fire_plasma<1-5>
fire_capship
fire_capship_forward_gun
fire_no1
fire_no_cruise_disruptor
fire_no_torpedo
fire_no_capship

************************************************** ***
[Munition]
'munition_hit_effect='
This is the effect of the impact.
These all can also be used in the [Explosion section in the 'effect=' entry.

Pirates:
pi_photon_<01-04>_impact
pi_laser_<01-04>_impact
pi_tachyon_<01-04>_impact
pi_particle_<01-04>_impact
pi_neutron_<01-04>_impact
pi_pulse_<01-03>_impact
pi_plasma_<01-03>_impact
pi_capgun_01_impact

Liberty:
li_laser_<01-04>_impact
li_plasma_<01-04>_impact
li_capgun_01_impact

Bretonia:
br_tachyon_<01-04>_impact
br_particle_<01-03>_impact
br_capgun_01_impact

Kusari:
ku_neutron_<01-04>_impact
ku_photon_<01-04>_impact
ku_capgun_01_impact
Rheinland:
rh_tachyon_<01-04>_impact
rh_plasma_<01-04>_impact
rh_capgun_01_impact

Civilian:
ci_laser_<01-03>_impact
ci_pulse_<01-04>_impact
ci_photon_<01-04>_impact
ci_tachyon_<01-04>_impact
ci_capgun_01_impact

Nomad:
rtc_nomadtorpedo_impact
no_capgun01_impact
no_gun01_rank01_impact

codenames:
sp_annihilator_<01-03>_impact
sp_bloodhound_<01-03>_impact
sp_destabilizer_<01-03>_impact
sp_distortion_<01-03>_impact
sp_doomsday_<01-03>_impact

************************************************** ***
[Munition]
'const_effect='
This is the "look" of the projectile, mostly you will only notice this one in a firefight.

Liberty:
li_laser_<01-04>_proj
li_plasma_<01-04>_proj
li_missile<01-02>_drive
li_empmissile_drive
li_cruisedis01_drive
li_torpedo01_drive
li_mine<01-02>
li_capgun_01_proj
li_cruiser_maingun
li_flakcannon01_proj

Bretonia:
br_tachyon_<01-04>_proj
br_particle_<01-04>_proj
br_missile<01-02>_drive
br_empmissile_drive
br_mine<01-02>
br_gunboat_maingun
br_capgun_01_proj
br_flakcannon01_proj

Kusari:
ku_neutron_<01-04>_proj
ku_photon_<01-04>_proj
ku_missile<01-02>_drive
ku_empmissile_drive
ku_cruisedis01_drive
ku_torpedo01_drive
ku_mine<01-02>
ku_gunboat_maingun
ku_capgun_01_proj
ku_flakcannon01_proj

Rheinland:
rh_tachyon_<01-04>_proj
rh_plasma_<01-04>_proj
rh_missile<01-02>_drive
rh_empmissile_drive
rh_mine<01-02>
rh_gunboat_maingun
rh_capgun_01_proj
rh_flakcannon01_proj

Pirate:
pi_missile<01-02>_drive
pi_mine<01-02>
pi_photon_<01-04>_proj
pi_laser_<01-04>_proj
pi_tachyon_<01-04>_proj
pi_particle_<01-04>_proj
pi_neutron_<01-04>_proj
pi_pulse_<01-03>_proj
pi_plasma_<01-03>_proj
pi_capgun_01_proj

Civilian:
ci_photon_<01-04>_proj
ci_tachyon_<01-04>_proj
ci_laser_<01-04>_proj
ci_pulse_<01-04>_proj
ci_capgun_01_proj

Nomad:
no_gun01_rank01_proj
no_cruisedis01_drive
rtc_nomadtorpedo_proj
no_capgun01_proj

Codenames:
sp_annihilator_<01-03>_proj
sp_bloodhound_<01-03>_proj
sp_destabilizer_<01-03>_proj
sp_distortion_<01-03>_proj
sp_doomsday_<01-03>_proj

************************************************** ***
[Munition]
'DA_archetype='(.3db files) and 'material_library='(.mat files)
These are the icons for ammo in the stores. Don't mix these!

equipment\models\weapons\li_rad_missile.3db
equipment\models\li_equip.mat

equipment\models\torpedoes\ge_torpedo.3db
equipment\models\ge_equip.mat

equipment\models\mines\r_plasma_mine.3db
equipment\models\r_equip.mat

************************************************** ***
[Gun]
'DA_archetype='(.cmp files) and 'material_library='(.mat files)
This is the model and skin of the gun. Don't mix these!
Note: one .mat file can contain skins for several guns!

Liberty:
equipment\models\weapons\li_rad_launcher.cmp
equipment\models\weapons\li_cm_dropper01.cmp
equipment\models\weapons\li_auto_cannon.cmp
equipment\models\weapons\li_laser_beam.cmp
equipment\models\weapons\li_smlturret.cmp
equipment\models\weapons\li_heavy_ion_blaster.cmp
equipment\models\weapons\li_plasma_blaster.cmp
equipment\models\li_equip.mat
equipment\models\turret\li_turret<01-04>.cmp
equipment\models\turret\li_turret04b.cmp
equipment\models\turret\li_turret05.cmp
equipment\models\turret\li_turret05b.cmp
equipment\models\turret\li_cruiser_gun01.cmp
equipment\models\li_turret.mat

Generic:
equipment\models\weapons\co_proton_cooker.cmp , these have funny names
equipment\models\weapons\co_raildaddy.cmp
equipment\models\weapons\co_shock_therapy.cmp
equipment\models\weapons\ge_shredder_shotgun.cmp
equipment\models\ge_equip.mat
equipment\models\turret\utility_turret<01-03>.cmp
equipment\models\turret\prison_turret01.cmp
equipment\models\turret\liner_turret01.cmp
equipment\models\turret\weapons_platform_turret.cm p
equipment\models\turret\weapons_platform_mturret.c mp
equipment\models\ge_turret.mat
equipment\models\turret\sp_turret<01-02>.cmp ;station turrets
equipment\models\sp_turret.mat
equipment\models\weapons\no_fighter_gun.cmp
equipment\models\hardware.mat

Bretonia:
equipment\models\weapons\r_mass_driver.cmp
equipment\models\weapons\r_railgun.cmp
equipment\models\r_equip.mat
equipment\models\turret\r_turret<01-04>.cmp
equipment\models\turret\r_turret04b.cmp
equipment\models\turret\r_gunboat_gun01.cmp
equipment\models\r_turret.mat

Kusari:
equipment\models\weapons\ku_ion_blaster.cmp
equipment\models\ku_equip.mat
equipment\models\turret\ku_turret<01-04>.cmp
equipment\models\turret\ku_gunboat_gun01.cmp
equipment\models\ku_turret.mat

Rheinland:
equipment\models\weapons\rh_gamma_beamer.cmp
equipment\models\weapons\rh_proton_blaster.cmp
equipment\models\rh_equip.mat
equipment\models\turret\rh_turret<01-04>.cmp
equipment\models\turret\rh_gunboat_gun01.cmp
equipment\models\rh_turret.mat

Weird stuff:
Equipment\models\turret\dyson_turret01.cmp ;now it's getting freaky
SolarSolar_mat_dyson_city.mat

Solar\dockable\nomad_lair_turret<01-02>.cmp
material_library=solar\nomad.mat
solar\nomad.mat

************************************************** ***
Hardpoints
'hp_gun_type='

hp_gun_special_<1-10> ; 'normal' gun/missile hardpoints. You set level of the gun here. hp_turret_special_<1-10> ; 'normal' turret hardpoint. You set level of the turret here. hp_torpedo_special_1 ; torpedo hp_torpedo_special_2 ; cruise disruptor

************************************************** ***
Weapon types
'weapon_type='
This specifies as what kind of projectile your ammo will be treated. Important for different effectivity against different shield types.

W_Photon01
W_Laser01
W_Tachyon01
W_Particle01
W_Neutron01
W_Pulse01
W_Plasma01

*********************************************************

Also a quick HP tutorial and the functions;

HpMount - It's for the height of the ship about this kind of hover pad when landed.
HpContrails - It's for this dust trails which are created when you fly through space.
HpRunningLight - It's for the blinking or glowing lights all over your ship.
HpWeapon - It's for the place where a weapon is attached to the ship ans the weapons orientation.
HpTurret - Same as Weapons, but fpr turrets.
HpShield - It's to define the place where the shield generator is mounted.
HpCockpit - It's for the point where you look from if you are in cockpit view.
HpHeadlight - It's for the headlight on your ship.
HpCM - This defines the place where a countermeasure dropper can be mounted.
HpMine - Same as HpCM, but for mine layers.
HpTorpedo - Defines the place where a torpedo or cruise disruptor can be mounted.
HpCloak - Defines the place where a cloak generator can be mounted.
HpDocklight - This is for the lights which only glows or blink when you dock to a base.
HpEngine - This defines where an engine exhaust is.
HpFX - Effects form effects.ini can be applied to this HP.
HpPilot - This is where the pilot model is mounted into the ship.
HpThruster - This HP defines the place where a thruster can be mounted.
HpTractor_Source=This is the place, where the tractor beam is mounted. The graphical effect, when tractoring is also coming from here.
HpBayDoor=This has something to do with Baydoors (animated?), but I'm not sure, what it is needed for. However in the shiparch.ini are also references to the HpBaydoors, so that they might be useful.

The only other hardpoint, which the original FL ships have is a HpEngineGlow hardpoint, but I'm again not sure, what it is needed for.

Most of the custom ships I know do not have HpBayDoor and HpEngineGlow hardpoints, but they function perfectly. Therefore it seems, as if these hardpoints are not absolutely necessary!

One more thing: If you have ships with several parts, which can be destroyed partly (like flying around with only one wing, because the other one was blown up) need to have some Dpzzz hardpoints (For parts that can be damaged or blown off).

Original by Roo Avery, 2008/5/16

Posted on: 2015/1/2 4:57
"C" for "Caterpillar"... "Cool"... "Cheesey"!
Top