Minecraft

How to Install and Configure MineTinker on a Minecraft Server

Minecraft·May 20, 2026·28 min read

MineTinker Overview

MineTinker is a Minecraft plugin that brings Tinkers Construct-style gear upgrades to servers running Spigot, Paper, or Purpur. Because it is a plugin, players do not need to install a client-side mod before joining. That makes it a practical option for public or friend servers where asking everyone to manage mods would immediately turn into a support queue.

The plugin adds dozens of modifiers for weapons, tools, and armor. These modifiers can improve mining, add combat effects, change movement, or make everyday survival tasks faster. Equipment can also level up through use, unlocking more modifier slots as players keep using their favorite items.

MineTinker is highly configurable. Server owners can adjust modifier behavior, recipes, messages, leveling, permissions, and more from in-game menus or by editing plugin files. This guide explains how to download MineTinker, install it on a HolyHosting Minecraft server, use its main features, and handle the issues most server owners run into first.

Downloading MineTinker

  1. Open the MineTinker page on the Spigot website.
  2. Select Download Now in the top-right corner.
  1. On the next page, scroll to the Assets section.
  2. Click MineTinker.jar to download the plugin file.
  1. Save the `.jar` somewhere easy to find, such as your desktop or downloads folder.

Installing MineTinker on the Server

MineTinker requires a plugin-compatible server type. Before uploading it, make sure your server is running Spigot, Paper, or Purpur. If your server is still on vanilla Minecraft, switch the server software from the version selector or server type area of your control panel, then restart once so the plugin folders generate correctly.

After that, install MineTinker with the steps below.

  1. Open the HolyHosting server panel and go to the file manager or FTP client.
  1. Log in with your panel or FTP password when prompted.
  1. Open the `plugins` folder.
  2. Upload the `MineTinker.jar` file into that folder.
  1. Wait until the upload finishes, then restart the Minecraft server.

When the server starts again, MineTinker should create its configuration folder and become available in-game.

First Steps In-Game

Once MineTinker is installed, players can start by gathering the usual survival resources: wood, stone, ores, furnaces, crafting tables, and anything else needed for gear progression. MineTinker works around crafted equipment and crafted modifiers, so the normal survival loop still matters.

For setup and testing, it helps to become a server operator first. Operator access lets you view modifier menus, recipes, descriptions, and administrative commands. Later, you can move those abilities into permission groups with a plugin such as LuckPerms.

Crafting Compatible Equipment

MineTinker works best with equipment players craft normally. When a player crafts a tool, weapon, or armor piece, the plugin can assign its default MineTinker data, including level and modifier slots.

Items spawned by commands, kits, or other plugins may not receive the same data. For example, gear from a kit plugin can look normal but fail to accept modifiers. If an item refuses to work with MineTinker, craft a fresh version at a workbench before assuming the plugin is broken. Minecraft troubleshooting has enough mysteries already.

Viewing and Crafting Modifiers

Use the following command in chat to browse available modifiers:

`/mt mods`

This opens the MineTinker modifier menu. With the correct permission, you can view modifier details and check recipes from inside the menu. Left-click a modifier to see how it is crafted, then create it at a workbench using the listed materials.

Modifiers are usually custom blocks or items that can later be combined with equipment. Some only work on certain item types. A mining modifier may apply to pickaxes, while a combat modifier may be limited to swords or other weapons. These restrictions can be adjusted in the configuration if your server needs different balancing.

Applying Modifiers to Gear

To attach a modifier, place an anvil near you and open it. Put the tool, weapon, or armor piece in the first slot, then place the modifier in the second slot. If the item is eligible and you have enough experience, the anvil will apply the modifier.

By default, equipment starts with limited modifier slots. One modifier may be all that fits at first, but more slots can unlock as the item levels up. Server owners can change these limits if they want faster progression, stricter balance, or complete chaos with a settings file attached.

Leveling Equipment

