CustomAnvil

Custom Anvil

Custom Anvil is a plugin that allows server administrators to customize every aspect of the anvil's mechanics. It is expected to work on 1.18 to 1.21.7 minecraft servers running spigot or paper (or Folia. But it is experimental). (the plugin support of 1.16.5 to 1.17.1 is not supported and issue less likely to be fixed)

Custom Anvil was previously named Custom Anvil. It was renamed because it now affects every anvil aspect and not only unsafe enchants Custom Anvil is based on Custom Anvil by DelilahEve.

--- Custom Anvil have the following features: - Vanilla like default configuration. - Custom enchantment level limit. - Custom anvil recipes. - Custom enchant restrictions (allow unsafe enchantment only for a group of item or create new restriction). - Custom items of unit repairs (repair damaged with unit of "material", for example the repair of diamond sword by diamonds). - Custom XP cost for every aspect of the anvil. - Permissions to bypass level limit or enchantment restriction. - Display XP cost instead of "too expensive" when above level 40. (see below for more information) - Can handle some custom enchantment plugins (see below for more information) - Gui to configure the plugin in game. - Support of color code and hexadecimal color - (Experimental) Folia support (gui do not work) ---

Permissions:

```yml ca.affected: Player with this permission will be affected by the plugin ca.bypass.fuse: Allow player to combine every enchantments to every item (no custom limit) ca.bypass.level: Allow player to bypass every level limit (no custom limit) ca.command.reload: Allow administrator to reload the plugin's configs ca.config.edit: Allow administrator to edit the plugin's config in game

Related to use of color (usage of permission for color is toggleable in basic config gui or config.yml)

ca.color.code: Allow player to use color code if permission is required (toggleable) ca.color.hex: Allow player to use hexadecimal color if permission is required (toggleable) ```

Commands

```yml anvilconfigreload or carl: Reload every config of this plugin customanvilconfig or configanvil: open a menu for administrator to edit plugin's config in game ```

Supported Plugins

Custom Anvil can be compatible with some custom enchantments and anvil mechanics plugins.

Here is a list of supported custom enchantment plugins with support status: - Enchantment²: Support by Custom Anvil but still experimental. Automatic configuration.

- EcoEnchant: Support by Custom Anvil but still experimental. Need to use /anvilconfigreload or a server restart to add newly added enchantment. Use EcoEnchant restriction system by default.

- ExcellentEnchants: Support by Custom Anvil but still experimental. Use ExcellentEnchants item type.

- Superenchants Support by Superenchants. Use CustomAnvil to combine enchantment in anvil in survival.

Here is a list of supported anvil mechanic plugins with support status: - Disenchantment Support by Custom Anvil but still experimental. Mostly use Custom Anvil basic XP settings. (version >= 6.1.5)

- HavenBags Support by Custom Anvil. Not really enchantment related but CustomAnvil should not impact bag upgrade and skin via anvil. (version >= 1.31.0)

If you like Custom Anvil to support a specific plugin (custom enchant or anvil mechanic). You can ask, but please note implementing compatibility will be considered as low priority as I work for the plugin on my free time for free.

Overriding Too Expensive

One of the configurations allow displaying price about 40 and removing Too Expensive. By how the minecraft client work: price above 40 can only be displayed green, even if the player does not own enough experience level. Minecraft version 1.18 to latest marked as supported do not need any ProtocoLib dependency. Any recent paper version also are supported for this feature. But you should wait for update for new version containing new enchantable item or new enchantments. Other version need ProtocoLib enabled on your server for this feature. You can also wait for an update of the plugin to support a newer version.

Please note that 1.16.5 to 1.17.1 are not officially supported. Run at your own risk.

For custom enchantment plugin developers

For information about the API, please refer to the Wiki (Please note that the wiki is currently incomplete)​

---

Default Plugin's Configurations

For 1.18 to 1.20.6 use the 1.18 configurations For 1.21 to 1.21.7 use the 1.21 configurations

---

Metric And Telemetry

Custom anvil use bstat and faststats for metric and error reporting.

You can select specific telemetry or disable all in config.yml. You can also disable bstat and faststats in their /plugin folder if you like too.

faststats is in beta testing please report me or them any error you encounter

Planned:

- Better Folia support (make gui work. fix some dirty handled parts) - Get restriction on unknown enchantments - Warn admin on unsupported minecraft version - More features for custom anvil craft​

Known issue:

Most unknown registered enchantments (by unsupported custom enchantment plugin & datapacks) will not have restriction by default. Planned but no eta.