1251

--- Applies the given brush with the given height and size to the given position.
-- @param	pos1		Vector3		The position at which to apply the brush.
-- @param	brush_name	string		The name of the brush to apply.
-- @param	brush_size	Vector3		The size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!
-- @param	height		number		The height of the brush application.
-- @returns	bool, string|{ added: number, removed: number }	A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).
local function apply(pos1, brush_name, brush_size, height)

{
	"type": "function",
	"internal": false,
	"description": "Applies the given brush with the given height and size to the given position.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\t\tVector3\t\tThe position at which to apply the brush.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The position at which to apply the brush."
		},
		{
			"directive": "param",
			"text": "brush_name\tstring\t\tThe name of the brush to apply.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to apply."
		},
		{
			"directive": "param",
			"text": "brush_size\tVector3\t\tThe size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!",
			"name": "brush_size",
			"type": "Vector3",
			"description": "The size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!"
		},
		{
			"directive": "param",
			"text": "height\t\tnumber\t\tThe height of the brush application.",
			"name": "height",
			"type": "number",
			"description": "The height of the brush application."
		},
		{
			"directive": "returns",
			"text": "bool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).",
			"type": "bool, string|{ added: number, removed: number }",
			"description": "A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful)."
		}
	],
	"line": 7,
	"namespace": "worldeditadditions.sculpt",
	"line_last": 13,
	"name": "apply",
	"instanced": false,
	"args": [
		"pos1",
		"brush_name",
		"brush_size",
		"height"
	],
	"text": "--- Applies the given brush with the given height and size to the given position.\n-- @param\tpos1\t\tVector3\t\tThe position at which to apply the brush.\n-- @param\tbrush_name\tstring\t\tThe name of the brush to apply.\n-- @param\tbrush_size\tVector3\t\tThe size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!\n-- @param\theight\t\tnumber\t\tThe height of the brush application.\n-- @returns\tbool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).\nlocal function apply(pos1, brush_name, brush_size, height)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\t\tVector3\t\tThe position at which to apply the brush.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The position at which to apply the brush."
		},
		{
			"directive": "param",
			"text": "brush_name\tstring\t\tThe name of the brush to apply.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to apply."
		},
		{
			"directive": "param",
			"text": "brush_size\tVector3\t\tThe size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!",
			"name": "brush_size",
			"type": "Vector3",
			"description": "The size of the brush application. Values are interpreted on the X/Y coordinates, and NOT X/Z!"
		},
		{
			"directive": "param",
			"text": "height\t\tnumber\t\tThe height of the brush application.",
			"name": "height",
			"type": "number",
			"description": "The height of the brush application."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).",
		"type": "bool, string|{ added: number, removed: number }",
		"description": "A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful)."
	},
	"name_full": "worldeditadditions.sculpt.apply",
	"filename": "worldeditadditions/lib/sculpt/apply.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/sculpt/apply.lua#L8-L14"
}

--- Applies the given brush at the given x/z position to the given heightmap.
-- Important: Where a Vector3 is mentioned in the parameter list, it reall MUST
-- be a Vector3 instance.
-- Also important: Remember that the position there is RELATIVE TO THE HEIGHTMAP'S origin (0, 0) and is on the X and Z axes!
-- @param	brush			table	The ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1.
-- @param	brush_size		Vector3	The size of the brush on the x/y axes.
-- @pram	height			number	The multiplier to apply to each brush pixel value just before applying it. Negative values are allowed - this will cause a subtraction operation instead of an addition.
-- @param	position		Vector3	The position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on.
-- @param	heightmap		table	The heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these.
-- @param	heightmap_size	Vector3	The size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information.
-- @returns	true,number,number|false,string		If the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed.
local function apply_heightmap(brush, brush_size, height, position, heightmap, heightmap_size)

{
	"type": "function",
	"internal": false,
	"description": "Applies the given brush at the given x/z position to the given heightmap.\nImportant: Where a Vector3 is mentioned in the parameter list, it reall MUST\nbe a Vector3 instance.\nAlso important: Remember that the position there is RELATIVE TO THE HEIGHTMAP'S origin (0, 0) and is on the X and Z axes!",
	"directives": [
		{
			"directive": "param",
			"text": "brush\t\t\ttable\tThe ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1.",
			"name": "brush",
			"type": "table",
			"description": "The ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1."
		},
		{
			"directive": "param",
			"text": "brush_size\t\tVector3\tThe size of the brush on the x/y axes.",
			"name": "brush_size",
			"type": "Vector3",
			"description": "The size of the brush on the x/y axes."
		},
		{
			"directive": "pram",
			"text": "height\t\t\tnumber\tThe multiplier to apply to each brush pixel value just before applying it. Negative values are allowed - this will cause a subtraction operation instead of an addition."
		},
		{
			"directive": "param",
			"text": "position\t\tVector3\tThe position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on.",
			"name": "position",
			"type": "Vector3",
			"description": "The position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on."
		},
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tThe heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these.",
			"name": "heightmap",
			"type": "table",
			"description": "The heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tVector3\tThe size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information.",
			"name": "heightmap_size",
			"type": "Vector3",
			"description": "The size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information."
		},
		{
			"directive": "returns",
			"text": "true,number,number|false,string\t\tIf the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed.",
			"type": "true,number,number|false,string",
			"description": "If the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed."
		}
	],
	"line": 7,
	"namespace": "worldeditadditions.sculpt",
	"line_last": 18,
	"name": "apply_heightmap",
	"instanced": false,
	"args": [
		"brush",
		"brush_size",
		"height",
		"position",
		"heightmap",
		"heightmap_size"
	],
	"text": "--- Applies the given brush at the given x/z position to the given heightmap.\n-- Important: Where a Vector3 is mentioned in the parameter list, it reall MUST\n-- be a Vector3 instance.\n-- Also important: Remember that the position there is RELATIVE TO THE HEIGHTMAP'S origin (0, 0) and is on the X and Z axes!\n-- @param\tbrush\t\t\ttable\tThe ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1.\n-- @param\tbrush_size\t\tVector3\tThe size of the brush on the x/y axes.\n-- @pram\theight\t\t\tnumber\tThe multiplier to apply to each brush pixel value just before applying it. Negative values are allowed - this will cause a subtraction operation instead of an addition.\n-- @param\tposition\t\tVector3\tThe position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on.\n-- @param\theightmap\t\ttable\tThe heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these.\n-- @param\theightmap_size\tVector3\tThe size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information.\n-- @returns\ttrue,number,number|false,string\t\tIf the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed.\nlocal function apply_heightmap(brush, brush_size, height, position, heightmap, heightmap_size)",
	"params": [
		{
			"directive": "param",
			"text": "brush\t\t\ttable\tThe ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1.",
			"name": "brush",
			"type": "table",
			"description": "The ZERO-indexed brush to apply. Values should be normalised to be between 0 and 1."
		},
		{
			"directive": "param",
			"text": "brush_size\t\tVector3\tThe size of the brush on the x/y axes.",
			"name": "brush_size",
			"type": "Vector3",
			"description": "The size of the brush on the x/y axes."
		},
		{
			"directive": "param",
			"text": "position\t\tVector3\tThe position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on.",
			"name": "position",
			"type": "Vector3",
			"description": "The position RELATIVE TO THE HEIGHTMAP on the x/z coordinates to centre the brush application on."
		},
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tThe heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these.",
			"name": "heightmap",
			"type": "table",
			"description": "The heightmap to apply the brush to. See worldeditadditions.make_heightmap for how to obtain one of these."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tVector3\tThe size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information.",
			"name": "heightmap_size",
			"type": "Vector3",
			"description": "The size of the aforementioned heightmap. See worldeditadditions.make_heightmap for more information."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "true,number,number|false,string\t\tIf the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed.",
		"type": "true,number,number|false,string",
		"description": "If the operation was not successful, then false followed by an error message as a string is returned. If it was successful however, 3 values are returned: true, then the number of nodes added, then the number of nodes removed."
	},
	"name_full": "worldeditadditions.sculpt.apply_heightmap",
	"filename": "worldeditadditions/lib/sculpt/apply_heightmap.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/sculpt/apply_heightmap.lua#L8-L19"
}

--- Makes a sculpting brush that is as close to a target size as possible.
-- @param	brush_name	string	The name of the brush to create.
-- @param	target_size	Vector3	The target size of the brush to create.
-- @returns	true,table,Vector3|false,string	If the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead.
local function make_brush(brush_name, target_size)

{
	"type": "function",
	"internal": false,
	"description": "Makes a sculpting brush that is as close to a target size as possible.",
	"directives": [
		{
			"directive": "param",
			"text": "brush_name\tstring\tThe name of the brush to create.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to create."
		},
		{
			"directive": "param",
			"text": "target_size\tVector3\tThe target size of the brush to create.",
			"name": "target_size",
			"type": "Vector3",
			"description": "The target size of the brush to create."
		},
		{
			"directive": "returns",
			"text": "true,table,Vector3|false,string\tIf the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead.",
			"type": "true,table,Vector3|false,string",
			"description": "If the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead."
		}
	],
	"line": 5,
	"namespace": "worldeditadditions.sculpt",
	"line_last": 9,
	"name": "make_brush",
	"instanced": false,
	"args": [
		"brush_name",
		"target_size"
	],
	"text": "--- Makes a sculpting brush that is as close to a target size as possible.\n-- @param\tbrush_name\tstring\tThe name of the brush to create.\n-- @param\ttarget_size\tVector3\tThe target size of the brush to create.\n-- @returns\ttrue,table,Vector3|false,string\tIf the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead.\nlocal function make_brush(brush_name, target_size)",
	"params": [
		{
			"directive": "param",
			"text": "brush_name\tstring\tThe name of the brush to create.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to create."
		},
		{
			"directive": "param",
			"text": "target_size\tVector3\tThe target size of the brush to create.",
			"name": "target_size",
			"type": "Vector3",
			"description": "The target size of the brush to create."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "true,table,Vector3|false,string\tIf the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead.",
		"type": "true,table,Vector3|false,string",
		"description": "If the operation was successful, true followed by the brush in a 1D ZERO-indexed table followed by the actual size of the brush as a Vector3 (x & y components used only). If the operation was not successful, false and an error message string is returned instead."
	},
	"name_full": "worldeditadditions.sculpt.make_brush",
	"filename": "worldeditadditions/lib/sculpt/make_brush.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/sculpt/make_brush.lua#L6-L10"
}

--- Generates a textual preview of a given brush.
-- @param	brush		table	The brush in question to preview.
-- @param	size		Vector3	The size of the brush.
-- @returns	string		A preview of the brush as a string.
local function make_preview(brush, size, framed)

{
	"type": "function",
	"internal": false,
	"description": "Generates a textual preview of a given brush.",
	"directives": [
		{
			"directive": "param",
			"text": "brush\t\ttable\tThe brush in question to preview.",
			"name": "brush",
			"type": "table",
			"description": "The brush in question to preview."
		},
		{
			"directive": "param",
			"text": "size\t\tVector3\tThe size of the brush.",
			"name": "size",
			"type": "Vector3",
			"description": "The size of the brush."
		},
		{
			"directive": "returns",
			"text": "string\t\tA preview of the brush as a string.",
			"type": "string",
			"description": "A preview of the brush as a string."
		}
	],
	"line": 7,
	"namespace": "worldeditadditions.sculpt",
	"line_last": 11,
	"name": "make_preview",
	"instanced": false,
	"args": [
		"brush",
		"size",
		"framed"
	],
	"text": "--- Generates a textual preview of a given brush.\n-- @param\tbrush\t\ttable\tThe brush in question to preview.\n-- @param\tsize\t\tVector3\tThe size of the brush.\n-- @returns\tstring\t\tA preview of the brush as a string.\nlocal function make_preview(brush, size, framed)",
	"params": [
		{
			"directive": "param",
			"text": "brush\t\ttable\tThe brush in question to preview.",
			"name": "brush",
			"type": "table",
			"description": "The brush in question to preview."
		},
		{
			"directive": "param",
			"text": "size\t\tVector3\tThe size of the brush.",
			"name": "size",
			"type": "Vector3",
			"description": "The size of the brush."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "string\t\tA preview of the brush as a string.",
		"type": "string",
		"description": "A preview of the brush as a string."
	},
	"name_full": "worldeditadditions.sculpt.make_preview",
	"filename": "worldeditadditions/lib/sculpt/make_preview.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/sculpt/make_preview.lua#L8-L12"
}

--- Generates a textual preview of a given brush.
-- @param	brush_name	string	The name of the brush to create a preview for.
-- @param	target_size	Vector3	The target size of the brush to create. Default: (10, 10, 0).
-- @returns	bool,string	If the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead.
local function preview_brush(brush_name, target_size, framed)

{
	"type": "function",
	"internal": false,
	"description": "Generates a textual preview of a given brush.",
	"directives": [
		{
			"directive": "param",
			"text": "brush_name\tstring\tThe name of the brush to create a preview for.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to create a preview for."
		},
		{
			"directive": "param",
			"text": "target_size\tVector3\tThe target size of the brush to create. Default: (10, 10, 0).",
			"name": "target_size",
			"type": "Vector3",
			"description": "The target size of the brush to create. Default: (10, 10, 0)."
		},
		{
			"directive": "returns",
			"text": "bool,string\tIf the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead.",
			"type": "bool,string",
			"description": "If the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead."
		}
	],
	"line": 10,
	"namespace": "worldeditadditions.sculpt",
	"line_last": 14,
	"name": "preview_brush",
	"instanced": false,
	"args": [
		"brush_name",
		"target_size",
		"framed"
	],
	"text": "--- Generates a textual preview of a given brush.\n-- @param\tbrush_name\tstring\tThe name of the brush to create a preview for.\n-- @param\ttarget_size\tVector3\tThe target size of the brush to create. Default: (10, 10, 0).\n-- @returns\tbool,string\tIf the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead.\nlocal function preview_brush(brush_name, target_size, framed)",
	"params": [
		{
			"directive": "param",
			"text": "brush_name\tstring\tThe name of the brush to create a preview for.",
			"name": "brush_name",
			"type": "string",
			"description": "The name of the brush to create a preview for."
		},
		{
			"directive": "param",
			"text": "target_size\tVector3\tThe target size of the brush to create. Default: (10, 10, 0).",
			"name": "target_size",
			"type": "Vector3",
			"description": "The target size of the brush to create. Default: (10, 10, 0)."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool,string\tIf the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead.",
		"type": "bool,string",
		"description": "If the operation was successful, true followed by a preview of the brush as a string. If the operation was not successful, false and an error message string is returned instead."
	},
	"name_full": "worldeditadditions.sculpt.preview_brush",
	"filename": "worldeditadditions/lib/sculpt/preview_brush.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/sculpt/preview_brush.lua#L11-L15"
}

--- Additively adds a point to the current selection defined by pos1..pos2 or
-- makes a selection from the provided point.
-- @param	name	string	Player name.
-- @param	pos	vector	The position to include.
-- @returns	void
function selection.add_point(name, newpos)

{
	"type": "function",
	"internal": false,
	"description": "Additively adds a point to the current selection defined by pos1..pos2 or\nmakes a selection from the provided point.",
	"directives": [
		{
			"directive": "param",
			"text": "name\tstring\tPlayer name.",
			"name": "name",
			"type": "string",
			"description": "Player name."
		},
		{
			"directive": "param",
			"text": "pos\tvector\tThe position to include.",
			"name": "pos",
			"type": "vector",
			"description": "The position to include."
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 17,
	"namespace": "worldeditadditions.selection",
	"line_last": 22,
	"name": "add_point",
	"instanced": false,
	"args": [
		"name",
		"newpos"
	],
	"text": "--- Additively adds a point to the current selection defined by pos1..pos2 or\n-- makes a selection from the provided point.\n-- @param\tname\tstring\tPlayer name.\n-- @param\tpos\tvector\tThe position to include.\n-- @returns\tvoid\nfunction selection.add_point(name, newpos)",
	"params": [
		{
			"directive": "param",
			"text": "name\tstring\tPlayer name.",
			"name": "name",
			"type": "string",
			"description": "Player name."
		},
		{
			"directive": "param",
			"text": "pos\tvector\tThe position to include.",
			"name": "pos",
			"type": "vector",
			"description": "The position to include."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions.selection.add_point",
	"filename": "worldeditadditions/lib/selection/selection.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/selection/selection.lua#L18-L23"
}

--- Checks if a string is a valid axis.
-- @param	str	string	String to check (be sure to remove any + or -).
-- @param	hv	bool	Include "h" (general horizontal) and "v" (general vertical).
-- @return	bool	If string is a valid axis then true.
function selection.check_axis(str,hv)

{
	"type": "function",
	"internal": false,
	"description": "Checks if a string is a valid axis.",
	"directives": [
		{
			"directive": "param",
			"text": "str\tstring\tString to check (be sure to remove any + or -).",
			"name": "str",
			"type": "string",
			"description": "String to check (be sure to remove any + or -)."
		},
		{
			"directive": "param",
			"text": "hv\tbool\tInclude \"h\" (general horizontal) and \"v\" (general vertical).",
			"name": "hv",
			"type": "bool",
			"description": "Include \"h\" (general horizontal) and \"v\" (general vertical)."
		},
		{
			"directive": "returns",
			"text": "bool\tIf string is a valid axis then true.",
			"type": "bool",
			"description": "If string is a valid axis then true."
		}
	],
	"line": 81,
	"namespace": "worldeditadditions.selection",
	"line_last": 85,
	"name": "check_axis",
	"instanced": false,
	"args": [
		"str",
		"hv"
	],
	"text": "--- Checks if a string is a valid axis.\n-- @param\tstr\tstring\tString to check (be sure to remove any + or -).\n-- @param\thv\tbool\tInclude \"h\" (general horizontal) and \"v\" (general vertical).\n-- @return\tbool\tIf string is a valid axis then true.\nfunction selection.check_axis(str,hv)",
	"params": [
		{
			"directive": "param",
			"text": "str\tstring\tString to check (be sure to remove any + or -).",
			"name": "str",
			"type": "string",
			"description": "String to check (be sure to remove any + or -)."
		},
		{
			"directive": "param",
			"text": "hv\tbool\tInclude \"h\" (general horizontal) and \"v\" (general vertical).",
			"name": "hv",
			"type": "bool",
			"description": "Include \"h\" (general horizontal) and \"v\" (general vertical)."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tIf string is a valid axis then true.",
		"type": "bool",
		"description": "If string is a valid axis then true."
	},
	"name_full": "worldeditadditions.selection.check_axis",
	"filename": "worldeditadditions/lib/selection/selection.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/selection/selection.lua#L82-L86"
}

--- Checks if a string is a valid dir.
-- @param	str	string	String to check (be sure to remove any + or -).
-- @return	bool	If string is a valid dir then true.
function selection.check_dir(str)

{
	"type": "function",
	"internal": false,
	"description": "Checks if a string is a valid dir.",
	"directives": [
		{
			"directive": "param",
			"text": "str\tstring\tString to check (be sure to remove any + or -).",
			"name": "str",
			"type": "string",
			"description": "String to check (be sure to remove any + or -)."
		},
		{
			"directive": "returns",
			"text": "bool\tIf string is a valid dir then true.",
			"type": "bool",
			"description": "If string is a valid dir then true."
		}
	],
	"line": 93,
	"namespace": "worldeditadditions.selection",
	"line_last": 96,
	"name": "check_dir",
	"instanced": false,
	"args": [
		"str"
	],
	"text": "--- Checks if a string is a valid dir.\n-- @param\tstr\tstring\tString to check (be sure to remove any + or -).\n-- @return\tbool\tIf string is a valid dir then true.\nfunction selection.check_dir(str)",
	"params": [
		{
			"directive": "param",
			"text": "str\tstring\tString to check (be sure to remove any + or -).",
			"name": "str",
			"type": "string",
			"description": "String to check (be sure to remove any + or -)."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tIf string is a valid dir then true.",
		"type": "bool",
		"description": "If string is a valid dir then true."
	},
	"name_full": "worldeditadditions.selection.check_dir",
	"filename": "worldeditadditions/lib/selection/selection.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/selection/selection.lua#L94-L97"
}

--- Clears current selection, *but only pos1 and pos2!
-- @param	name	string	Player name.
-- @returns	void
function selection.clear_points(name)

{
	"type": "function",
	"internal": false,
	"description": "Clears current selection, *but only pos1 and pos2!",
	"directives": [
		{
			"directive": "param",
			"text": "name\tstring\tPlayer name.",
			"name": "name",
			"type": "string",
			"description": "Player name."
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 71,
	"namespace": "worldeditadditions.selection",
	"line_last": 74,
	"name": "clear_points",
	"instanced": false,
	"args": [
		"name"
	],
	"text": "--- Clears current selection, *but only pos1 and pos2!\n-- @param\tname\tstring\tPlayer name.\n-- @returns\tvoid\nfunction selection.clear_points(name)",
	"params": [
		{
			"directive": "param",
			"text": "name\tstring\tPlayer name.",
			"name": "name",
			"type": "string",
			"description": "Player name."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions.selection.clear_points",
	"filename": "worldeditadditions/lib/selection/selection.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions/lib/selection/selection.lua#L72-L75"
}

--- Add a new listener to the given named event.
-- @param	this		EventEmitter	The EventEmitter instance to add the listener to.
-- @param	event_name	string			The name of the event to listen on.
-- @param	func		function		The callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit().
-- @returns	number		The number of listeners attached to that event.
function EventEmitter.addEventListener(this, event_name, func)

{
	"type": "function",
	"internal": false,
	"description": "Add a new listener to the given named event.",
	"directives": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to add the listener to.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to add the listener to."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to listen on.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to listen on."
		},
		{
			"directive": "param",
			"text": "func\t\tfunction\t\tThe callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit().",
			"name": "func",
			"type": "function",
			"description": "The callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit()."
		},
		{
			"directive": "returns",
			"text": "number\t\tThe number of listeners attached to that event.",
			"type": "number",
			"description": "The number of listeners attached to that event."
		}
	],
	"line": 18,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 23,
	"name": "addEventListener",
	"instanced": false,
	"args": [
		"this",
		"event_name",
		"func"
	],
	"text": "--- Add a new listener to the given named event.\n-- @param\tthis\t\tEventEmitter\tThe EventEmitter instance to add the listener to.\n-- @param\tevent_name\tstring\t\t\tThe name of the event to listen on.\n-- @param\tfunc\t\tfunction\t\tThe callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit().\n-- @returns\tnumber\t\tThe number of listeners attached to that event.\nfunction EventEmitter.addEventListener(this, event_name, func)",
	"params": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to add the listener to.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to add the listener to."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to listen on.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to listen on."
		},
		{
			"directive": "param",
			"text": "func\t\tfunction\t\tThe callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit().",
			"name": "func",
			"type": "function",
			"description": "The callback function to call when the event is emitted. Will be passed a single argument - the object passed as the second argument to .emit()."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\t\tThe number of listeners attached to that event.",
		"type": "number",
		"description": "The number of listeners attached to that event."
	},
	"name_full": "worldeditadditions_core.EventEmitter.addEventListener",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L19-L24"
}

--- Clear all listeners from a given event name.
-- @param	this		EventEmitter	The EventEmitter instance to clear listeners from.
-- @param	event_name	string			The name of the event to clear the listeners from.
function EventEmitter.clear(this, event_name)

{
	"type": "function",
	"internal": false,
	"description": "Clear all listeners from a given event name.",
	"directives": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to clear listeners from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to clear the listeners from.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to clear the listeners from."
		}
	],
	"line": 73,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 76,
	"name": "clear",
	"instanced": false,
	"args": [
		"this",
		"event_name"
	],
	"text": "--- Clear all listeners from a given event name.\n-- @param\tthis\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.\n-- @param\tevent_name\tstring\t\t\tThe name of the event to clear the listeners from.\nfunction EventEmitter.clear(this, event_name)",
	"params": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to clear listeners from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to clear the listeners from.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to clear the listeners from."
		}
	],
	"name_full": "worldeditadditions_core.EventEmitter.clear",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L74-L77"
}

--- Clear all listeners.
-- @param	this		EventEmitter	The EventEmitter instance to clear listeners from.
function EventEmitter.clear_all(this, event_name)

{
	"type": "function",
	"internal": false,
	"description": "Clear all listeners.",
	"directives": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to clear listeners from."
		}
	],
	"line": 80,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 82,
	"name": "clear_all",
	"instanced": false,
	"args": [
		"this",
		"event_name"
	],
	"text": "--- Clear all listeners.\n-- @param\tthis\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.\nfunction EventEmitter.clear_all(this, event_name)",
	"params": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to clear listeners from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to clear listeners from."
		}
	],
	"name_full": "worldeditadditions_core.EventEmitter.clear_all",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L81-L83"
}

--- Emit an event.
-- @param	this		EventEmitter	The EventEmitter instance to emit the event from.
-- @param	event_name	string			The name of the event to emit.
-- @param	args		table|any		The argument(s) to pass to listener functions. It is strongly advised you pass a table here.
function EventEmitter.emit(this, event_name, args)

{
	"type": "function",
	"internal": false,
	"description": "Emit an event.",
	"directives": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to emit the event from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to emit the event from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to emit.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to emit."
		},
		{
			"directive": "param",
			"text": "args\t\ttable|any\t\tThe argument(s) to pass to listener functions. It is strongly advised you pass a table here.",
			"name": "args",
			"type": "table|any",
			"description": "The argument(s) to pass to listener functions. It is strongly advised you pass a table here."
		}
	],
	"line": 55,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 59,
	"name": "emit",
	"instanced": false,
	"args": [
		"this",
		"event_name",
		"args"
	],
	"text": "--- Emit an event.\n-- @param\tthis\t\tEventEmitter\tThe EventEmitter instance to emit the event from.\n-- @param\tevent_name\tstring\t\t\tThe name of the event to emit.\n-- @param\targs\t\ttable|any\t\tThe argument(s) to pass to listener functions. It is strongly advised you pass a table here.\nfunction EventEmitter.emit(this, event_name, args)",
	"params": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to emit the event from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to emit the event from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to emit.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to emit."
		},
		{
			"directive": "param",
			"text": "args\t\ttable|any\t\tThe argument(s) to pass to listener functions. It is strongly advised you pass a table here.",
			"name": "args",
			"type": "table|any",
			"description": "The argument(s) to pass to listener functions. It is strongly advised you pass a table here."
		}
	],
	"name_full": "worldeditadditions_core.EventEmitter.emit",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L56-L60"
}

