> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticomnitooladdon.md).

# ManticOmniToolAddon

One tool slot for ManticHoes, ManticSwords, ManticRods and ManticPickaxes. Use `/omni` or `/omnitool` while holding a configured Mantic tool to choose another tool. Stored tools retain their item data, including upgrades.

## Server setup

1. Stop the server and back up the addon folder, including player data.
2. Install ManticLib and the tool plugins you want to use. This addon update targets ManticHoes 2.1, ManticRods 2.0, ManticSwords 2.0-BETA and ManticPickaxes 1.0. Install the full plugin jars on the server; API jars are for building only.
3. Put `ManticOmniToolAddon-1.1.jar` in `plugins/`, replacing the previous addon jar, then start the server.
4. In `plugins/ManticOmniToolAddon/config.yml`, select the tool IDs:

   ```yaml
   hoeType: default
   swordType: default
   rodType: default
   pickaxeType: basic
   ```

   Hoe, sword and rod IDs come from their tool configuration files. `pickaxeType` is the filename without `.yml` under `plugins/ManticPickaxes/pickaxes/`; for example, `basic.yml` means `basic`.
5. Run `/omni reload` after editing the addon's files. Reload requires `mantic.omnitooladdon.reload`.

Automatic switching selects a sword when attacking, a rod when right-clicking toward water, a hoe when left-clicking a crop, and a pickaxe when left-clicking a block supported by its blueprint in an allowed world. Crops take priority over pickaxe blocks. Tool plugins still apply their own gameplay restrictions.

## Existing custom menus

New menus include the pickaxe button. Existing `menus/omni.yml` layouts are preserved. To add the button, place an unused character such as `d` in your layout and add this entry to `items`:

```yaml
- displayName: '&a&lPickaxe'
  skull: ''
  lore:
    - '&7&oClick to switch'
  glow: true
  material: DIAMOND_PICKAXE
  durability: 0
  key: d
  action: SWITCH_PICKAXE
```

For example, use these nine-character rows for four tool buttons and the existing coloured borders:

```yaml
layout:
  - ' 1 2 3   '
  - ' a b c d '
  - ' 1 2 3   '
```

Then run `/omni reload`. Other supported actions are `SWITCH_HOE`, `SWITCH_SWORD` and `SWITCH_ROD`.

## Tool guides

* [ManticHoes](https://docs.mantic.dev/mantichoes.md)
* [ManticSwords](https://docs.mantic.dev/manticswords.md)
* [ManticRods](https://docs.mantic.dev/manticrods.md)
* [ManticPickaxes](https://docs.mantic.dev/manticpickaxes.md)

## Online license verification

The plugin checks its existing license key online when it starts. The server must be able to reach `auth.mantic.dev` over HTTPS (port 443). If verification fails, read the server log for the reason, correct the key or network issue, then restart the server. A rate-limit response includes how long to wait when available.
