This repository is archived. Development of this fork continues as OP-Essentials — same mod, new name, with all the fixes and features from 1.1.6 through 1.1.12 (vanish overhaul, chat fixes, live reloads and more). This tree stops at 1.1.5 and is kept for history only.

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