--- Create a new event emitter.
-- @param	tbl	table|nil	Optional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!
-- @returns	table	The new EventEmitter object. If a table is passed in, a new table is NOT created.
function EventEmitter.new(tbl)

{
	"type": "function",
	"internal": false,
	"description": "Create a new event emitter.",
	"directives": [
		{
			"directive": "param",
			"text": "tbl\ttable|nil\tOptional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!",
			"name": "tbl",
			"type": "table|nil",
			"description": "Optional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!"
		},
		{
			"directive": "returns",
			"text": "table\tThe new EventEmitter object. If a table is passed in, a new table is NOT created.",
			"type": "table",
			"description": "The new EventEmitter object. If a table is passed in, a new table is NOT created."
		}
	],
	"line": 7,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 10,
	"name": "new",
	"instanced": false,
	"args": [
		"tbl"
	],
	"text": "--- Create a new event emitter.\n-- @param\ttbl\ttable|nil\tOptional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!\n-- @returns\ttable\tThe new EventEmitter object. If a table is passed in, a new table is NOT created.\nfunction EventEmitter.new(tbl)",
	"params": [
		{
			"directive": "param",
			"text": "tbl\ttable|nil\tOptional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!",
			"name": "tbl",
			"type": "table|nil",
			"description": "Optional. A table to base the new EventEmitter object on. EventEmitter will attach ann instance of itself to this object. The 'events' property on the object MUST NOT be set. IT WILL BE OVERWRITTEN!"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "table\tThe new EventEmitter object. If a table is passed in, a new table is NOT created.",
		"type": "table",
		"description": "The new EventEmitter object. If a table is passed in, a new table is NOT created."
	},
	"name_full": "worldeditadditions_core.EventEmitter.new",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L8-L11"
}

--- Remove an existing listener from the given named event.
-- @param	this		EventEmitter	The EventEmitter instance to remove the listener from.
-- @param	event_name	string			The name of the event to remove from.
-- @param	func		function		The callback function to remove from the list of listeners for the given named event.
-- @return	bool		Whether it was actually removed or not. False means it failed to find the given listener function.
function EventEmitter.removeEventListener(this, event_name, func)

{
	"type": "function",
	"internal": false,
	"description": "Remove an existing listener from the given named event.",
	"directives": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to remove the listener from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to remove the listener from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to remove from.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to remove from."
		},
		{
			"directive": "param",
			"text": "func\t\tfunction\t\tThe callback function to remove from the list of listeners for the given named event.",
			"name": "func",
			"type": "function",
			"description": "The callback function to remove from the list of listeners for the given named event."
		},
		{
			"directive": "returns",
			"text": "bool\t\tWhether it was actually removed or not. False means it failed to find the given listener function.",
			"type": "bool",
			"description": "Whether it was actually removed or not. False means it failed to find the given listener function."
		}
	],
	"line": 36,
	"namespace": "worldeditadditions_core.EventEmitter",
	"line_last": 41,
	"name": "removeEventListener",
	"instanced": false,
	"args": [
		"this",
		"event_name",
		"func"
	],
	"text": "--- Remove an existing listener from the given named event.\n-- @param\tthis\t\tEventEmitter\tThe EventEmitter instance to remove the listener from.\n-- @param\tevent_name\tstring\t\t\tThe name of the event to remove from.\n-- @param\tfunc\t\tfunction\t\tThe callback function to remove from the list of listeners for the given named event.\n-- @return\tbool\t\tWhether it was actually removed or not. False means it failed to find the given listener function.\nfunction EventEmitter.removeEventListener(this, event_name, func)",
	"params": [
		{
			"directive": "param",
			"text": "this\t\tEventEmitter\tThe EventEmitter instance to remove the listener from.",
			"name": "this",
			"type": "EventEmitter",
			"description": "The EventEmitter instance to remove the listener from."
		},
		{
			"directive": "param",
			"text": "event_name\tstring\t\t\tThe name of the event to remove from.",
			"name": "event_name",
			"type": "string",
			"description": "The name of the event to remove from."
		},
		{
			"directive": "param",
			"text": "func\t\tfunction\t\tThe callback function to remove from the list of listeners for the given named event.",
			"name": "func",
			"type": "function",
			"description": "The callback function to remove from the list of listeners for the given named event."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\tWhether it was actually removed or not. False means it failed to find the given listener function.",
		"type": "bool",
		"description": "Whether it was actually removed or not. False means it failed to find the given listener function."
	},
	"name_full": "worldeditadditions_core.EventEmitter.removeEventListener",
	"filename": "worldeditadditions_core/utils/EventEmitter.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/EventEmitter.lua#L37-L42"
}

--- Determines whether this face is equal to another face or not.
-- @param	a	Face	The first face to compare.
-- @param	b	Face	The second face to compare.
-- @returns	bool		Whether the 2 faces are equal or not.
function Face.equal(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Determines whether this face is equal to another face or not.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tFace\tThe first face to compare.",
			"name": "a",
			"type": "Face",
			"description": "The first face to compare."
		},
		{
			"directive": "param",
			"text": "b\tFace\tThe second face to compare.",
			"name": "b",
			"type": "Face",
			"description": "The second face to compare."
		},
		{
			"directive": "returns",
			"text": "bool\t\tWhether the 2 faces are equal or not.",
			"type": "bool",
			"description": "Whether the 2 faces are equal or not."
		}
	],
	"line": 23,
	"namespace": "worldeditadditions_core.Face",
	"line_last": 27,
	"name": "equal",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Determines whether this face is equal to another face or not.\n-- @param\ta\tFace\tThe first face to compare.\n-- @param\tb\tFace\tThe second face to compare.\n-- @returns\tbool\t\tWhether the 2 faces are equal or not.\nfunction Face.equal(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\tFace\tThe first face to compare.",
			"name": "a",
			"type": "Face",
			"description": "The first face to compare."
		},
		{
			"directive": "param",
			"text": "b\tFace\tThe second face to compare.",
			"name": "b",
			"type": "Face",
			"description": "The second face to compare."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\tWhether the 2 faces are equal or not.",
		"type": "bool",
		"description": "Whether the 2 faces are equal or not."
	},
	"name_full": "worldeditadditions_core.Face.equal",
	"filename": "worldeditadditions_core/utils/mesh.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/mesh.lua#L24-L28"
}

--- Creates a new face from a list of vertices.
-- The list of vertices should be anti-clockwise.
-- @param	vertices	Vector3[]	A list of Vector3 vertices that define the face.
function Face.new(vertices)

{
	"type": "function",
	"internal": false,
	"description": "Creates a new face from a list of vertices.\nThe list of vertices should be anti-clockwise.",
	"directives": [
		{
			"directive": "param",
			"text": "vertices\tVector3[]\tA list of Vector3 vertices that define the face.",
			"name": "vertices",
			"type": "Vector3[]",
			"description": "A list of Vector3 vertices that define the face."
		}
	],
	"line": 14,
	"namespace": "worldeditadditions_core.Face",
	"line_last": 17,
	"name": "new",
	"instanced": false,
	"args": [
		"vertices"
	],
	"text": "--- Creates a new face from a list of vertices.\n-- The list of vertices should be anti-clockwise.\n-- @param\tvertices\tVector3[]\tA list of Vector3 vertices that define the face.\nfunction Face.new(vertices)",
	"params": [
		{
			"directive": "param",
			"text": "vertices\tVector3[]\tA list of Vector3 vertices that define the face.",
			"name": "vertices",
			"type": "Vector3[]",
			"description": "A list of Vector3 vertices that define the face."
		}
	],
	"name_full": "worldeditadditions_core.Face.new",
	"filename": "worldeditadditions_core/utils/mesh.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/mesh.lua#L15-L18"
}

--- Gets the value associated with the given key.
-- @param	key		string	The key to retrieve the value for.
-- @returns	any|nil	The value associated with the given key, or nil if it doesn't exist in this cache.
function LRU:get(key)

{
	"type": "function",
	"internal": false,
	"description": "Gets the value associated with the given key.",
	"directives": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key to retrieve the value for.",
			"name": "key",
			"type": "string",
			"description": "The key to retrieve the value for."
		},
		{
			"directive": "returns",
			"text": "any|nil\tThe value associated with the given key, or nil if it doesn't exist in this cache.",
			"type": "any|nil",
			"description": "The value associated with the given key, or nil if it doesn't exist in this cache."
		}
	],
	"line": 36,
	"namespace": "worldeditadditions_core.LRU",
	"line_last": 39,
	"name": "get",
	"instanced": true,
	"args": [
		"key"
	],
	"text": "--- Gets the value associated with the given key.\n-- @param\tkey\t\tstring\tThe key to retrieve the value for.\n-- @returns\tany|nil\tThe value associated with the given key, or nil if it doesn't exist in this cache.\nfunction LRU:get(key)",
	"params": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key to retrieve the value for.",
			"name": "key",
			"type": "string",
			"description": "The key to retrieve the value for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "any|nil\tThe value associated with the given key, or nil if it doesn't exist in this cache.",
		"type": "any|nil",
		"description": "The value associated with the given key, or nil if it doesn't exist in this cache."
	},
	"name_full": "worldeditadditions_core.LRU.get",
	"filename": "worldeditadditions_core/utils/lru.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/lru.lua#L37-L40"
}

--- Determines whether the given key is present in this cache object.
-- Does NOT update the most recently used status of said key.
-- @param	key		string	The key to check.
-- @returns	bool	Whether the given key exists in the cache or not.
function LRU:has(key)

{
	"type": "function",
	"internal": false,
	"description": "Determines whether the given key is present in this cache object.\nDoes NOT update the most recently used status of said key.",
	"directives": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key to check.",
			"name": "key",
			"type": "string",
			"description": "The key to check."
		},
		{
			"directive": "returns",
			"text": "bool\tWhether the given key exists in the cache or not.",
			"type": "bool",
			"description": "Whether the given key exists in the cache or not."
		}
	],
	"line": 28,
	"namespace": "worldeditadditions_core.LRU",
	"line_last": 32,
	"name": "has",
	"instanced": true,
	"args": [
		"key"
	],
	"text": "--- Determines whether the given key is present in this cache object.\n-- Does NOT update the most recently used status of said key.\n-- @param\tkey\t\tstring\tThe key to check.\n-- @returns\tbool\tWhether the given key exists in the cache or not.\nfunction LRU:has(key)",
	"params": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key to check.",
			"name": "key",
			"type": "string",
			"description": "The key to check."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tWhether the given key exists in the cache or not.",
		"type": "bool",
		"description": "Whether the given key exists in the cache or not."
	},
	"name_full": "worldeditadditions_core.LRU.has",
	"filename": "worldeditadditions_core/utils/lru.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/lru.lua#L29-L33"
}

--- Creates a new LRU cache.
-- Optimal sizes: 8, 16, 32, 64 or any value above
-- @param	max_size=32		number	The maximum number of items to store in the cache.
-- @returns	LRU				A new LRU cache.
function LRU.new(max_size)

{
	"type": "function",
	"internal": false,
	"description": "Creates a new LRU cache.\nOptimal sizes: 8, 16, 32, 64 or any value above",
	"directives": [
		{
			"directive": "param",
			"text": "max_size=32\t\tnumber\tThe maximum number of items to store in the cache.",
			"name": "max_size",
			"type": "number",
			"description": "The maximum number of items to store in the cache.",
			"default_value": "32"
		},
		{
			"directive": "returns",
			"text": "LRU\t\t\t\tA new LRU cache.",
			"type": "LRU",
			"description": "A new LRU cache."
		}
	],
	"line": 12,
	"namespace": "worldeditadditions_core.LRU",
	"line_last": 16,
	"name": "new",
	"instanced": false,
	"args": [
		"max_size"
	],
	"text": "--- Creates a new LRU cache.\n-- Optimal sizes: 8, 16, 32, 64 or any value above\n-- @param\tmax_size=32\t\tnumber\tThe maximum number of items to store in the cache.\n-- @returns\tLRU\t\t\t\tA new LRU cache.\nfunction LRU.new(max_size)",
	"params": [
		{
			"directive": "param",
			"text": "max_size=32\t\tnumber\tThe maximum number of items to store in the cache.",
			"name": "max_size",
			"type": "number",
			"description": "The maximum number of items to store in the cache.",
			"default_value": "32"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "LRU\t\t\t\tA new LRU cache.",
		"type": "LRU",
		"description": "A new LRU cache."
	},
	"name_full": "worldeditadditions_core.LRU.new",
	"filename": "worldeditadditions_core/utils/lru.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/lru.lua#L13-L17"
}

--- Adds a given key-value pair to this cache.
-- Note that this might (or might not) result in the eviction of another item.
-- @param	key		string	The key of the item to add.
-- @param	value	any		The value to associate with the given key.
-- @returns nil
function LRU:set(key, value)

{
	"type": "function",
	"internal": false,
	"description": "Adds a given key-value pair to this cache.\nNote that this might (or might not) result in the eviction of another item.",
	"directives": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key of the item to add.",
			"name": "key",
			"type": "string",
			"description": "The key of the item to add."
		},
		{
			"directive": "param",
			"text": "value\tany\t\tThe value to associate with the given key.",
			"name": "value",
			"type": "any",
			"description": "The value to associate with the given key."
		},
		{
			"directive": "returns",
			"text": "nil",
			"type": "nil"
		}
	],
	"line": 49,
	"namespace": "worldeditadditions_core.LRU",
	"line_last": 54,
	"name": "set",
	"instanced": true,
	"args": [
		"key",
		"value"
	],
	"text": "--- Adds a given key-value pair to this cache.\n-- Note that this might (or might not) result in the eviction of another item.\n-- @param\tkey\t\tstring\tThe key of the item to add.\n-- @param\tvalue\tany\t\tThe value to associate with the given key.\n-- @returns nil\nfunction LRU:set(key, value)",
	"params": [
		{
			"directive": "param",
			"text": "key\t\tstring\tThe key of the item to add.",
			"name": "key",
			"type": "string",
			"description": "The key of the item to add."
		},
		{
			"directive": "param",
			"text": "value\tany\t\tThe value to associate with the given key.",
			"name": "value",
			"type": "any",
			"description": "The value to associate with the given key."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "nil",
		"type": "nil"
	},
	"name_full": "worldeditadditions_core.LRU.set",
	"filename": "worldeditadditions_core/utils/lru.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/lru.lua#L50-L55"
}

--- Adds a face to this mesh.
-- @param	self	Mesh	The mesh instance to operate on.
-- @param	face	Face	The face to add.
-- @returns	void
function Mesh.add_face(self, face)

