RentTools

RentTools is a plugin for Minecraft Paper/Spigot that adds a system for renting tools, weapons, and armor between players. Players can list their items for rent, while others can borrow them for a limited time through a convenient menu or bulletin board. T

Quick challenge

How far can you run before the mobs catch you?

RentTools

info

📦 RentTools – Tool & Weapon Rental System for Minecraft

Paper / Spigot is a powerful plugin for Paper / Spigot servers that introduces a complete item rental system between players: via commands, an intuitive GUI, and a bulletin board.

---

⚙️ Core Features

🔄 Item Rental

* Players can rent out any tool or weapon * Other players can borrow items for a set period * When the rental expires, the item is automatically returned to the owner * If the inventory is full, the item is sent to the warehouse

---

🛠 Supported Items

✔ Swords (SWORD) ✔ Pickaxes (PICKAXE) ✔ Axes (AXE) ✔ Shovels (SHOVEL) ✔ Hoes (HOE) ✔ Spears (SPEAR, including custom ones – WOODEN, COPPER, etc.) ✔ Mace (MACE) ✔ Copper tools and weapons

❌ Blocks and placeable items cannot be rented

---

💾 Full Item Preservation

The plugin saves EVERYTHING:

* enchantments * durability * name * lore * NBT / PDC data * custom items

---

🧭 User-Friendly GUI

Command: `/rent`

Menu includes:

* rent out item * rental list * bulletin board * my rentals * warehouse * penalties

---

📋 Bulletin Board

Players can publish “for rent” listings.

Displays:

* item * owner * price and deposit * rental duration * online status * extension availability

---

📩 Requests

* Online — owner receives a clickable notification * Offline — notification is delivered on login

---

📦 Warehouse (`/rent warehouse`)

If there’s no inventory space:

* rented items * returned items * payments

➡️ everything is stored in the warehouse

---

💰 Currency

Default:

* DIAMOND_ORE * DEEPSLATE_DIAMOND_ORE

Can be changed in `config.yml` Vault support (optional)

---

☠️ Death Penalties

If a renter dies:

* the item is deleted * not returned to the owner (anti-duplication protection) * the renter receives a penalty * the owner is notified

📊 Penalty Calculation

Penalty depends on:

* material (WOOD, IRON, DIAMOND, etc.) * item type * enchantments

Formula: penalty = item value + enchantment value

---

✨ Enchantments

* Automatic enchantment detection * Fully configurable in `enchant-penalties.yml`

---

🛡 Deposit (Insurance)

* Returned after a successful rental * Kept by the owner if the item is lost

---

⭐ Player Reputation

Statistics system:

* successful rentals * lost items

File: `reputation.yml`

---

🚫 Blacklist

Restrict specific players from renting:

``` /rent blacklist add <player> /rent blacklist remove <player> ```

---

🔒 Restrictions

* Players with unpaid penalties cannot rent items * Configurable in `config.yml`

---

⏳ Rental Extension

If allowed by the owner:

``` /rent extend <id> ```

---

💸 Server Commission

* Can be enabled/disabled * Adjustable percentage

---

🔍 Filters

Board filtering:

* by item type * online owners only

---

📝 Logs

File `logs.yml` records:

* rental creation * start and completion * item losses * penalties * extensions

---

🛠 Admin Commands

Permission: `renttools.admin`

``` /rent admin delete <id> /rent admin fine <player> <amount> /rent admin unfine <penaltyId> /rent admin warehouse /rent admin logs ```

---

🎮 Player Commands

``` /rent /rent create <price> <time> /rent list /rent board /rent my /rent warehouse /rent penalties /rent cancel <id> /rent extend <id> ```

---

📁 Config Files

* config.yml * rentals.yml * announcements.yml * warehouse.yml * penalties.yml * item-penalties.yml * enchant-penalties.yml * reputation.yml * blacklist.yml * logs.yml

---