MineTinker gear gains experience as players use it. A pickaxe can gain progress while mining, a weapon can gain progress through combat, and armor can gain progress from relevant use. When an item levels up, players may see action bar messages confirming the increase.

Higher levels can unlock more modifier slots, letting players combine abilities into stronger equipment. This is useful for long-term survival servers because players can build toward signature items instead of replacing everything every few hours.

Leveling speed, slot limits, and related behavior can all be adjusted in the plugin configuration.

Useful Modifier Examples

MineTinker includes many modifiers, and a few examples show how much they can change gameplay.

A modifier such as Shulking can launch targets upward with a levitation-style effect, creating a strong combat advantage. Another combat option, Berserk, can grant a strength boost when the player drops below a low-health threshold. Effects like these can be fun, but they may need tuning on PvP or economy servers.

For mining, Auto Smelt can turn certain mined blocks directly into smelted drops. This is excellent for collecting ingots quickly, but it can also affect blocks that do not have useful smelted results. If a drop seems odd, check the modifier settings before blaming the pickaxe.

Movement modifiers can also change how players explore. Multijump, for example, allows extra jump height and can improve as the modifier levels up. Used carefully, this can make exploration more dynamic without requiring a separate movement plugin.

If a modifier becomes too strong, you can disable it, change its values, or restrict who can use it through permissions and configuration.

Configuration Options

MineTinker has a large configuration surface. You can change messages, recipes, modifier restrictions, leveling values, feature toggles, and the behavior of individual abilities. There are two common ways to manage these settings: the in-game editor and direct file editing.

The in-game editor is faster for small changes. Manual file editing is better when you want to search, compare, or make several controlled edits at once.

In-Game Configuration Editor

  1. Join the Minecraft server.
  2. Open chat and run:

`/mt editconfiguration`

  1. Hover over the file or category you want to edit.
  2. Select the setting and use left, right, or middle clicks to change values.
  1. Run `/mt reload` after saving changes.

A full server restart is still recommended after larger edits, especially when changing modifier behavior or plugin-wide settings.

Manual Configuration Method

  1. Open the server file manager or FTP client.
  2. Navigate to:

`/plugins/MineTinker`

  1. Find the configuration file you want to change.
  2. Open the file with the editor.
  1. Make your changes, then save the file.
  1. Restart the server and join to confirm the changes work as expected.

Permissions

Most regular MineTinker gameplay does not require every player to have command access. Players should generally be able to craft and use modified gear normally. Administrative commands, menus, configuration tools, and some advanced features should be controlled with permissions.

LuckPerms is the usual choice for assigning those permissions to users or groups. Add only the nodes players actually need, then keep configuration and management commands limited to staff. For the complete permission list, check the official MineTinker documentation for the version you installed.

Common Problems

MineTinker commands do not work

First, confirm your account is an operator or has the correct permission nodes. Administrative commands are not always available to normal players. If permissions look correct, verify that the server is running Spigot, Paper, or Purpur and that the installed MineTinker version supports your Minecraft version.

Gear will not accept modifiers

Craft a new item manually and try again. Items created through commands, kit plugins, or other custom item systems may not contain the data MineTinker expects. The plugin is designed around crafted equipment, so generated gear can miss important metadata.

A modifier is too powerful

Open the configuration and reduce the modifier strength, change its conditions, or disable it. You can also remove a modifier from an item with `/mt removemodifier`, then add it back later with `/mt addmodifier` if you are testing balance values.

The `/mt mods` menu opens but recipes or pages do not work

This can happen after plugin reloads or other server-side hiccups. Restarting the Minecraft server usually clears it. Repeated plugin reloads may work in some cases, but a clean restart is more reliable.

  • MineTinker on Spigot
  • How to add plugins to a Minecraft server
  • Becoming a Minecraft server operator
  • Installing and using LuckPerms

Still have questions?

Come chat with us and we will get back to you as soon as possible!

Contact Support