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
42 local HUD_Overlay = true --show glider struts as overlay on HUD
43 local debug = false --show debug info in top-center of hud
44 local moveModelUp = false
45 if tonumber(string.sub(minetest.get_version().string, 1, 1)) and tonumber(string.sub(minetest.get_version().string, 1, 1)) > 4 then
48 hangglider = {} --Make this global, so other mods can tell if hangglider exists.
51 hangglider.id = {} -- hud id for displaying overlay with struts
53 if debug then hangglider.debug = {} end -- hud id for debug data
54 --hangglider.airbreak = {} -- true if falling fast when equip
56 minetest.register_entity("hangglider:airstopper", { --A one-instant entity that catches the player and stops them.
61 on_step = function(self, _)
62 local canExist = false
64 local player = self.attach
65 if player:is_player() then
66 local pname = player:get_player_name()
68 if player:get_player_velocity().y < 0.5 and player:get_player_velocity().y > -0.5 then
69 --Let go when the player actually stops, as that's the whole point.
70 if hangglider.use[pname] then
72 minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
74 minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
90 if minetestd and minetestd.services.gravityctl.enabled then
91 minetestd.gravityctl.register_gravity_effect("hangglider",
93 return hangglider.use[player:get_player_name()]
95 function(gravity, player)
96 local vel = player:get_player_velocity()
97 if debug then player:hud_change(hangglider.debug[pname].id, "text", vel.y..', '..player:get_physics_override().gravity..', '..tostring(hangglider.airbreak[pname])) end
98 return ((vel.y + 3)/20)
106 minetest.register_entity("hangglider:glider", {
108 visual_size = {x = 12, y = 12},
112 textures = {"wool_white.png","default_wood.png"},
113 on_step = function(self, _)
114 local canExist = false
115 if self.object:get_attach() then
116 local player = self.object:get_attach("parent")
118 local pos = player:getpos()
119 local pname = player:get_player_name()
120 if hangglider.use[pname] then
121 local mrn_name = minetest.registered_nodes[minetest.get_node(vector.new(pos.x, pos.y-0.5, pos.z)).name]
123 if not (mrn_name.walkable or (mrn_name.drowning and mrn_name.drowning == 1)) then
125 step_v = player:get_player_velocity().y
126 if step_v < 0 and step_v > -3 then
127 player:set_physics_override({speed=math.abs(step_v/2) + 0.75})
128 elseif step_v <= -3 then --Cap our fall speed.
129 player:set_physics_override({speed=2.25})
131 player:set_physics_override({speed=1})
133 if not minetestd then
134 if debug then player:hud_change(hangglider.debug[pname].id, "text", step_v..', '..player:get_physics_override().gravity..', '..tostring(hangglider.airbreak[pname])) end
135 player:set_physics_override({gravity=((step_v + 3)/20)})
137 --[[local vel = player:get_player_velocity()
138 if debug then player:hud_change(hangglider.debug[pname].id, "text", vel.y..', '..grav..', '..tostring(hangglider.airbreak[pname])) end
140 player:set_physics_override({gravity = (vel.y + 2.0)/20})
145 player:set_physics_override({
149 if not minetestd then
150 player:set_physics_override({gravity=1})
152 hangglider.use[pname] = false
154 player:hud_change(hangglider.id[pname], "text", "blank.png")
156 --hangglider.airbreak[pname] = false
161 self.object:set_detach()
167 minetest.register_on_dieplayer(function(player)
168 player:set_physics_override({
172 hangglider.use[player:get_player_name()] = false
176 minetest.register_on_joinplayer(function(player)
177 local pname = player:get_player_name()
178 player:set_physics_override({
182 hangglider.use[pname] = false
184 hangglider.id[pname] = player:hud_add({
185 hud_elem_type = "image",
187 position = {x=0, y=0},
188 scale = {x=-100, y=-100},
189 alignment = {x=1, y=1},
193 hangglider.debug[pname] = {id = player:hud_add({hud_elem_type = "text",
194 position = {x=0.5, y=0.1},
196 number = 0xFF0000}), -- red text
200 --hangglider.airbreak[pname] = false
203 minetest.register_on_leaveplayer(function(player)
204 local pname = player:get_player_name()
205 hangglider.use[pname] = nil
206 if HUD_Overlay then hangglider.id[pname] = nil end
207 if debug then hangglider.debug[pname] = nil end
208 --hangglider.airbreak[pname] = nil
211 minetest.register_tool("hangglider:hangglider", {
212 description = "Glider",
213 inventory_image = "glider_item.png",
215 on_use = function(itemstack, player, pointed_thing)
219 local pos = player:get_pos()
220 local pname = player:get_player_name()
221 if minetest.get_node(pos).name == "air" and not hangglider.use[pname] then --Equip
222 minetest.sound_play("bedsheet", {pos=pos, max_hear_distance = 8, gain = 1.0})
223 if HUD_Overlay then player:hud_change(hangglider.id[pname], "text", "glider_struts.png") end
224 local airbreak = false
225 local vel = player:get_player_velocity().y
226 --[[if vel < -1.5 then -- engage mid-air, falling fast, so stop but ramp velocity more quickly
227 --hangglider.airbreak[pname] = true
229 local stopper = minetest.add_entity(pos, "hangglider:airstopper")
230 minetest.after(0, function(stopper, player) --"Extreme Measures"
231 stopper:set_pos(player:get_pos())
232 stopper:get_luaentity().attach = player
233 player:set_attach( stopper, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
234 end, stopper, player)
238 minetest.add_entity(pos, "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
240 minetest.add_entity(pos, "hangglider:glider"):set_attach(player, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
243 hangglider.use[pname] = true
244 player:set_physics_override({jump = 0})
245 -- if minetest 0.4.x use this:
247 -- if minetest 5.x use this:
248 -- minetest.add_entity(player:get_pos(), "hangglider:glider"):set_attach(player, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
249 itemstack:set_wear(itemstack:get_wear() + 255)
251 elseif hangglider.use[pname] then --Unequip
252 if HUD_Overlay then player:hud_change(hangglider.id[pname], "text", "default_wood.png^[colorize:#0000:255") end
253 hangglider.use[pname] = false
256 sound = {breaks = "default_tool_breaks"},
259 minetest.register_craft({
261 output = "hangglider:hangglider",
262 recipe = {"default:paper", "default:paper", "default:paper", "default:paper", "hangglider:hangglider", "default:paper", "default:paper", "default:paper", "default:paper"},
265 minetest.register_craft({
266 output = "hangglider:hangglider",
268 {"wool:white", "wool:white", "wool:white"},
269 {"default:stick", "", "default:stick"},
270 {"", "default:stick", ""},