AwesomeNeeded

# AwesomeNeeded - All-in-One Essentials Framework **The ultimate essentials plugin for Minecraft servers with full in-game GUI support!** AwesomeNeeded is a comprehensive, feature-rich essentials framework designed for Minecraft 1.19.x - 1.21.x servers running Paper, Spigot, or Bukkit. Built from the ground up with performance and usability in mind, it provides everything you need to run a professional Minecraft server. --- ## ✨ Key Features ### 🎮 **Player Features** - **Teleportation System** - TPA requests, random teleport (RTP), spawn points, homes, and warps - **Economy System** - Built-in economy with Vault integration for compatibility - **Shop System** - Fully customizable in-game shop with GUI interface - **Kits** - Timed kits with cooldowns and permissions (includes 3 default kits) - **Crates** - Reward crate system with animations (includes 3 default crates) - **Claims** - Land protection system with trust management - **Homes & Warps** - Multiple home locations and server-wide warp points - **Backpacks** - Extra inventory space for players - **Achievements** - Custom achievement system with rewards ### 👑 **VIP Features** - **Fly Time** - Timed flight system with automatic management - **Nicknames** - Custom display names with color support - **Daily/Weekly Rewards** - Scheduled rewards for player retention - **Boosters** - XP and money multipliers - **Custom Heads** - Access to custom player head database ### 🛡️ **Moderation Tools** - **Punishment System** - Mute, ban, kick, warn with duration support - **Anti-Cheat** - Built-in cheat detection system - **Action Logging** - Comprehensive logging of player actions - **Admin Tools** - Invsee, freeze, vanish, and more - **Chat Management** - Chat filters, formatting, and moderation ### 📊 **Server Management** - **Scoreboard** - Dynamic sidebar with live player stats - **Tab List** - Customizable player list formatting - **Performance Tools** - Anti-lag features and resource monitoring - **Module System** - Toggle features on/off as needed - **World Manager** - Multi-world support and management - **Region Titles** - Location-based title messages ### 🔧 **Utility Commands** - `/workbench` - Open crafting table anywhere - `/anvil` - Open anvil interface - `/enderchest` - Access your ender chest - `/hat` - Wear any item as a hat - `/trash` - Disposable trash GUI - `/heal` - Heal yourself or others - `/feed` - Restore hunger - And 30+ more utility commands! --- ## 🎯 What Makes AwesomeNeeded Different? ### **All-in-One Solution** Stop juggling multiple plugins! AwesomeNeeded combines 40+ essential features into one optimized package. ### **GUI-First Design** Every feature has an intuitive in-game GUI - no need to memorize complex commands or edit config files in-game. ### **Performance Focused** - Efficient database handling with HikariCP connection pooling - Async operations where possible - Minimal server impact with optimized code ### **Highly Configurable** - 6 configuration files for complete customization - JSON-based data persistence for transparency - Module system to enable/disable features ### **Modern & Maintained** - Built with Adventure API for modern text components - Supports latest Minecraft versions (1.19.x - 1.21.x) - Regular updates and bug fixes --- ## 📦 Default Content Included ### **Kits (3 Pre-configured)** - **Starter Kit** - Stone tools, food, basic supplies (24h cooldown) - **VIP Kit** - Iron gear, better items (12h cooldown) - **MVP Kit** - Diamond gear, premium items (6h cooldown) ### **Crates (3 Pre-configured)** - **Common Crate** - Diamonds, emeralds, gold, iron - **Rare Crate** - Diamond blocks, netherite scraps, totems - **Epic Crate** - Netherite ingots, elytra, beacons --- ## 🔌 Integration Support ### **Optional Dependencies (Soft Dependencies)** - **Vault** - Economy integration (has built-in fallback) - **PlaceholderAPI** - Dynamic placeholder support - **LuckPerms** - Advanced permission integration All integrations are optional - AwesomeNeeded works perfectly standalone! --- ## 🚀 Quick Start 1. Download `AwesomeNeeded-1.0.0.0.jar` 2. Place in your server's `plugins/` folder 3. Start/restart your server 4. Configuration files auto-generate in `plugins/AwesomeNeeded/` 5. Customize configs to your liking 6. Use `/awesome` to access the main control panel --- ## 🎮 Command Overview **Teleportation:** `/tpa`, `/tpaccept`, `/tpdeny`, `/rtp`, `/spawn`, `/home`, `/warp`, `/back` **Economy:** `/balance`, `/pay`, `/shop`, `/eco` **Features:** `/kit`, `/crate`, `/claim`, `/fly`, `/daily`, `/weekly` **Social:** `/nick`, `/afk`, `/msg`, `/reply` **Moderation:** `/ban`, `/kick`, `/mute`, `/warn`, `/freeze`, `/invsee` **Utilities:** `/workbench`, `/anvil`, `/heal`, `/feed`, `/hat`, `/trash` **Admin:** `/setspawn`, `/setwarp`, `/eco`, `/module`, `/awesome admin` And many more! Full command list in documentation. --- ## 📋 Permissions All permissions follow the format: `awesome.<featur