{
	"type": "function",
	"internal": false,
	"description": "Adds a face to this mesh.",
	"directives": [
		{
			"directive": "param",
			"text": "self\tMesh\tThe mesh instance to operate on.",
			"name": "self",
			"type": "Mesh",
			"description": "The mesh instance to operate on."
		},
		{
			"directive": "param",
			"text": "face\tFace\tThe face to add.",
			"name": "face",
			"type": "Face",
			"description": "The face to add."
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 55,
	"namespace": "worldeditadditions_core.Mesh",
	"line_last": 59,
	"name": "add_face",
	"instanced": false,
	"args": [
		"self",
		"face"
	],
	"text": "--- Adds a face to this mesh.\n-- @param\tself\tMesh\tThe mesh instance to operate on.\n-- @param\tface\tFace\tThe face to add.\n-- @returns\tvoid\nfunction Mesh.add_face(self, face)",
	"params": [
		{
			"directive": "param",
			"text": "self\tMesh\tThe mesh instance to operate on.",
			"name": "self",
			"type": "Mesh",
			"description": "The mesh instance to operate on."
		},
		{
			"directive": "param",
			"text": "face\tFace\tThe face to add.",
			"name": "face",
			"type": "Face",
			"description": "The face to add."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions_core.Mesh.add_face",
	"filename": "worldeditadditions_core/utils/mesh.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/mesh.lua#L56-L60"
}

--- Deduplicate the list of faces in this Mesh.
-- Removes all faces that are exactly equal to one another. This reduces the
-- filesize.
-- @returns	number	The number of faces removed.
function Mesh.dedupe(self)

{
	"type": "function",
	"internal": false,
	"description": "Deduplicate the list of faces in this Mesh.\nRemoves all faces that are exactly equal to one another. This reduces the\nfilesize.",
	"directives": [
		{
			"directive": "returns",
			"text": "number\tThe number of faces removed.",
			"type": "number",
			"description": "The number of faces removed."
		}
	],
	"line": 63,
	"namespace": "worldeditadditions_core.Mesh",
	"line_last": 67,
	"name": "dedupe",
	"instanced": false,
	"args": [
		"self"
	],
	"text": "--- Deduplicate the list of faces in this Mesh.\n-- Removes all faces that are exactly equal to one another. This reduces the\n-- filesize.\n-- @returns\tnumber\tThe number of faces removed.\nfunction Mesh.dedupe(self)",
	"params": [],
	"returns": {
		"directive": "returns",
		"text": "number\tThe number of faces removed.",
		"type": "number",
		"description": "The number of faces removed."
	},
	"name_full": "worldeditadditions_core.Mesh.dedupe",
	"filename": "worldeditadditions_core/utils/mesh.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/mesh.lua#L64-L68"
}

--- Creates a new empty mesh object container.
-- @returns	Mesh
function Mesh.new()

{
	"type": "function",
	"internal": false,
	"description": "Creates a new empty mesh object container.",
	"directives": [
		{
			"directive": "returns",
			"text": "Mesh",
			"type": "Mesh"
		}
	],
	"line": 48,
	"namespace": "worldeditadditions_core.Mesh",
	"line_last": 50,
	"name": "new",
	"instanced": false,
	"args": [
		""
	],
	"text": "--- Creates a new empty mesh object container.\n-- @returns\tMesh\nfunction Mesh.new()",
	"params": [],
	"returns": {
		"directive": "returns",
		"text": "Mesh",
		"type": "Mesh"
	},
	"name_full": "worldeditadditions_core.Mesh.new",
	"filename": "worldeditadditions_core/utils/mesh.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/mesh.lua#L49-L51"
}

--- Parses a list of node names, accounting for special keywords and group names.
-- @param	nodelist	string[]	The list of nodes to parse.
-- @returns	bool,string|table<string|function|number>	A success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.
-- 
-- Different data types in the parsed nodelist mean different things:
-- 
-- - **string:** The name of a group
-- - **function:** A special function to call with the node id to match against as the first and only argument.
-- - **number:** The id of the node to check against.
local function __parse_nodelist(nodelist)

{
	"type": "function",
	"internal": false,
	"description": "Parses a list of node names, accounting for special keywords and group names.",
	"directives": [
		{
			"directive": "param",
			"text": "nodelist\tstring[]\tThe list of nodes to parse.",
			"name": "nodelist",
			"type": "string[]",
			"description": "The list of nodes to parse."
		},
		{
			"directive": "returns",
			"text": "bool,string|table<string|function|number>\tA success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.\n\nDifferent data types in the parsed nodelist mean different things:\n\n- **string:** The name of a group\n- **function:** A special function to call with the node id to match against as the first and only argument.\n- **number:** The id of the node to check against.",
			"type": "bool,string|table<string|function|number>",
			"description": "A success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.\n\nDifferent data types in the parsed nodelist mean different things:\n\n- **string:** The name of a group\n- **function:** A special function to call with the node id to match against as the first and only argument.\n- **number:** The id of the node to check against."
		}
	],
	"line": 19,
	"namespace": "worldeditadditions_core.NodeListMatcher",
	"line_last": 28,
	"name": "__parse_nodelist",
	"instanced": false,
	"args": [
		"nodelist"
	],
	"text": "--- Parses a list of node names, accounting for special keywords and group names.\n-- @param\tnodelist\tstring[]\tThe list of nodes to parse.\n-- @returns\tbool,string|table<string|function|number>\tA success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.\n-- \n-- Different data types in the parsed nodelist mean different things:\n-- \n-- - **string:** The name of a group\n-- - **function:** A special function to call with the node id to match against as the first and only argument.\n-- - **number:** The id of the node to check against.\nlocal function __parse_nodelist(nodelist)",
	"params": [
		{
			"directive": "param",
			"text": "nodelist\tstring[]\tThe list of nodes to parse.",
			"name": "nodelist",
			"type": "string[]",
			"description": "The list of nodes to parse."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool,string|table<string|function|number>\tA success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.\n\nDifferent data types in the parsed nodelist mean different things:\n\n- **string:** The name of a group\n- **function:** A special function to call with the node id to match against as the first and only argument.\n- **number:** The id of the node to check against.",
		"type": "bool,string|table<string|function|number>",
		"description": "A success bool (true = success), followed by eitheran error string if success == false or the parsed nodelist if success == true.\n\nDifferent data types in the parsed nodelist mean different things:\n\n- **string:** The name of a group\n- **function:** A special function to call with the node id to match against as the first and only argument.\n- **number:** The id of the node to check against."
	},
	"name_full": "worldeditadditions_core.NodeListMatcher.__parse_nodelist",
	"filename": "worldeditadditions_core/utils/NodeListMatcher.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/NodeListMatcher.lua#L20-L29"
}

--- Determines if the given node id has the given group name.
-- Caches the result for performance. You probably want NodeListMatcher:match_id(node_id).
-- @param	matcher		NodeListMatcher		The NodeListMatcher instance to use to make the query.
-- @param	node_id		number				The numerical id of the node to check.
-- @param	group_name	string				The name of the group to check if the given node id has.
-- @returns	bool		True if the given node id belongs to the specified group, and false if it does not.
function NodeListMatcher.match_group(matcher, node_id, group_name)

{
	"type": "function",
	"internal": false,
	"description": "Determines if the given node id has the given group name.\nCaches the result for performance. You probably want NodeListMatcher:match_id(node_id).",
	"directives": [
		{
			"directive": "param",
			"text": "matcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to use to make the query.",
			"name": "matcher",
			"type": "NodeListMatcher",
			"description": "The NodeListMatcher instance to use to make the query."
		},
		{
			"directive": "param",
			"text": "node_id\t\tnumber\t\t\t\tThe numerical id of the node to check.",
			"name": "node_id",
			"type": "number",
			"description": "The numerical id of the node to check."
		},
		{
			"directive": "param",
			"text": "group_name\tstring\t\t\t\tThe name of the group to check if the given node id has.",
			"name": "group_name",
			"type": "string",
			"description": "The name of the group to check if the given node id has."
		},
		{
			"directive": "returns",
			"text": "bool\t\tTrue if the given node id belongs to the specified group, and false if it does not.",
			"type": "bool",
			"description": "True if the given node id belongs to the specified group, and false if it does not."
		}
	],
	"line": 99,
	"namespace": "worldeditadditions_core.NodeListMatcher",
	"line_last": 105,
	"name": "match_group",
	"instanced": false,
	"args": [
		"matcher",
		"node_id",
		"group_name"
	],
	"text": "--- Determines if the given node id has the given group name.\n-- Caches the result for performance. You probably want NodeListMatcher:match_id(node_id).\n-- @param\tmatcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to use to make the query.\n-- @param\tnode_id\t\tnumber\t\t\t\tThe numerical id of the node to check.\n-- @param\tgroup_name\tstring\t\t\t\tThe name of the group to check if the given node id has.\n-- @returns\tbool\t\tTrue if the given node id belongs to the specified group, and false if it does not.\nfunction NodeListMatcher.match_group(matcher, node_id, group_name)",
	"params": [
		{
			"directive": "param",
			"text": "matcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to use to make the query.",
			"name": "matcher",
			"type": "NodeListMatcher",
			"description": "The NodeListMatcher instance to use to make the query."
		},
		{
			"directive": "param",
			"text": "node_id\t\tnumber\t\t\t\tThe numerical id of the node to check.",
			"name": "node_id",
			"type": "number",
			"description": "The numerical id of the node to check."
		},
		{
			"directive": "param",
			"text": "group_name\tstring\t\t\t\tThe name of the group to check if the given node id has.",
			"name": "group_name",
			"type": "string",
			"description": "The name of the group to check if the given node id has."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\tTrue if the given node id belongs to the specified group, and false if it does not.",
		"type": "bool",
		"description": "True if the given node id belongs to the specified group, and false if it does not."
	},
	"name_full": "worldeditadditions_core.NodeListMatcher.match_group",
	"filename": "worldeditadditions_core/utils/NodeListMatcher.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/NodeListMatcher.lua#L100-L106"
}

--- Matches the given node id against the nodelist provided at the instantiation of this NodeListMatcher instance.
-- Returns true if the given node_id matches against any one of the items in the nodelist. In other words, performs a logical OR operation.
-- 
-- We use the term 'item' and not 'node' here since not all items in the nodelist are nodes: nodelists support special keywords such as 'liquidlike' and 'airlike', as well as group names (prefixed with an at sign @).
-- @param	matcher		NodeListMatcher		The NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there).
-- @param	node_id		number				The numerical id of the node to match against the internal nodelist.
-- @returns	bool		True if the given node id matches against any of the items in the nodelist.
function NodeListMatcher.match_id(matcher, node_id)

{
	"type": "function",
	"internal": false,
	"description": "Matches the given node id against the nodelist provided at the instantiation of this NodeListMatcher instance.\nReturns true if the given node_id matches against any one of the items in the nodelist. In other words, performs a logical OR operation.\n\nWe use the term 'item' and not 'node' here since not all items in the nodelist are nodes: nodelists support special keywords such as 'liquidlike' and 'airlike', as well as group names (prefixed with an at sign @).",
	"directives": [
		{
			"directive": "param",
			"text": "matcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there).",
			"name": "matcher",
			"type": "NodeListMatcher",
			"description": "The NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there)."
		},
		{
			"directive": "param",
			"text": "node_id\t\tnumber\t\t\t\tThe numerical id of the node to match against the internal nodelist.",
			"name": "node_id",
			"type": "number",
			"description": "The numerical id of the node to match against the internal nodelist."
		},
		{
			"directive": "returns",
			"text": "bool\t\tTrue if the given node id matches against any of the items in the nodelist.",
			"type": "bool",
			"description": "True if the given node id matches against any of the items in the nodelist."
		}
	],
	"line": 73,
	"namespace": "worldeditadditions_core.NodeListMatcher",
	"line_last": 80,
	"name": "match_id",
	"instanced": false,
	"args": [
		"matcher",
		"node_id"
	],
	"text": "--- Matches the given node id against the nodelist provided at the instantiation of this NodeListMatcher instance.\n-- Returns true if the given node_id matches against any one of the items in the nodelist. In other words, performs a logical OR operation.\n-- \n-- We use the term 'item' and not 'node' here since not all items in the nodelist are nodes: nodelists support special keywords such as 'liquidlike' and 'airlike', as well as group names (prefixed with an at sign @).\n-- @param\tmatcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there).\n-- @param\tnode_id\t\tnumber\t\t\t\tThe numerical id of the node to match against the internal nodelist.\n-- @returns\tbool\t\tTrue if the given node id matches against any of the items in the nodelist.\nfunction NodeListMatcher.match_id(matcher, node_id)",
	"params": [
		{
			"directive": "param",
			"text": "matcher\t\tNodeListMatcher\t\tThe NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there).",
			"name": "matcher",
			"type": "NodeListMatcher",
			"description": "The NodeListMatcher instance to query against. Use some_matcher:match_id(node_id) to avoid specifying this manually (note the colon : and not a dot . there)."
		},
		{
			"directive": "param",
			"text": "node_id\t\tnumber\t\t\t\tThe numerical id of the node to match against the internal nodelist.",
			"name": "node_id",
			"type": "number",
			"description": "The numerical id of the node to match against the internal nodelist."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\tTrue if the given node id matches against any of the items in the nodelist.",
		"type": "bool",
		"description": "True if the given node id matches against any of the items in the nodelist."
	},
	"name_full": "worldeditadditions_core.NodeListMatcher.match_id",
	"filename": "worldeditadditions_core/utils/NodeListMatcher.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/NodeListMatcher.lua#L74-L81"
}

--- Creates a new NodeListMatcher instance with the given node list.
-- Once created, you probably want to call the :match_id(node_id) function.
-- @param	nodelist	string[]	The list of nodes to match against.
-- 
-- `airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.
-- 
-- Node names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group.
-- @returns	bool,string|NodeListMatcher			A success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance.
function NodeListMatcher.new(nodelist)

{
	"type": "function",
	"internal": false,
	"description": "Creates a new NodeListMatcher instance with the given node list.\nOnce created, you probably want to call the :match_id(node_id) function.",
	"directives": [
		{
			"directive": "param",
			"text": "nodelist\tstring[]\tThe list of nodes to match against.\n\n`airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.\n\nNode names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group.",
			"name": "nodelist",
			"type": "string[]",
			"description": "The list of nodes to match against.\n\n`airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.\n\nNode names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group."
		},
		{
			"directive": "returns",
			"text": "bool,string|NodeListMatcher\t\t\tA success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance.",
			"type": "bool,string|NodeListMatcher",
			"description": "A success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance."
		}
	],
	"line": 51,
	"namespace": "worldeditadditions_core.NodeListMatcher",
	"line_last": 59,
	"name": "new",
	"instanced": false,
	"args": [
		"nodelist"
	],
	"text": "--- Creates a new NodeListMatcher instance with the given node list.\n-- Once created, you probably want to call the :match_id(node_id) function.\n-- @param\tnodelist\tstring[]\tThe list of nodes to match against.\n-- \n-- `airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.\n-- \n-- Node names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group.\n-- @returns\tbool,string|NodeListMatcher\t\t\tA success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance.\nfunction NodeListMatcher.new(nodelist)",
	"params": [
		{
			"directive": "param",
			"text": "nodelist\tstring[]\tThe list of nodes to match against.\n\n`airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.\n\nNode names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group.",
			"name": "nodelist",
			"type": "string[]",
			"description": "The list of nodes to match against.\n\n`airlike` and `liquidlike` are special keywords that instead check if a given node id behaves like air or a liquid respectively.\n\nNode names prefixed with an at sign (@) are considered group names, and given node ids are checked for membership of the given group."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool,string|NodeListMatcher\t\t\tA success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance.",
		"type": "bool,string|NodeListMatcher",
		"description": "A success bool (true == success), and then either a string (if succes == false) or otherwise the newly created NodeListMatcher instance."
	},
	"name_full": "worldeditadditions_core.NodeListMatcher.new",
	"filename": "worldeditadditions_core/utils/NodeListMatcher.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/NodeListMatcher.lua#L52-L60"
}

--- Parses a chance value, and returns the 1-in-N value thereof.
-- @param	str		string	The string to parse.
-- @param	mode	string	The operation mode. Valid modes: "1-in-n" (default), "weight". "1-in-n" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). "weight", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood).
-- @returns	number|nil	The 1-in-N chance if parsing was successful, otherwise nil.
local function parse_chance(str, mode)

{
	"type": "function",
	"internal": false,
	"description": "Parses a chance value, and returns the 1-in-N value thereof.",
	"directives": [
		{
			"directive": "param",
			"text": "str\t\tstring\tThe string to parse.",
			"name": "str",
			"type": "string",
			"description": "The string to parse."
		},
		{
			"directive": "param",
			"text": "mode\tstring\tThe operation mode. Valid modes: \"1-in-n\" (default), \"weight\". \"1-in-n\" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). \"weight\", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood).",
			"name": "mode",
			"type": "string",
			"description": "The operation mode. Valid modes: \"1-in-n\" (default), \"weight\". \"1-in-n\" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). \"weight\", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood)."
		},
		{
			"directive": "returns",
			"text": "number|nil\tThe 1-in-N chance if parsing was successful, otherwise nil.",
			"type": "number|nil",
			"description": "The 1-in-N chance if parsing was successful, otherwise nil."
		}
	],
	"line": 5,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 9,
	"name": "parse_chance",
	"instanced": false,
	"args": [
		"str",
		"mode"
	],
	"text": "--- Parses a chance value, and returns the 1-in-N value thereof.\n-- @param\tstr\t\tstring\tThe string to parse.\n-- @param\tmode\tstring\tThe operation mode. Valid modes: \"1-in-n\" (default), \"weight\". \"1-in-n\" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). \"weight\", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood).\n-- @returns\tnumber|nil\tThe 1-in-N chance if parsing was successful, otherwise nil.\nlocal function parse_chance(str, mode)",
	"params": [
		{
			"directive": "param",
			"text": "str\t\tstring\tThe string to parse.",
			"name": "str",
			"type": "string",
			"description": "The string to parse."
		},
		{
			"directive": "param",
			"text": "mode\tstring\tThe operation mode. Valid modes: \"1-in-n\" (default), \"weight\". \"1-in-n\" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). \"weight\", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood).",
			"name": "mode",
			"type": "string",
			"description": "The operation mode. Valid modes: \"1-in-n\" (default), \"weight\". \"1-in-n\" refers to a 1-in-N chance of something happening (lower numbers mean greater likelihood). \"weight\", on the other hand, is instead a weighting that something will happen (higher numbers mean a greater likelihood)."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number|nil\tThe 1-in-N chance if parsing was successful, otherwise nil.",
		"type": "number|nil",
		"description": "The 1-in-N chance if parsing was successful, otherwise nil."
	},
	"name_full": "worldeditadditions_core.parse.parse_chance",
	"filename": "worldeditadditions_core/utils/parse/chance.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/chance.lua#L6-L10"
}

--- Parses a map of key-value pairs into a table.
-- For example, "count 25000 speed 0.8 rate_erosion 0.006 doawesome true" would be parsed into
-- the following table: { count = 25000, speed = 0.8, rate_erosion = 0.006, doawesome = true }.
-- @param	params_text	string		The string to parse.
-- @param	keywords	string[]?	Optional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true.
-- @returns	table		A table of key-value pairs parsed out from the given string.
local function parse_map(params_text, keywords)

{
	"type": "function",
	"internal": false,
	"description": "Parses a map of key-value pairs into a table.\nFor example, \"count 25000 speed 0.8 rate_erosion 0.006 doawesome true\" would be parsed into\nthe following table: { count = 25000, speed = 0.8, rate_erosion = 0.006, doawesome = true }.",
	"directives": [
		{
			"directive": "param",
			"text": "params_text\tstring\t\tThe string to parse.",
			"name": "params_text",
			"type": "string",
			"description": "The string to parse."
		},
		{
			"directive": "param",
			"text": "keywords\tstring[]?\tOptional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true.",
			"name": "keywords",
			"type": "string[]?",
			"description": "Optional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true."
		},
		{
			"directive": "returns",
			"text": "table\t\tA table of key-value pairs parsed out from the given string.",
			"type": "table",
			"description": "A table of key-value pairs parsed out from the given string."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 12,
	"name": "parse_map",
	"instanced": false,
	"args": [
		"params_text",
		"keywords"
	],
	"text": "--- Parses a map of key-value pairs into a table.\n-- For example, \"count 25000 speed 0.8 rate_erosion 0.006 doawesome true\" would be parsed into\n-- the following table: { count = 25000, speed = 0.8, rate_erosion = 0.006, doawesome = true }.\n-- @param\tparams_text\tstring\t\tThe string to parse.\n-- @param\tkeywords\tstring[]?\tOptional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true.\n-- @returns\ttable\t\tA table of key-value pairs parsed out from the given string.\nlocal function parse_map(params_text, keywords)",
	"params": [
		{
			"directive": "param",
			"text": "params_text\tstring\t\tThe string to parse.",
			"name": "params_text",
			"type": "string",
			"description": "The string to parse."
		},
		{
			"directive": "param",
			"text": "keywords\tstring[]?\tOptional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true.",
			"name": "keywords",
			"type": "string[]?",
			"description": "Optional. A list of keywords. Keywords can be present on their own without a value. If found, their value will be automatically set to bool true."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "table\t\tA table of key-value pairs parsed out from the given string.",
		"type": "table",
		"description": "A table of key-value pairs parsed out from the given string."
	},
	"name_full": "worldeditadditions_core.parse.parse_map",
	"filename": "worldeditadditions_core/utils/parse/map.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/map.lua#L7-L13"
}

--- Makes a seed from a string.
-- If the input is a number, it is returned as-is.
-- If the input is a string and can be converted to a number with tonumber(),
-- the output of tonumber() is returned.
-- Otherwise, the string is converted to a number via a simple hashing algorithm
-- (caution: certainlly NOT crypto-secure!).
-- @param   {string}    str     The string to convert.
-- @source https://stackoverflow.com/a/2624210/1460422 The idea came from here
local function parse_seed(str)

{
	"type": "function",
	"internal": false,
	"description": "Makes a seed from a string.\nIf the input is a number, it is returned as-is.\nIf the input is a string and can be converted to a number with tonumber(),\nthe output of tonumber() is returned.\nOtherwise, the string is converted to a number via a simple hashing algorithm\n(caution: certainlly NOT crypto-secure!).",
	"directives": [
		{
			"directive": "param",
			"text": "{string}    str     The string to convert.",
			"name": "{string}    str     The string to convert."
		},
		{
			"directive": "source",
			"text": "https://stackoverflow.com/a/2624210/1460422 The idea came from here"
		}
	],
	"line": 3,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 11,
	"name": "parse_seed",
	"instanced": false,
	"args": [
		"str"
	],
	"text": "--- Makes a seed from a string.\n-- If the input is a number, it is returned as-is.\n-- If the input is a string and can be converted to a number with tonumber(),\n-- the output of tonumber() is returned.\n-- Otherwise, the string is converted to a number via a simple hashing algorithm\n-- (caution: certainlly NOT crypto-secure!).\n-- @param   {string}    str     The string to convert.\n-- @source https://stackoverflow.com/a/2624210/1460422 The idea came from here\nlocal function parse_seed(str)",
	"params": [
		{
			"directive": "param",
			"text": "{string}    str     The string to convert.",
			"name": "{string}    str     The string to convert."
		}
	],
	"name_full": "worldeditadditions_core.parse.parse_seed",
	"filename": "worldeditadditions_core/utils/parse/seed.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/seed.lua#L4-L12"
}

--- Parses a list of strings as a list of weighted nodes - e.g. like in
-- the //mix command. Example: "dirt 5 stone sand 2".
-- @param	parts	string[]	The list of strings to parse (try worldeditadditions_core.split)
-- @param	as_list	bool		If true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array.
-- @param	func_normalise	callable	If specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name.
-- @returns	table	A table in the form node_name => weight.
local function parse_weighted_nodes(parts, as_list, func_normalise)

{
	"type": "function",
	"internal": false,
	"description": "Parses a list of strings as a list of weighted nodes - e.g. like in\nthe //mix command. Example: \"dirt 5 stone sand 2\".",
	"directives": [
		{
			"directive": "param",
			"text": "parts\tstring[]\tThe list of strings to parse (try worldeditadditions_core.split)",
			"name": "parts",
			"type": "string[]",
			"description": "The list of strings to parse (try worldeditadditions_core.split)"
		},
		{
			"directive": "param",
			"text": "as_list\tbool\t\tIf true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array.",
			"name": "as_list",
			"type": "bool",
			"description": "If true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array."
		},
		{
			"directive": "param",
			"text": "func_normalise\tcallable\tIf specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name.",
			"name": "func_normalise",
			"type": "callable",
			"description": "If specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name."
		},
		{
			"directive": "returns",
			"text": "table\tA table in the form node_name => weight.",
			"type": "table",
			"description": "A table in the form node_name => weight."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 12,
	"name": "parse_weighted_nodes",
	"instanced": false,
	"args": [
		"parts",
		"as_list",
		"func_normalise"
	],
	"text": "--- Parses a list of strings as a list of weighted nodes - e.g. like in\n-- the //mix command. Example: \"dirt 5 stone sand 2\".\n-- @param\tparts\tstring[]\tThe list of strings to parse (try worldeditadditions_core.split)\n-- @param\tas_list\tbool\t\tIf true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array.\n-- @param\tfunc_normalise\tcallable\tIf specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name.\n-- @returns\ttable\tA table in the form node_name => weight.\nlocal function parse_weighted_nodes(parts, as_list, func_normalise)",
	"params": [
		{
			"directive": "param",
			"text": "parts\tstring[]\tThe list of strings to parse (try worldeditadditions_core.split)",
			"name": "parts",
			"type": "string[]",
			"description": "The list of strings to parse (try worldeditadditions_core.split)"
		},
		{
			"directive": "param",
			"text": "as_list\tbool\t\tIf true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array.",
			"name": "as_list",
			"type": "bool",
			"description": "If true, then table.insert() successive { node = string, weight = number } subtables when parsing instead of populating as an associative array."
		},
		{
			"directive": "param",
			"text": "func_normalise\tcallable\tIf specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name.",
			"name": "func_normalise",
			"type": "callable",
			"description": "If specified, the given function will be used to normalise node names instead of worldedit.normalize_nodename. A single argument is passed containing the un-normalised node name, and the return value is assumed to be the normalised node name."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "table\tA table in the form node_name => weight.",
		"type": "table",
		"description": "A table in the form node_name => weight."
	},
	"name_full": "worldeditadditions_core.parse.parse_weighted_nodes",
	"filename": "worldeditadditions_core/utils/parse/weighted_nodes.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/weighted_nodes.lua#L7-L13"
}

--- Tokenises a string of multiple commands into an array of individual commands.
-- Preserves the forward slash at the beginning of each command name.
-- Also supports arbitrarily nested and complex curly braces { } for grouping
-- commands together that would normally be split apart.
-- 
-- Simple example:
-- INPUT: //1 //2 //outset 25 //fixlight
-- OUTPUT: { "//1", "//2", "//outset 25", "//fixlight" }
-- 
-- Example with curly braces:
-- INPUT: //1 //2 //outset 50 {//many 5 //multi //fixlight //clearcut}
-- OUTPUT: { "//1", "//2", "//outset 50", "//many 5 //multi //fixlight //clearcut"}
-- 
-- @param	command_str		str		The command string to operate on.
-- @returns	bool,(string[]|string)	If the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead.
function worldeditadditions_core.parse.tokenise_commands(command_str)

{
	"type": "function",
	"internal": false,
	"description": "Tokenises a string of multiple commands into an array of individual commands.\nPreserves the forward slash at the beginning of each command name.\nAlso supports arbitrarily nested and complex curly braces { } for grouping\ncommands together that would normally be split apart.\n\nSimple example:\nINPUT: //1 //2 //outset 25 //fixlight\nOUTPUT: { \"//1\", \"//2\", \"//outset 25\", \"//fixlight\" }\n\nExample with curly braces:\nINPUT: //1 //2 //outset 50 {//many 5 //multi //fixlight //clearcut}\nOUTPUT: { \"//1\", \"//2\", \"//outset 50\", \"//many 5 //multi //fixlight //clearcut\"}\n",
	"directives": [
		{
			"directive": "param",
			"text": "command_str\t\tstr\t\tThe command string to operate on.",
			"name": "command_str",
			"type": "str",
			"description": "The command string to operate on."
		},
		{
			"directive": "returns",
			"text": "bool,(string[]|string)\tIf the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead.",
			"type": "bool,(string[]|string)",
			"description": "If the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead."
		}
	],
	"line": 91,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 106,
	"name": "parse.tokenise_commands",
	"instanced": false,
	"args": [
		"command_str"
	],
	"text": "--- Tokenises a string of multiple commands into an array of individual commands.\n-- Preserves the forward slash at the beginning of each command name.\n-- Also supports arbitrarily nested and complex curly braces { } for grouping\n-- commands together that would normally be split apart.\n-- \n-- Simple example:\n-- INPUT: //1 //2 //outset 25 //fixlight\n-- OUTPUT: { \"//1\", \"//2\", \"//outset 25\", \"//fixlight\" }\n-- \n-- Example with curly braces:\n-- INPUT: //1 //2 //outset 50 {//many 5 //multi //fixlight //clearcut}\n-- OUTPUT: { \"//1\", \"//2\", \"//outset 50\", \"//many 5 //multi //fixlight //clearcut\"}\n-- \n-- @param\tcommand_str\t\tstr\t\tThe command string to operate on.\n-- @returns\tbool,(string[]|string)\tIf the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead.\nfunction worldeditadditions_core.parse.tokenise_commands(command_str)",
	"params": [
		{
			"directive": "param",
			"text": "command_str\t\tstr\t\tThe command string to operate on.",
			"name": "command_str",
			"type": "str",
			"description": "The command string to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool,(string[]|string)\tIf the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead.",
		"type": "bool,(string[]|string)",
		"description": "If the operation was successful, then true followed by a table of strings is returned. If the operation was not successful, then false followed by an error message (as a single string) is returned instead."
	},
	"name_full": "worldeditadditions_core.parse.parse.tokenise_commands",
	"filename": "worldeditadditions_core/utils/parse/tokenise_commands.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/tokenise_commands.lua#L92-L107"
}

--- Recombines a list of tokens into a list of commands.
-- @param   parts   string[]    The tokens from tokenise(str).
-- @returns         string[]	The tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)
local function recombine(parts)

{
	"type": "function",
	"internal": false,
	"description": "Recombines a list of tokens into a list of commands.",
	"directives": [
		{
			"directive": "param",
			"text": "parts   string[]    The tokens from tokenise(str).",
			"name": "parts   string[]    The tokens from tokenise(str)."
		},
		{
			"directive": "returns",
			"text": "string[]\tThe tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)",
			"type": "string[]",
			"description": "The tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)"
		}
	],
	"line": 72,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 75,
	"name": "recombine",
	"instanced": false,
	"args": [
		"parts"
	],
	"text": "--- Recombines a list of tokens into a list of commands.\n-- @param   parts   string[]    The tokens from tokenise(str).\n-- @returns         string[]\tThe tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)\nlocal function recombine(parts)",
	"params": [
		{
			"directive": "param",
			"text": "parts   string[]    The tokens from tokenise(str).",
			"name": "parts   string[]    The tokens from tokenise(str)."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "string[]\tThe tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)",
		"type": "string[]",
		"description": "The tokens, but run through trim() & grouped into commands (1 element in the list = 1 command)"
	},
	"name_full": "worldeditadditions_core.parse.recombine",
	"filename": "worldeditadditions_core/utils/parse/tokenise_commands.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/tokenise_commands.lua#L73-L76"
}

--- The main tokeniser. Splits the input string up into space separated tokens, except when said spaces are inside { curly braces }.
-- Note that the outermost set of curly braces are stripped.
-- @param   str     string  The input string to tokenise.
-- @returns string[]        A list of tokens
local function tokenise(str)

{
	"type": "function",
	"internal": false,
	"description": "The main tokeniser. Splits the input string up into space separated tokens, except when said spaces are inside { curly braces }.\nNote that the outermost set of curly braces are stripped.",
	"directives": [
		{
			"directive": "param",
			"text": "str     string  The input string to tokenise.",
			"name": "str     string  The input string to tokenise."
		},
		{
			"directive": "returns",
			"text": "string[]        A list of tokens",
			"type": "string[]        A list of tokens"
		}
	],
	"line": 9,
	"namespace": "worldeditadditions_core.parse",
	"line_last": 13,
	"name": "tokenise",
	"instanced": false,
	"args": [
		"str"
	],
	"text": "--- The main tokeniser. Splits the input string up into space separated tokens, except when said spaces are inside { curly braces }.\n-- Note that the outermost set of curly braces are stripped.\n-- @param   str     string  The input string to tokenise.\n-- @returns string[]        A list of tokens\nlocal function tokenise(str)",
	"params": [
		{
			"directive": "param",
			"text": "str     string  The input string to tokenise.",
			"name": "str     string  The input string to tokenise."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "string[]        A list of tokens",
		"type": "string[]        A list of tokens"
	},
	"name_full": "worldeditadditions_core.parse.tokenise",
	"filename": "worldeditadditions_core/utils/parse/tokenise_commands.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/parse/tokenise_commands.lua#L10-L14"
}

--- Clears all the positions for the given player.
-- @param	player_name		string	The name of the player to clear the positions for.
-- @returns	void
local function clear(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Clears all the positions for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to clear the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to clear the positions for."
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 222,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 225,
	"name": "clear",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Clears all the positions for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to clear the positions for.\n-- @returns\tvoid\nlocal function clear(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to clear the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to clear the positions for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions_core.pos.clear",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L223-L226"
}

--- Fetches pos1/pos2 from WorldEdit (if available) and sets them in WorldEditAdditions' postional subsystem
-- @param	player_name		string	The name of the player to sync the positions for.
local function compat_worldedit_get(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Fetches pos1/pos2 from WorldEdit (if available) and sets them in WorldEditAdditions' postional subsystem",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to sync the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to sync the positions for."
		}
	],
	"line": 107,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 109,
	"name": "compat_worldedit_get",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Fetches pos1/pos2 from WorldEdit (if available) and sets them in WorldEditAdditions' postional subsystem\n-- @param\tplayer_name\t\tstring\tThe name of the player to sync the positions for.\nlocal function compat_worldedit_get(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to sync the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to sync the positions for."
		}
	],
	"name_full": "worldeditadditions_core.pos.compat_worldedit_get",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L108-L110"
}

--- Sets pos1/pos2 in worldedit for compatibility.
-- @param	player_name		string	The name of the player to set the position for.
-- @param	i				number	The index of the position to set.
-- @param	pos				Vector3	The position to set.
-- @param	do_update=true	bool	Whether to call worldedit.marker_update() or not.
-- @returns	nil
local function compat_worldedit_set(player_name, i, pos, do_update)

{
	"type": "function",
	"internal": false,
	"description": "Sets pos1/pos2 in worldedit for compatibility.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index of the position to set.",
			"name": "i",
			"type": "number",
			"description": "The index of the position to set."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to set.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to set."
		},
		{
			"directive": "param",
			"text": "do_update=true\tbool\tWhether to call worldedit.marker_update() or not.",
			"name": "do_update",
			"type": "bool",
			"description": "Whether to call worldedit.marker_update() or not.",
			"default_value": "true"
		},
		{
			"directive": "returns",
			"text": "nil",
			"type": "nil"
		}
	],
	"line": 85,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 91,
	"name": "compat_worldedit_set",
	"instanced": false,
	"args": [
		"player_name",
		"i",
		"pos",
		"do_update"
	],
	"text": "--- Sets pos1/pos2 in worldedit for compatibility.\n-- @param\tplayer_name\t\tstring\tThe name of the player to set the position for.\n-- @param\ti\t\t\t\tnumber\tThe index of the position to set.\n-- @param\tpos\t\t\t\tVector3\tThe position to set.\n-- @param\tdo_update=true\tbool\tWhether to call worldedit.marker_update() or not.\n-- @returns\tnil\nlocal function compat_worldedit_set(player_name, i, pos, do_update)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index of the position to set.",
			"name": "i",
			"type": "number",
			"description": "The index of the position to set."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to set.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to set."
		},
		{
			"directive": "param",
			"text": "do_update=true\tbool\tWhether to call worldedit.marker_update() or not.",
			"name": "do_update",
			"type": "bool",
			"description": "Whether to call worldedit.marker_update() or not.",
			"default_value": "true"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "nil",
		"type": "nil"
	},
	"name_full": "worldeditadditions_core.pos.compat_worldedit_set",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L86-L92"
}

--- Counts the number of positioons registered to a given player.
-- @param	player_name		string	The name of the player to fetch the position for.
-- @returns	number			The number of positions registered for the given player.
local function count(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Counts the number of positioons registered to a given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "returns",
			"text": "number\t\t\tThe number of positions registered for the given player.",
			"type": "number",
			"description": "The number of positions registered for the given player."
		}
	],
	"line": 164,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 167,
	"name": "count",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Counts the number of positioons registered to a given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the position for.\n-- @returns\tnumber\t\t\tThe number of positions registered for the given player.\nlocal function count(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\t\t\tThe number of positions registered for the given player.",
		"type": "number",
		"description": "The number of positions registered for the given player."
	},
	"name_full": "worldeditadditions_core.pos.count",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L165-L168"
}

--- Ensures that a table exists for the given player.
-- @param	player_name		string	The name of the player to check.
local function ensure_player(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Ensures that a table exists for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to check.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to check."
		}
	],
	"line": 41,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 43,
	"name": "ensure_player",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Ensures that a table exists for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to check.\nlocal function ensure_player(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to check.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to check."
		}
	],
	"name_full": "worldeditadditions_core.pos.ensure_player",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L42-L44"
}

