MineClone2/mods/ITEMS/mcl_stairs/API.md

5.3 KiB

API for mcl_stairs

Register your own stairs and slabs!

Quick start

Register platinum stair and slab based on node example:platinum:

mcl_stairs.register_stair_and_slab_simple("platinum", "example:platinum", "Platinum Stair", "Platinum Slab", "Double Platinum Slab")

mcl_stairs.register_stair_and_slab_simple(subname, sourcenode, desc_stair, desc_slab, double_description, corner_stair_texture_override)

Register a simple stair and a slab. The stair and slab will inherit all attributes from sourcenode. The sourcenode is also used as the item for crafting recipes. If multiple nodes should craft into the same stairs/slab, see mcl_stairs.register_craft_stairs or mcl_stairs.register_craft_slab

This function is meant for simple nodes; if you need more flexibility, use one of the other functions instead.

See register_stair and register_slab for the itemstrings of the registered nodes.

Parameters

  • subname: Name fragment for node itemstrings (see register_stair and register_slab)
  • sourcenode: The node on which this stair is based on
  • desc_stair: Description of stair node
  • desc_slab: Description of slab node
  • double_description: Description of double slab node
  • corner_stair_texture_override: Optional, see register_stair

mcl_stairs.register_stair_and_slab(subname, recipeitem, groups, images, desc_stair, desc_slab, sounds, hardness, double_description, corner_stair_texture_override)

Register a simple stair and a slab, plus crafting recipes. In this function, you need to specify most things explicitly.

Parameters

  • desc_stair: Description of stair node
  • desc_slab: Description of slab node
  • Other parameters: Same as for register_stair and register_slab

mcl_stairs.register_stair(subname, recipeitem, groups, images, description, sounds, hardness, corner_stair_texture_override)

Registers a stair. This also includes the inner and outer corner stairs, they are added automatically. Also adds crafting recipes.

The itemstrings for the registered nodes will be of the form:

  • mcl_stairs:stair_<subname>: Normal stair
  • mcl_stairs:stair_<subname>_inner: Inner stair
  • mcl_stairs:stair_<subname>_outer: Outer stair

Parameters

  • subname: Name fragment for node itemstrings (see above)
  • recipeitem: Item for crafting recipe and attribute inheritance. Do not use group: prefix here, alternative recipes can be registered using mcl_stairs.register_craft_stairs(subname, recipeitem_or_group).
  • groups: Groups used for stair
  • images: Textures
  • description: Stair description/tooltip
  • sounds: Sounds table
  • hardness: MCL2 block hardness value
  • corner_stair_texture_override: Optional. Custom textures for corner stairs, see below

groups, images, sounds or hardness can be nil, in which case the value is inhereted from the recipeitem.

corner_stair_texture_override

This optional parameter specifies the textures to be used for corner stairs.

It can be one of the following data types:

  • string: one of:
    • "default": Use same textures as original node
    • "woodlike": Take first frame of the original tiles, then take a triangle piece of the texture, rotate it by 90° and overlay it over the original texture
  • table: Specify textures explicitly. Table of tiles to override textures for inner and outer stairs. Table format: { tiles_def_for_outer_stair, tiles_def_for_inner_stair }
  • nil: Equivalent to "default"

mcl_stairs.register_slab(subname, recipeitem, groups, images, description, sounds, hardness, double_description)

Registers a slab and a corresponding double slab. Also adds crafting recipe.

The itemstrings for the registered nodes will be of the form:

  • mcl_stairs:slab_<subname>: Slab
  • mcl_stairs:slab_<subname>_top: Upper slab, used internally
  • mcl_stairs:slab_<subname>_double: Double slab

Parameters

  • double_description: Node description/tooltip for double slab
  • Other parameters: Same as for register_stair

mcl_stairs.register_craft_stairs(subname, recipeitem)

Just registers a recipe for mcl_stairs:stair_<subname>. Useful if a node variant should craft the same stairs as the base node, since the above functions use the same parameter for crafting material and attribute inheritance. e.g. 6 Purpur Pillar -> 4 Purpur Stairs is an alternate recipe.

Creates staircase recipes with 6 input items, both left-facing and right-facing. Outputs 4 stairs.

The itemstring for the output node will be of the form:

  • mcl_stairs:stair_<subname>: Normal stair

Parameters

  • subname: Name fragment for node itemstring (see above)
  • recipeitem: Item for crafting recipe. Use group: prefix to use a group instead

mcl_stairs.register_craft_slab(subname, recipeitem)

Just registers a recipe for mcl_stairs:slab_<subname>. Useful if a node variant should craft the same stairs as the base node, since the above functions use the same parameter for crafting material and attribute inheritance. e.g. 3 Quartz Pillar -> 6 Quartz Slab is an alternate recipe.

Creates slab recipe with 3 input items in any horizontal line. Outputs 6 slabs.

The itemstring for the output node will be of the form:

  • mcl_stairs:slab_<subname>: Slab

Parameters

  • subname: Name fragment for node itemstring (see above)
  • recipeitem: Item for crafting recipe. Use group: prefix to use a group instead