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

Command	Description	Permission
/tpa <player>	Request to teleport to a player	idleessentials.tpa
/tpahere <player>	Request a player to teleport to you	idleessentials.tpahere
/tpaccept [player]	Accept a teleport request	idleessentials.accept
/tpdeny [player]	Deny a teleport request	idleessentials.deny
/tpcancel	Cancel your pending request	idleessentials.cancel
/tpatoggle	Toggle teleport requests on/off	idleessentials.toggle
/tpalock	Lock/unlock current position as safe	idleessentials.lock

Home Commands

Command	Description	Permission
/sethome [name]	Set a home location	idleessentials.home.sethome
/home [name]	Teleport to a home	idleessentials.home.use
/delhome <name>	Delete a home	idleessentials.home.delete

Warp Commands

Command	Description	Permission
/setwarp <name>	Create a public warp	idleessentials.warp.setwarp
/warp [name]	Teleport to a warp	idleessentials.warp.use
/delwarp <name>	Delete a warp	idleessentials.warp.delwarp

Economy & Shop Commands

Command	Description	Permission
/shop	Open shop to buy slots	idleessentials.shop.use
/ah	Open auction house	idleessentials.ah.use
/ah sell <price>	Sell held item on auction	idleessentials.ah.sell
/ah cancel	Cancel your listings	idleessentials.ah.use

Admin Commands

Command	Description	Permission
/idletpa	Main plugin command	idleessentials.use
/idletpa reload	Reload configuration	idleessentials.reload
/idletpa help	Detailed command help	idleessentials.use
/idletpa settings	View current settings	idleessentials.settings
/idletpa safety	View safety system info	idleessentials.use
/idletpa guidebook	Get admin guidebook	idleessentials.admin

🔑 Permissions

TPA Permissions

Permission	Description
idleessentials.tpa	Use /tpa command
idleessentials.tpahere	Use /tpahere command
idleessentials.accept	Accept teleport requests
idleessentials.deny	Deny teleport requests
idleessentials.toggle	Toggle teleport requests
idleessentials.cancel	Cancel outgoing requests
idleessentials.lock	Use position lock
idleessentials.bypass.cooldown	Bypass cooldowns
idleessentials.bypass.safety	Bypass safety checks

Home Permissions

Permission	Description
idleessentials.home.use	Use home commands
idleessentials.home.sethome	Set homes
idleessentials.home.delete	Delete homes
idleessentials.home.bypassdelay	Bypass home teleport delay
idleessentials.homes.unlimited	Unlimited home slots

Warp Permissions

Permission	Description
idleessentials.warp.use	Use warp commands
idleessentials.warp.setwarp	Create warps
idleessentials.warp.delwarp	Delete warps
idleessentials.warp.bypassdelay	Bypass warp teleport delay
idleessentials.warps.unlimited	Unlimited warp slots

Economy Permissions

Permission	Description
idleessentials.shop.use	Use the shop
idleessentials.shop.physical.create	Create physical shops
idleessentials.ah.use	Use auction house
idleessentials.ah.sell	Sell items on auction
idleessentials.ah.admin	Admin auction house access

Admin Permissions

Permission	Description
idleessentials.use	All basic commands
idleessentials.admin	Full admin access
idleessentials.reload	Reload plugin
idleessentials.settings	View/change settings

🚀 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