Idle_Essentials

# 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: ```yaml # 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: ```bash 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