> 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/manticrods.md).

# ManticRods

Mantic Development's Upgradable Fishing Rods Minecraft Plugin

Purchase online at [Mantic Development](https://www.mantic.dev/product/manticrods).

<figure><img src="https://2746822811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCVqlaAAAoPORtPYtxCWn%2Fuploads%2FqPwyLOVJK02zAIahcS7t%2Fmanticrods.png?alt=media&#x26;token=1f5eb237-7058-456e-b36c-64d464930b16" alt=""><figcaption></figcaption></figure>

ManticRods adds configurable fishing rods, enchants, upgrades, prestige, fishing statistics, and shard currency to a Bukkit server.

## Install

1. Install ManticLib. ManticRods requires it.
2. Put the ManticLib and ManticRods plugin JARs in the server's `plugins` folder.
3. Start or restart the server. ManticRods creates its data folder and default configuration files.
4. If your ManticRods distribution includes a license key, enter your own key in the `license` field in `config.yml` and keep it private.

Configuration files are in `plugins/ManticRods/`. Keep private values such as license keys and Discord webhook URLs out of public posts.

## Configure ManticRods

Use `/manticrod editor` in game to open the configuration editor. It requires `manticrods.editor`, which is operator-only by default. The editor lets you browse settings, toggle booleans, enter scalar values in chat, and add or remove list and map entries. It saves edits and reloads plugin settings.

For manual edits, use the comments in generated YAML files and run `/manticrod reload` with `manticrods.reload`. Changes to command names and aliases in `commands.yml` require a server restart.

See [Configuration files](/manticrods/configuration-files.md), [Permissions](/manticrods/permissions.md), and [Developer API](/manticrods/developer-api.md).

## Common commands

These are the default command names. You can change names and aliases in `commands.yml`.

| Command                   | Use                                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `/manticrod menu`         | Open your rod menu.                                                                                                             |
| `/manticrod editor`       | Open the configuration editor.                                                                                                  |
| `/manticrod reload`       | Reload plugin settings.                                                                                                         |
| `/manticrod reset all`    | From console, confirm twice within 10 seconds to reset all ManticRods player data; requires `manticrods.player.resetall`.       |
| `/rodupgrade`             | Open upgrades for the rod in hand.                                                                                              |
| `/shards balance`         | View your shard balance. Shard actions require the internal shard economy.                                                      |
| `/shards pay`             | Pay shards to another player.                                                                                                   |
| `/shards resetall`        | From console, confirm twice within 10 seconds to reset only all players' shard balances; requires `manticrods.shards.resetall`. |
| `/shardshop`              | Open the shard shop when enabled.                                                                                               |
| `/fish`                   | View your caught-fish count.                                                                                                    |
| `/fish top` or `/fishtop` | View the fish leaderboard.                                                                                                      |
| `/shardtop`               | View the shard leaderboard.                                                                                                     |
| `/autofishing`            | Toggle autofishing.                                                                                                             |
| `/rodprestige`            | Open the prestige menu.                                                                                                         |
| `/captcha <player>`       | Send a captcha to an online player; requires permission.                                                                        |

Use `/manticrod` without arguments to see the actions available to you. For all command names and aliases, see `commands.yml`.

## FAQ

### How do I reset data?

To reset one player's ManticRods data, use `/manticrod reset <player>` with `manticrods.player.reset`.

To reset only shard balances for all players, run `/shards resetall` twice from the server console within 10 seconds. It requires `manticrods.shards.resetall`.

To reset all ManticRods player data, run `/manticrod reset all` twice from the server console within 10 seconds. It requires `manticrods.player.resetall`. Back up the server before using either reset-all command.