Flyers (Programming)

Hellmoo $flyers are very complicated objects. The following is a breakdown of their properties:

-	mosquito ultralight (#75771)	cessna tiltrotor (#111470)	patton supa-lifta (#408794)	dragoon microzep (#33562)	description
alt_per_ascend	1000	1000	1000	1000	how many meters the flyer rises per ascend command
alt_per_descend	750	750	750	750	how many meters the flyer falls per descend command
altitude	0	0	0	0	flyer's current altitude (if in the sky)
altitude_max	5000	5000	5000	5000	the highest altitude the flyer can ascend to
armor	{{#277, 200, 200}, {#278, 200, 200}, {#172505, 200, 200}, {#268, 20, 50}, {#308, 10, 20}, {#281, 5, 30}, {#1326, 200, 200}, {#37210, 10, 30}, {#99011, 5, 10}, {#279, 10, 20}}	{{#277, 200, 200}, {#278, 200, 200}, {#172505, 200, 200}, {#268, 20, 50}, {#308, 10, 20}, {#281, 5, 30}, {#1326, 200, 200}, {#37210, 10, 30}, {#99011, 5, 10}, {#279, 10, 20}}	{{#277, 200, 200}, {#278, 200, 200}, {#172505, 200, 200}, {#268, 20, 50}, {#308, 10, 20}, {#281, 5, 30}, {#1326, 200, 200}, {#37210, 10, 30}, {#99011, 5, 10}, {#279, 10, 20}}	{{#277, 200, 200}, {#278, 200, 200}, {#172505, 200, 200}, {#268, 20, 50}, {#308, 10, 20}, {#281, 5, 30}, {#1326, 200, 200}, {#37210, 10, 30}, {#99011, 5, 10}, {#279, 10, 20}}	defensive value of currently installed armor
ascend_speed	4.5	5.0	12	6.0	speed at which the flyer ascends higher, in seconds
auto_land_if_no_players	1	1	1	1	should the flyer land automatically after a few minutes if no players are onboard?
blueprint	#353149	#74465	#22556	#202702	the blueprint used to spawn the flyer's interior at creation
burn_rate	1.0	1.0	1.0	1.0	multiplier for fuel burning. Generic is set to 1.0.
control	10	10	10	10	amount of control the pilot(s) currently have over the flyer
control_max	10	10	10	10	maximum amount of control the pilot(s) can have over the flyer
crash_altitude	500	500	500	500	altitude below which a flyer is considered crashed (defautl 500)
cruise_speed	4.0	8.0	20.0	15.0	how quickly the flyer moves between sky rooms in seconds. modified by pilot skill (see $actions.pilot.cruise)
custom_name	""	""	""	""	custom name for the flyer
damage	{{#15895, 30, 50, 0}}	{{#15895, 30, 50, 0}}	{{#15895, 30, 50, 0}}	{{#15895, 30, 50, 0}}	damage for missiles
death_listeners	{}	{}	{}	{}	who to inform when the flyer dies via hear_death()
descend_speed	4.5	5.0	7	9.0	speed at which the flyer descends, in seconds
dest	#-1	#-1	#-1	#-1	unknown
destroyed_parts	{}	{}	{}	{}	parts destroyed by damage (see part_list)
dying	0	0	0	0	flyer currently dying
evade_mod	3	2	5	2	unkown
exit_in	#249545	#-1	#-1	#-1	entrance into the flyer's .inside_area
fuel	0	0	0	0	current fuel level for the flyer
fuel_ascend	30	20	20	20	unknown
fuel_cruise	60	20	20	20	unknown
fuel_descend	20	20	20	20	unknown
fuel_liquid	#140609	#140609	#140609	#140609	unknown
fuel_max	750	1000	5000	2500	maximum fuel level for the flyer
fuel_per_ascend	20	30	50	7	amount of fuel burned when the flyer ascends
fuel_per_cruise	35	50	80	15	amount of fuel burned when the flyer moves
fuel_per_descend	5	5	8	5	amount of fuel burned when the flyer descends (unimplemented)
fuel_per_heart	8	3	7	1	fuel per flyer heartbeat burned when not landed (hovering or flying)
fuel_type	#140609	#140609	#140609	#140609	type of fuel to be used on flyer
generic_module	#103734	#103734	#103734	#103734	objnum for generic flyer module. Only children of this object can be installed in the cockpit.
gscan_speed	3	3	3	3	speed at which the flyer performs a ground scan
has_proper_name	0	0	0	0	whether or not to use 'The' in :dname()
health	35	50	90	150	current health of the flyer
health_max	35	50	90	150	maximum health for the flyer
heart	0	0	0	0	flyer's heart queue
home	#-1	#-1	#-1	#-1	flyer's home room. Non recycling flyers are moved here on death.
hover_altitude	20	20	10	20	the altitude at which the flyer hovers while on the ground
inside_area	#311217	#-1	#-1	#-1	flyer's interior $area
installed_armor	{}	{}	{}	{}	installed armor packages
intercepting	#-1	#-1	#-1	#-1	current flier intercept target
land_noise	#280330	#280330	#280330	#280330	noise object broadcast from the room a flyer lands in.
landed	0	0	0	0	is the flyer landed?
landing_speed	5.0	5.0	12	3.0	speed at which the flyer lands AND takes off in seconds
last_heartbeat	0	0	0	0	flyer's last heartbeat time (epoch)
lock	0	0	0	0	number of seconds until current targeting task completes
max_load	150000	300000	3000000	2500000	maximum weight the flyer can have on it for successful takeoff
missile_ceiling	5000	5000	5000	5000	the highest altitude from which a flyer can fire a missile
outdoor_room	#142063	#142063	#142063	#142063	objnum for parent of outdoor rooms for the flyer
part_list	{}	{{#3635, 30}, {#4476, 10}, {#62435, 4}, {#5400, 4}, {#99614, 2}, {#158680, 2}, {#55653, 8}, {#99605, 10}, {#3537, 23}, {#253366, 24}, {#225004, 38}, {#20315, 24}, {#5763, 4}, {#2911, 4}, {#669, 2}, {#4852, 5}, {#2514, 5}, {#1559, 1}, {#5181, 5}, {#4632, 4}, {#5541, 12}, {#212606, 3}, {#3530, 1}, {#684, 10}, {#677, 2}, {#39843, 4}, {#105663, 4}, {#2418, 1}, {#257861, 5}, {#5431, 4}, {#270666, 5}}	{{#3635, 30}, {#4476, 10}, {#62435, 4}, {#5400, 4}, {#99614, 2}, {#158680, 2}, {#55653, 14}, {#99605, 16}, {#3537, 31}, {#253366, 34}, {#225004, 53}, {#20315, 34}, {#5763, 4}, {#2514, 10}, {#1559, 2}, {#5181, 10}, {#4632, 12}, {#5541, 15}, {#212606, 6}, {#3530, 2}, {#677, 4}, {#39843, 8}, {#105663, 8}, {#257861, 15}, {#5431, 4}, {#270666, 12}, {#58102, 1}}	{{#231968, 20}, {#152155, 20}, {#193731, 12}, {#270666, 10}, {#55653, 12}, {#99605, 10}, {#58102, 1}, {#232006, 5}, {#3635, 30}, {#4476, 10}, {#62435, 4}, {#5400, 4}, {#99614, 2}, {#158680, 2}, {#3537, 16}, {#253366, 4}, {#225004, 8}, {#20315, 16}, {#5763, 4}, {#1559, 2}, {#4632, 6}, {#257861, 8}}	list of parts in the flyer that can be destroyed by damage
pilot	#-1	#-1	#-1	#-1	flyer's current pilot (reset on new actions)
pilot_difficulty	0	0	-2	0	difficulty modifier for level and cruise checks
plot	0	0	0	0	is the flyer permanent?
policy	#-1	#-1	#-1	#-1	flyer's installed insurance policy
preserve_on_explode	{}	{}	{}	{}	list of objects inside the flyer to not destroy or move when the flyer explodes. Used on permanent flyers only.
radar_warning	{}	{}	{}	{}	unknown
recipe_for	#-1	#291964	#328255	#186948	the schematic used to craft the flyer
recycle_on_explode	1	1	1	1	recycle the flyer when it explodes?
registry	"BH10832"	""	""	""	flyer's registry code, assigned randomly when crafted
repair_difficulty	0	0	0	0	difficulty for repair skill check
scan_task	0	0	0	0	task_id for current ground scan
size	10	20	70	80	physical size of the flyer. Used in determining if a flyer can land in a given tile, compared to airstrip
takeoff_noise	{"From %dir you hear the %vol receding whir of an airship taking off.", 3}	{"From %dir you hear the %vol receding whir of an airship taking off.", 3}	{"From %dir you hear the %vol, thrumming bass of a heavy airship taking off.", 3}	{"From %dir you hear the %vol receding whir of an airship taking off.", 3}	noise broadcast from the room a flyer takes off from.
target	#-1	#-1	#-1	#-1	current missile target tile
target_difficulty	0	0	0	0	difficulty for missile lock task
target_task	0	0	0	0	task_id for current target task
unique	0	0	0	0	should the flyer's name be displayed separately in :look_place_msg, instead of rolled up?
value	20000	20000	20000	20000	base price of the flyer

Flyers also define a set of messages.

-	mosquito ultralight (#75771)	cessna tiltrotor (#111470)	patton supa-lifta (#408794)	dragoon microzep (#33562)	description
ascend_finish_ground_msg	"Overhead, %dt disappears from sight."	"Overhead, %dt disappears from sight."	"Overhead, %dt disappears from sight."	"Overhead, %dt disappears from sight."	displayed in current room when the flyer finishes ascending after takeoff (only in ground rooms)
ascend_finish_msg	"%IT rises up from %from to cruising altitude."	"%IT rises up from %from to cruising altitude."	"%IT rises up from %from to cruising altitude."	"%IT rises up from %from to cruising altitude."	displayed in current room when the flyer finishes ascending after takeoff (only in sky rooms)
ascend_ground_msg	"%DT lifts out of hover and begins to ascend."	"%DT lifts out of hover and begins to ascend."	"%DT lifts out of hover and begins to ascend."	"%DT lifts out of hover and begins to ascend."	displayed in current room when the flyer begins to ascend after takeoff (only in ground rooms)
ascend_inside_finish_msg	"The acceleration eases as you reach cruising altitude."	"The acceleration eases as you reach cruising altitude."	"The acceleration eases as you reach cruising altitude."	"You reach cruising altitude."	displayed in cockpit when the flyer finishes ascending
ascend_inside_msg	"Acceleration pushes you down and back, as %dt begins its ascent."	"Acceleration pushes you down and back, as %dt begins its ascent."	"Acceleration pushes you down and back, as %dt begins its ascent."	"Acceleration gently pushes you down, as %dt begins its ascent."	displayed in cockpit when the flyer begins to ascend
ascend_more_msg	"%DT pulls back into a climb."	"%DT pulls back into a climb."	"%DT pulls back into a climb."	"%DT ascends even higher into the sky."	displayed in the current room when the flyer ascends, but only while already in flight
crash_msg	"%DT slams into the ground in a huge fireball."	"%DT slams into the ground in a huge fireball."	"%DT slams into the ground in a huge fireball."	"%DT slams into the ground in a huge fireball."	displayed in the current room when the flyer crashes into the ground
cruise_finish_msg	"%DT recedes to %dl and vanishes."	"%DT recedes to %dl and vanishes."	"%DT recedes to %dl and vanishes."	"%DT recedes to %dl and vanishes."	displayed in current sky room when a flyer finishes moving
cruise_ground_msg	"Overhead, %dt glides over the horizon to %dl."	"Overhead, %dt glides over the horizon to %dl."	"Overhead, %dt glides over the horizon to %dl."	"Overhead, %dt glides over the horizon to %dl."	displayed in current sky room's overlying area when it begins to move
cruise_in_finish_msg	"%IT glides in from %dl."	"%IT glides in from %dl."	"%IT glides in from %dl."	"%DT glides in from %dl."	displayed in destination sky room when a flyer finishes moving
cruise_in_ground_msg	"Overhead, %it glides into view from %dl."	"Overhead, %it glides into view from %dl."	"Overhead, %it glides into view from %dl."	"Overhead, %it glides into view from %dl."	displayed in current sky room's overlying area when it finishes moving
cruise_in_msg	"Away to %dl, you can barely see %it approaching."	"Away to %dl, you can barely see %it approaching."	"Away to %dl, you can barely see %it approaching."	"Away to %dl, you can barely see %it approaching."	displayed in destination sky room when a flyer begins to move
cruise_msg	"%DT banks deeply, turning toward %dl."	"%DT banks deeply, turning toward %dl."	"%DT banks deeply, turning toward %dl."	"%DT rotates slowly, turning toward %dl."	displayed in current sky room when a flyer begins to move
descend_finish_ground_msg	"%DT descends from the sky to a low hover, kicking dust in your face."	"%DT descends from the sky to a low hover, kicking dust in your face."	"%DT descends from the sky to a low hover, kicking dust in your face."	"%DT descends from the sky to a low hover, softly bathing your face in a breeze."	displayed in landing zone room when a flyer finishes descending into it from a sky room
descend_finish_msg	"%DT leaves the open sky to hover over %dl."	"%DT leaves the open sky to hover over %dl."	"%DT leaves the open sky to hover over %dl."	"%DT leaves the open sky to hover over %dl."	displayed in starting room when a flyer finishes descending
descend_ground_msg	"%IT seems to be diving toward you."	"%IT seems to be diving toward you."	"%IT seems to be diving toward you."	"%IT seems to be dropping toward your location."	displayed in landing zone room when a flyer begins to descend into it from a sky room
descend_inside_finish_msg	"%DT shudders as the descent brakes to a hover."	"%DT shudders as the descent brakes to a hover."	"%DT shudders as the descent brakes to a hover."	"%DT's descent comes to a stop."	displayed in cockpit when the flyer finishes descending
descend_inside_msg	"Your stomach lurches as %dt dives toward the earth."	"Your stomach lurches as %dt dives toward the earth."	"Your stomach lurches as %dt dives toward the earth."	"%DT gently descends toward the earth."	displayed in cockpit when the flyer begins to descend
descend_more_msg	"%DT dives."	"%DT dives."	"%DT dives."	"%DT gently drops."	displayed in the current room when the flyer descends, but only while already in flight
descend_msg	"%DT noses down, diving toward %dl."	"%DT noses down, diving toward %dl."	"%DT noses down, diving toward %dl."	"%DT begins to slowly drop back to earth."	displayed in current room when the flyer begins to descend to the ground (only in sky rooms)
die_msg	"%DT veers at a crazy angle, then plummets toward earth."	"%DT veers at a crazy angle, then plummets toward earth."	"%DT veers at a crazy angle, then plummets toward earth."	"%DT sags a bit in the middle, then drops rapidly to earth."	displayed in current room when the flyer dies
explode_inside_msg	"�[1m�[31mThe structure of %dn comes to pieces around you in a horrendous explosion! OH FUCKING HELL!�[0m"	"�[1m�[31mThe structure of %dn comes to pieces around you in a horrendous explosion! OH FUCKING HELL!�[0m"	"�[1m�[31mThe structure of %dn comes to pieces around you in a horrendous explosion! OH FUCKING HELL!�[0m"	"�[1m�[31mThe structure of %dn comes to pieces around you in a horrendous explosion! OH FUCKING HELL!�[0m"	displayed in the flyer's interior rooms when the flyer explodes
explode_msg	"%DT is covered in flames for a few moments, then explodes."	"%DT is covered in flames for a few moments, then explodes."	"%DT is covered in flames for a few moments, then explodes."	"%DT is covered in flames for a few moments, then explodes."	displayed in current room when the flyer explodes
land_msg	"%DT settles slowly down to the ground."	"%DT settles slowly down to the ground."	"%DT settles slowly down to the ground."	"%DT settles slowly down to the ground."	displayed in the current room when the flyer lands
look_place_hover_msg	"%IN hovers above you."	"%IN hovers above you."	"%IN hovers above you."	"%IN hovers above you."	added to flyer's location description if hovering over ground
look_place_land_msg	"%IN is landed here."	"%IN is landed here."	"%IN is landed here."	"%IN is landed here."	added to flyer's location description if landed
look_place_msg	"A zeppelin is flying overhead."	"A zeppelin is flying overhead."	"A zeppelin is flying overhead."	"A zeppelin is flying overhead."	unknown, probably phased out
look_place_sky_msg	"%IN sails through the sky."	"%IN sails through the sky."	"%IN sails through the sky."	"%IN sails through the sky."	added to flyer's location description if in the sky
look_place_wreck_msg	"The wreck of a flyer is strewn across the ground."	"The wreck of a flyer is strewn across the ground."	"The wreck of a flyer is strewn across the ground."	"The wreck of a flyer is strewn across the ground."	Added to flyer's location if it is wrecked and landed
takeoff_msg	"%DT shudders and lifts away from the ground into a hover."	"%DT shudders and lifts away from the ground into a hover."	"%DT shudders and lifts away from the ground into a hover."	"%DT gently lifts away from the ground into a hover."	displayed in the current room when the flyer takes off
yoke_msg	"%DN manipulates the control yoke."	"%DN manipulates the control yoke."	"%DN manipulates the control yoke."	"%DN manipulates the control yoke."	displayed in cockpit when the pilot moves the flyer