Q Anvil

Q Anvil adds a new anvil for Forge 1.20.1 that uses player health instead of experience levels.

It is designed for modpacks that want an anvil system based on survival resources rather than XP. The Q Anvil does not break during normal use, so players can use it repeatedly without losing the block.

Features

• Use player health to operate the anvil instead of experience levels.
• The Q Anvil does not break during normal use.
• Optional integration with Q Shop. When Q Shop is installed, the Q Anvil can use currency such as coins instead of, or together with, health.
• Configure the default payment mode, currency id, health cost, and currency cost in the common configuration file.
• Input slots support up to 999 items when max_input_stack_size is set to 999 in config/qanvil-common.toml. The default remains 64.
• KubeJS integration lets you customize outputs, payment types, payment amounts, material consumption, and per-operation behavior.
• The original vanilla anvil recipes remain available; KubeJS can also replace the result for specific left and right inputs.

Screenshots

Configuration

The common configuration file is:

config/qanvil-common.toml

The default payment mode is health. Available payment modes are health, currency, and both. Q Shop is optional; the Q Anvil still works in health mode when Q Shop is not installed.

To allow stacks larger than 64 in the two input slots, change:

max_input_stack_size = 999

The allowed range is 1 to 999.

KubeJS Integration

KubeJS integration is optional. Put scripts in kubejs/server_scripts/ and listen for QAnvilEvents.update.

The event provides:

• event.left or event.input: the left input item.
• event.right or event.addition: the right input item.
• event.originalOutput: the result calculated by the vanilla anvil.
• event.output: the final item displayed and produced by the Q Anvil.
• event.currencyId: the currency id used for this operation.
• event.currencyCost: the currency amount charged for this operation.
• event.healthCost: the player health amount charged for this operation.
• event.materialCost: the number of right-side items consumed after taking the result.

KubeJS values have higher priority than the configuration for that individual operation. This allows a script to use currency for one recipe and health for another, even when the default configuration uses a different payment mode.

Custom Output and Currency Payment

QAnvilEvents.update(event => {
  const left = event.left;
  const right = event.right;

  if (left.id != 'minecraft:diamond_sword') return;
  if (right.id != 'minecraft:netherite_ingot') return;

  event.output = Item.of('minecraft:netherite_sword');
  event.currencyId = 'coins';
  event.currencyCost = 25;
  event.healthCost = 0;
  event.materialCost = 1;
});

Custom Output with Health Payment

QAnvilEvents.update(event => {
  if (event.left.id != 'minecraft:diamond_sword') return;
  if (event.right.id != 'minecraft:stick') return;

  event.setOutput(Item.of('minecraft:iron_sword'));
  event.healthCost = 4;
  event.currencyCost = 0;
  event.setMaterialCost(1);
});

Preserve the Vanilla Result and Change the Payment

QAnvilEvents.update(event => {
  if (event.originalOutput.empty) return;
  if (event.left.id != 'minecraft:diamond_pickaxe') return;

  event.output = event.originalOutput.copy();
  event.currencyId = 'points';
  event.currencyCost = 30;
  event.healthCost = 0;
});

Forge-style Cost Methods

The event also supports familiar Forge-style methods:

QAnvilEvents.update(event => {
  if (event.left.id != 'minecraft:iron_sword') return;

  event.setOutput(event.left.copy());
  event.setCost(5);
  event.setMaterialCost(1);
});

setCost(5) uses the configured payment mode. Explicit currencyCost and healthCost values take priority over setCost(5). Set both explicit values when an operation should charge both currency and health.

To cancel an operation completely:

QAnvilEvents.update(event => {
  if (event.right.id == 'minecraft:bedrock') {
    event.cancel();
  }
});

The Q Anvil is obtained by using a Netherite Upgrade Smithing Template, a vanilla anvil, and a netherite ingot in a vanilla smithing table. It can also be given with:

/give @s qanvil:q_anvil