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.
39 local HUD_Overlay = true --show glider struts as overlay on HUD
40 local debug = false --show debug info in top-center of hud
41 hangglider = {} --Make this global, so other mods can tell if hangglider exists.
44 hangglider.id = {} -- hud id for displaying overlay with struts
46 if debug then hangglider.debug = {} end -- hud id for debug data
47 hangglider.airbreak = {} -- true if falling fast when equip
49 minetest.register_entity("hangglider:airstopper", { --A one-instant entity that catches the player and slows them down.
54 on_step = function(self, _)
55 if self.object:get_hp() ~= 1 then
56 self.object:set_hp(self.object:get_hp() - 1)
59 self.attach:set_detach()
66 minetest.register_entity("hangglider:glider", {
68 visual_size = {x = 12, y = 12},
72 textures = {"wool_white.png","default_wood.png"},
73 on_step = function(self, _)
74 local canExist = false
75 if self.object:get_attach() then
76 local player = self.object:get_attach("parent")
78 local pos = player:getpos()
79 local pname = player:get_player_name()
80 if hangglider.use[pname] then
81 local mrn_name = minetest.registered_nodes[minetest.get_node(vector.new(pos.x, pos.y-0.5, pos.z)).name]
83 if not (mrn_name.walkable or (mrn_name.drowning and mrn_name.drowning == 1)) then
85 local vel = player:get_player_velocity()
86 local grav = player:get_physics_override().gravity
87 if debug then player:hud_change(hangglider.debug[pname].id, "text", vel.y..', '..grav..', '..tostring(hangglider.airbreak[pname])) end
88 -- If airbreaking used, increase the descent progression to not give
89 -- mid-flight unequip/equip cycles a distance advantage.
90 if hangglider.airbreak[pname] then
92 grav = -0.2 --Extreme measures are needed, as sometimes speed will get a bit out of control
93 elseif vel.y <= -2.0 then
95 elseif vel.y <= -1.75 then
97 elseif vel.y <= -1.5 then
99 elseif vel.y <= -1.25 then
101 elseif vel.y <= -1 then
103 elseif vel.y <= -0.75 then
105 elseif vel.y <= -0.5 then
107 elseif vel.y <= -0.25 then
109 elseif vel.y <= 0 then
114 else -- normal descent progression
115 if vel.y <= -4.0 then
117 elseif vel.y <= -2.0 then
119 elseif vel.y <= -1.5 then
121 elseif vel.y <= -1.25 then
123 elseif vel.y <= -1 then
125 elseif vel.y <= -0.75 then
127 elseif vel.y <= -0.5 then
129 elseif vel.y <= -0.25 then
131 elseif vel.y <= 0 then
137 player:set_physics_override({gravity = grav})
142 player:set_physics_override({
147 hangglider.use[pname] = false
149 player:hud_change(hangglider.id[pname], "text", "blank.png")
151 hangglider.airbreak[pname] = false
156 self.object:set_detach()
162 minetest.register_on_dieplayer(function(player)
163 player:set_physics_override({
167 hangglider.use[player:get_player_name()] = false
171 minetest.register_on_joinplayer(function(player)
172 local pname = player:get_player_name()
173 player:set_physics_override({
177 hangglider.use[pname] = false
179 hangglider.id[pname] = player:hud_add({
180 hud_elem_type = "image",
182 position = {x=0, y=0},
183 scale = {x=-100, y=-100},
184 alignment = {x=1, y=1},
188 hangglider.debug[pname] = {id = player:hud_add({hud_elem_type = "text",
189 position = {x=0.5, y=0.1},
191 number = 0xFF0000}), -- red text
195 hangglider.airbreak[pname] = false
198 minetest.register_on_leaveplayer(function(player)
199 local pname = player:get_player_name()
200 hangglider.use[pname] = nil
201 if HUD_Overlay then hangglider.id[pname] = nil end
202 if debug then hangglider.debug[pname] = nil end
203 hangglider.airbreak[pname] = nil
206 minetest.register_tool("hangglider:hangglider", {
207 description = "Glider",
208 inventory_image = "glider_item.png",
210 on_use = function(itemstack, user, pointed_thing)
214 local pos = user:get_pos()
215 local pname = user:get_player_name()
216 if minetest.get_node(pos).name == "air" and not hangglider.use[pname] then --Equip
217 minetest.sound_play("bedsheet", {pos=pos, max_hear_distance = 8, gain = 1.0})
218 if HUD_Overlay then user:hud_change(hangglider.id[pname], "text", "glider_struts.png") end
219 local vel = user:get_player_velocity().y
220 if vel < -0.8 then -- engage mid-air, falling fast, so stop but ramp velocity more quickly
221 hangglider.airbreak[pname] = true
222 user:set_physics_override({
227 local stopper = minetest.add_entity(pos, "hangglider:airstopper")
228 stopper:get_luaentity().attach = user
229 user:set_attach( stopper, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
231 user:set_physics_override({
237 hangglider.use[pname] = true
238 -- if minetest 0.4.x use this:
239 minetest.add_entity(user:get_pos(), "hangglider:glider"):set_attach(user, "", {x=0,y=0,z=0}, {x=0,y=0,z=0})
240 -- if minetest 5.x use this:
241 -- minetest.add_entity(user:get_pos(), "hangglider:glider"):set_attach(user, "", {x=0,y=10,z=0}, {x=0,y=0,z=0})
242 itemstack:set_wear(itemstack:get_wear() + 255)
244 elseif hangglider.use[pname] then --Unequip
245 if HUD_Overlay then user:hud_change(hangglider.id[pname], "text", "blank.png") end
246 hangglider.use[pname] = false
249 sound = {breaks = "default_tool_breaks"},
252 minetest.register_craft({
253 output = "hangglider:hangglider",
255 {"wool:white", "wool:white", "wool:white"},
256 {"default:stick", "", "default:stick"},
257 {"", "default:stick", ""},