Add definitions/{DecorationDefinition,LSystemTreeDefinition}.lua and specs/SchematicSpecifier.lua.
This commit is contained in:
243
definitions/DecorationDefinition.lua
Normal file
243
definitions/DecorationDefinition.lua
Normal file
@@ -0,0 +1,243 @@
|
||||
--- @meta
|
||||
|
||||
|
||||
--- DecorationDefinition describes a decoration to be registered with core.register_decoration().
|
||||
--- See [Decoration types](https://api.luanti.org/definition-tables/#decoration-types).
|
||||
--- @class DecorationDefinition
|
||||
local DecorationDefinition = {
|
||||
--- Type of decoration. "simple", "schematic" or "lsystem" supported.
|
||||
--- @type 'simple'|'schematic'|'lsystem'?
|
||||
deco_type = '',
|
||||
|
||||
--- Node (or list of nodes) that the decoration can be placed on.
|
||||
--- @type string|string[]?
|
||||
place_on = '',
|
||||
|
||||
--- Size of the square (X / Z) divisions of the mapchunk being generated.
|
||||
--- Determines the resolution of noise variation if used.
|
||||
--- If the chunk size is not evenly divisible by sidelen, sidelen is made
|
||||
--- equal to the chunk size.
|
||||
--- @type integer?
|
||||
sidelen = 0,
|
||||
|
||||
--- The value determines 'decorations per surface node'.
|
||||
--- Used only if noise_params is not specified.
|
||||
--- If >= 10.0 complete coverage is enabled and decoration placement uses
|
||||
--- a different and much faster method.
|
||||
--- @type number?
|
||||
fill_ratio = 0.02,
|
||||
|
||||
--- NoiseParams structure describing the noise used for decoration
|
||||
--- distribution.
|
||||
--- A noise value is calculated for each square division and determines
|
||||
--- 'decorations per surface node' within each division.
|
||||
--- If the noise value >= 10.0 complete coverage is enabled and
|
||||
--- decoration placement uses a different and much faster method.
|
||||
--- If this parameter is omitted, fill_ratio is used instead.
|
||||
---
|
||||
--- Example:
|
||||
--- ```lua
|
||||
--- noise_params = {
|
||||
--- offset = 0,
|
||||
--- scale = 0.45,
|
||||
--- spread = { x = 100, y = 100, z = 100 },
|
||||
--- seed = 354,
|
||||
--- octaves = 3,
|
||||
--- persistence = 0.7,
|
||||
--- lacunarity = 2.0,
|
||||
--- flags = 'absvalue',
|
||||
--- },
|
||||
--- ```
|
||||
--- @type NoiseParams?
|
||||
noise_params = nil,
|
||||
|
||||
--- List of biomes in which this decoration occurs. Occurs in all biomes
|
||||
--- if this is omitted, and ignored if the Mapgen being used does not
|
||||
--- support biomes.
|
||||
--- Can be a list of (or a single) biome names, IDs, or definitions.
|
||||
--- @type string[]|string|integer[]|integer|BiomeDefinition[]|BiomeDefinition?
|
||||
biomes = {},
|
||||
|
||||
--- Lower limit for decoration (inclusive).
|
||||
--- These parameter refer to the Y coordinate of the 'place_on' node.
|
||||
--- @type integer?
|
||||
y_min = -31000,
|
||||
--- Upper limit for decoration (inclusive).
|
||||
--- These parameter refer to the Y coordinate of the 'place_on' node.
|
||||
--- @type integer?
|
||||
y_max = 31000,
|
||||
|
||||
--- Node (or list of nodes) that the decoration only spawns next to.
|
||||
--- Checks the 8 neighboring nodes on the same height,
|
||||
--- and also the ones at the height plus the `check_offset`, excluding both center nodes.
|
||||
---
|
||||
--- For example `'default:water'` will make the decoration only spawn next to water.
|
||||
--- If instead a list of nodes is given, the decoration will spawn next to any of them.
|
||||
--- If omitted, no check is performed.
|
||||
---
|
||||
--- @type string|string[]?
|
||||
spawn_by = '',
|
||||
|
||||
--- Specifies the offset that `spawn_by` should also check.
|
||||
--- The default value of -1 is useful to e.g check for water next to the base node.
|
||||
--- 0 disables additional checks, valid values: {-1, 0, 1}
|
||||
--- @type -1|0|1?
|
||||
check_offset = -1,
|
||||
|
||||
--- Number of `spawn_by` nodes that must be surrounding the decoration
|
||||
--- position to occur.
|
||||
--- If absent or -1, decorations occur next to any nodes.
|
||||
--- @type integer?
|
||||
num_spawn_by = 1,
|
||||
|
||||
--- Flags for all decoration types.
|
||||
--- "liquid_surface": Find the highest liquid (not solid) surface under
|
||||
--- open air. Search stops and fails on the first solid node.
|
||||
--- Cannot be used with "all_floors" or "all_ceilings" below.
|
||||
--- "force_placement": Nodes other than "air" and "ignore" are replaced
|
||||
--- by the decoration.
|
||||
--- "all_floors", "all_ceilings": Instead of placement on the highest
|
||||
--- surface in a mapchunk the decoration is placed on all floor and/or
|
||||
--- ceiling surfaces, for example in caves and dungeons.
|
||||
--- Ceiling decorations act as an inversion of floor decorations so the
|
||||
--- effect of 'place_offset_y' is inverted.
|
||||
--- Y-slice probabilities do not function correctly for ceiling
|
||||
--- schematic decorations as the behavior is unchanged.
|
||||
--- If a single decoration registration has both flags the floor and
|
||||
--- ceiling decorations will be aligned vertically.
|
||||
--- @type string?
|
||||
flags = 'liquid_surface, force_placement, all_floors, all_ceilings',
|
||||
|
||||
----- Simple-type parameters
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- The node name used as the decoration.
|
||||
--- If instead a list of strings, a randomly selected node from the list
|
||||
--- is placed as the decoration.
|
||||
--- @type string|string[]?
|
||||
decoration = 'default:grass',
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- Decoration height in nodes.
|
||||
--- If height_max is not 0, this is the lower limit of a randomly
|
||||
--- selected height.
|
||||
--- @type integer?
|
||||
height = 1,
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- Upper limit of the randomly selected height.
|
||||
--- If absent, the parameter 'height' is used as a constant.
|
||||
--- @type integer?
|
||||
height_max = 0,
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- Param2 value of decoration nodes.
|
||||
--- If param2_max is not 0, this is the lower limit of a randomly
|
||||
--- selected param2.
|
||||
--- @type integer?
|
||||
param2 = 0,
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- Upper limit of the randomly selected param2.
|
||||
--- If absent, the parameter 'param2' is used as a constant.
|
||||
--- @type integer?
|
||||
param2_max = 0,
|
||||
|
||||
--- Used when `deco_type` is `"simple"`.
|
||||
---
|
||||
--- Y offset of the decoration base node relative to the standard base
|
||||
--- node position.
|
||||
--- Can be positive or negative. Default is 0.
|
||||
--- Effect is inverted for "all_ceilings" decorations.
|
||||
--- Ignored by 'y_min', 'y_max' and 'spawn_by' checks, which always refer
|
||||
--- to the 'place_on' node.
|
||||
--- @type integer?
|
||||
place_offset_y = 0,
|
||||
|
||||
----- Schematic-type parameters
|
||||
|
||||
--- Used when `deco_type` is `"schematic"`.
|
||||
---
|
||||
--- If schematic is a string, it is the filepath relative to the current
|
||||
--- working directory of the specified Luanti schematic file.
|
||||
--- Could also be the ID of a previously registered schematic.
|
||||
---
|
||||
--- If schematic is a table, it is a SchematicSpecifier structure
|
||||
--- describing the schematic directly.
|
||||
--- The fields `size` and `data` are mandatory whereas `yslice_prob` is optional.
|
||||
--- See ['Schematic specifier'](https://api.luanti.org/schematics/#schematic-specifier) for details.
|
||||
--- Example:
|
||||
--- ```lua
|
||||
--- {
|
||||
--- size = { x = 4, y = 6, z = 4 },
|
||||
--- data = {
|
||||
--- { name = 'default:cobble', param1 = 255, param2 = 0 },
|
||||
--- { name = 'default:dirt_with_grass', param1 = 255, param2 = 0 },
|
||||
--- { name = 'air', param1 = 255, param2 = 0 },
|
||||
--- ...,
|
||||
--- },
|
||||
--- yslice_prob = {
|
||||
--- { ypos = 2, prob = 128 },
|
||||
--- { ypos = 5, prob = 64 },
|
||||
--- ...,
|
||||
--- },
|
||||
--- }
|
||||
--- ```
|
||||
--- @type string|integer|SchematicSpecifier?
|
||||
schematic = nil,
|
||||
|
||||
--- Used when `deco_type` is `"schematic"`.
|
||||
---
|
||||
--- Map of node names to replace in the schematic after reading it.
|
||||
--- Key is the old node name, value is the new node name.
|
||||
--- If a node name is not found in the map, it is not replaced.
|
||||
--- This is useful for reusing schematics with different materials.
|
||||
---
|
||||
--- Example: `{ ['default:wood'] = 'default:pine_wood', ['default:leaves'] = 'default:pine_leaves' }`
|
||||
---
|
||||
--- @type table<string, string>?
|
||||
replacements = nil,
|
||||
|
||||
--- Used when `deco_type` is `"schematic"`.
|
||||
---
|
||||
--- Flags for schematic decorations. See ['Schematic attributes'](https://api.luanti.org/schematics/#schematic-attributes).
|
||||
---
|
||||
--- Example: `flags = 'place_center_x, place_center_y, place_center_z'`
|
||||
---
|
||||
--- @type string?
|
||||
flags = '',
|
||||
|
||||
--- Used when `deco_type` is `"schematic"`.
|
||||
---
|
||||
--- Rotation can be "0", "90", "180", "270", or "random"
|
||||
--- @type '0'|'90'|'180'|'270'|'random'?
|
||||
rotation = '90',
|
||||
|
||||
--- Used when `deco_type` is `"schematic"`.
|
||||
---
|
||||
--- If the flag 'place_center_y' is set this parameter is ignored.
|
||||
--- Y offset of the schematic base node layer relative to the 'place_on'
|
||||
--- node.
|
||||
---
|
||||
--- Can be positive or negative. Default is 0.
|
||||
--- Effect is inverted for "all_ceilings" decorations.
|
||||
--- Ignored by 'y_min', 'y_max' and 'spawn_by' checks, which always refer
|
||||
--- to the 'place_on' node.
|
||||
--- @type integer?
|
||||
place_offset_y = 0,
|
||||
|
||||
----- L-system-type parameters
|
||||
|
||||
--- Used when `deco_type` is `"lsystem"`.
|
||||
---
|
||||
--- Same as for `core.spawn_tree`.
|
||||
--- See section [L-system trees](https://api.luanti.org/l-system-trees/) for more details.
|
||||
--- @see core.spawn_tree
|
||||
--- @type LSystemTreeDefinition?
|
||||
treedef = {},
|
||||
}
|
||||
20
definitions/LSystemTreeDefinition.lua
Normal file
20
definitions/LSystemTreeDefinition.lua
Normal file
@@ -0,0 +1,20 @@
|
||||
|
||||
--- @class LSystemTreeDefinition
|
||||
--- @field axiom string initial tree axiom
|
||||
--- @field rules_a string rules set A
|
||||
--- @field rules_b string rules set B
|
||||
--- @field rules_c string rules set C
|
||||
--- @field rules_d string rules set D
|
||||
--- @field trunk string trunk node name
|
||||
--- @field leaves string leaves node name
|
||||
--- @field leaves2 string secondary leaves node name
|
||||
--- @field leaves2_chance number chance (0-100) to replace leaves with leaves2
|
||||
--- @field angle number angle in degr
|
||||
--- @field iterations number max number of iterations, usually 2 -5
|
||||
--- @field random_level number factor to lower number of iterations, usually 0 - 3
|
||||
--- @field trunk_type string single/double/crossed) type of trunk: 1 node, 2x2 nodes or 3x3 in cross shape
|
||||
--- @field thin_branches boolean true -> use thin (1 node) branches
|
||||
--- @field fruit string fruit node name
|
||||
--- @field fruit_chance number chance (0-100) to replace leaves with fruit node
|
||||
--- @field seed number random seed, if no seed is provided, the engine will create one.
|
||||
local LSystemTreeDefinition = {}
|
||||
36
specs/SchematicSpecifier.lua
Normal file
36
specs/SchematicSpecifier.lua
Normal file
@@ -0,0 +1,36 @@
|
||||
--- @mete
|
||||
|
||||
|
||||
--- A schematic specifier identifies a schematic by either a filename to a Luanti Schematic file (.mts) or through raw data supplied through Lua, in the form of a table.
|
||||
--- @class SchematicSpecifier
|
||||
local SchematicSpecifier = {
|
||||
--- Size of the schematic.
|
||||
--- Vector containing the dimensions of the provided schematic. (required field)
|
||||
--- @type Position
|
||||
size = { x = 0, y = 0, z = 0 },
|
||||
|
||||
--- List of Y-slice probabilities.
|
||||
--- Each entry contains a Y position and a probability (0-255) that the slice at that Y position will be included when the schematic is placed.
|
||||
--- This allows for variation in the placed schematic.
|
||||
--- * A probability value of 0 or 1 means that node will never appear (0% chance).
|
||||
--- * A probability value of 254 or 255 means the node will always appear (100% chance).
|
||||
--- * If the probability value p is greater than 1, then there is a (p / 256 * 100) percent chance that node will appear when the schematic is placed on the map.
|
||||
---
|
||||
--- Table of {ypos, prob} slice tables. A slice table sets the probability of a particular horizontal slice of the schematic being placed.
|
||||
--- (optional field) ypos = 0 for the lowest horizontal slice of a schematic. The default of prob is 255.
|
||||
--- @type {ypos: integer, prob: integer}[]?
|
||||
yslice_prob = {},
|
||||
|
||||
--- List of nodes in the schematic.
|
||||
--- Flat table of MapNode tables making up the schematic, in the order of [z [y [x]]]. (required field)
|
||||
data = {
|
||||
--- @type string the name of the map node to place (required)
|
||||
name = '',
|
||||
--- @type integer? (alias param1): the probability of this node being placed (default: 255)
|
||||
prob = 0,
|
||||
--- @type integer? the raw param2 value of the node being placed onto the map (default: 0)
|
||||
param2 = 0,
|
||||
--- @type boolean? boolean representing if the node should forcibly overwrite any previous contents (default: false)
|
||||
force_place = false,
|
||||
},
|
||||
}
|
||||
Reference in New Issue
Block a user