NeoEssentials

# NeoEssentials (https://img.shields.io/badge/Minecraft-1.21.1-brightgreen.svg)](https://www.minecraft.net/) (https://img.shields.io/badge/NeoForge-orange.svg)](https://neoforged.net/) (https://img.shields.io/badge/License-MIT-lightgrey.svg)](https://opensource.org/licenses/MIT) (https://img.shields.io/github/v/release/ZeroG-Network-PTY-LTD/NeoEssentials?label=Version)](https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/releases) (https://img.shields.io/discord/709351422088708196?color=7289da&label=Discord&logo=discord&logoColor=white)](https://discord.gg/dUGAQF2Mga) (https://img.shields.io/badge/Ko--fi-Support%20Me-F16061?logo=ko-fi&logoColor=white)](https://ko-fi.com/mrwhiteflamesyt) > NeoEssentials is a comprehensive, config-driven essentials mod for Minecraft NeoForge 1.21.1 - 1.21.11 servers. It provides 50+ commands, GUI tools, advanced administration, and a real-time web dashboard—all managed by modular JSON config files and standardized documentation. ## 🌟 Overview NeoEssentials brings essential server management, player utilities, and advanced admin features to NeoForge servers. All features are strictly documented and driven by config files for reliability and transparency. **Server-Side Only**: No client install required—works with vanilla clients. **50+ Commands**: Covers all major server functions, utilities, and moderation. **Modern UI**: GUI commands, color code support, and web dashboard. ## ✨ Core Systems & Features - **Economy System**: Player balances, payments, kits, and shop support. - **Chat & Messaging**: Private messages, mail, ignore/socialspy, AFK system. - **Moderation**: Ban, kick, mute, jail, vanish, freeze, sudo, player data. - **Teleportation**: Homes, warps, spawn, teleport requests, back system. - **Kit Management**: Configurable item kits with cooldowns and preview. - **Web Dashboard**: Real-time server monitoring, config editing, API endpoints. - **Permission System**: LuckPerms, FTB Ranks, and built-in support. - **Item Management**: Item spawning, repair, enchant, clearinventory, powertool. - **Utility Systems**: Nicknames, MOTD, near, ping, depth, helpop, rules, suicide, etc. - **API & Placeholder System**: PlaceholderAPI integration, custom placeholders, REST API endpoints. ## 📖 Documentation Start at (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/Home) for a complete, config-driven documentation hub. All major systems are documented and standardized to match the codebase and config files: - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/EconomySystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/ChatSystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/ModerationSystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/TeleportationSystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/KitManagement) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/WebDashboard) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/PermissionSystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/ItemManagement) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/UtilitySystems) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/APISystem) - (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/AFKSystem) See (https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki/APISystem) for API & Placeholder System details, including: - PlaceholderAPI integration for dynamic text - Custom and expansion placeholders - Web Dashboard REST API endpoints for server status, player info, logs, config, events, and statistics - Permissions and config options for API features ## 🚀 Quick Start ### Installation 1. Download the latest release (https://img.shields.io/github/v/release/ZeroG-Network-PTY-LTD/NeoEssentials?label=Version)](https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/releases) 2. Place the JAR file in your server's `mods` folder 3. Start your server to generate configuration files in `config/neoessentials/` 4. Configure permissions and features as needed 5. Restart the server to apply changes ### Essential Configuration Files ``` config/neoessentials/ ├── config.json # Main configuration settings ├── permissions.json # Permission system setup ├── language/ # Language files directory ├── shops.json # Shop system configuration └── settings.json # Additional mod settings ``` ### Quick Permission Setup For LuckPerms users: ``` /lp group admin permission set neoessentials.admin true /lp group moderator permission set neoessentials.moderator true /lp group default permission set neoe