**Title:** Greek

**Description:** 

**Details:**
_It's all Greek to me._  

This mod is completely dependency-agnostic, meaning no extra mods are required to have any content. Some mods are optionally required to provide certain crafting recipes (see [Dependencies](#dependencies)). All non-`greek` recipe items are configurable (see [Configuration](#configuration)).

## Contents
* Polished marble
* Carved marble tiles
* Painted marble tiles
* Marble pillars
* Marble detailing (acroterions, triglyphs, metopes)
* Gilded gold
* Vases
* Lamps and fire bowls
* Blue doors and shutters
* Stairs for most listed nodes

See [the complete item list](https://github.com/GreenXenith/greek?tab=readme-ov-file#full-lists) for more details.

## Dependencies
All listed dependencies are only defaults and are configurable unless noted otherwise.

* `stairs`: May provide more up-to-date stair placement functionality. Not required for stairs.
* `dye`: Used in numerous color recipes, mainly render and painted tiles (non-configurable).
* `darkage`: Provides marble and chalk (used in polished marble and cement, respectively).
* `building_blocks`: Provides marble for polished marble.
* `technic_worldgen`: Provides marble for polished marble.
* `default`: Provides silver sandstone (for cement), gold block (for gilded gold), clay (for red clay), and steel ingot (for locked doors). Also provides various `group:wood`s.
* `basic_materials`: Provides padlock for locked doors.

## Configuration
All craftitems are configurable via the `minetest.conf` using settings listed in [settingtypes.txt](https://github.com/GreenXenith/greek/blob/master/settingtypes.txt). Craftitem settings use a comma-deliminated list of itemstrings. Each item listed, if available, will be used as a valid item in crafting recipes using that item type. Some `greek` implementations are included by default, but may be disabled by removing the items from their lists.  

Configurable item types:

* Marble: Used to craft polished marble. Polished marble is in turn used to craft all other marble-related items.   
  NOTE: If [greeknodes compaitibility](#compatibility) is enabled, at least one registered item must be in this list.
* Limestone: Used to craft cement for render.
* Cement: Used to craft render.
* Gold block: Used to craft gilded gold.
* Clay: Used to craft red clay.
* Blue wood: Used to craft doors and shutters.
* Lock: Used to craft locked doors.

Other settings:

* Stairs in creative inventory
* Dye consumption upon coloring
* Maximum vase capacity
* Snuff fire bowls on dig
* Enable `greeknodes` aliases
* Alias `greeknodes` marble to polished marble
* Alias `greeknodes` tar to building_blocks equivalents

See [settingtypes.txt](https://github.com/GreenXenith/greek/blob/master/settingtypes.txt) for defaults.  

## Compatibility
This mod is the successor to my old `greeknodes` mod. Aliases are registered by default to convert old `greeknodes` items to `greek` items. For this to be successful, at least one valid marble item must be configured, or aliasing to polished marble must be enabled. Compatibility can be [disabled](#configuration) entirely, of course.

## Implementations
### Coloring
Some nodes (render, painted tiles) have 8 available colors variants. They can be obtained by combining them with a dye (dye is consumed by default) or punching a colorable node with a dye.

### Stairs
I need to be able to use dye punch-coloring on certain stairs (painted tile, render). Default stairs has two issues:

* Takes explicit definition values instead of a whole definition
* Doesn't return what items were actually registered

As such, I've rolled my own implementation near-identical to that of default stairs, but a bit more succinct and generic. I've used the rotation functions from default stairs, and it will poll for a more up-to-date function if default stairs is enabled.

### Doors
Depending on external mods for content would not be very dependency-agnostic, so I've opted to roll my own doors as simply as I could manage. My implementation is smaller and in some ways more naive than default doors, but it works as well as I'd like.

Doors are implemented using only 2 (a, b) nodes per type rather than 8 (a, b, c, d, for unlocked and locked). An open A door is identical to a closed B door, and vise-versa, provided the front and back of the door texture is identical. Locked doors are implemented using param2 palette index (locked doors have a silver handle). They can only be obtained via crafting.

Doors also support skeleton keys. As an extended key feature, you can bind already-bound keys to unbound doors.

### Craftrings
Some nodes have many near-identical variants (such as metopes). Rather than making a unique crafting recipe for each node, a "craftring" is registered to loop through all possible variants. Placing one version of the item in the crafting grid will output the next version. The last variant will return the first variant (to form the loop).

As crafting large amounts of certain variants can be tedious, variants can be copied. Placing 2 of a target variant in the crafting grid with another variant will output the target variant and keep the other 2 target variants.

```
+-+-+-+    +-+-+-+  +-+
|A|A|B| -> |A|A| |  |A|
+-+-+-+    +-+-+-+  +-+
```

## Todo
* Configurable sounds
* Translation support
* Posable statues
* ???

**Tags:** building, decorative
**Repository:** https://github.com/GreenXenith/greek
**License:** MIT