--- Gets the position with the given index for the given player.
-- @param	player_name		string	The name of the player to fetch the position for.
-- @param	i				number	The index of the position to fetch.
-- @returns	Vector3?		The position requested, or nil if it doesn't exist.
local function get(player_name, i)

{
	"type": "function",
	"internal": false,
	"description": "Gets the position with the given index for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index of the position to fetch.",
			"name": "i",
			"type": "number",
			"description": "The index of the position to fetch."
		},
		{
			"directive": "returns",
			"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
			"type": "Vector3?",
			"description": "The position requested, or nil if it doesn't exist."
		}
	],
	"line": 114,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 118,
	"name": "get",
	"instanced": false,
	"args": [
		"player_name",
		"i"
	],
	"text": "--- Gets the position with the given index for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the position for.\n-- @param\ti\t\t\t\tnumber\tThe index of the position to fetch.\n-- @returns\tVector3?\t\tThe position requested, or nil if it doesn't exist.\nlocal function get(player_name, i)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index of the position to fetch.",
			"name": "i",
			"type": "number",
			"description": "The index of the position to fetch."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
		"type": "Vector3?",
		"description": "The position requested, or nil if it doesn't exist."
	},
	"name_full": "worldeditadditions_core.pos.get",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L115-L119"
}

--- Gets a list of all the positions for the given player.
-- @param	player_name		string	The name of the player to fetch the position for.
-- @returns	Vector3[]		A list of positions for the given player.
local function get_all(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Gets a list of all the positions for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "returns",
			"text": "Vector3[]\t\tA list of positions for the given player.",
			"type": "Vector3[]",
			"description": "A list of positions for the given player."
		}
	],
	"line": 135,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 138,
	"name": "get_all",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Gets a list of all the positions for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the position for.\n-- @returns\tVector3[]\t\tA list of positions for the given player.\nlocal function get_all(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3[]\t\tA list of positions for the given player.",
		"type": "Vector3[]",
		"description": "A list of positions for the given player."
	},
	"name_full": "worldeditadditions_core.pos.get_all",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L136-L139"
}

--- Get a bounding box that encloses all the positions currently defined by a given player.
-- @param	player_name		string	The name of the player to fetch the boudnign box for.
-- @returns nil|(Vector3,Vector3)	2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined.
local function get_bounds(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Get a bounding box that encloses all the positions currently defined by a given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the boudnign box for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the boudnign box for."
		},
		{
			"directive": "returns",
			"text": "nil|(Vector3,Vector3)\t2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined.",
			"type": "nil|(Vector3,Vector3)",
			"description": "2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined."
		}
	],
	"line": 146,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 149,
	"name": "get_bounds",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Get a bounding box that encloses all the positions currently defined by a given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the boudnign box for.\n-- @returns nil|(Vector3,Vector3)\t2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined.\nlocal function get_bounds(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the boudnign box for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the boudnign box for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "nil|(Vector3,Vector3)\t2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined.",
		"type": "nil|(Vector3,Vector3)",
		"description": "2 positions that define opposite corners of a region that fully encloses all the defined points for the given player, or nil ir the specified player has no points currently defined."
	},
	"name_full": "worldeditadditions_core.pos.get_bounds",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L147-L150"
}

--- Convenience function that returns position 1 for the given player.
-- @param	player_name		string	The name of the player to fetch the position for.
-- @returns	Vector3?		The position requested, or nil if it doesn't exist.
local function get1(player_name) return get(player_name, 1) end

{
	"type": "function",
	"internal": false,
	"description": "Convenience function that returns position 1 for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "returns",
			"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
			"type": "Vector3?",
			"description": "The position requested, or nil if it doesn't exist."
		}
	],
	"line": 126,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 129,
	"name": "get1",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Convenience function that returns position 1 for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the position for.\n-- @returns\tVector3?\t\tThe position requested, or nil if it doesn't exist.\nlocal function get1(player_name) return get(player_name, 1) end",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
		"type": "Vector3?",
		"description": "The position requested, or nil if it doesn't exist."
	},
	"name_full": "worldeditadditions_core.pos.get1",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L127-L130"
}

--- Convenience function that returns position 1 for the given player.
-- @param	player_name		string	The name of the player to fetch the position for.
-- @returns	Vector3?		The position requested, or nil if it doesn't exist.
local function get2(player_name) return get(player_name, 2) end

{
	"type": "function",
	"internal": false,
	"description": "Convenience function that returns position 1 for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		},
		{
			"directive": "returns",
			"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
			"type": "Vector3?",
			"description": "The position requested, or nil if it doesn't exist."
		}
	],
	"line": 130,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 133,
	"name": "get2",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Convenience function that returns position 1 for the given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to fetch the position for.\n-- @returns\tVector3?\t\tThe position requested, or nil if it doesn't exist.\nlocal function get2(player_name) return get(player_name, 2) end",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to fetch the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to fetch the position for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3?\t\tThe position requested, or nil if it doesn't exist.",
		"type": "Vector3?",
		"description": "The position requested, or nil if it doesn't exist."
	},
	"name_full": "worldeditadditions_core.pos.get2",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L131-L134"
}

--- Shows the visual markers for the given player's positions and defined region once more.
-- Often used some time after calling worldeditadditions_core.pos.unmark().
-- @param	player_name		string	The name of the player to operate on.
-- @returns	void
local function mark(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Shows the visual markers for the given player's positions and defined region once more.\nOften used some time after calling worldeditadditions_core.pos.unmark().",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to operate on.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to operate on."
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 284,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 288,
	"name": "mark",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Shows the visual markers for the given player's positions and defined region once more.\n-- Often used some time after calling worldeditadditions_core.pos.unmark().\n-- @param\tplayer_name\t\tstring\tThe name of the player to operate on.\n-- @returns\tvoid\nlocal function mark(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to operate on.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions_core.pos.mark",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L285-L289"
}

--- Removes the last position from the for a given player and returns it.
-- @param	player_name		string	The name of the player to pop the position for.
-- @returns	Vector3?		The position removed, or nil if it doesn't exist.
local function pop(player_name)

{
	"type": "function",
	"internal": false,
	"description": "Removes the last position from the for a given player and returns it.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to pop the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to pop the position for."
		},
		{
			"directive": "returns",
			"text": "Vector3?\t\tThe position removed, or nil if it doesn't exist.",
			"type": "Vector3?",
			"description": "The position removed, or nil if it doesn't exist."
		}
	],
	"line": 236,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 239,
	"name": "pop",
	"instanced": false,
	"args": [
		"player_name"
	],
	"text": "--- Removes the last position from the for a given player and returns it.\n-- @param\tplayer_name\t\tstring\tThe name of the player to pop the position for.\n-- @returns\tVector3?\t\tThe position removed, or nil if it doesn't exist.\nlocal function pop(player_name)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to pop the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to pop the position for."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3?\t\tThe position removed, or nil if it doesn't exist.",
		"type": "Vector3?",
		"description": "The position removed, or nil if it doesn't exist."
	},
	"name_full": "worldeditadditions_core.pos.pop",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L237-L240"
}

