NeoEssentials

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 Home for a complete, config-driven documentation hub. All major systems are documented and standardized to match the codebase and config files:

• EconomySystem
• ChatSystem
• ModerationSystem
• TeleportationSystem
• KitManagement
• WebDashboard
• PermissionSystem
• ItemManagement
• UtilitySystems
• APISystem
• AFKSystem

See 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
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 neoessentials.player true

🎮 Command Reference

See Home and individual system docs above for full command lists and config options.

🔧 Configuration Examples

All features are managed by modular JSON config files. See Home and system docs above for details.

🔗 API Integration for Modders

See APISystem for full API and PlaceholderAPI documentation, including:

• Registering custom placeholders
• Using REST API endpoints for server data
• Economy API for mod integration

🔗 Integration & Compatibility

• LuckPerms and FTB Ranks supported
• Server-Side Only (no client mods required)
• Vanilla Client Support
• Performance Optimized

🛠️ Development

IDE Setup

This project uses IntelliJ IDEA Community Edition with Gradle.

Setup Instructions:

1. Clone the repository
2. Open the project in IntelliJ IDEA
3. Import as a Gradle project
4. Wait for Gradle to sync and download dependencies
5. The IDE is configured to automatically download sources and javadocs

Running the Mod:

• Use Gradle run configurations provided by NeoForge ModDev
• runClient - Test in client mode
• runServer - Test in server mode
• runData - Generate data resources

Building:

./gradlew build

Output JAR: build/libs/neoessentials-VERSION+build.XXX.jar

Project Structure

• Java 21 - Target JDK version
• Gradle - Build system with auto-incrementing build numbers
• NeoForge ModDev 2.0.107 - Modern mod development plugin
• Parchment Mappings - Better parameter names and javadocs

🤝 Support & Community

• Discord: Join our Discord server for support and community discussion
• Bug Reports: Report issues and bugs through GitHub or Discord
• Feature Requests: Suggest new features and improvements
• Documentation: See Home and system docs above

📄 License

NeoEssentials is licensed under the MIT License. See the LICENSE file for details.

🌟 Ready to enhance your server? Download NeoEssentials and give your players the essential tools they need!

Made with ❤️ for the Minecraft community