api.lua 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402
  1. -- farming/api.lua
  2. -- support for MT game translation.
  3. local S = farming.get_translator
  4. -- Wear out hoes, place soil
  5. -- TODO Ignore group:flower
  6. farming.registered_plants = {}
  7. farming.hoe_on_use = function(itemstack, user, pointed_thing, uses)
  8. local pt = pointed_thing
  9. -- check if pointing at a node
  10. if not pt then
  11. return
  12. end
  13. if pt.type ~= "node" then
  14. return
  15. end
  16. local under = minetest.get_node(pt.under)
  17. local p = {x=pt.under.x, y=pt.under.y+1, z=pt.under.z}
  18. local above = minetest.get_node(p)
  19. -- return if any of the nodes is not registered
  20. if not minetest.registered_nodes[under.name] then
  21. return
  22. end
  23. if not minetest.registered_nodes[above.name] then
  24. return
  25. end
  26. -- check if the node above the pointed thing is air
  27. if above.name ~= "air" then
  28. return
  29. end
  30. -- check if pointing at soil
  31. if minetest.get_item_group(under.name, "soil") ~= 1 then
  32. return
  33. end
  34. -- check if (wet) soil defined
  35. local regN = minetest.registered_nodes
  36. if regN[under.name].soil == nil or regN[under.name].soil.wet == nil or regN[under.name].soil.dry == nil then
  37. return
  38. end
  39. local player_name = user and user:get_player_name() or ""
  40. if minetest.is_protected(pt.under, player_name) then
  41. minetest.record_protection_violation(pt.under, player_name)
  42. return
  43. end
  44. if minetest.is_protected(pt.above, player_name) then
  45. minetest.record_protection_violation(pt.above, player_name)
  46. return
  47. end
  48. -- turn the node into soil and play sound
  49. minetest.set_node(pt.under, {name = regN[under.name].soil.dry})
  50. minetest.sound_play("default_dig_crumbly", {
  51. pos = pt.under,
  52. gain = 0.5,
  53. }, true)
  54. if not minetest.is_creative_enabled(player_name) then
  55. -- wear tool
  56. local wdef = itemstack:get_definition()
  57. itemstack:add_wear(65535/(uses-1))
  58. -- tool break sound
  59. if itemstack:get_count() == 0 and wdef.sound and wdef.sound.breaks then
  60. minetest.sound_play(wdef.sound.breaks, {pos = pt.above,
  61. gain = 0.5}, true)
  62. end
  63. end
  64. return itemstack
  65. end
  66. -- Register new hoes
  67. farming.register_hoe = function(name, def)
  68. -- Check for : prefix (register new hoes in your mod's namespace)
  69. if name:sub(1,1) ~= ":" then
  70. name = ":" .. name
  71. end
  72. -- Check def table
  73. if def.description == nil then
  74. def.description = S("Hoe")
  75. end
  76. if def.inventory_image == nil then
  77. def.inventory_image = "unknown_item.png"
  78. end
  79. if def.max_uses == nil then
  80. def.max_uses = 30
  81. end
  82. -- Register the tool
  83. minetest.register_tool(name, {
  84. description = def.description,
  85. inventory_image = def.inventory_image,
  86. on_use = function(itemstack, user, pointed_thing)
  87. return farming.hoe_on_use(itemstack, user, pointed_thing, def.max_uses)
  88. end,
  89. groups = def.groups,
  90. sound = {breaks = "default_tool_breaks"},
  91. })
  92. -- Register its recipe
  93. if def.recipe then
  94. minetest.register_craft({
  95. output = name:sub(2),
  96. recipe = def.recipe
  97. })
  98. elseif def.material then
  99. minetest.register_craft({
  100. output = name:sub(2),
  101. recipe = {
  102. {def.material, def.material},
  103. {"", "group:stick"},
  104. {"", "group:stick"}
  105. }
  106. })
  107. end
  108. end
  109. -- how often node timers for plants will tick, +/- some random value
  110. local function tick(pos)
  111. minetest.get_node_timer(pos):start(math.random(166, 286))
  112. end
  113. -- how often a growth failure tick is retried (e.g. too dark)
  114. local function tick_again(pos)
  115. minetest.get_node_timer(pos):start(math.random(40, 80))
  116. end
  117. -- Seed placement
  118. farming.place_seed = function(itemstack, placer, pointed_thing, plantname)
  119. local pt = pointed_thing
  120. -- check if pointing at a node
  121. if not pt then
  122. return itemstack
  123. end
  124. if pt.type ~= "node" then
  125. return itemstack
  126. end
  127. local under = minetest.get_node(pt.under)
  128. local above = minetest.get_node(pt.above)
  129. local player_name = placer and placer:get_player_name() or ""
  130. if minetest.is_protected(pt.under, player_name) then
  131. minetest.record_protection_violation(pt.under, player_name)
  132. return
  133. end
  134. if minetest.is_protected(pt.above, player_name) then
  135. minetest.record_protection_violation(pt.above, player_name)
  136. return
  137. end
  138. -- return if any of the nodes is not registered
  139. if not minetest.registered_nodes[under.name] then
  140. return itemstack
  141. end
  142. if not minetest.registered_nodes[above.name] then
  143. return itemstack
  144. end
  145. -- check if pointing at the top of the node
  146. if pt.above.y ~= pt.under.y+1 then
  147. return itemstack
  148. end
  149. -- check if you can replace the node above the pointed node
  150. if not minetest.registered_nodes[above.name].buildable_to then
  151. return itemstack
  152. end
  153. -- check if pointing at soil
  154. if minetest.get_item_group(under.name, "soil") < 2 then
  155. return itemstack
  156. end
  157. -- add the node and remove 1 item from the itemstack
  158. minetest.log("action", player_name .. " places node " .. plantname .. " at " ..
  159. minetest.pos_to_string(pt.above))
  160. minetest.add_node(pt.above, {name = plantname, param2 = 1})
  161. tick(pt.above)
  162. if not minetest.is_creative_enabled(player_name) then
  163. itemstack:take_item()
  164. end
  165. return itemstack
  166. end
  167. farming.grow_plant = function(pos, elapsed)
  168. local node = minetest.get_node(pos)
  169. local name = node.name
  170. local def = minetest.registered_nodes[name]
  171. if not def.next_plant then
  172. -- disable timer for fully grown plant
  173. return
  174. end
  175. -- grow seed
  176. if minetest.get_item_group(node.name, "seed") and def.fertility then
  177. local soil_node = minetest.get_node_or_nil({x = pos.x, y = pos.y - 1, z = pos.z})
  178. if not soil_node then
  179. tick_again(pos)
  180. return
  181. end
  182. -- omitted is a check for light, we assume seeds can germinate in the dark.
  183. for _, v in pairs(def.fertility) do
  184. if minetest.get_item_group(soil_node.name, v) ~= 0 then
  185. local placenode = {name = def.next_plant}
  186. if def.place_param2 then
  187. placenode.param2 = def.place_param2
  188. end
  189. minetest.swap_node(pos, placenode)
  190. if minetest.registered_nodes[def.next_plant].next_plant then
  191. tick(pos)
  192. return
  193. end
  194. end
  195. end
  196. return
  197. end
  198. -- check if on wet soil
  199. local below = minetest.get_node({x = pos.x, y = pos.y - 1, z = pos.z})
  200. if minetest.get_item_group(below.name, "soil") < 3 then
  201. tick_again(pos)
  202. return
  203. end
  204. -- check light
  205. local light = minetest.get_node_light(pos)
  206. if not light or light < def.minlight or light > def.maxlight then
  207. tick_again(pos)
  208. return
  209. end
  210. -- grow
  211. local placenode = {name = def.next_plant}
  212. if def.place_param2 then
  213. placenode.param2 = def.place_param2
  214. end
  215. minetest.swap_node(pos, placenode)
  216. -- new timer needed?
  217. if minetest.registered_nodes[def.next_plant].next_plant then
  218. tick(pos)
  219. end
  220. return
  221. end
  222. -- Register plants
  223. farming.register_plant = function(name, def)
  224. local mname = name:split(":")[1]
  225. local pname = name:split(":")[2]
  226. -- Check def table
  227. if not def.description then
  228. def.description = S("Seed")
  229. end
  230. if not def.harvest_description then
  231. def.harvest_description = pname:gsub("^%l", string.upper)
  232. end
  233. if not def.inventory_image then
  234. def.inventory_image = "unknown_item.png"
  235. end
  236. if not def.steps then
  237. return nil
  238. end
  239. if not def.minlight then
  240. def.minlight = 1
  241. end
  242. if not def.maxlight then
  243. def.maxlight = 14
  244. end
  245. if not def.fertility then
  246. def.fertility = {}
  247. end
  248. farming.registered_plants[pname] = def
  249. -- Register seed
  250. local lbm_nodes = {mname .. ":seed_" .. pname}
  251. local g = {seed = 1, snappy = 3, attached_node = 1, flammable = 2}
  252. for k, v in pairs(def.fertility) do
  253. g[v] = 1
  254. end
  255. minetest.register_node(":" .. mname .. ":seed_" .. pname, {
  256. description = def.description,
  257. tiles = {def.inventory_image},
  258. inventory_image = def.inventory_image,
  259. wield_image = def.inventory_image,
  260. drawtype = "signlike",
  261. groups = g,
  262. paramtype = "light",
  263. paramtype2 = "wallmounted",
  264. place_param2 = def.place_param2 or nil, -- this isn't actually used for placement
  265. walkable = false,
  266. sunlight_propagates = true,
  267. selection_box = {
  268. type = "fixed",
  269. fixed = {-0.5, -0.5, -0.5, 0.5, -5/16, 0.5},
  270. },
  271. fertility = def.fertility,
  272. sounds = default.node_sound_dirt_defaults({
  273. dig = {name = "", gain = 0},
  274. dug = {name = "default_grass_footstep", gain = 0.2},
  275. place = {name = "default_place_node", gain = 0.25},
  276. }),
  277. on_place = function(itemstack, placer, pointed_thing)
  278. local under = pointed_thing.under
  279. local node = minetest.get_node(under)
  280. local udef = minetest.registered_nodes[node.name]
  281. if udef and udef.on_rightclick and
  282. not (placer and placer:is_player() and
  283. placer:get_player_control().sneak) then
  284. return udef.on_rightclick(under, node, placer, itemstack,
  285. pointed_thing) or itemstack
  286. end
  287. return farming.place_seed(itemstack, placer, pointed_thing, mname .. ":seed_" .. pname)
  288. end,
  289. next_plant = mname .. ":" .. pname .. "_1",
  290. on_timer = farming.grow_plant,
  291. minlight = def.minlight,
  292. maxlight = def.maxlight,
  293. })
  294. -- Register harvest
  295. minetest.register_craftitem(":" .. mname .. ":" .. pname, {
  296. description = def.harvest_description,
  297. inventory_image = mname .. "_" .. pname .. ".png",
  298. groups = def.groups or {flammable = 2},
  299. })
  300. -- Register growing steps
  301. for i = 1, def.steps do
  302. local base_rarity = 1
  303. if def.steps ~= 1 then
  304. base_rarity = 8 - (i - 1) * 7 / (def.steps - 1)
  305. end
  306. local drop = {
  307. items = {
  308. {items = {mname .. ":" .. pname}, rarity = base_rarity},
  309. {items = {mname .. ":" .. pname}, rarity = base_rarity * 2},
  310. {items = {mname .. ":seed_" .. pname}, rarity = base_rarity},
  311. {items = {mname .. ":seed_" .. pname}, rarity = base_rarity * 2},
  312. }
  313. }
  314. local nodegroups = {snappy = 3, flammable = 2, plant = 1, not_in_creative_inventory = 1, attached_node = 1}
  315. nodegroups[pname] = i
  316. local next_plant = nil
  317. if i < def.steps then
  318. next_plant = mname .. ":" .. pname .. "_" .. (i + 1)
  319. lbm_nodes[#lbm_nodes + 1] = mname .. ":" .. pname .. "_" .. i
  320. end
  321. minetest.register_node(":" .. mname .. ":" .. pname .. "_" .. i, {
  322. drawtype = "plantlike",
  323. waving = 1,
  324. tiles = {mname .. "_" .. pname .. "_" .. i .. ".png"},
  325. paramtype = "light",
  326. paramtype2 = def.paramtype2 or nil,
  327. place_param2 = def.place_param2 or nil,
  328. walkable = false,
  329. buildable_to = true,
  330. drop = drop,
  331. selection_box = {
  332. type = "fixed",
  333. fixed = {-0.5, -0.5, -0.5, 0.5, -5/16, 0.5},
  334. },
  335. groups = nodegroups,
  336. sounds = default.node_sound_leaves_defaults(),
  337. next_plant = next_plant,
  338. on_timer = farming.grow_plant,
  339. minlight = def.minlight,
  340. maxlight = def.maxlight,
  341. })
  342. end
  343. -- replacement LBM for pre-nodetimer plants
  344. minetest.register_lbm({
  345. name = ":" .. mname .. ":start_nodetimer_" .. pname,
  346. nodenames = lbm_nodes,
  347. action = function(pos, node)
  348. tick_again(pos)
  349. end,
  350. })
  351. -- Return
  352. local r = {
  353. seed = mname .. ":seed_" .. pname,
  354. harvest = mname .. ":" .. pname
  355. }
  356. return r
  357. end