--- Adds a position to the list for a given player.
-- @param	player_name		string	The name of the player to add the position for.
-- @param	pos				Vector3	The position to add.
-- @returns	number			The new number of positions for that player.
local function push(player_name, pos)

{
	"type": "function",
	"internal": false,
	"description": "Adds a position to the list for a given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to add the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to add the position for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to add.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to add."
		},
		{
			"directive": "returns",
			"text": "number\t\t\tThe new number of positions for that player.",
			"type": "number",
			"description": "The new number of positions for that player."
		}
	],
	"line": 255,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 259,
	"name": "push",
	"instanced": false,
	"args": [
		"player_name",
		"pos"
	],
	"text": "--- Adds a position to the list for a given player.\n-- @param\tplayer_name\t\tstring\tThe name of the player to add the position for.\n-- @param\tpos\t\t\t\tVector3\tThe position to add.\n-- @returns\tnumber\t\t\tThe new number of positions for that player.\nlocal function push(player_name, pos)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to add the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to add the position for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to add.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to add."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\t\t\tThe new number of positions for that player.",
		"type": "number",
		"description": "The new number of positions for that player."
	},
	"name_full": "worldeditadditions_core.pos.push",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L256-L260"
}

--- Sets the position at the given index for the given player.
-- You probably want push_pos, not this function.
-- @param	player_name		string	The name of the player to set the position for.
-- @param	i				number	The index to set the position at.
-- @param	pos				Vector3	The position to set.
-- @returns	bool			Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).
local function set(player_name, i, pos)

{
	"type": "function",
	"internal": false,
	"description": "Sets the position at the given index for the given player.\nYou probably want push_pos, not this function.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index to set the position at.",
			"name": "i",
			"type": "number",
			"description": "The index to set the position at."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to set.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to set."
		},
		{
			"directive": "returns",
			"text": "bool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).",
			"type": "bool",
			"description": "Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time)."
		}
	],
	"line": 174,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 180,
	"name": "set",
	"instanced": false,
	"args": [
		"player_name",
		"i",
		"pos"
	],
	"text": "--- Sets the position at the given index for the given player.\n-- You probably want push_pos, not this function.\n-- @param\tplayer_name\t\tstring\tThe name of the player to set the position for.\n-- @param\ti\t\t\t\tnumber\tThe index to set the position at.\n-- @param\tpos\t\t\t\tVector3\tThe position to set.\n-- @returns\tbool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).\nlocal function set(player_name, i, pos)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the position for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the position for."
		},
		{
			"directive": "param",
			"text": "i\t\t\t\tnumber\tThe index to set the position at.",
			"name": "i",
			"type": "number",
			"description": "The index to set the position at."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3\tThe position to set.",
			"name": "pos",
			"type": "Vector3",
			"description": "The position to set."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).",
		"type": "bool",
		"description": "Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time)."
	},
	"name_full": "worldeditadditions_core.pos.set",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L175-L181"
}

--- Sets the all the positions for the given player.
-- You probably want push_pos, not this function.
-- @param	player_name		string	The name of the player to set the positions for.
-- @param	pos_list		Vector3	The table of positions to set.
-- @returns	bool			Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).
local function set_all(player_name, pos_list)

{
	"type": "function",
	"internal": false,
	"description": "Sets the all the positions for the given player.\nYou probably want push_pos, not this function.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the positions for."
		},
		{
			"directive": "param",
			"text": "pos_list\t\tVector3\tThe table of positions to set.",
			"name": "pos_list",
			"type": "Vector3",
			"description": "The table of positions to set."
		},
		{
			"directive": "returns",
			"text": "bool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).",
			"type": "bool",
			"description": "Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time)."
		}
	],
	"line": 208,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 213,
	"name": "set_all",
	"instanced": false,
	"args": [
		"player_name",
		"pos_list"
	],
	"text": "--- Sets the all the positions for the given player.\n-- You probably want push_pos, not this function.\n-- @param\tplayer_name\t\tstring\tThe name of the player to set the positions for.\n-- @param\tpos_list\t\tVector3\tThe table of positions to set.\n-- @returns\tbool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).\nlocal function set_all(player_name, pos_list)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to set the positions for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set the positions for."
		},
		{
			"directive": "param",
			"text": "pos_list\t\tVector3\tThe table of positions to set.",
			"name": "pos_list",
			"type": "Vector3",
			"description": "The table of positions to set."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\t\tWhether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time).",
		"type": "bool",
		"description": "Whether the operation was successful or not (players aren't allowed more than positions_count_limit number of positions at a time)."
	},
	"name_full": "worldeditadditions_core.pos.set_all",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L209-L214"
}

--- Convenience function that set position 1 for the given player.
-- @param	player_name		string		The name of the player to set pos1 for.
-- @param	pos				Vector3?	The new Vector3 for pos1 to set.
-- @returns	bool			Whether the operation was successful or not, but in this case will always return true so can be ignored.
local function set1(player_name, pos)

{
	"type": "function",
	"internal": false,
	"description": "Convenience function that set position 1 for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\t\tThe name of the player to set pos1 for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set pos1 for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3?\tThe new Vector3 for pos1 to set.",
			"name": "pos",
			"type": "Vector3?",
			"description": "The new Vector3 for pos1 to set."
		},
		{
			"directive": "returns",
			"text": "bool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.",
			"type": "bool",
			"description": "Whether the operation was successful or not, but in this case will always return true so can be ignored."
		}
	],
	"line": 192,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 196,
	"name": "set1",
	"instanced": false,
	"args": [
		"player_name",
		"pos"
	],
	"text": "--- Convenience function that set position 1 for the given player.\n-- @param\tplayer_name\t\tstring\t\tThe name of the player to set pos1 for.\n-- @param\tpos\t\t\t\tVector3?\tThe new Vector3 for pos1 to set.\n-- @returns\tbool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.\nlocal function set1(player_name, pos)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\t\tThe name of the player to set pos1 for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set pos1 for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3?\tThe new Vector3 for pos1 to set.",
			"name": "pos",
			"type": "Vector3?",
			"description": "The new Vector3 for pos1 to set."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.",
		"type": "bool",
		"description": "Whether the operation was successful or not, but in this case will always return true so can be ignored."
	},
	"name_full": "worldeditadditions_core.pos.set1",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L193-L197"
}

--- Convenience function that set position 2 for the given player.
-- @param	player_name		string		The name of the player to set pos1 for.
-- @param	pos				Vector3?	The new Vector3 for pos2 to set.
-- @returns	bool			Whether the operation was successful or not, but in this case will always return true so can be ignored.
local function set2(player_name, pos)

{
	"type": "function",
	"internal": false,
	"description": "Convenience function that set position 2 for the given player.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\t\tThe name of the player to set pos1 for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set pos1 for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3?\tThe new Vector3 for pos2 to set.",
			"name": "pos",
			"type": "Vector3?",
			"description": "The new Vector3 for pos2 to set."
		},
		{
			"directive": "returns",
			"text": "bool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.",
			"type": "bool",
			"description": "Whether the operation was successful or not, but in this case will always return true so can be ignored."
		}
	],
	"line": 199,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 203,
	"name": "set2",
	"instanced": false,
	"args": [
		"player_name",
		"pos"
	],
	"text": "--- Convenience function that set position 2 for the given player.\n-- @param\tplayer_name\t\tstring\t\tThe name of the player to set pos1 for.\n-- @param\tpos\t\t\t\tVector3?\tThe new Vector3 for pos2 to set.\n-- @returns\tbool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.\nlocal function set2(player_name, pos)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\t\tThe name of the player to set pos1 for.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to set pos1 for."
		},
		{
			"directive": "param",
			"text": "pos\t\t\t\tVector3?\tThe new Vector3 for pos2 to set.",
			"name": "pos",
			"type": "Vector3?",
			"description": "The new Vector3 for pos2 to set."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\t\t\tWhether the operation was successful or not, but in this case will always return true so can be ignored.",
		"type": "bool",
		"description": "Whether the operation was successful or not, but in this case will always return true so can be ignored."
	},
	"name_full": "worldeditadditions_core.pos.set2",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L200-L204"
}

--- Hides the visual markers for the given player's positions and defined region, but does not clear the points.
-- @param	player_name		string	The name of the player to operate on.
-- @param	markers=true	bool	Whether to hide positional markers.
-- @param	walls=true		bool	Whether to hide the marker walls.
-- @returns	void
local function unmark(player_name, markers, walls)

{
	"type": "function",
	"internal": false,
	"description": "Hides the visual markers for the given player's positions and defined region, but does not clear the points.",
	"directives": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to operate on.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to operate on."
		},
		{
			"directive": "param",
			"text": "markers=true\tbool\tWhether to hide positional markers.",
			"name": "markers",
			"type": "bool",
			"description": "Whether to hide positional markers.",
			"default_value": "true"
		},
		{
			"directive": "param",
			"text": "walls=true\t\tbool\tWhether to hide the marker walls.",
			"name": "walls",
			"type": "bool",
			"description": "Whether to hide the marker walls.",
			"default_value": "true"
		},
		{
			"directive": "returns",
			"text": "void",
			"type": "void"
		}
	],
	"line": 268,
	"namespace": "worldeditadditions_core.pos",
	"line_last": 273,
	"name": "unmark",
	"instanced": false,
	"args": [
		"player_name",
		"markers",
		"walls"
	],
	"text": "--- Hides the visual markers for the given player's positions and defined region, but does not clear the points.\n-- @param\tplayer_name\t\tstring\tThe name of the player to operate on.\n-- @param\tmarkers=true\tbool\tWhether to hide positional markers.\n-- @param\twalls=true\t\tbool\tWhether to hide the marker walls.\n-- @returns\tvoid\nlocal function unmark(player_name, markers, walls)",
	"params": [
		{
			"directive": "param",
			"text": "player_name\t\tstring\tThe name of the player to operate on.",
			"name": "player_name",
			"type": "string",
			"description": "The name of the player to operate on."
		},
		{
			"directive": "param",
			"text": "markers=true\tbool\tWhether to hide positional markers.",
			"name": "markers",
			"type": "bool",
			"description": "Whether to hide positional markers.",
			"default_value": "true"
		},
		{
			"directive": "param",
			"text": "walls=true\t\tbool\tWhether to hide the marker walls.",
			"name": "walls",
			"type": "bool",
			"description": "Whether to hide the marker walls.",
			"default_value": "true"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "void",
		"type": "void"
	},
	"name_full": "worldeditadditions_core.pos.unmark",
	"filename": "worldeditadditions_core/core/pos.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/core/pos.lua#L269-L274"
}

--- Determines whether a  given value is present in this queue or not.
-- @param	value	any		The value to check.
-- @returns	bool	Whether the given value exists in the queue or not.
function Queue:contains(value)

{
	"type": "function",
	"internal": false,
	"description": "Determines whether a  given value is present in this queue or not.",
	"directives": [
		{
			"directive": "param",
			"text": "value\tany\t\tThe value to check.",
			"name": "value",
			"type": "any",
			"description": "The value to check."
		},
		{
			"directive": "returns",
			"text": "bool\tWhether the given value exists in the queue or not.",
			"type": "bool",
			"description": "Whether the given value exists in the queue or not."
		}
	],
	"line": 25,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 28,
	"name": "contains",
	"instanced": true,
	"args": [
		"value"
	],
	"text": "--- Determines whether a  given value is present in this queue or not.\n-- @param\tvalue\tany\t\tThe value to check.\n-- @returns\tbool\tWhether the given value exists in the queue or not.\nfunction Queue:contains(value)",
	"params": [
		{
			"directive": "param",
			"text": "value\tany\t\tThe value to check.",
			"name": "value",
			"type": "any",
			"description": "The value to check."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tWhether the given value exists in the queue or not.",
		"type": "bool",
		"description": "Whether the given value exists in the queue or not."
	},
	"name_full": "worldeditadditions_core.Queue.contains",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L26-L29"
}

--- Dequeues an item from the front of the queue.
-- @returns		any|nil		Returns the item at the front of the queue, or nil if no items are currently enqueued. 
function Queue:dequeue()

{
	"type": "function",
	"internal": false,
	"description": "Dequeues an item from the front of the queue.",
	"directives": [
		{
			"directive": "returns",
			"text": "any|nil\t\tReturns the item at the front of the queue, or nil if no items are currently enqueued.",
			"type": "any|nil",
			"description": "Returns the item at the front of the queue, or nil if no items are currently enqueued."
		}
	],
	"line": 51,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 53,
	"name": "dequeue",
	"instanced": true,
	"args": [
		""
	],
	"text": "--- Dequeues an item from the front of the queue.\n-- @returns\t\tany|nil\t\tReturns the item at the front of the queue, or nil if no items are currently enqueued. \nfunction Queue:dequeue()",
	"params": [],
	"returns": {
		"directive": "returns",
		"text": "any|nil\t\tReturns the item at the front of the queue, or nil if no items are currently enqueued.",
		"type": "any|nil",
		"description": "Returns the item at the front of the queue, or nil if no items are currently enqueued."
	},
	"name_full": "worldeditadditions_core.Queue.dequeue",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L52-L54"
}

--- Adds a new value to the end of the queue.
-- @param	value	any		The new value to add to the end of the queue.
-- @returns	number	The index of the value that was added to the queue.
function Queue:enqueue(value)

{
	"type": "function",
	"internal": false,
	"description": "Adds a new value to the end of the queue.",
	"directives": [
		{
			"directive": "param",
			"text": "value\tany\t\tThe new value to add to the end of the queue.",
			"name": "value",
			"type": "any",
			"description": "The new value to add to the end of the queue."
		},
		{
			"directive": "returns",
			"text": "number\tThe index of the value that was added to the queue.",
			"type": "number",
			"description": "The index of the value that was added to the queue."
		}
	],
	"line": 15,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 18,
	"name": "enqueue",
	"instanced": true,
	"args": [
		"value"
	],
	"text": "--- Adds a new value to the end of the queue.\n-- @param\tvalue\tany\t\tThe new value to add to the end of the queue.\n-- @returns\tnumber\tThe index of the value that was added to the queue.\nfunction Queue:enqueue(value)",
	"params": [
		{
			"directive": "param",
			"text": "value\tany\t\tThe new value to add to the end of the queue.",
			"name": "value",
			"type": "any",
			"description": "The new value to add to the end of the queue."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe index of the value that was added to the queue.",
		"type": "number",
		"description": "The index of the value that was added to the queue."
	},
	"name_full": "worldeditadditions_core.Queue.enqueue",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L16-L19"
}

--- Returns whether the queue is empty or not.
-- @returns	bool	Whether the queue is empty or not.
function Queue:is_empty()

{
	"type": "function",
	"internal": false,
	"description": "Returns whether the queue is empty or not.",
	"directives": [
		{
			"directive": "returns",
			"text": "bool\tWhether the queue is empty or not.",
			"type": "bool",
			"description": "Whether the queue is empty or not."
		}
	],
	"line": 37,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 39,
	"name": "is_empty",
	"instanced": true,
	"args": [
		""
	],
	"text": "--- Returns whether the queue is empty or not.\n-- @returns\tbool\tWhether the queue is empty or not.\nfunction Queue:is_empty()",
	"params": [],
	"returns": {
		"directive": "returns",
		"text": "bool\tWhether the queue is empty or not.",
		"type": "bool",
		"description": "Whether the queue is empty or not."
	},
	"name_full": "worldeditadditions_core.Queue.is_empty",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L38-L40"
}

--- Creates a new queue instance.
-- @returns	Queue
function Queue.new()

{
	"type": "function",
	"internal": false,
	"description": "Creates a new queue instance.",
	"directives": [
		{
			"directive": "returns",
			"text": "Queue",
			"type": "Queue"
		}
	],
	"line": 7,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 9,
	"name": "new",
	"instanced": false,
	"args": [
		""
	],
	"text": "--- Creates a new queue instance.\n-- @returns\tQueue\nfunction Queue.new()",
	"params": [],
	"returns": {
		"directive": "returns",
		"text": "Queue",
		"type": "Queue"
	},
	"name_full": "worldeditadditions_core.Queue.new",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L8-L10"
}

--- Removes the item with the given index from the queue.
-- Item indexes do not change as the items in a queue are added and removed.
-- @param		number		The index of the item to remove from the queue.
-- @returns		nil
function Queue:remove_index(index)

{
	"type": "function",
	"internal": false,
	"description": "Removes the item with the given index from the queue.\nItem indexes do not change as the items in a queue are added and removed.",
	"directives": [
		{
			"directive": "param",
			"text": "number\t\tThe index of the item to remove from the queue.",
			"name": "number",
			"type": "The index of the item to remove from the queue."
		},
		{
			"directive": "returns",
			"text": "nil",
			"type": "nil"
		}
	],
	"line": 43,
	"namespace": "worldeditadditions_core.Queue",
	"line_last": 47,
	"name": "remove_index",
	"instanced": true,
	"args": [
		"index"
	],
	"text": "--- Removes the item with the given index from the queue.\n-- Item indexes do not change as the items in a queue are added and removed.\n-- @param\t\tnumber\t\tThe index of the item to remove from the queue.\n-- @returns\t\tnil\nfunction Queue:remove_index(index)",
	"params": [
		{
			"directive": "param",
			"text": "number\t\tThe index of the item to remove from the queue.",
			"name": "number",
			"type": "The index of the item to remove from the queue."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "nil",
		"type": "nil"
	},
	"name_full": "worldeditadditions_core.Queue.remove_index",
	"filename": "worldeditadditions_core/utils/queue.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/queue.lua#L44-L48"
}

--- Adds item(s) to set.
-- @param	a	set	Set to manipulate.
-- @param	i	not nil	Values(s) to add.
-- @returns	bool	Success of operation.
function Set.add(a,i)

{
	"type": "function",
	"internal": false,
	"description": "Adds item(s) to set.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tset\tSet to manipulate.",
			"name": "a",
			"type": "set",
			"description": "Set to manipulate."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to add.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to add."
		},
		{
			"directive": "returns",
			"text": "bool\tSuccess of operation.",
			"type": "bool",
			"description": "Success of operation."
		}
	],
	"line": 44,
	"namespace": "worldeditadditions_core.Set",
	"line_last": 48,
	"name": "add",
	"instanced": false,
	"args": [
		"a",
		"i"
	],
	"text": "--- Adds item(s) to set.\n-- @param\ta\tset\tSet to manipulate.\n-- @param\ti\tnot nil\tValues(s) to add.\n-- @returns\tbool\tSuccess of operation.\nfunction Set.add(a,i)",
	"params": [
		{
			"directive": "param",
			"text": "a\tset\tSet to manipulate.",
			"name": "a",
			"type": "set",
			"description": "Set to manipulate."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to add.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to add."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tSuccess of operation.",
		"type": "bool",
		"description": "Success of operation."
	},
	"name_full": "worldeditadditions_core.Set.add",
	"filename": "worldeditadditions_core/utils/set.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/set.lua#L45-L49"
}

--- Deletes item(s) from set.
-- @param	a	set	Set to manipulate.
-- @param	i	not nil	Values(s) to delete.
-- @returns	bool	Success of operation.
function Set.delete(a,i)

{
	"type": "function",
	"internal": false,
	"description": "Deletes item(s) from set.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tset\tSet to manipulate.",
			"name": "a",
			"type": "set",
			"description": "Set to manipulate."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to delete.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to delete."
		},
		{
			"directive": "returns",
			"text": "bool\tSuccess of operation.",
			"type": "bool",
			"description": "Success of operation."
		}
	],
	"line": 57,
	"namespace": "worldeditadditions_core.Set",
	"line_last": 61,
	"name": "delete",
	"instanced": false,
	"args": [
		"a",
		"i"
	],
	"text": "--- Deletes item(s) from set.\n-- @param\ta\tset\tSet to manipulate.\n-- @param\ti\tnot nil\tValues(s) to delete.\n-- @returns\tbool\tSuccess of operation.\nfunction Set.delete(a,i)",
	"params": [
		{
			"directive": "param",
			"text": "a\tset\tSet to manipulate.",
			"name": "a",
			"type": "set",
			"description": "Set to manipulate."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to delete.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to delete."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tSuccess of operation.",
		"type": "bool",
		"description": "Success of operation."
	},
	"name_full": "worldeditadditions_core.Set.delete",
	"filename": "worldeditadditions_core/utils/set.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/set.lua#L58-L62"
}

--- Checks if value(s) are present in set.
-- @param	a	set	Set to inspect.
-- @param	i	not nil	Values(s) to check.
-- @returns	bool	Value(s) are present?
function Set.has(a,i)

{
	"type": "function",
	"internal": false,
	"description": "Checks if value(s) are present in set.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tset\tSet to inspect.",
			"name": "a",
			"type": "set",
			"description": "Set to inspect."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to check.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to check."
		},
		{
			"directive": "returns",
			"text": "bool\tValue(s) are present?",
			"type": "bool",
			"description": "Value(s) are present?"
		}
	],
	"line": 70,
	"namespace": "worldeditadditions_core.Set",
	"line_last": 74,
	"name": "has",
	"instanced": false,
	"args": [
		"a",
		"i"
	],
	"text": "--- Checks if value(s) are present in set.\n-- @param\ta\tset\tSet to inspect.\n-- @param\ti\tnot nil\tValues(s) to check.\n-- @returns\tbool\tValue(s) are present?\nfunction Set.has(a,i)",
	"params": [
		{
			"directive": "param",
			"text": "a\tset\tSet to inspect.",
			"name": "a",
			"type": "set",
			"description": "Set to inspect."
		},
		{
			"directive": "param",
			"text": "i\tnot nil\tValues(s) to check.",
			"name": "i",
			"type": "not nil",
			"description": "Values(s) to check."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tValue(s) are present?",
		"type": "bool",
		"description": "Value(s) are present?"
	},
	"name_full": "worldeditadditions_core.Set.has",
	"filename": "worldeditadditions_core/utils/set.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/set.lua#L71-L75"
}

