IdleEssentials - All-in-One Minecraft Essentials Plugin

A comprehensive all-in-one essentials plugin for Minecraft Paper/Spigot/Bukkit servers featuring TPA System, Homes, Warps, Economy, Auction House, and Physical Shops with beautiful visual effects and interactive chat buttons.

✨ Features

🏠 Home System

• Private Homes: Each player gets 1 free home (configurable)
• Home Shop: Purchase additional home slots with scaling costs
• Easy Management: Set, delete, and teleport to homes with simple commands
• Visual Effects: Beautiful teleportation animations

🌐 Warp System

• Public Warps: Create global teleport points for all players
• Warp Shop: Purchase warp slots (20x more expensive than homes)
• Global Access: Anyone can teleport to any warp
• Business Opportunity: Create your own warp network

💰 Economy System

• Player Balances: Full economy with starting balance support
• Auction House: Sell items to other players
• Tax System: Configurable tax on auction sales
• Shop Integration: Buy homes, warps, and physical shop slots

🏪 Auction House

• Limited Slots: 3 slots per player (configurable)
• Cooldown System: Prevents spam (1 hour default)
• Tax System: 5% tax on all sales
• GUI Interface: Beautiful inventory-based browsing
• Auto-Expiry: Listings expire after 48 hours

🏪 Physical Shops

• Multiblock Structure: Chest + Glass + Item Frame
• Visual Display: Items displayed in item frames
• Easy Setup: Shift-click to create, click to purchase
• Stock Management: Automatic stock tracking

🛡️ Advanced Safety System

• Fall/Void Detection: Prevents teleporting into dangerous falls or the void
• Fire/Lava Detection: Warns about nearby fire and lava hazards
• Hostile Mob Detection: Detects hostile mobs in the vicinity
• Suffocation Prevention: Checks for blocks that would suffocate the player
• Drowning Prevention: Warns about deep water
• Contact Damage Detection: Identifies cacti, magma blocks, berry bushes
• Explosion Risk Detection: Detects TNT, respawn anchors, beds in wrong dimensions
• Position Lock System: Mark safe locations to bypass safety checks

🎨 Beautiful Visual Interface

• Interactive Chat Buttons: Accept/Deny buttons directly in chat
• Boss Bar Countdown: Visual countdown during teleport delay
• Action Bar Messages: Real-time status updates
• Title Messages: Important events shown as titles
• Particle Effects: Visual feedback for teleports
• Sound Effects: Audio feedback for all actions
• Gradient Color Schemes: Modern, customizable colors

📋 Commands

TPA Commands

Home Commands

Warp Commands

Economy & Shop Commands

Admin Commands

🔑 Permissions

TPA Permissions

Home Permissions

Warp Permissions

Economy Permissions

Admin Permissions

🚀 Installation

1. Download the IdleEssentials-3.0.0.jar file
2. Place it in your server's plugins/ folder
3. Restart the server or use /reload
4. Edit plugins/IdleEssentials/config.yml to customize settings
5. (Optional) Give admins the guidebook: /idletpa guidebook

🔧 Configuration

The configuration file (config.yml) offers extensive customization:

# General Settings
timeout: 30                    # Request timeout in seconds
cooldown: 10                   # Cooldown between requests
teleport-delay: 3              # Delay before teleporting

# Home Settings
homes:
  default-limit: 1             # Free homes for new players
  teleport-delay: true
  delay-seconds: 3

# Warp Settings
warps:
  default-limit: 0             # Free warps for new players
  teleport-delay: true
  delay-seconds: 3

# Economy
economy:
  starting-balance: 0.0        # Starting money
  currency-symbol: "$"

# Auction House
auction-house:
  max-slots: 3                 # Max listings per player
  cooldown-seconds: 3600       # 1 hour cooldown
  tax-percent: 5.0            # 5% sales tax
  listing-duration-hours: 48   # 48 hour expiry

# Shop Pricing
shop:
  base-home-cost: 2000         # First additional home
  base-warp-cost: 40000        # First warp (20x homes)
  cost-multiplier: 5.0         # Each purchase 5x more expensive
  max-homes: 10                # Maximum homes allowed
  max-warps: 5                 # Maximum warps allowed

# Safety System
safety:
  enabled: true
  require-confirmation: true
  check-fall-danger: true
  check-fire-danger: true
  check-mob-danger: true
  check-suffocation: true
  check-drowning: true
  check-contact-damage: true
  check-explosion-danger: true

🛠️ Building from Source

Using Gradle:

gradlew clean build

The compiled JAR will be in build/libs/IdleEssentials-3.0.0.jar.

📝 How It Works

🏠 Home System

1. Players start with 1 free home
2. Use /sethome [name] to create a home at your location
3. Use /home [name] to teleport to it
4. Buy additional slots in /shop (cost scales: 2,000 → 10,000 → 50,000...)
5. Maximum 10 homes per player (configurable)

🌐 Warp System

1. Players start with 0 free warps (warps are premium)
2. Use /setwarp <name> to create a public warp
3. Anyone can use /warp [name] to teleport there
4. Buy warp slots in /shop (cost is 20x homes: 40,000 → 200,000...)
5. Maximum 5 warps per player (configurable)
6. Business Opportunity: Create popular warps and earn money!

💰 Economy System

1. Players earn money by selling items on the auction house
2. Use /ah sell <price> while holding an item
3. Other players browse /ah and purchase items
4. Money is used to buy homes, warps, and physical shop slots

🏪 Auction House

1. Limited to 3 active listings per player
2. 1-hour cooldown between listings
3. 5% tax on all sales
4. Listings expire after 48 hours
5. Cancel listings with /ah cancel

🏪 Physical Shops

1. Build a multiblock structure: Chest on bottom, Glass in middle, Item Frame on top
2. Shift-right-click the chest with an item to create the shop
3. Set price using commands (or default price applies)
4. Players click the item frame to purchase
5. Stock is managed automatically from the chest

🛡️ TPA Safety System

1. Player A runs /tpa PlayerB or /tpahere PlayerB
2. Player B receives a message with Accept and Deny buttons in chat
3. Player B clicks a button or uses /tpaccept / /tpdeny
4. If accepted, the Safety System checks the destination
5. If danger is detected, Player B gets a warning with Proceed or Cancel options
6. If safe (or confirmed), teleportation begins with countdown
7. Player is teleported with visual effects

📖 Admin Guidebook

Admins can get a written book with full plugin documentation:

/idletpa guidebook

The book contains:

• Complete command reference
• All permissions
• Configuration guide
• Setup instructions
• Troubleshooting tips

🎮 Compatible Versions

• Paper: 1.21.x+ (Recommended)
• Spigot: 1.21.x+
• Bukkit: 1.21.x+
• Java: 21+

📜 License

This plugin is open source. Feel free to modify and distribute.

🤝 Support

For issues, suggestions, or contributions, please contact the developer.

📁 Data Files

The plugin stores data in these files:

• economy.yml - Player balances
• homes.yml - Player homes
• warps.yml - Public warps
• auctionhouse.yml - Active listings
• physicalshops.yml - Physical shop data

Made with ❤️ for the Minecraft community

Just visual beautiful and very comfortable TPA