AquaAdder

AquaAdder is a Paper plugin for adding custom items, custom block visuals, generated resource packs, and Blockbench models.

Requirements
Paper 1.21x

Java 21

Copy the jar into your server plugins folder.
Start the server once.
Edit:

plugins/AquaAdder/config.yml

Restart the server or run:

/aqa reload

Resource Pack
The plugin generates and serves its own resource pack.

Recommended config:

resource-pack:
  enabled: true
  host: "0.0.0.0"
  port: 25665
  public-host: "YOUR_SERVER_IP"
  public-url: ""
  required: true

Use host: "0.0.0.0" for binding the local HTTP server.

Use public-host for the IP or domain players connect to. Example:

public-host: "play.example.com"
If you already host the pack somewhere else, use public-url:

public-url: "https://example.com/aquaadder-pack.zip"
Rebuild and resend the pack:

/aqa pack

Commands

/aqa reload
/aqa pack
/aqa give <item> [amount]
/aqa summon <item>
/aquaadder also works.

Custom Items
Add items in config.yml:

custom-items:
  ruby_shard:
    enabled: true
    base-material: PAPER
    custom-model-data: 10001
    display-name: "<red>Ruby Shard"
    texture: "textures/item/ruby_shard.png"
    model: ""

Put textures in:

plugins/AquaAdder/textures/item/ruby_shard.png

The file name should match the item ID.

Blockbench Models
Put item models here:

plugins/AquaAdder/blockbench/models/items/my_item.bbmodel

Put block models here:

plugins/AquaAdder/blockbench/models/blocks/my_block.bbmodel

On /aqa reload, AquaAdder creates config entries automatically:

Files in blockbench/models/items become custom items.
Files in blockbench/models/blocks become custom items and custom blocks.
Then run:

/aqa pack

Use them with:

/aqa give my_item
/aqa summon my_item

Custom Blocks
Example:

custom-blocks:
  example_block:
    enabled: true
    item: "AquaAdder:example_gem"
    adapter: NOTE_BLOCK
    note: 5
    instrument: BASS_GUITAR
    hardness: 1.0
    required-tool: IRON_PICKAXE

Players place the block by right-clicking with the linked custom item.

Texture Troubleshooting
If you see the generated fallback texture, the plugin did not find your PNG.

Check the server log for:

Missing texture for ...
Put the texture in one of these folders:

plugins/AquaAdder/textures/item/<id>.png
plugins/AquaAdder/textures/items/<id>.png
plugins/AquaAdder/textures/<id>.png
plugins/AquaAdder/blockbench/items/<id>.png
plugins/AquaAdder/blockbench/textures/item/<id>.png

Then run:

/aqa reload
/aqa pack