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.<feature>

• awesome.user - Basic player features
• awesome.vip - VIP features (fly, nicknames, etc.)
• awesome.admin - Administrative commands
• awesome.* - All permissions

Granular permissions available for every feature!

---

💾 Data Storage

• Configuration: YAML files for easy editing
• Player Data: JSON files for transparency and portability
• Database: MySQL or SQLite support with HikariCP pooling
• Automatic Backups: Configurable data backup system

---

🌐 Server Compatibility

• Minecraft Versions: 1.19.x, 1.20.x, 1.21.x
• Server Software: Paper (recommended), Spigot, Bukkit
• Java Version: Java 17 or higher
• Dependencies: None required (all optional)

---

📊 Statistics

• 40+ Manager Systems - Comprehensive feature coverage
• 40+ Commands - With tab completion support
• 6 Config Files - Complete customization
• 4.7 MB - Lightweight and optimized
• Zero Dependencies Required - Works standalone
• 1.19+ Support - Modern Minecraft compatibility

---

⚡ Performance

AwesomeNeeded is designed with performance in mind:

• Optimized database queries with prepared statements
• Async operations for I/O-heavy tasks
• Efficient event handling with minimal overhead
• Smart caching to reduce redundant operations
• Resource monitoring and anti-lag features included

Suitable for servers of all sizes - from small community servers to large networks!

---

🎨 Customization

Every aspect is customizable:

• Custom messages in messages.yml
• Feature toggles in config.yml
• Shop items in shop.yml
• Kit contents in kits.yml
• Crate rewards in crates.yml
• Module states in memory

Make it yours!

---

🏆 Why Choose AwesomeNeeded?

Complete Solution - Everything you need in one plugin
User-Friendly - Intuitive GUIs for all features
Performance - Optimized for minimal server impact
Flexible - Enable/disable features as needed
Modern - Built with latest APIs and best practices
Supported - Active development and updates
Free - Open source and free to use

---

📝 License

AwesomeNeeded is open source software.

---

🙏 Support the Project

If you enjoy AwesomeNeeded:

• Share with other server owners
• Report bugs to help us improve
• Suggest features you'd like to see
• Write a review on Modrinth

---

Ready to transform your Minecraft server? Download AwesomeNeeded today!