forked from VoxeLibre/VoxeLibre
72 lines
4.2 KiB
Markdown
72 lines
4.2 KiB
Markdown
# API for adding MineClone 2 fences
|
|
This API allows you to add fences and fence gates.
|
|
The recommended function is `mcl_fences.register_fence_and_fence_gate`.
|
|
|
|
## ` mcl_fences.register_fence = function(id, fence_name, texture, groups, connects_to, sounds)`
|
|
Adds a fence without crafting recipe. A single node is created.
|
|
|
|
### Parameter
|
|
* `id`: A part of the itemstring of the node to create. The node name will be “`<modname>:<id>`”
|
|
* `fence_name`: User-visible name (`description`)
|
|
* `texture`: Texture to apply on the fence (all sides)
|
|
* `groups`: Table of groups to which the fence belongs to
|
|
* `hardness`: Hardness (if unsure, pick the hardness of the material node)
|
|
* `blast_resistance`: Blast resistance (if unsure, pick the blast resistance of the material node)
|
|
* `connects_to`: Table of nodes (itemstrings) to which the fence will connect to. Use `group:<groupname>` for all members of the group `<groupname>`
|
|
* `sounds`: Node sound table for the fence
|
|
|
|
### Return value
|
|
The full itemstring of the new fence node.
|
|
|
|
Notes: Fences will always have the group `fence=1`. They will always connect to solid nodes (group `solid=1`).
|
|
|
|
## `mcl_fences.register_fence_gate = function(id, fence_gate_name, texture, groups, sounds, sound_open, sound_close, sound_gain_open, sound_gain_close)`
|
|
Adds a fence gate without crafting recipe. This will create 2 nodes.
|
|
|
|
### Parameters
|
|
* `id`: A part of the itemstring of the nodes to create. The node names will be “`<modname>:<id>_gate`” and “`<modname>:<id>_gate_open`”
|
|
* `fence_gate_name`: User-visible name (`description`)
|
|
* `texture`: Texture to apply on the fence gate (all sides)
|
|
* `groups`: Table of groups to which the fence gate belongs to
|
|
* `hardness`: Hardness (if unsure, pick the hardness of the material node)
|
|
* `blast_resistance`: Blast resistance (if unsure, pick the blast resistance of the material node)
|
|
* `sounds`: Node sound table for the fence gate
|
|
* `sound_open`: Sound to play when opening fence gate (optional, default is wooden sound)
|
|
* `sound_close`: Sound to play when closing fence gate (optional, default is wooden sound)
|
|
* `sound_gain_open`: Gain (0.0-1.0) of the opening fence gate sound (optional, default is 0.3)
|
|
* `sound_gain_close`: Gain (0.0-1.0) of the closing fence gate sound (optional, default is 0.3)
|
|
|
|
Notes: Fence gates will always have the group `fence_gate=1`. The open fence gate will always have the group `not_in_creative_inventory=1`.
|
|
|
|
### Return value
|
|
This function returns 2 values, in the following order:
|
|
|
|
1. Itemstring of the closed fence gate
|
|
2. Itemstring of the open fence gate
|
|
|
|
## `mcl_fences.register_fence_and_fence_gate = function(id, fence_name, fence_gate_name, texture, groups, connects_to, sounds, sound_open, sound_close, sound_gain_open, sound_gain_close)`
|
|
Registers a fence and fence gate. This is basically a combination of the two functions above. This is the recommended way to add a fence / fence gate pair.
|
|
This will register 3 nodes in total without crafting recipes.
|
|
|
|
* `id`: A part of the itemstring of the nodes to create.
|
|
* `fence_name`: User-visible name (`description`) of the fence
|
|
* `fence_gate_name`: User-visible name (`description`) of the fence gate
|
|
* `texture`: Texture to apply on the fence and fence gate (all sides)
|
|
* `groups`: Table of groups to which the fence and fence gate belong to
|
|
* `hardness`: Hardness (if unsure, pick the hardness of the material node)
|
|
* `blast_resistance`: Blast resistance (if unsure, pick the blast resistance of the material node)
|
|
* `connects_to`: Table of nodes (itemstrings) to which the fence will connect to. Use `group:<groupname>` for all members of the group `<groupname>`
|
|
* `sounds`: Node sound table for the fence and the fence gate
|
|
* `sound_open`: Sound to play when opening fence gate (optional, default is wooden sound)
|
|
* `sound_close`: Sound to play when closing fence gate (optional, default is wooden sound)
|
|
* `sound_gain_open`: Gain (0.0-1.0) of the opening fence gate sound (optional, default is 0.3)
|
|
* `sound_gain_close`: Gain (0.0-1.0) of the closing fence gate sound (optional, default is 0.3)
|
|
|
|
### Return value
|
|
This function returns 3 values, in this order:
|
|
|
|
1. Itemstring of the fence
|
|
2. Itemstring of the closed fence gate
|
|
3. Itemstring of the open fence gate
|
|
|