Implement anvil

[ShockedPlot7560]

Introduction

As the title suggests, this PR implements the anvils

Relevant issues

• Implemented anvil functionality #6305 PR abandoned and reworked

Changes

API changes

• Introduce a new Durable::isValidRepairMaterial enabling everyone to implement their own verification logic
• Add repairMaterials to ArmorMaterial and ToolTier
• Add repairCost functions in Item

Behavioural changes

• Anvil works

Tests

I tested this PR by doing the following (tick all that apply):

• Writing PHPUnit tests (commit these in the tests/phpunit folder)
• Playtesting using a Minecraft client (provide screenshots or a video)
• Writing a test plugin (provide the code and sample output)
• Other (provide details)

https://youtu.be/d3vcwi_45DY

[IvanCraft623]

Just a quick overview

No longer valid

[dktapps]

My gut reaction to this is: I don't like the code.

I don't think we should be using custom actions for this since the actions are only usable with specific types of transactions. By the way other stuff has been done, different AnvilTransaction classes should be implemented.

I'm also not liking the logic of some of the item comparisons being limited to checking type IDs. Plugins will likely want to implement more complex logic, like using tags or NBT checking.

[dktapps]

I think it would also probably be preferable to have more events, e.g. PlayerItemRenameEvent, PlayerItemRepairEvent, PlayerItemCombineEvent (not sure about this last one). (That being said, if there were transaction types for this instead of actions, it would be a good amount nicer).

Doesn't make much sense to make plugins do complex logic to figure out the action type when we can just tell them directly.

[github-actions]

This PR has been marked as "Waiting on Author", but we haven't seen any activity in 7 days.

If there is no further activity, it will be closed in 28 days.

Note for maintainers: Adding an assignee to the PR will prevent it from being marked as stale.

[kostamax27]

It would be nice to be able to cancel this

[Copilot]

Pull Request Overview

This PR implements anvil functionality by adding new API methods for repair material validation, XP cost calculation, and enhanced anvil behavior. Key changes include new tests for anvil crafting, extended item repair cost handling, and integration of anvil recipes into the crafting manager.

Reviewed Changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/phpunit/crafting/*	Added tests covering material repair and item self-combination recipes for anvils
src/network/mcpe/handler/ItemStackRequestExecutor.php	Integrated AnvilTransaction support and optional anvil crafting action handling
src/item/Item.php	Introduced anvil repair cost management with appropriate tag serialization
src/inventory/transaction/AnvilTransaction.php	Added a new transaction type to validate, execute, and trigger anvil events
src/crafting/*	Added new recipe types (MaterialRepairRecipe, ItemSelfCombineRecipe, etc.) and updated the crafting manager for anvil recipes
src/block/utils/AnvilHelper.php	Encapsulated anvil result calculation logic with XP cost filtering

[ShockedPlot7560]

Here is a TODO list to complete this PR for me:

• Add an event to be able to cancel the anvil damage
• Add an event or adjust events to be able to change the custom name of an item
• Clear and precise unit tests for anvil crafting recipes
• Validate in game the gameplay
• Validate Anvil cost with unit tests & in game
• Include book combinaison

[kostamax27]

Here is a TODO list to complete this PR for me:

How about an event for canceling or changing an item’s name?

Possible uses: the server doesn’t allow colored names, censorship, etc.

[ShockedPlot7560]

You already have PlayerUseAnvilEvent to cancel this but you can't change anything yep

[JkqzDev]

Here is a TODO list to complete this PR for me:

• Add an event to be able to cancel the anvil damage
• Add an event or adjust events to be able to change the custom name of an item
• Clear and precise unit tests for anvil crafting recipes
• Validate in game the gameplay
• Validate Anvil cost with unit tests & in game

I have tested this fork and with the changes you have made I think that the combinations of items with books still do not work.
I have added it in my fork but I don't know if it is to your taste: https://github.com/RequiemPvP/PocketMine-MP/blob/dbbb4f8fb1af2ef45a77fcc495715bae9bd94aef/src/crafting/AnvilCraftingManagerDataFiller.php#L76

[ShockedPlot7560]

Thank you @JkqzDev.
From what I can see, your implementation looks good, but it raises me one question.
Can any items really be combined with an enchanted book for Minecraft Bedrock?

[JkqzDev]

Thank you @JkqzDev. From what I can see, your implementation looks good, but it raises me one question. Can any items really be combined with an enchanted book for Minecraft Bedrock?

Good question @ShockedPlot7560
When I implemented it, I also had the same question, but I think this answers the question: https://github.com/RequiemPvP/PocketMine-MP/blob/dbbb4f8fb1af2ef45a77fcc495715bae9bd94aef/src/crafting/ItemCombineRecipe.php#L53
I'm not sure if it actually works the way it's supposed to.

[dktapps]

Makes sense to me, though it might be worth checking if there are any primary vs secondary restrictions

[JkqzDev]

@ShockedPlot7560 I remember that I sent you a message about a problem that happened with Anvil: the xp cost that appeared in the UI was not always the real cost.

[ShockedPlot7560]

It was part of the unit tests which currently failed a lot

[JkqzDev]

https://github.com/JkqzDev/PocketMine-MP/blob/3f7d270c41aeb6cd0d4c6f5738b6ea6db776f1a7/src/crafting/ItemCombineRecipe.php#L93

I have made changes to this PR. I'm not sure it has been solved because unit tests continue to fail but within the game (from what I have tested) it works fine.
@ShockedPlot7560