--- Creates a new set.
-- @param	i	any	Initial values(s) of the set.
-- @returns	Set	A table of keys equal to true.
function Set.new(i)

{
	"type": "function",
	"internal": false,
	"description": "Creates a new set.",
	"directives": [
		{
			"directive": "param",
			"text": "i\tany\tInitial values(s) of the set.",
			"name": "i",
			"type": "any",
			"description": "Initial values(s) of the set."
		},
		{
			"directive": "returns",
			"text": "Set\tA table of keys equal to true.",
			"type": "Set",
			"description": "A table of keys equal to true."
		}
	],
	"line": 29,
	"namespace": "worldeditadditions_core.Set",
	"line_last": 32,
	"name": "new",
	"instanced": false,
	"args": [
		"i"
	],
	"text": "--- Creates a new set.\n-- @param\ti\tany\tInitial values(s) of the set.\n-- @returns\tSet\tA table of keys equal to true.\nfunction Set.new(i)",
	"params": [
		{
			"directive": "param",
			"text": "i\tany\tInitial values(s) of the set.",
			"name": "i",
			"type": "any",
			"description": "Initial values(s) of the set."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Set\tA table of keys equal to true.",
		"type": "Set",
		"description": "A table of keys equal to true."
	},
	"name_full": "worldeditadditions_core.Set.new",
	"filename": "worldeditadditions_core/utils/set.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/set.lua#L30-L33"
}

--- Applies changes to a heightmap to a Voxel Manipulator data block.
-- @param	pos1	vector		Position 1 of the defined region
-- @param	pos2	vector		Position 2 of the defined region
-- @param	area	VoxelArea	The VoxelArea object (see worldedit.manip_helpers.init)
-- @param	data	number[]	The node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator.
-- @param	heightmap_old	number[]	The original heightmap from worldeditadditions.make_heightmap.
-- @param	heightmap_new	number[]	The new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work.
-- @param	heightmap_size	vector	The x / z size of the heightmap. Any y value set in the vector is ignored.
-- @returns	bool, string|{ added: number, removed: number }	A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).
local function apply_heightmap_changes(pos1, pos2, area, data, heightmap_old, heightmap_new, heightmap_size)

{
	"type": "function",
	"internal": false,
	"description": "Applies changes to a heightmap to a Voxel Manipulator data block.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tvector\t\tPosition 1 of the defined region",
			"name": "pos1",
			"type": "vector",
			"description": "Position 1 of the defined region"
		},
		{
			"directive": "param",
			"text": "pos2\tvector\t\tPosition 2 of the defined region",
			"name": "pos2",
			"type": "vector",
			"description": "Position 2 of the defined region"
		},
		{
			"directive": "param",
			"text": "area\tVoxelArea\tThe VoxelArea object (see worldedit.manip_helpers.init)",
			"name": "area",
			"type": "VoxelArea",
			"description": "The VoxelArea object (see worldedit.manip_helpers.init)"
		},
		{
			"directive": "param",
			"text": "data\tnumber[]\tThe node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator.",
			"name": "data",
			"type": "number[]",
			"description": "The node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator."
		},
		{
			"directive": "param",
			"text": "heightmap_old\tnumber[]\tThe original heightmap from worldeditadditions.make_heightmap.",
			"name": "heightmap_old",
			"type": "number[]",
			"description": "The original heightmap from worldeditadditions.make_heightmap."
		},
		{
			"directive": "param",
			"text": "heightmap_new\tnumber[]\tThe new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work.",
			"name": "heightmap_new",
			"type": "number[]",
			"description": "The new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tvector\tThe x / z size of the heightmap. Any y value set in the vector is ignored.",
			"name": "heightmap_size",
			"type": "vector",
			"description": "The x / z size of the heightmap. Any y value set in the vector is ignored."
		},
		{
			"directive": "returns",
			"text": "bool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).",
			"type": "bool, string|{ added: number, removed: number }",
			"description": "A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful)."
		}
	],
	"line": 7,
	"namespace": "worldeditadditions_core.terrain",
	"line_last": 16,
	"name": "apply_heightmap_changes",
	"instanced": false,
	"args": [
		"pos1",
		"pos2",
		"area",
		"data",
		"heightmap_old",
		"heightmap_new",
		"heightmap_size"
	],
	"text": "--- Applies changes to a heightmap to a Voxel Manipulator data block.\n-- @param\tpos1\tvector\t\tPosition 1 of the defined region\n-- @param\tpos2\tvector\t\tPosition 2 of the defined region\n-- @param\tarea\tVoxelArea\tThe VoxelArea object (see worldedit.manip_helpers.init)\n-- @param\tdata\tnumber[]\tThe node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator.\n-- @param\theightmap_old\tnumber[]\tThe original heightmap from worldeditadditions.make_heightmap.\n-- @param\theightmap_new\tnumber[]\tThe new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work.\n-- @param\theightmap_size\tvector\tThe x / z size of the heightmap. Any y value set in the vector is ignored.\n-- @returns\tbool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).\nlocal function apply_heightmap_changes(pos1, pos2, area, data, heightmap_old, heightmap_new, heightmap_size)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tvector\t\tPosition 1 of the defined region",
			"name": "pos1",
			"type": "vector",
			"description": "Position 1 of the defined region"
		},
		{
			"directive": "param",
			"text": "pos2\tvector\t\tPosition 2 of the defined region",
			"name": "pos2",
			"type": "vector",
			"description": "Position 2 of the defined region"
		},
		{
			"directive": "param",
			"text": "area\tVoxelArea\tThe VoxelArea object (see worldedit.manip_helpers.init)",
			"name": "area",
			"type": "VoxelArea",
			"description": "The VoxelArea object (see worldedit.manip_helpers.init)"
		},
		{
			"directive": "param",
			"text": "data\tnumber[]\tThe node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator.",
			"name": "data",
			"type": "number[]",
			"description": "The node ids data array containing the slice of the Minetest world extracted using the Voxel Manipulator."
		},
		{
			"directive": "param",
			"text": "heightmap_old\tnumber[]\tThe original heightmap from worldeditadditions.make_heightmap.",
			"name": "heightmap_old",
			"type": "number[]",
			"description": "The original heightmap from worldeditadditions.make_heightmap."
		},
		{
			"directive": "param",
			"text": "heightmap_new\tnumber[]\tThe new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work.",
			"name": "heightmap_new",
			"type": "number[]",
			"description": "The new heightmap containing the altered updated values. It is expected that worldeditadditions.table.shallowcopy be used to make a COPY of the data worldeditadditions.make_heightmap for this purpose. Both heightmap_old AND heightmap_new are REQUIRED in order for this function to work."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tvector\tThe x / z size of the heightmap. Any y value set in the vector is ignored.",
			"name": "heightmap_size",
			"type": "vector",
			"description": "The x / z size of the heightmap. Any y value set in the vector is ignored."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool, string|{ added: number, removed: number }\tA bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful).",
		"type": "bool, string|{ added: number, removed: number }",
		"description": "A bool indicating whether the operation was successful or not, followed by either an error message as a string (if it was not successful) or a table of statistics (if it was successful)."
	},
	"name_full": "worldeditadditions_core.terrain.apply_heightmap_changes",
	"filename": "worldeditadditions_core/utils/terrain/apply_heightmap_changes.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/terrain/apply_heightmap_changes.lua#L8-L17"
}

--- Calculates a normal map for the given heightmap.
-- Caution: This method (like worldeditadditions.make_heightmap) works on
-- X AND Z, and NOT x and y. This means that the resulting 3d normal vectors
-- will have the z and y values swapped.
-- @param	heightmap		table	A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().
-- @param	heightmap_size	int[]	The size of the heightmap in the form [ z, x ]
-- @return	Vector[]		The calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal.
local function calculate_normals(heightmap, heightmap_size)

{
	"type": "function",
	"internal": false,
	"description": "Calculates a normal map for the given heightmap.\nCaution: This method (like worldeditadditions.make_heightmap) works on\nX AND Z, and NOT x and y. This means that the resulting 3d normal vectors\nwill have the z and y values swapped.",
	"directives": [
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().",
			"name": "heightmap",
			"type": "table",
			"description": "A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap()."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]",
			"name": "heightmap_size",
			"type": "int[]",
			"description": "The size of the heightmap in the form [ z, x ]"
		},
		{
			"directive": "returns",
			"text": "Vector[]\t\tThe calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal.",
			"type": "Vector[]",
			"description": "The calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.terrain",
	"line_last": 13,
	"name": "calculate_normals",
	"instanced": false,
	"args": [
		"heightmap",
		"heightmap_size"
	],
	"text": "--- Calculates a normal map for the given heightmap.\n-- Caution: This method (like worldeditadditions.make_heightmap) works on\n-- X AND Z, and NOT x and y. This means that the resulting 3d normal vectors\n-- will have the z and y values swapped.\n-- @param\theightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().\n-- @param\theightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]\n-- @return\tVector[]\t\tThe calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal.\nlocal function calculate_normals(heightmap, heightmap_size)",
	"params": [
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().",
			"name": "heightmap",
			"type": "table",
			"description": "A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap()."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]",
			"name": "heightmap_size",
			"type": "int[]",
			"description": "The size of the heightmap in the form [ z, x ]"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector[]\t\tThe calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal.",
		"type": "Vector[]",
		"description": "The calculated normal map, in the same form as the input heightmap. Each element of the array is a Vector3 instance representing a normal."
	},
	"name_full": "worldeditadditions_core.terrain.calculate_normals",
	"filename": "worldeditadditions_core/utils/terrain/calculate_normals.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/terrain/calculate_normals.lua#L7-L14"
}

--- Converts a 2d heightmap into slope values in radians.
-- Convert a radians to degrees by doing (radians*math.pi) / 180 for display,
-- but it is STRONGLY recommended to keep all internal calculations in radians.
-- @param	heightmap		table	A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().
-- @param	heightmap_size	int[]	The size of the heightmap in the form [ z, x ]
-- @return	Vector[]		The calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians.
local function calculate_slopes(heightmap, heightmap_size)

{
	"type": "function",
	"internal": false,
	"description": "Converts a 2d heightmap into slope values in radians.\nConvert a radians to degrees by doing (radians*math.pi) / 180 for display,\nbut it is STRONGLY recommended to keep all internal calculations in radians.",
	"directives": [
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().",
			"name": "heightmap",
			"type": "table",
			"description": "A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap()."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]",
			"name": "heightmap_size",
			"type": "int[]",
			"description": "The size of the heightmap in the form [ z, x ]"
		},
		{
			"directive": "returns",
			"text": "Vector[]\t\tThe calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians.",
			"type": "Vector[]",
			"description": "The calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.terrain",
	"line_last": 12,
	"name": "calculate_slopes",
	"instanced": false,
	"args": [
		"heightmap",
		"heightmap_size"
	],
	"text": "--- Converts a 2d heightmap into slope values in radians.\n-- Convert a radians to degrees by doing (radians*math.pi) / 180 for display,\n-- but it is STRONGLY recommended to keep all internal calculations in radians.\n-- @param\theightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().\n-- @param\theightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]\n-- @return\tVector[]\t\tThe calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians.\nlocal function calculate_slopes(heightmap, heightmap_size)",
	"params": [
		{
			"directive": "param",
			"text": "heightmap\t\ttable\tA ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap().",
			"name": "heightmap",
			"type": "table",
			"description": "A ZERO indexed flat heightmap. See worldeditadditions.terrain.make_heightmap()."
		},
		{
			"directive": "param",
			"text": "heightmap_size\tint[]\tThe size of the heightmap in the form [ z, x ]",
			"name": "heightmap_size",
			"type": "int[]",
			"description": "The size of the heightmap in the form [ z, x ]"
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector[]\t\tThe calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians.",
		"type": "Vector[]",
		"description": "The calculated slope map, in the same form as the input heightmap. Each element of the array is a (floating-point) number representing the slope in that cell in radians."
	},
	"name_full": "worldeditadditions_core.terrain.calculate_slopes",
	"filename": "worldeditadditions_core/utils/terrain/calculate_slopes.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/terrain/calculate_slopes.lua#L7-L13"
}

--- Given a manip object and associates, generates a 2D x/z heightmap.
-- Note that pos1 and pos2 should have already been pushed through
-- worldedit.sort_pos(pos1, pos2) before passing them to this function.
-- @param	pos1	Vector		Position 1 of the region to operate on
-- @param	pos2	Vector		Position 2 of the region to operate on
-- @param	manip	VoxelManip	The VoxelManip object.
-- @param	area	area		The associated area object.
-- @param	data	table		The associated data object.
-- @return	table,table			The ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }.
local function make_heightmap(pos1, pos2, manip, area, data)

{
	"type": "function",
	"internal": false,
	"description": "Given a manip object and associates, generates a 2D x/z heightmap.\nNote that pos1 and pos2 should have already been pushed through\nworldedit.sort_pos(pos1, pos2) before passing them to this function.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tVector\t\tPosition 1 of the region to operate on",
			"name": "pos1",
			"type": "Vector",
			"description": "Position 1 of the region to operate on"
		},
		{
			"directive": "param",
			"text": "pos2\tVector\t\tPosition 2 of the region to operate on",
			"name": "pos2",
			"type": "Vector",
			"description": "Position 2 of the region to operate on"
		},
		{
			"directive": "param",
			"text": "manip\tVoxelManip\tThe VoxelManip object.",
			"name": "manip",
			"type": "VoxelManip",
			"description": "The VoxelManip object."
		},
		{
			"directive": "param",
			"text": "area\tarea\t\tThe associated area object.",
			"name": "area",
			"type": "area",
			"description": "The associated area object."
		},
		{
			"directive": "param",
			"text": "data\ttable\t\tThe associated data object.",
			"name": "data",
			"type": "table",
			"description": "The associated data object."
		},
		{
			"directive": "returns",
			"text": "table,table\t\t\tThe ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }.",
			"type": "table,table",
			"description": "The ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.terrain",
	"line_last": 15,
	"name": "make_heightmap",
	"instanced": false,
	"args": [
		"pos1",
		"pos2",
		"manip",
		"area",
		"data"
	],
	"text": "--- Given a manip object and associates, generates a 2D x/z heightmap.\n-- Note that pos1 and pos2 should have already been pushed through\n-- worldedit.sort_pos(pos1, pos2) before passing them to this function.\n-- @param\tpos1\tVector\t\tPosition 1 of the region to operate on\n-- @param\tpos2\tVector\t\tPosition 2 of the region to operate on\n-- @param\tmanip\tVoxelManip\tThe VoxelManip object.\n-- @param\tarea\tarea\t\tThe associated area object.\n-- @param\tdata\ttable\t\tThe associated data object.\n-- @return\ttable,table\t\t\tThe ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }.\nlocal function make_heightmap(pos1, pos2, manip, area, data)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tVector\t\tPosition 1 of the region to operate on",
			"name": "pos1",
			"type": "Vector",
			"description": "Position 1 of the region to operate on"
		},
		{
			"directive": "param",
			"text": "pos2\tVector\t\tPosition 2 of the region to operate on",
			"name": "pos2",
			"type": "Vector",
			"description": "Position 2 of the region to operate on"
		},
		{
			"directive": "param",
			"text": "manip\tVoxelManip\tThe VoxelManip object.",
			"name": "manip",
			"type": "VoxelManip",
			"description": "The VoxelManip object."
		},
		{
			"directive": "param",
			"text": "area\tarea\t\tThe associated area object.",
			"name": "area",
			"type": "area",
			"description": "The associated area object."
		},
		{
			"directive": "param",
			"text": "data\ttable\t\tThe associated data object.",
			"name": "data",
			"type": "table",
			"description": "The associated data object."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "table,table\t\t\tThe ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }.",
		"type": "table,table",
		"description": "The ZERO-indexed heightmap data (as 1 single flat array), followed by the size of the heightmap in the form { z = size_z, x = size_x }."
	},
	"name_full": "worldeditadditions_core.terrain.make_heightmap",
	"filename": "worldeditadditions_core/utils/terrain/make_heightmap.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/terrain/make_heightmap.lua#L7-L16"
}

--- Returns the absolute form of this vector.
-- In other words, it removes the minus sign from all components of the vector.
-- @param	a		Vector3		The vector to operate on.
-- @returns	Vector3	The absolute form of the given vector.
function Vector3.abs(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns the absolute form of this vector.\nIn other words, it removes the minus sign from all components of the vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tThe absolute form of the given vector.",
			"type": "Vector3",
			"description": "The absolute form of the given vector."
		}
	],
	"line": 268,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 272,
	"name": "abs",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns the absolute form of this vector.\n-- In other words, it removes the minus sign from all components of the vector.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tThe absolute form of the given vector.\nfunction Vector3.abs(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tThe absolute form of the given vector.",
		"type": "Vector3",
		"description": "The absolute form of the given vector."
	},
	"name_full": "worldeditadditions_core.Vector3.abs",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L269-L273"
}

--- Adds the specified vectors or numbers together.
-- Returns the result as a new vector.
-- If 1 of the inputs is a number and the other a vector, then the number will
-- be added to each of the components of the vector.
-- @param	a	Vector3|number	The first item to add.
-- @param	a	Vector3|number	The second item to add.
-- @returns	Vector3				The result as a new Vector3 object.
function Vector3.add(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Adds the specified vectors or numbers together.\nReturns the result as a new vector.\nIf 1 of the inputs is a number and the other a vector, then the number will\nbe added to each of the components of the vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to add.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to add."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to add.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to add."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
			"type": "Vector3",
			"description": "The result as a new Vector3 object."
		}
	],
	"line": 31,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 38,
	"name": "add",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Adds the specified vectors or numbers together.\n-- Returns the result as a new vector.\n-- If 1 of the inputs is a number and the other a vector, then the number will\n-- be added to each of the components of the vector.\n-- @param\ta\tVector3|number\tThe first item to add.\n-- @param\ta\tVector3|number\tThe second item to add.\n-- @returns\tVector3\t\t\t\tThe result as a new Vector3 object.\nfunction Vector3.add(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to add.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to add."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to add.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to add."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
		"type": "Vector3",
		"description": "The result as a new Vector3 object."
	},
	"name_full": "worldeditadditions_core.Vector3.add",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L32-L39"
}

--- Returns the area of this vector.
-- In other words, multiplies all the components together and returns a scalar value.
-- @param	a		Vector3		The vector to return the area of.
-- @returns	number	The area of this vector.
function Vector3.area(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns the area of this vector.\nIn other words, multiplies all the components together and returns a scalar value.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to return the area of.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to return the area of."
		},
		{
			"directive": "returns",
			"text": "number\tThe area of this vector.",
			"type": "number",
			"description": "The area of this vector."
		}
	],
	"line": 146,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 150,
	"name": "area",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns the area of this vector.\n-- In other words, multiplies all the components together and returns a scalar value.\n-- @param\ta\t\tVector3\t\tThe vector to return the area of.\n-- @returns\tnumber\tThe area of this vector.\nfunction Vector3.area(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to return the area of.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to return the area of."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe area of this vector.",
		"type": "number",
		"description": "The area of this vector."
	},
	"name_full": "worldeditadditions_core.Vector3.area",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L147-L151"
}

--- Rounds the components of this vector up.
-- @param 	a		Vector3		The vector to operate on.
-- @returns	Vector3	A new instance with the x/y/z components rounded up.
function Vector3.ceil(a)

{
	"type": "function",
	"internal": false,
	"description": "Rounds the components of this vector up.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new instance with the x/y/z components rounded up.",
			"type": "Vector3",
			"description": "A new instance with the x/y/z components rounded up."
		}
	],
	"line": 114,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 117,
	"name": "ceil",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Rounds the components of this vector up.\n-- @param \ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tA new instance with the x/y/z components rounded up.\nfunction Vector3.ceil(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new instance with the x/y/z components rounded up.",
		"type": "Vector3",
		"description": "A new instance with the x/y/z components rounded up."
	},
	"name_full": "worldeditadditions_core.Vector3.ceil",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L115-L118"
}

