mirror of
https://github.com/minetest-mods/ropes.git
synced 2024-11-24 16:33:48 +01:00
52a32fe1f2
This change includes some extensive rewriting of the shared underlying functions as well as the cosmetic changes. Rope destruction should happen instantly down its entire length now. Rope boxes themselves are now "climbable", making it easier to transfer from one rope to another. There's also a new user setting for limiting the number of rope box types available to the player.
34 lines
3.5 KiB
Lua
34 lines
3.5 KiB
Lua
ropes.doc = {}
|
|
|
|
if not minetest.get_modpath("doc") then
|
|
return
|
|
end
|
|
|
|
-- internationalization boilerplate
|
|
local MP = minetest.get_modpath(minetest.get_current_modname())
|
|
local S, NS = dofile(MP.."/intllib.lua")
|
|
|
|
ropes.doc.ropesegment_longdesc = S("Rope segments are bundles of fibre twisted into robust cables.")
|
|
ropes.doc.ropesegment_usage = S("This craft item is useful for creating rope ladders, or for spooling on wooden spindles to hang and climb upon.")
|
|
|
|
ropes.doc.ropeladder_longdesc = S("A hanging rope ladder that automatically extends downward.")
|
|
ropes.doc.ropeladder_usage = S("After a rope ladder is placed on a vertical wall it will begin extending downward until it reaches its maximum length (@1 meters). If the rope ladder is removed all of the ladder below the point of removal will disappear. A rope ladder can be severed partway down using an axe or similar tool, and the ladder below the point where it is cut will collapse. No rope is actually lost in the process, though, and if the uppermost section of the ladder is removed and replaced the ladder will re-extend to the same maximum length as before.", ropes.ropeLadderLength)
|
|
|
|
local rope_length_doc
|
|
if ropes.ropeLengthMaxMultiple > 1 then
|
|
rope_length_doc = S("Rope boxes have a certain amount of rope contained within them specified in the name of the node. They come in @1 standard lengths (from @2 meters to @3 meters in multiples of @2 meters) that can be crafted by combining and splitting up rope boxes in the crafting grid. For example, you can craft a @4m rope box by combining two @2m rope boxes, and the two @2m rope boxes can be recovered by splitting the @4m rope box back up in the crafting grid.", ropes.ropeLengthMaxMultiple, ropes.ropeLength, ropes.ropeLength*ropes.ropeLengthMaxMultiple, ropes.ropeLength*2)
|
|
else
|
|
rope_length_doc = S("Rope boxes contain @1 meters of rope.", ropes.ropeLength)
|
|
end
|
|
|
|
ropes.doc.ropebox_longdesc = S("Ropes are hung by placing rope boxes, which automatically lower a rope of fixed length below them. They can be climbed and cut.")
|
|
ropes.doc.ropebox_usage = rope_length_doc .. "\n\n" ..
|
|
S("When a rope box is placed the rope will immediately begin lowering from it at one meter per second. The rope will only descend when its end is in the vicinity of an active player, suspending its journey when no players are nearby, so a long descent may require a player to climb down the rope as it goes. Take care not to fall off the end! If you are near the bottom end of a rope that's extending you'll be automatically carried down with it. The rope will stop when it encounters and obstruction, but will resume lowering if the obstruction is removed.") .. "\n\n" ..
|
|
S("A rope can be severed midway using an axe or other similar tools. The section of rope below the cut will collapse and disappear, potentially causing players who were hanging on to it to fall. The remaining rope will not resume descent on its own, but the rope box at the top of the rope \"remembers\" how long the rope was and if it is deconstructed and replaced it will still have the same maximum length of rope as before - no rope is permnanently lost when a rope is severed like this.")
|
|
|
|
doc.add_entry_alias("nodes", "ropes:ropeladder_top", "nodes", "ropes:ropeladder")
|
|
doc.add_entry_alias("nodes", "ropes:ropeladder_top", "nodes", "ropes:ropeladder_bottom")
|
|
doc.add_entry_alias("nodes", "ropes:ropeladder_top", "nodes", "ropes:ropeladder_falling")
|
|
|
|
doc.add_entry_alias("nodes", "ropes:rope", "nodes", "ropes:rope_bottom")
|
|
doc.add_entry_alias("nodes", "ropes:rope", "nodes", "ropes:rope_top") |