RentTools

📦 RentTools – Tool & Weapon Rental System for Minecraft

RentTools 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

---

📢 Additional

• Messages use prefix: [RentTools]
• On startup: Plugin By FeDen

---

🚀 Summary

RentTools is a complete rental system featuring:
✔ security
✔ high configurability
✔ integrated economy
✔ GUI interface

Perfect for vanilla+ style servers 🔥