--- Clamps the given point to fall within the region defined by 2 points.
-- @param	a		Vector3		The target vector to clamp.
-- @param	pos1	Vector3	pos1 of the defined region.
-- @param	pos2	Vector3	pos2 of the defined region.
-- @returns	Vector3	The target vector, clamped to fall within the defined region.
function Vector3.clamp(a, pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Clamps the given point to fall within the region defined by 2 points.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe target vector to clamp.",
			"name": "a",
			"type": "Vector3",
			"description": "The target vector to clamp."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		},
		{
			"directive": "returns",
			"text": "Vector3\tThe target vector, clamped to fall within the defined region.",
			"type": "Vector3",
			"description": "The target vector, clamped to fall within the defined region."
		}
	],
	"line": 319,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 324,
	"name": "clamp",
	"instanced": false,
	"args": [
		"a",
		"pos1",
		"pos2"
	],
	"text": "--- Clamps the given point to fall within the region defined by 2 points.\n-- @param\ta\t\tVector3\t\tThe target vector to clamp.\n-- @param\tpos1\tVector3\tpos1 of the defined region.\n-- @param\tpos2\tVector3\tpos2 of the defined region.\n-- @returns\tVector3\tThe target vector, clamped to fall within the defined region.\nfunction Vector3.clamp(a, pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe target vector to clamp.",
			"name": "a",
			"type": "Vector3",
			"description": "The target vector to clamp."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tThe target vector, clamped to fall within the defined region.",
		"type": "Vector3",
		"description": "The target vector, clamped to fall within the defined region."
	},
	"name_full": "worldeditadditions_core.Vector3.clamp",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L320-L325"
}

--- Returns a new instance of this vector.
-- @param	a			Vector3		The vector to clone.
-- @returns	Vector3		A new vector whose values are identical to those of the original vector.
function Vector3.clone(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns a new instance of this vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\t\tVector3\t\tThe vector to clone.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to clone."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\tA new vector whose values are identical to those of the original vector.",
			"type": "Vector3",
			"description": "A new vector whose values are identical to those of the original vector."
		}
	],
	"line": 24,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 27,
	"name": "clone",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns a new instance of this vector.\n-- @param\ta\t\t\tVector3\t\tThe vector to clone.\n-- @returns\tVector3\t\tA new vector whose values are identical to those of the original vector.\nfunction Vector3.clone(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\t\tVector3\t\tThe vector to clone.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to clone."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\tA new vector whose values are identical to those of the original vector.",
		"type": "Vector3",
		"description": "A new vector whose values are identical to those of the original vector."
	},
	"name_full": "worldeditadditions_core.Vector3.clone",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L25-L28"
}

--- Divides the specified vectors or numbers together.
-- Returns the result as a new vector.
-- If 1 of the inputs is a number and the other a vector, then the number will
-- be divided to each of the components of the vector.
-- @param	a	Vector3|number	The first item to divide.
-- @param	a	Vector3|number	The second item to divide.
-- @returns	Vector3				The result as a new Vector3 object.
function Vector3.divide(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Divides the specified vectors or numbers together.\nReturns the result as a new vector.\nIf 1 of the inputs is a number and the other a vector, then the number will\nbe divided to each of the components of the vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to divide.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to divide."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to divide.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to divide."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
			"type": "Vector3",
			"description": "The result as a new Vector3 object."
		}
	],
	"line": 88,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 95,
	"name": "divide",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Divides the specified vectors or numbers together.\n-- Returns the result as a new vector.\n-- If 1 of the inputs is a number and the other a vector, then the number will\n-- be divided to each of the components of the vector.\n-- @param\ta\tVector3|number\tThe first item to divide.\n-- @param\ta\tVector3|number\tThe second item to divide.\n-- @returns\tVector3\t\t\t\tThe result as a new Vector3 object.\nfunction Vector3.divide(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to divide.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to divide."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to divide.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to divide."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
		"type": "Vector3",
		"description": "The result as a new Vector3 object."
	},
	"name_full": "worldeditadditions_core.Vector3.divide",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L89-L96"
}

--- Calculates the dot product of this vector and another vector.
-- @param	a		Vector3		The first vector to operate on.
-- @param	a		Vector3		The second vector to operate on.
-- @returns	number	The dot product of this vector as a scalar value.
function Vector3.dot(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Calculates the dot product of this vector and another vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe first vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe second vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The second vector to operate on."
		},
		{
			"directive": "returns",
			"text": "number\tThe dot product of this vector as a scalar value.",
			"type": "number",
			"description": "The dot product of this vector as a scalar value."
		}
	],
	"line": 185,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 189,
	"name": "dot",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Calculates the dot product of this vector and another vector.\n-- @param\ta\t\tVector3\t\tThe first vector to operate on.\n-- @param\ta\t\tVector3\t\tThe second vector to operate on.\n-- @returns\tnumber\tThe dot product of this vector as a scalar value.\nfunction Vector3.dot(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe first vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe second vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The second vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe dot product of this vector as a scalar value.",
		"type": "number",
		"description": "The dot product of this vector as a scalar value."
	},
	"name_full": "worldeditadditions_core.Vector3.dot",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L186-L190"
}

--- Determines if 2 vectors are equal to each other.
-- 2 vectors are equal if their values are identical.
-- @param	a		Vector3		The first vector to test.
-- @param	a		Vector3		The second vector to test.
-- @returns	bool	Whether the 2 vectors are equal or not.
function Vector3.equals(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Determines if 2 vectors are equal to each other.\n2 vectors are equal if their values are identical.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe first vector to test.",
			"name": "a",
			"type": "Vector3",
			"description": "The first vector to test."
		},
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe second vector to test.",
			"name": "a",
			"type": "Vector3",
			"description": "The second vector to test."
		},
		{
			"directive": "returns",
			"text": "bool\tWhether the 2 vectors are equal or not.",
			"type": "bool",
			"description": "Whether the 2 vectors are equal or not."
		}
	],
	"line": 197,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 202,
	"name": "equals",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Determines if 2 vectors are equal to each other.\n-- 2 vectors are equal if their values are identical.\n-- @param\ta\t\tVector3\t\tThe first vector to test.\n-- @param\ta\t\tVector3\t\tThe second vector to test.\n-- @returns\tbool\tWhether the 2 vectors are equal or not.\nfunction Vector3.equals(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe first vector to test.",
			"name": "a",
			"type": "Vector3",
			"description": "The first vector to test."
		},
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe second vector to test.",
			"name": "a",
			"type": "Vector3",
			"description": "The second vector to test."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "bool\tWhether the 2 vectors are equal or not.",
		"type": "bool",
		"description": "Whether the 2 vectors are equal or not."
	},
	"name_full": "worldeditadditions_core.Vector3.equals",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L198-L203"
}

--- Expands the defined region to include the given point.
-- @param	target	Vector3	The target vector to include.
-- @param	pos1	Vector3	pos1 of the defined region.
-- @param	pos2	Vector3	pos2 of the defined region.
-- @returns	Vector3,Vector3		2 vectors that represent the expand_region.
function Vector3.expand_region(target, pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Expands the defined region to include the given point.",
	"directives": [
		{
			"directive": "param",
			"text": "target\tVector3\tThe target vector to include.",
			"name": "target",
			"type": "Vector3",
			"description": "The target vector to include."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		},
		{
			"directive": "returns",
			"text": "Vector3,Vector3\t\t2 vectors that represent the expand_region.",
			"type": "Vector3,Vector3",
			"description": "2 vectors that represent the expand_region."
		}
	],
	"line": 331,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 336,
	"name": "expand_region",
	"instanced": false,
	"args": [
		"target",
		"pos1",
		"pos2"
	],
	"text": "--- Expands the defined region to include the given point.\n-- @param\ttarget\tVector3\tThe target vector to include.\n-- @param\tpos1\tVector3\tpos1 of the defined region.\n-- @param\tpos2\tVector3\tpos2 of the defined region.\n-- @returns\tVector3,Vector3\t\t2 vectors that represent the expand_region.\nfunction Vector3.expand_region(target, pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "target\tVector3\tThe target vector to include.",
			"name": "target",
			"type": "Vector3",
			"description": "The target vector to include."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3,Vector3\t\t2 vectors that represent the expand_region.",
		"type": "Vector3,Vector3",
		"description": "2 vectors that represent the expand_region."
	},
	"name_full": "worldeditadditions_core.Vector3.expand_region",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L332-L337"
}

--- Rounds the components of this vector down.
-- @param 	a		Vector3		The vector to operate on.
-- @returns	Vector3	A new instance with the x/y/z components rounded down.
function Vector3.floor(a)

{
	"type": "function",
	"internal": false,
	"description": "Rounds the components of this vector down.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new instance with the x/y/z components rounded down.",
			"type": "Vector3",
			"description": "A new instance with the x/y/z components rounded down."
		}
	],
	"line": 108,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 111,
	"name": "floor",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Rounds the components of this vector down.\n-- @param \ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tA new instance with the x/y/z components rounded down.\nfunction Vector3.floor(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new instance with the x/y/z components rounded down.",
		"type": "Vector3",
		"description": "A new instance with the x/y/z components rounded down."
	},
	"name_full": "worldeditadditions_core.Vector3.floor",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L109-L112"
}

--- Given 2 angles and a length, return a Vector3 pointing in that direction.
-- Consider a sphere, with the 2 angles defining a point on the sphere's surface.
-- This function returns that point as a Vector3.
-- @source	https://math.stackexchange.com/a/1881767/221181
-- @param	angle_x		number	The X angle.
-- @param	angle_y		number	The Y angle.
-- @param	length		number	The radius of the sphere in question.
-- @returns	Vector3		The point on the sphere defined by the aforementioned parameters.
function Vector3.fromBearing(angle_x, angle_y, length)

{
	"type": "function",
	"internal": false,
	"description": "Given 2 angles and a length, return a Vector3 pointing in that direction.\nConsider a sphere, with the 2 angles defining a point on the sphere's surface.\nThis function returns that point as a Vector3.",
	"directives": [
		{
			"directive": "source",
			"text": "https://math.stackexchange.com/a/1881767/221181"
		},
		{
			"directive": "param",
			"text": "angle_x\t\tnumber\tThe X angle.",
			"name": "angle_x",
			"type": "number",
			"description": "The X angle."
		},
		{
			"directive": "param",
			"text": "angle_y\t\tnumber\tThe Y angle.",
			"name": "angle_y",
			"type": "number",
			"description": "The Y angle."
		},
		{
			"directive": "param",
			"text": "length\t\tnumber\tThe radius of the sphere in question.",
			"name": "length",
			"type": "number",
			"description": "The radius of the sphere in question."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\tThe point on the sphere defined by the aforementioned parameters.",
			"type": "Vector3",
			"description": "The point on the sphere defined by the aforementioned parameters."
		}
	],
	"line": 396,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 404,
	"name": "fromBearing",
	"instanced": false,
	"args": [
		"angle_x",
		"angle_y",
		"length"
	],
	"text": "--- Given 2 angles and a length, return a Vector3 pointing in that direction.\n-- Consider a sphere, with the 2 angles defining a point on the sphere's surface.\n-- This function returns that point as a Vector3.\n-- @source\thttps://math.stackexchange.com/a/1881767/221181\n-- @param\tangle_x\t\tnumber\tThe X angle.\n-- @param\tangle_y\t\tnumber\tThe Y angle.\n-- @param\tlength\t\tnumber\tThe radius of the sphere in question.\n-- @returns\tVector3\t\tThe point on the sphere defined by the aforementioned parameters.\nfunction Vector3.fromBearing(angle_x, angle_y, length)",
	"params": [
		{
			"directive": "param",
			"text": "angle_x\t\tnumber\tThe X angle.",
			"name": "angle_x",
			"type": "number",
			"description": "The X angle."
		},
		{
			"directive": "param",
			"text": "angle_y\t\tnumber\tThe Y angle.",
			"name": "angle_y",
			"type": "number",
			"description": "The Y angle."
		},
		{
			"directive": "param",
			"text": "length\t\tnumber\tThe radius of the sphere in question.",
			"name": "length",
			"type": "number",
			"description": "The radius of the sphere in question."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\tThe point on the sphere defined by the aforementioned parameters.",
		"type": "Vector3",
		"description": "The point on the sphere defined by the aforementioned parameters."
	},
	"name_full": "worldeditadditions_core.Vector3.fromBearing",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L397-L405"
}

--- Determines if this vector is contained within the region defined by the given vectors.
-- @param	a		Vector3		The target vector to check.
-- @param	pos1	Vector3		pos1 of the defined region.
-- @param	pos2	Vector3		pos2 of the defined region.
-- @return	boolean	Whether the given target is contained within the defined worldedit region.
function Vector3.is_contained(target, pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Determines if this vector is contained within the region defined by the given vectors.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe target vector to check.",
			"name": "a",
			"type": "Vector3",
			"description": "The target vector to check."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		},
		{
			"directive": "returns",
			"text": "boolean\tWhether the given target is contained within the defined worldedit region.",
			"type": "boolean",
			"description": "Whether the given target is contained within the defined worldedit region."
		}
	],
	"line": 303,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 308,
	"name": "is_contained",
	"instanced": false,
	"args": [
		"target",
		"pos1",
		"pos2"
	],
	"text": "--- Determines if this vector is contained within the region defined by the given vectors.\n-- @param\ta\t\tVector3\t\tThe target vector to check.\n-- @param\tpos1\tVector3\t\tpos1 of the defined region.\n-- @param\tpos2\tVector3\t\tpos2 of the defined region.\n-- @return\tboolean\tWhether the given target is contained within the defined worldedit region.\nfunction Vector3.is_contained(target, pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe target vector to check.",
			"name": "a",
			"type": "Vector3",
			"description": "The target vector to check."
		},
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3",
			"description": "pos2 of the defined region."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "boolean\tWhether the given target is contained within the defined worldedit region.",
		"type": "boolean",
		"description": "Whether the given target is contained within the defined worldedit region."
	},
	"name_full": "worldeditadditions_core.Vector3.is_contained",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L304-L309"
}

--- Calculates the scalar length of this vector.
-- @param	a		Vector3		The vector to operate on.
-- @returns	number	The length of this vector as a scalar value.
function Vector3.length(a)

{
	"type": "function",
	"internal": false,
	"description": "Calculates the scalar length of this vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "number\tThe length of this vector as a scalar value.",
			"type": "number",
			"description": "The length of this vector as a scalar value."
		}
	],
	"line": 168,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 171,
	"name": "length",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Calculates the scalar length of this vector.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tnumber\tThe length of this vector as a scalar value.\nfunction Vector3.length(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe length of this vector as a scalar value.",
		"type": "number",
		"description": "The length of this vector as a scalar value."
	},
	"name_full": "worldeditadditions_core.Vector3.length",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L169-L172"
}

--- Returns the scalar length of this vector squared.
-- @param	a		Vector3		The vector to operate on.
-- @returns	number	The length squared of this vector as a scalar value.
function Vector3.length_squared(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns the scalar length of this vector squared.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "number\tThe length squared of this vector as a scalar value.",
			"type": "number",
			"description": "The length squared of this vector as a scalar value."
		}
	],
	"line": 154,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 157,
	"name": "length_squared",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns the scalar length of this vector squared.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tnumber\tThe length squared of this vector as a scalar value.\nfunction Vector3.length_squared(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe length squared of this vector as a scalar value.",
		"type": "number",
		"description": "The length squared of this vector as a scalar value."
	},
	"name_full": "worldeditadditions_core.Vector3.length_squared",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L155-L158"
}

--- Returns a new vector whose length clamped to the given length.
-- The direction in which the vector is pointing is not changed.
-- @param	a		Vector3		The vector to operate on.
-- @returns	Vector3	A new Vector3 instance limited to the specified length.
function Vector3.limit_to(a, length)

{
	"type": "function",
	"internal": false,
	"description": "Returns a new vector whose length clamped to the given length.\nThe direction in which the vector is pointing is not changed.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new Vector3 instance limited to the specified length.",
			"type": "Vector3",
			"description": "A new Vector3 instance limited to the specified length."
		}
	],
	"line": 208,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 212,
	"name": "limit_to",
	"instanced": false,
	"args": [
		"a",
		"length"
	],
	"text": "--- Returns a new vector whose length clamped to the given length.\n-- The direction in which the vector is pointing is not changed.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tA new Vector3 instance limited to the specified length.\nfunction Vector3.limit_to(a, length)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new Vector3 instance limited to the specified length.",
		"type": "Vector3",
		"description": "A new Vector3 instance limited to the specified length."
	},
	"name_full": "worldeditadditions_core.Vector3.limit_to",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L209-L213"
}

--- Returns a vector of the max values of 2 vectors.
-- @param	pos1	Vector3		The first vector to operate on.
-- @param	pos2	Vector3		The second vector to operate on.
-- @return	Vector3		The maximum values from the input vectors.
function Vector3.max(pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Returns a vector of the max values of 2 vectors.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3",
			"description": "The second vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\tThe maximum values from the input vectors.",
			"type": "Vector3",
			"description": "The maximum values from the input vectors."
		}
	],
	"line": 378,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 382,
	"name": "max",
	"instanced": false,
	"args": [
		"pos1",
		"pos2"
	],
	"text": "--- Returns a vector of the max values of 2 vectors.\n-- @param\tpos1\tVector3\t\tThe first vector to operate on.\n-- @param\tpos2\tVector3\t\tThe second vector to operate on.\n-- @return\tVector3\t\tThe maximum values from the input vectors.\nfunction Vector3.max(pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3",
			"description": "The second vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\tThe maximum values from the input vectors.",
		"type": "Vector3",
		"description": "The maximum values from the input vectors."
	},
	"name_full": "worldeditadditions_core.Vector3.max",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L379-L383"
}

--- Returns the value of the maximum component of the vector.
-- Returns a scalar value.
-- @param	a		Vector3		The vector to operate on.
-- @returns	number	The value of the maximum component of the vector.
function Vector3.max_component(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns the value of the maximum component of the vector.\nReturns a scalar value.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "number\tThe value of the maximum component of the vector.",
			"type": "number",
			"description": "The value of the maximum component of the vector."
		}
	],
	"line": 260,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 264,
	"name": "max_component",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns the value of the maximum component of the vector.\n-- Returns a scalar value.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tnumber\tThe value of the maximum component of the vector.\nfunction Vector3.max_component(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe value of the maximum component of the vector.",
		"type": "number",
		"description": "The value of the maximum component of the vector."
	},
	"name_full": "worldeditadditions_core.Vector3.max_component",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L261-L265"
}

--- Returns the mean (average) of 2 positions.
-- In other words, returns the centre of 2 points.
-- @param	pos1	Vector3|number	pos1 of the defined region.
-- @param	pos2	Vector3|number	pos2 of the defined region.
-- @param	target	Vector3	Centre coordinates.
function Vector3.mean(pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Returns the mean (average) of 2 positions.\nIn other words, returns the centre of 2 points.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tVector3|number\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3|number",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3|number\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3|number",
			"description": "pos2 of the defined region."
		},
		{
			"directive": "param",
			"text": "target\tVector3\tCentre coordinates.",
			"name": "target",
			"type": "Vector3",
			"description": "Centre coordinates."
		}
	],
	"line": 350,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 355,
	"name": "mean",
	"instanced": false,
	"args": [
		"pos1",
		"pos2"
	],
	"text": "--- Returns the mean (average) of 2 positions.\n-- In other words, returns the centre of 2 points.\n-- @param\tpos1\tVector3|number\tpos1 of the defined region.\n-- @param\tpos2\tVector3|number\tpos2 of the defined region.\n-- @param\ttarget\tVector3\tCentre coordinates.\nfunction Vector3.mean(pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tVector3|number\tpos1 of the defined region.",
			"name": "pos1",
			"type": "Vector3|number",
			"description": "pos1 of the defined region."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3|number\tpos2 of the defined region.",
			"name": "pos2",
			"type": "Vector3|number",
			"description": "pos2 of the defined region."
		},
		{
			"directive": "param",
			"text": "target\tVector3\tCentre coordinates.",
			"name": "target",
			"type": "Vector3",
			"description": "Centre coordinates."
		}
	],
	"name_full": "worldeditadditions_core.Vector3.mean",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L351-L356"
}

--- Returns a vector of the min components of 2 vectors.
-- @param	pos1	Vector3|number	The first vector to operate on.
-- @param	pos2	Vector3|number	The second vector to operate on.
-- @return	Vector3	The minimum values from the input vectors
function Vector3.min(pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Returns a vector of the min components of 2 vectors.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tVector3|number\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3|number",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3|number\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3|number",
			"description": "The second vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tThe minimum values from the input vectors",
			"type": "Vector3",
			"description": "The minimum values from the input vectors"
		}
	],
	"line": 360,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 364,
	"name": "min",
	"instanced": false,
	"args": [
		"pos1",
		"pos2"
	],
	"text": "--- Returns a vector of the min components of 2 vectors.\n-- @param\tpos1\tVector3|number\tThe first vector to operate on.\n-- @param\tpos2\tVector3|number\tThe second vector to operate on.\n-- @return\tVector3\tThe minimum values from the input vectors\nfunction Vector3.min(pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tVector3|number\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3|number",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3|number\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3|number",
			"description": "The second vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tThe minimum values from the input vectors",
		"type": "Vector3",
		"description": "The minimum values from the input vectors"
	},
	"name_full": "worldeditadditions_core.Vector3.min",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L361-L365"
}

--- Returns the value of the minimum component of the vector.
-- Returns a scalar value.
-- @param	a		Vector3		The vector to operate on.
-- @returns	number	The value of the minimum component of the vector.
function Vector3.min_component(a)

{
	"type": "function",
	"internal": false,
	"description": "Returns the value of the minimum component of the vector.\nReturns a scalar value.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "number\tThe value of the minimum component of the vector.",
			"type": "number",
			"description": "The value of the minimum component of the vector."
		}
	],
	"line": 252,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 256,
	"name": "min_component",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Returns the value of the minimum component of the vector.\n-- Returns a scalar value.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tnumber\tThe value of the minimum component of the vector.\nfunction Vector3.min_component(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "number\tThe value of the minimum component of the vector.",
		"type": "number",
		"description": "The value of the minimum component of the vector."
	},
	"name_full": "worldeditadditions_core.Vector3.min_component",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L253-L257"
}

