1 -- Hangglider mod for Minetest
2 -- Original code by Piezo_ (orderofthefourthwall@gmail.com)
5 -- Modifications by David G (kestral246@gmail.com)
7 -- For Minetest 5.x, glider's set_attach needs to be offset by 1 node
8 -- Switch to alternate commented line below with correct offset.
9 -- Additional tuning of parameters.
10 -- Commented out debug hud display code, prefixed with "--debug:".
13 -- Give visual indication that hangglider is equiped.
14 -- Display simple overlay with blurred struts when equiped.
15 -- Issue: don't know how to disable overlay in third person view.
16 -- Also Unequip hangglider when landing on water.
17 -- Attempt to linearize parabolic flight path.
18 -- Start gravity stronger, but gradually reduce it as descent velocity increases.
19 -- Don't use airstopper when equipped from the ground (descent velocity is low).
20 -- Slightly increase flight speed to 1.25.
21 -- Unequip/equip cycling mid-flight should not fly farther than continuous flight.
22 -- When equipping mid-air (descent velocity higher), use airstopper but increase descent slope afterwards.
23 -- Create airbreak flag so all equips mid-flight use faster descent.
24 -- Reset airbreak flag only when land (canExist goes false).
25 -- Issue: it wouldn't reset if land in water, use fly, and launch from air, before I added test for water,
26 -- not sure if there are other such cases.
27 -- Temporarily add hud debug display to show descent velocity, gravity override, and airbreak flag.
28 -- Still in process of tuning all the parameters.
31 -- Modifications by Piezo_
33 -- hud overlay and debug can be enabled/disabled
34 -- Added blender-rendered overlay for struts using the actual model.
35 -- Reduced airbreak penalty severity
36 -- gave glider limited durability.
37 -- Improved gravity adjustment function.
38 -- Changed airbreaking process
39 -- Removed airbreak penalty, as any 'advantage' seems minimal after new adjustments
40 -- Removed airbreak until minetest devs are smart enough to implement better serverside players.
41 -- Simplified liquid check.
43 -- Modifications by gpcf
45 -- get shot down while flying over protected areas marked as no-fly-zones (flak, from German Flugabwehrkanone)
46 -- set these areas with the /area_flak command
48 -- Modifications by SpaghettiToastBook
50 -- Physics overrides use player_monoids mod if available
54 local HUD_Overlay = true --show glider struts as overlay on HUD
55 local debug = false --show debug info in top-center of hud
56 local moveModelUp = false
57 if tonumber(string.sub(minetest.get_version().string, 1, 1)) and tonumber(string.sub(minetest.get_version().string, 1, 1)) > 4 then
60 hangglider = {} --Make this global, so other mods can tell if hangglider exists.
63 hangglider.id = {} -- hud id for displaying overlay with struts
65 if debug then hangglider.debug = {} end -- hud id for debug data
66 --hangglider.airbreak = {} -- true if falling fast when equip
68 minetest.register_entity("hangglider:airstopper", { --A one-instant entity that catches the player and stops them.
73 on_step = function(self, _)
74 local canExist = false
76 local player = self.attach
77 if player:is_player() then
78 local pname = player:get_player_name()
80 if player:get_player_velocity().y < 0.5 and player:get_player_velocity().y > -0.5 then
81 --Let go when the player actually stops, as that's the whole point.
82 if hangglider.use[pname] then
84 minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
86 minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
102 if core.global_exists("areas") then
103 hangglider.flak = true
104 -- chat command definition essentially copied from areas mod.
105 minetest.register_chatcommand("area_flak",{
107 description = "Toggle airspace restrictions for area <ID>",
108 func = function(name, param)
109 local id = tonumber(param)
111 return false, "Invalid usage, see /help area_flak."
114 if not areas:isAreaOwner(id, name) then
115 return false, "Area "..id.." does not exist"
116 .." or is not owned by you."
118 local open = not areas.areas[id].flak
119 -- Save false as nil to avoid inflating the DB.
120 areas.areas[id].flak = open or nil
122 return true, ("Area's airspace %s."):format(open and "closed" or "opened")
127 if core.global_exists("minetestd") and minetestd.services.physicsctl.enabled then
128 minetestd.physicsctl.register_physics_effect("hangglider",
129 function(player) -- check
130 return hangglider.use[player:get_player_name()]
132 function(phys, player) -- blend
133 local vel_y = player:get_player_velocity().y
134 if debug then player:hud_change(hangglider.debug[pname].id, "text", vel_y..', '..player:get_physics_override().gravity..', '..tostring(hangglider.airbreak[pname])) end
135 phys.gravity = phys.gravity*((vel_y + 3)/20)
136 if vel_y < 0 and vel_y > -3 then
137 phys.speed = (math.abs(vel_y/2) + 0.75)
138 elseif vel_y <= -3 then --Cap our gliding movement speed.
147 hangglider.can_fly = function (pname, pos)
148 -- Checks if the player will get shot down at the position
150 local zone = wardzones.getZone(pos)
152 return (minetest.check_player_privs(pname, {protection_bypass=true}) or wardzones.checkPlayerZoneAccess(pname, zone) or not zone["data"]["no_fly"])
155 if areas and minetest.is_protected(vector.round(pos), pname) then
156 if hangglider.flak then
157 for id, area in pairs(areas:getAreasAtPos(pos)) do
167 hangglider.shot_sound = function (pos)
168 minetest.sound_play("hangglider_flak_shot", {
170 max_hear_distance = 30,
175 local function set_fast(name, value)
176 local privs = minetest.get_player_privs(name)
178 minetest.set_player_privs(name, privs)
181 local physics_attrs = {"jump", "speed", "gravity"}
182 local function apply_physics_override(player, overrides)
183 if player_monoids then
184 for _, attr in pairs(physics_attrs) do
185 if overrides[attr] then
186 player_monoids[attr]:add_change(player, overrides[attr], "hangglider:glider")
190 player:set_physics_override(overrides)
192 if minetest.settings:get_bool("hangglider_no_fast") then
193 set_fast(player:get_player_name(), nil)
197 local function remove_physics_override(player, overrides)
198 for _, attr in pairs(physics_attrs) do
199 if overrides[attr] then
200 if core.global_exists("player_monoids") then
201 player_monoids[attr]:del_change(player, "hangglider:glider")
203 player:set_physics_override({[attr] = 1})
207 set_fast(player:get_player_name(), true)
211 minetest.register_entity("hangglider:glider", {
213 visual_size = {x = 12, y = 12},
214 collisionbox = {0,0,0,0,0,0},
218 textures = {"wool_white.png","default_wood.png"},
219 on_step = function(self, dtime)
220 local canExist = false
221 if self.object:get_attach() then
222 local player = self.object:get_attach("parent")
224 local pos = player:getpos()
225 local pname = player:get_player_name()
226 if hangglider.use[pname] then
227 local mrn_name = minetest.registered_nodes[minetest.get_node(vector.new(pos.x, pos.y-0.5, pos.z)).name]
229 if not (mrn_name.walkable or mrn_name.liquidtype ~= "none") then
232 if not minetestd then
233 step_v = player:get_player_velocity().y
234 if step_v < 0 and step_v > -3 then
235 apply_physics_override(player, {speed=math.abs(step_v/2) + 0.75})
236 elseif step_v <= -3 then --Cap our gliding movement speed.
237 apply_physics_override(player, {speed=2.25})
239 remove_physics_override(player, {speed=1})
241 if debug then player:hud_change(hangglider.debug[pname].id, "text", step_v..', '..player:get_physics_override().gravity..', '..tostring(hangglider.airbreak[pname])) end
242 apply_physics_override(player, {gravity=((step_v + 3)/20)})
244 --[[local vel = player:get_player_velocity()
245 if debug then player:hud_change(hangglider.debug[pname].id, "text", vel.y..', '..grav..', '..tostring(hangglider.airbreak[pname])) end
247 player:set_physics_override({gravity = (vel.y + 2.0)/20})
251 if not hangglider.can_fly(pname,pos) then
252 if not self.warned then -- warning shot
254 hangglider.shot_sound(pos)
255 minetest.chat_send_player(pname, "Protected area! You will be shot down in two seconds by anti-aircraft guns!")
257 self.warned = self.warned + dtime
258 if self.warned > 2 then -- shoot down
260 player:get_inventory():remove_item("main", ItemStack("hangglider:hangglider"))
261 hangglider.shot_sound(pos)
267 if not minetestd then
268 remove_physics_override(player, {
273 hangglider.use[pname] = false
275 player:hud_change(hangglider.id[pname], "text", "blank.png")
277 --hangglider.airbreak[pname] = false
282 self.object:set_detach()
288 minetest.register_on_dieplayer(function(player)
289 remove_physics_override(player, {
293 hangglider.use[player:get_player_name()] = false
297 minetest.register_on_joinplayer(function(player)
298 local pname = player:get_player_name()
299 remove_physics_override(player, {
303 hangglider.use[pname] = false
305 hangglider.id[pname] = player:hud_add({
306 hud_elem_type = "image",
308 position = {x=0, y=0},
309 scale = {x=-100, y=-100},
310 alignment = {x=1, y=1},
314 hangglider.debug[pname] = {id = player:hud_add({hud_elem_type = "text",
315 position = {x=0.5, y=0.1},
317 number = 0xFF0000}), -- red text
321 --hangglider.airbreak[pname] = false
324 minetest.register_on_leaveplayer(function(player)
325 local pname = player:get_player_name()
326 hangglider.use[pname] = nil
327 if HUD_Overlay then hangglider.id[pname] = nil end
328 if debug then hangglider.debug[pname] = nil end
329 --hangglider.airbreak[pname] = nil
332 minetest.register_tool("hangglider:hangglider", {
333 description = "Glider",
334 inventory_image = "glider_item.png",
336 on_use = function(itemstack, player, pointed_thing)
340 local pos = player:get_pos()
341 local pname = player:get_player_name()
342 if not hangglider.use[pname] then --Equip
343 minetest.sound_play("bedsheet", {pos=pos, max_hear_distance = 8, gain = 1.0})
344 if HUD_Overlay then player:hud_change(hangglider.id[pname], "text", "glider_struts.png") end
345 local airbreak = false
346 local vel = player:get_player_velocity().y
347 --[[if vel < -1.5 then -- engage mid-air, falling fast, so stop but ramp velocity more quickly
348 --hangglider.airbreak[pname] = true
350 local stopper = minetest.add_entity(pos, "hangglider:airstopper")
351 minetest.after(0, function(stopper, player) --"Extreme Measures"
352 stopper:set_pos(player:get_pos())
353 stopper:get_luaentity().attach = player
354 player:set_attach( stopper, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
355 end, stopper, player)
359 minetest.add_entity(pos, "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
361 minetest.add_entity(pos, "hangglider:glider"):set_attach(player, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
364 hangglider.use[pname] = true
365 apply_physics_override(player, {jump = 0})
366 -- if minetest 0.4.x use this:
368 -- if minetest 5.x use this:
369 -- minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
370 itemstack:set_wear(itemstack:get_wear() + 255)
372 elseif hangglider.use[pname] then --Unequip
373 if HUD_Overlay then player:hud_change(hangglider.id[pname], "text", "default_wood.png^[colorize:#0000:255") end
374 hangglider.use[pname] = false
377 sound = {breaks = "default_tool_breaks"},
380 minetest.register_craft({
382 output = "hangglider:hangglider",
383 recipe = {"default:paper", "default:paper", "default:paper", "default:paper", "hangglider:hangglider", "default:paper", "default:paper", "default:paper", "default:paper"},
386 minetest.register_craft({
387 output = "hangglider:hangglider",
389 {"wool:white", "wool:white", "wool:white"},
390 {"default:stick", "", "default:stick"},
391 {"", "default:stick", ""},