Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document the waxables and oxidizables data maps #147

Merged
merged 3 commits into from
Aug 12, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 55 additions & 2 deletions docs/resources/server/datamaps/builtin.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,9 @@ Allows configuring composter values, as a replacement for `ComposterBlock.COMPOS
```json5
{
// A 0 to 1 (inclusive) float representing the chance that the item will update the level of the composter
"chance": 1
"chance": 1,
// Optional, defaults to false - whether farmer villagers can compost this item
"can_villager_compost": false
}
```

Expand Down Expand Up @@ -98,6 +100,33 @@ Example:
}
```

## `neoforge:oxidizables`

Allows configuring oxidation stages, as a replacement for `WeatheringCopper#NEXT_BY_BLOCK` (which will be ignored in 1.21.2). This data map is also used to build a reverse deoxidation map (for scraping with an axe). It is located at `neoforge/data_maps/block/oxidizables.json` and its objects have the following structure:
Matyrobbrt marked this conversation as resolved.
Show resolved Hide resolved
Matyrobbrt marked this conversation as resolved.
Show resolved Hide resolved
```json5
{
// The block this block will turn into once oxidized
"next_oxidized_stage": "examplemod:oxidized_block"
}
```

:::note
Custom blocks must implement `WeatheringCopperFullBlock` or `WeatheringCopper` and call `changeOverTime` in `randomTick` to oxidize naturally.
:::

Example:

```json5
{
"values": {
"mymod:custom_copper": {
// Make a custom copper block oxidize into custom oxidized copper
"next_oxidized_stage": "mymod:custom_oxidized_copper"
}
}
}
```

## `neoforge:parrot_imitations`

Allows configuring the sounds produced by parrots when they want to imitate a mob, as a replacement for `Parrot#MOB_SOUND_MAP` (which is now ignored). This data map is located at `neoforge/data_maps/entity_type/parrot_imitations.json` and its objects have the following structure:
Expand Down Expand Up @@ -141,7 +170,7 @@ Example:
"minecraft:armorer": {
// Make armorers give the raid hero the armorer gift loot table
"loot_table": "minecraft:gameplay/hero_of_the_village/armorer_gift"
},
}
}
}
```
Expand Down Expand Up @@ -170,5 +199,29 @@ Example:
}
```

## `neoforge:waxables`
Matyrobbrt marked this conversation as resolved.
Show resolved Hide resolved

Allows configuring the block a block will turn into when waxed (right clicked with a honeycomb), as a replacement for `HoneycombItem#WAXABLES` (which will be ignored in 1.21.2). This data map is also used to build a reverse dewaxing map (for scraping with an axe). It is located at `neoforge/data_maps/block/waxables.json` and its objects have the following structure:

```json5
{
// The waxed variant of this block
"waxed": "minecraft:iron_block"
}
```

Example:

```json5
{
"values": {
// Make gold blocks turn into iron blocks once waxed
"minecraft:gold_block": {
"waxed": "minecraft:iron_block"
}
}
}
```

[datacomponent]: ../../../items/datacomponents.md
[datamap]: index.md
Loading