--- Return a vector that is amount distance towards b from a.
-- @param	a		Vector3		The vector to move from.
-- @param	b		Vector3		The vector to move towards.
-- @param	amount	number		The amount to move.
function Vector3.move_towards(a, b, amount)

{
	"type": "function",
	"internal": false,
	"description": "Return a vector that is amount distance towards b from a.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to move from.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to move from."
		},
		{
			"directive": "param",
			"text": "b\t\tVector3\t\tThe vector to move towards.",
			"name": "b",
			"type": "Vector3",
			"description": "The vector to move towards."
		},
		{
			"directive": "param",
			"text": "amount\tnumber\t\tThe amount to move.",
			"name": "amount",
			"type": "number",
			"description": "The amount to move."
		}
	],
	"line": 244,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 248,
	"name": "move_towards",
	"instanced": false,
	"args": [
		"a",
		"b",
		"amount"
	],
	"text": "--- Return a vector that is amount distance towards b from a.\n-- @param\ta\t\tVector3\t\tThe vector to move from.\n-- @param\tb\t\tVector3\t\tThe vector to move towards.\n-- @param\tamount\tnumber\t\tThe amount to move.\nfunction Vector3.move_towards(a, b, amount)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to move from.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to move from."
		},
		{
			"directive": "param",
			"text": "b\t\tVector3\t\tThe vector to move towards.",
			"name": "b",
			"type": "Vector3",
			"description": "The vector to move towards."
		},
		{
			"directive": "param",
			"text": "amount\tnumber\t\tThe amount to move.",
			"name": "amount",
			"type": "number",
			"description": "The amount to move."
		}
	],
	"name_full": "worldeditadditions_core.Vector3.move_towards",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L245-L249"
}

--- Multiplies the specified vectors or numbers together.
-- Returns the result as a new vector.
-- If 1 of the inputs is a number and the other a vector, then the number will
-- be multiplied to each of the components of the vector.
--
-- If both of the inputs are vectors, then the components are multiplied
-- by each other (NOT the cross product). In other words:
-- a.x * b.x, a.y * b.y, a.z * b.z
--
-- @param	a	Vector3|number	The first item to multiply.
-- @param	a	Vector3|number	The second item to multiply.
-- @returns	Vector3				The result as a new Vector3 object.
function Vector3.multiply(a, b)

{
	"type": "function",
	"internal": false,
	"description": "Multiplies the specified vectors or numbers together.\nReturns the result as a new vector.\nIf 1 of the inputs is a number and the other a vector, then the number will\nbe multiplied to each of the components of the vector.\n\nIf both of the inputs are vectors, then the components are multiplied\nby each other (NOT the cross product). In other words:\na.x * b.x, a.y * b.y, a.z * b.z\n",
	"directives": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to multiply.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to multiply."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to multiply.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to multiply."
		},
		{
			"directive": "returns",
			"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
			"type": "Vector3",
			"description": "The result as a new Vector3 object."
		}
	],
	"line": 65,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 77,
	"name": "multiply",
	"instanced": false,
	"args": [
		"a",
		"b"
	],
	"text": "--- Multiplies the specified vectors or numbers together.\n-- Returns the result as a new vector.\n-- If 1 of the inputs is a number and the other a vector, then the number will\n-- be multiplied to each of the components of the vector.\n--\n-- If both of the inputs are vectors, then the components are multiplied\n-- by each other (NOT the cross product). In other words:\n-- a.x * b.x, a.y * b.y, a.z * b.z\n--\n-- @param\ta\tVector3|number\tThe first item to multiply.\n-- @param\ta\tVector3|number\tThe second item to multiply.\n-- @returns\tVector3\t\t\t\tThe result as a new Vector3 object.\nfunction Vector3.multiply(a, b)",
	"params": [
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe first item to multiply.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The first item to multiply."
		},
		{
			"directive": "param",
			"text": "a\tVector3|number\tThe second item to multiply.",
			"name": "a",
			"type": "Vector3|number",
			"description": "The second item to multiply."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\t\t\t\tThe result as a new Vector3 object.",
		"type": "Vector3",
		"description": "The result as a new Vector3 object."
	},
	"name_full": "worldeditadditions_core.Vector3.multiply",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L66-L78"
}

--- Creates a new Vector3 instance.
-- @param x		number	The x co-ordinate value.
-- @param y		number	The y co-ordinate value.
-- @param z		number	The z co-ordinate value.
function Vector3.new(x, y, z)

{
	"type": "function",
	"internal": false,
	"description": "Creates a new Vector3 instance.",
	"directives": [
		{
			"directive": "param",
			"text": "x\t\tnumber\tThe x co-ordinate value.",
			"name": "x",
			"type": "number",
			"description": "The x co-ordinate value."
		},
		{
			"directive": "param",
			"text": "y\t\tnumber\tThe y co-ordinate value.",
			"name": "y",
			"type": "number",
			"description": "The y co-ordinate value."
		},
		{
			"directive": "param",
			"text": "z\t\tnumber\tThe z co-ordinate value.",
			"name": "z",
			"type": "number",
			"description": "The z co-ordinate value."
		}
	],
	"line": 6,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 10,
	"name": "new",
	"instanced": false,
	"args": [
		"x",
		"y",
		"z"
	],
	"text": "--- Creates a new Vector3 instance.\n-- @param x\t\tnumber\tThe x co-ordinate value.\n-- @param y\t\tnumber\tThe y co-ordinate value.\n-- @param z\t\tnumber\tThe z co-ordinate value.\nfunction Vector3.new(x, y, z)",
	"params": [
		{
			"directive": "param",
			"text": "x\t\tnumber\tThe x co-ordinate value.",
			"name": "x",
			"type": "number",
			"description": "The x co-ordinate value."
		},
		{
			"directive": "param",
			"text": "y\t\tnumber\tThe y co-ordinate value.",
			"name": "y",
			"type": "number",
			"description": "The y co-ordinate value."
		},
		{
			"directive": "param",
			"text": "z\t\tnumber\tThe z co-ordinate value.",
			"name": "z",
			"type": "number",
			"description": "The z co-ordinate value."
		}
	],
	"name_full": "worldeditadditions_core.Vector3.new",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L7-L11"
}

--- Rotate a given point around an origin point in 3d space.
-- Consider 3 axes (X, Y, and Z) that are centred on origin. This function
-- rotates point around these axes in the aforementioned order.
-- 
-- NOTE: This function is not as intuitive as it sounds.
-- A whiteboard and a head for mathematics is recommended before using this
-- function. Either that, or Blender 3 (https://blender.org/) is quite useful to visualise what's going on.
-- @source	GitHub Copilot, generated 2023-01-17
-- @warning	Not completely tested! Pending a thorough evaluation. Seems to basically work, after some tweaks to the fluff around the edges?
-- @param	origin	Vector3	The origin point to rotate around
-- @param	point	Vector3	The point to rotate.
-- @param	rotate	Vector3	Rotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!
-- @param	x		number	Rotate this much around the X axis (yz plane), in radians.
-- @param	y		number	Rotate this much around the Y axis (xz plane), in radians.
-- @param	z		number	Rotate this much around the Z axis (xy plane), in radians.
-- @return	Vector3	The rotated point.
function Vector3.rotate3d(origin, point, rotate)

{
	"type": "function",
	"internal": false,
	"description": "Rotate a given point around an origin point in 3d space.\nConsider 3 axes (X, Y, and Z) that are centred on origin. This function\nrotates point around these axes in the aforementioned order.\n\nNOTE: This function is not as intuitive as it sounds.\nA whiteboard and a head for mathematics is recommended before using this\nfunction. Either that, or Blender 3 (https://blender.org/) is quite useful to visualise what's going on.",
	"directives": [
		{
			"directive": "source",
			"text": "GitHub Copilot, generated 2023-01-17"
		},
		{
			"directive": "warning",
			"text": "Not completely tested! Pending a thorough evaluation. Seems to basically work, after some tweaks to the fluff around the edges?"
		},
		{
			"directive": "param",
			"text": "origin\tVector3\tThe origin point to rotate around",
			"name": "origin",
			"type": "Vector3",
			"description": "The origin point to rotate around"
		},
		{
			"directive": "param",
			"text": "point\tVector3\tThe point to rotate.",
			"name": "point",
			"type": "Vector3",
			"description": "The point to rotate."
		},
		{
			"directive": "param",
			"text": "rotate\tVector3\tRotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!",
			"name": "rotate",
			"type": "Vector3",
			"description": "Rotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!"
		},
		{
			"directive": "param",
			"text": "x\t\tnumber\tRotate this much around the X axis (yz plane), in radians.",
			"name": "x",
			"type": "number",
			"description": "Rotate this much around the X axis (yz plane), in radians."
		},
		{
			"directive": "param",
			"text": "y\t\tnumber\tRotate this much around the Y axis (xz plane), in radians.",
			"name": "y",
			"type": "number",
			"description": "Rotate this much around the Y axis (xz plane), in radians."
		},
		{
			"directive": "param",
			"text": "z\t\tnumber\tRotate this much around the Z axis (xy plane), in radians.",
			"name": "z",
			"type": "number",
			"description": "Rotate this much around the Z axis (xy plane), in radians."
		},
		{
			"directive": "returns",
			"text": "Vector3\tThe rotated point.",
			"type": "Vector3",
			"description": "The rotated point."
		}
	],
	"line": 412,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 428,
	"name": "rotate3d",
	"instanced": false,
	"args": [
		"origin",
		"point",
		"rotate"
	],
	"text": "--- Rotate a given point around an origin point in 3d space.\n-- Consider 3 axes (X, Y, and Z) that are centred on origin. This function\n-- rotates point around these axes in the aforementioned order.\n-- \n-- NOTE: This function is not as intuitive as it sounds.\n-- A whiteboard and a head for mathematics is recommended before using this\n-- function. Either that, or Blender 3 (https://blender.org/) is quite useful to visualise what's going on.\n-- @source\tGitHub Copilot, generated 2023-01-17\n-- @warning\tNot completely tested! Pending a thorough evaluation. Seems to basically work, after some tweaks to the fluff around the edges?\n-- @param\torigin\tVector3\tThe origin point to rotate around\n-- @param\tpoint\tVector3\tThe point to rotate.\n-- @param\trotate\tVector3\tRotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!\n-- @param\tx\t\tnumber\tRotate this much around the X axis (yz plane), in radians.\n-- @param\ty\t\tnumber\tRotate this much around the Y axis (xz plane), in radians.\n-- @param\tz\t\tnumber\tRotate this much around the Z axis (xy plane), in radians.\n-- @return\tVector3\tThe rotated point.\nfunction Vector3.rotate3d(origin, point, rotate)",
	"params": [
		{
			"directive": "param",
			"text": "origin\tVector3\tThe origin point to rotate around",
			"name": "origin",
			"type": "Vector3",
			"description": "The origin point to rotate around"
		},
		{
			"directive": "param",
			"text": "point\tVector3\tThe point to rotate.",
			"name": "point",
			"type": "Vector3",
			"description": "The point to rotate."
		},
		{
			"directive": "param",
			"text": "rotate\tVector3\tRotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!",
			"name": "rotate",
			"type": "Vector3",
			"description": "Rotate this much around the 3 different axes, x, y, and z. Axial rotations are handled in this order: X→Y→Z. Values MUST be in radians!"
		},
		{
			"directive": "param",
			"text": "x\t\tnumber\tRotate this much around the X axis (yz plane), in radians.",
			"name": "x",
			"type": "number",
			"description": "Rotate this much around the X axis (yz plane), in radians."
		},
		{
			"directive": "param",
			"text": "y\t\tnumber\tRotate this much around the Y axis (xz plane), in radians.",
			"name": "y",
			"type": "number",
			"description": "Rotate this much around the Y axis (xz plane), in radians."
		},
		{
			"directive": "param",
			"text": "z\t\tnumber\tRotate this much around the Z axis (xy plane), in radians.",
			"name": "z",
			"type": "number",
			"description": "Rotate this much around the Z axis (xy plane), in radians."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tThe rotated point.",
		"type": "Vector3",
		"description": "The rotated point."
	},
	"name_full": "worldeditadditions_core.Vector3.rotate3d",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L413-L429"
}

--- Rounds the components of this vector.
-- @param 	a		Vector3		The vector to operate on.
-- @returns	Vector3	A new instance with the x/y/z components rounded.
function Vector3.round(a)

{
	"type": "function",
	"internal": false,
	"description": "Rounds the components of this vector.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new instance with the x/y/z components rounded.",
			"type": "Vector3",
			"description": "A new instance with the x/y/z components rounded."
		}
	],
	"line": 120,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 123,
	"name": "round",
	"instanced": false,
	"args": [
		"a"
	],
	"text": "--- Rounds the components of this vector.\n-- @param \ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tA new instance with the x/y/z components rounded.\nfunction Vector3.round(a)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new instance with the x/y/z components rounded.",
		"type": "Vector3",
		"description": "A new instance with the x/y/z components rounded."
	},
	"name_full": "worldeditadditions_core.Vector3.round",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L121-L124"
}

--- Rounds the components of this vector to the specified number of decimal places.
-- @param	a		Vector3	The vector to round.
-- @param	dp		number	The number of decimal places to round to.
-- @returns	Vector3	A new instance with the components rounded to the specified number of decimal places.
function Vector3.round_dp(a, dp)

{
	"type": "function",
	"internal": false,
	"description": "Rounds the components of this vector to the specified number of decimal places.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\tThe vector to round.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to round."
		},
		{
			"directive": "param",
			"text": "dp\t\tnumber\tThe number of decimal places to round to.",
			"name": "dp",
			"type": "number",
			"description": "The number of decimal places to round to."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new instance with the components rounded to the specified number of decimal places.",
			"type": "Vector3",
			"description": "A new instance with the components rounded to the specified number of decimal places."
		}
	],
	"line": 127,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 131,
	"name": "round_dp",
	"instanced": false,
	"args": [
		"a",
		"dp"
	],
	"text": "--- Rounds the components of this vector to the specified number of decimal places.\n-- @param\ta\t\tVector3\tThe vector to round.\n-- @param\tdp\t\tnumber\tThe number of decimal places to round to.\n-- @returns\tVector3\tA new instance with the components rounded to the specified number of decimal places.\nfunction Vector3.round_dp(a, dp)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\tThe vector to round.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to round."
		},
		{
			"directive": "param",
			"text": "dp\t\tnumber\tThe number of decimal places to round to.",
			"name": "dp",
			"type": "number",
			"description": "The number of decimal places to round to."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new instance with the components rounded to the specified number of decimal places.",
		"type": "Vector3",
		"description": "A new instance with the components rounded to the specified number of decimal places."
	},
	"name_full": "worldeditadditions_core.Vector3.round_dp",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L128-L132"
}

--- Returns a new vector whose length clamped to the given length.
-- The direction in which the vector is pointing is not changed.
-- @param	a		Vector3		The vector to operate on.
-- @returns	Vector3	A new Vector3 instance limited to the specified length.
function Vector3.set_to(a, length)

{
	"type": "function",
	"internal": false,
	"description": "Returns a new vector whose length clamped to the given length.\nThe direction in which the vector is pointing is not changed.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new Vector3 instance limited to the specified length.",
			"type": "Vector3",
			"description": "A new Vector3 instance limited to the specified length."
		}
	],
	"line": 221,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 225,
	"name": "set_to",
	"instanced": false,
	"args": [
		"a",
		"length"
	],
	"text": "--- Returns a new vector whose length clamped to the given length.\n-- The direction in which the vector is pointing is not changed.\n-- @param\ta\t\tVector3\t\tThe vector to operate on.\n-- @returns\tVector3\tA new Vector3 instance limited to the specified length.\nfunction Vector3.set_to(a, length)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new Vector3 instance limited to the specified length.",
		"type": "Vector3",
		"description": "A new Vector3 instance limited to the specified length."
	},
	"name_full": "worldeditadditions_core.Vector3.set_to",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L222-L226"
}

--- Snaps this Vector3 to an imaginary square grid with the specified sized
-- squares.
-- @param 	a		Vector3		The vector to operate on.
-- @param	number	grid_size	The size of the squares on the imaginary grid to which to snap.
-- @returns	Vector3	A new Vector3 instance snapped to an imaginary grid of the specified size.
function Vector3.snap_to(a, grid_size)

{
	"type": "function",
	"internal": false,
	"description": "Snaps this Vector3 to an imaginary square grid with the specified sized\nsquares.",
	"directives": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "param",
			"text": "number\tgrid_size\tThe size of the squares on the imaginary grid to which to snap.",
			"name": "number",
			"type": "grid_size",
			"description": "The size of the squares on the imaginary grid to which to snap."
		},
		{
			"directive": "returns",
			"text": "Vector3\tA new Vector3 instance snapped to an imaginary grid of the specified size.",
			"type": "Vector3",
			"description": "A new Vector3 instance snapped to an imaginary grid of the specified size."
		}
	],
	"line": 137,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 142,
	"name": "snap_to",
	"instanced": false,
	"args": [
		"a",
		"grid_size"
	],
	"text": "--- Snaps this Vector3 to an imaginary square grid with the specified sized\n-- squares.\n-- @param \ta\t\tVector3\t\tThe vector to operate on.\n-- @param\tnumber\tgrid_size\tThe size of the squares on the imaginary grid to which to snap.\n-- @returns\tVector3\tA new Vector3 instance snapped to an imaginary grid of the specified size.\nfunction Vector3.snap_to(a, grid_size)",
	"params": [
		{
			"directive": "param",
			"text": "a\t\tVector3\t\tThe vector to operate on.",
			"name": "a",
			"type": "Vector3",
			"description": "The vector to operate on."
		},
		{
			"directive": "param",
			"text": "number\tgrid_size\tThe size of the squares on the imaginary grid to which to snap.",
			"name": "number",
			"type": "grid_size",
			"description": "The size of the squares on the imaginary grid to which to snap."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3\tA new Vector3 instance snapped to an imaginary grid of the specified size.",
		"type": "Vector3",
		"description": "A new Vector3 instance snapped to an imaginary grid of the specified size."
	},
	"name_full": "worldeditadditions_core.Vector3.snap_to",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L138-L143"
}

--- Sorts the components of the given vectors.
-- pos1 will contain the minimum values, and pos2 the maximum values.
-- Returns 2 new vectors.
-- Note that for this specific function
-- the vectors provided do not *have* to be instances of Vector3.
-- It is only required that they have the keys x, y, and z.
-- Vector3 instances are always returned.
-- This enables convenient ingesting of positions from outside.
-- @param	pos1	Vector3		The first vector to operate on.
-- @param	pos2	Vector3		The second vector to operate on.
-- @returns	Vector3,Vector3		The 2 sorted vectors (min, max).
function Vector3.sort(pos1, pos2)

{
	"type": "function",
	"internal": false,
	"description": "Sorts the components of the given vectors.\npos1 will contain the minimum values, and pos2 the maximum values.\nReturns 2 new vectors.\nNote that for this specific function\nthe vectors provided do not *have* to be instances of Vector3.\nIt is only required that they have the keys x, y, and z.\nVector3 instances are always returned.\nThis enables convenient ingesting of positions from outside.",
	"directives": [
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3",
			"description": "The second vector to operate on."
		},
		{
			"directive": "returns",
			"text": "Vector3,Vector3\t\tThe 2 sorted vectors (min, max).",
			"type": "Vector3,Vector3",
			"description": "The 2 sorted vectors (min, max)."
		}
	],
	"line": 276,
	"namespace": "worldeditadditions_core.Vector3",
	"line_last": 287,
	"name": "sort",
	"instanced": false,
	"args": [
		"pos1",
		"pos2"
	],
	"text": "--- Sorts the components of the given vectors.\n-- pos1 will contain the minimum values, and pos2 the maximum values.\n-- Returns 2 new vectors.\n-- Note that for this specific function\n-- the vectors provided do not *have* to be instances of Vector3.\n-- It is only required that they have the keys x, y, and z.\n-- Vector3 instances are always returned.\n-- This enables convenient ingesting of positions from outside.\n-- @param\tpos1\tVector3\t\tThe first vector to operate on.\n-- @param\tpos2\tVector3\t\tThe second vector to operate on.\n-- @returns\tVector3,Vector3\t\tThe 2 sorted vectors (min, max).\nfunction Vector3.sort(pos1, pos2)",
	"params": [
		{
			"directive": "param",
			"text": "pos1\tVector3\t\tThe first vector to operate on.",
			"name": "pos1",
			"type": "Vector3",
			"description": "The first vector to operate on."
		},
		{
			"directive": "param",
			"text": "pos2\tVector3\t\tThe second vector to operate on.",
			"name": "pos2",
			"type": "Vector3",
			"description": "The second vector to operate on."
		}
	],
	"returns": {
		"directive": "returns",
		"text": "Vector3,Vector3\t\tThe 2 sorted vectors (min, max).",
		"type": "Vector3,Vector3",
		"description": "The 2 sorted vectors (min, max)."
	},
	"name_full": "worldeditadditions_core.Vector3.sort",
	"filename": "worldeditadditions_core/utils/vector3.lua",
	"url": "https://github.com/sbrl/Minetest-WorldEditAdditions/blob/dev/worldeditadditions_core/utils/vector3.lua#L277-L288"
}