promotional bannermobile promotional banner

NeoEssentials

A comprehensive server-side essentials mod for Minecraft NeoForge servers, inspired by EssentialsX for Bukkit/Spigot.

File Details
DownloadInstall

neoessentials-1.0.2.3

ByMrWhiteFlamesYT
  • B
  • Jan 6, 2026
  • 1.23 MB
  • 298
  • 1.21.8+7
  • NeoForge

File Name

neoessentials-1.0.2.3+build.694.jar

Supported Versions

  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:neoessentials-1292165:7427117"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

NeoEssentials v1.0.2.3 - Major Fixes & Quality Improvements

Build #698+ | January 6, 2026 | Minecraft 1.21.1 - 1.21.11 | NeoForge 21.1.179+ / 21.11.24-beta

🎯 What's New in Build #698

🛠️ Code Quality - ZERO Warnings! ✨

Final Polish Complete:

  • ✅ Fixed StringBuffer → StringBuilder (better performance)
  • ✅ Fixed .length() > 0 → !isEmpty() (cleaner code)
  • ✅ Removed redundant @SuppressWarnings
  • ✅ Fixed @Nullable annotations on non-null methods
  • ✅ Simplified if statement logic
  • ✅ Removed unused parameter warnings

Achievement Unlocked:

  • 🏆 ZERO compilation errors
  • 🏆 ZERO warnings
  • 🏆 100% clean code
  • 🏆 Professional quality

🔇 Debug Logging Confirmed

Verified: All debug logging properly controlled by config
Default: Clean production logs (debug OFF)
When Needed: Easy toggle in config file

🎯 What's New in Build #680+

🏷️ LuckPerms Placeholder System - FIXED! 🎉

All LuckPerms placeholders now work correctly:

  • ✅ {luckperms_prefix} - Player's prefix from LuckPerms
  • ✅ {luckperms_suffix} - Player's suffix from LuckPerms
  • ✅ {luckperms_group} - Player's primary group
  • ✅ {luckperms_primary_group} - Primary group (alias)
  • ✅ {luckperms_displayname} - Full formatted name (prefix+name+suffix)

What was wrong:

  • Placeholders were querying the internal permission system instead of LuckPerms API
  • This caused them to return empty or incorrect values

What was fixed:

  • Changed to properly query LuckPerms adapter through PermissionAPI
  • Added comprehensive debug logging for troubleshooting
  • Enhanced meta data inspection for weighted prefixes/suffixes

Usage Example:

{
  "chat": {
    "chat-format": "{luckperms_prefix}{neoessentials_name}{luckperms_suffix}: {MESSAGE}"
  }
}

Result: [Admin] PlayerName [VIP]: Hello world!

🔇 Debug Logging Cleanup - Clean Console! 🧹

Before: 70+ lines of debug spam per chat message ❌
After: Clean, quiet logs ✅

What was removed:

  • Chat formatting debug (40+ lines per message)
  • Placeholder resolution logs (6 lines per placeholder)
  • Permission API queries (7 lines per query)
  • LuckPerms integration logs (20+ lines per query)

New config option:

{
  "logging": {
    "enableDebugLogging": false  // Set to true only when debugging
  }
}

When to enable:

  • Troubleshooting chat formatting issues
  • Debugging LuckPerms integration
  • Investigating permission problems
  • Otherwise keep it OFF for clean logs!

🛠️ Code Quality - 31+ Issues Fixed ✨

8 Critical Errors Fixed:

  • Constructor call to this() not first statement
  • File corruption in PayToggleManager and EconomyManager
  • NPE risks in TeleportLocation.getLevel()
  • Duplicate method definitions
  • Missing getBiome() method

23+ Warnings Fixed:

  • Unnecessary String.valueOf() calls
  • Unnecessary null checks (4x)
  • Ignored mkdirs() results (4x)
  • Resource warnings for Level (2x)
  • @Nullable on non-null methods (8x)
  • Redundant casts and variables

Result:

  • ✅ Zero compilation errors
  • ✅ Zero warnings (except intentional suppressions)
  • ✅ Professional code quality
  • ✅ Production-ready

🎯 Build #627 - Critical Shutdown Fix

🔧 Server Shutdown Hang RESOLVED 🎉

Problem: Server would hang indefinitely during shutdown, requiring force-kill
Symptom: Stuck at "ThreadedAnvilChunkStorage: All dimensions are saved"
Solution: Comprehensive thread pool shutdown implementation

What was fixed:

  • ✅ 7+ background thread pools now properly terminate
  • ✅ Server exits cleanly within 10-30 seconds
  • ✅ No more hanging on /stop or restart commands
  • ✅ Clean JVM shutdown with all resources released

Technical Details:

  • EconomyManager, TransactionHistoryManager, PayToggleManager executors
  • AfkManager and AfkMovementDetector schedulers
  • BanManager cleanup scheduler
  • TeleportRequestManager timeout scheduler
  • DashboardAPI HTTP server (improved 5-second graceful shutdown)

You'll now see detailed shutdown logs:

[INFO] Shutting down Economy Manager...
[INFO] EconomyManager shutdown complete.
[INFO] Shutting down AFK Manager...
[INFO] AFK Manager shutdown complete
[INFO] Running thread diagnostics...
[INFO] No NeoEssentials threads detected ✓

🛠️ Code Quality & Diagnostics

NEW: Thread Diagnostic Utility

  • Automatically detects any threads preventing shutdown
  • Logs non-daemon threads blocking JVM exit
  • Helps identify shutdown issues instantly

Code Improvements:

  • Fixed all code analysis warnings
  • Optimized lambda expressions with method references
  • Improved JavaDoc formatting
  • Better logging throughout shutdown process

🎯 What's New in Build #599

This release brings critical fixes, performance improvements, and enhanced LuckPerms integration with over 1000 lines of code improvements!

🚀 Major Improvements

🔐 LuckPerms Integration

✨ NEW: Automatic permission synchronization!

  • All 85+ NeoEssentials permissions now appear in LuckPerms autocomplete
  • Full web editor support - permissions visible in dropdown menus
  • Automatic sync on server startup
  • Export to YAML format for backup/sharing

Usage: Permissions automatically sync when LuckPerms is detected. Use /lp user <player> permission set neoessentials.<TAB> to see all available permissions!

📡 Teleportation System

✨ NEW: /tpo command implemented!

  • Teleport to offline player's last known location
  • Permission: neoessentials.teleport.admin.tpo
  • Usage: /tpo <playername>

✅ VERIFIED: All teleport commands working correctly

  • /back - Return to previous location ✅
  • /tpa - Request to teleport to player ✅
  • /tpahere - Request player teleport to you ✅
  • All 15 teleport commands fully functional

🔧 Performance & Stability

✅ ELIMINATED: Log spam from duplicate event handlers

  • Fixed thousands of WARN messages per minute during farming/building
  • 50% reduction in event processing overhead
  • Consolidated duplicate AFK activity handlers

✅ FIXED: Debug logging system

  • Removed duplicate config options
  • Single logging.enableDebugLogging setting controls all debug logs
  • Cleaner production logs

🐛 Critical Bug Fixes

Minecraft 1.21.4 Compatibility

✅ FIXED: Kit system crash on startup

  • Resolved NoSuchMethodError from Registry API changes
  • Unknown items now gracefully skipped
  • Server starts successfully with kits enabled

Command Fixes

✅ FIXED: /tpahere command crashes with NullPointerException

  • Resolved ConcurrentHashMap null value issue
  • All teleport request commands working correctly

✅ FIXED: Dashboard port configuration ignored

  • Port changes now properly applied
  • Requires restart or /dashboard restart to take effect

Permission System

✅ FIXED: 15 missing permission nodes added

  • Portable workstations: anvil, crafting, fletching, smithing, stonecutting
  • Utilities: realname, whois, seen, sign, rules, suicide, ping
  • All commands now have proper permission nodes

✅ FIXED: Ops bypassing LuckPerms permissions

  • LuckPerms now checked first when enabled
  • Proper permission priority order restored

📋 All Changes

Added

  • ✅ /tpo command (teleport to offline player)
  • ✅ LuckPerms permission sync system
  • ✅ 15 missing permission nodes
  • ✅ Enhanced switch expressions (modern Java)
  • ✅ Pattern matching instanceof
  • ✅ Method references (cleaner code)
  • ✅ Comprehensive documentation (7 new guides)

Fixed

  • ✅ Kit system crash (Minecraft 1.21.4)
  • ✅ /tpahere NullPointerException
  • ✅ Dashboard port configuration
  • ✅ Duplicate event handlers (log spam)
  • ✅ Debug logging consolidation
  • ✅ 40 code analysis warnings (27 + 13)
  • ✅ External permissions priority
  • ✅ Visibility scope issues
  • ✅ Potential NPE in teleport commands

Changed

  • ✅ Consolidated debug configuration
  • ✅ Updated to modern Java features
  • ✅ Improved code quality (zero warnings)
  • ✅ Enhanced error handling
  • ✅ Cleaner lambda usage

🎮 Usage Examples

LuckPerms Integration

# Permissions now autocomplete!
/lp user PlayerName permission set neoessentials.<TAB>

# Grant all portable workstations
/lp group default permission set neoessentials.stonecutting true
/lp group default permission set neoessentials.anvil true

# Use web editor - permissions now visible in UI!
/lp editor

New /tpo Command

# Teleport to where an offline player last was
/tpo OfflinePlayer

# Great for finding bases or investigating grief!

Debug Logging

{
  "logging": {
    "enableDebugLogging": false  // Controls ALL debug logging
  }
}

⚙️ Technical Details

  • Code Changes: 1000+ lines
  • Files Modified: 18+
  • Warnings Fixed: 40 (27 + 13)
  • Build Status: ✅ Successful
  • Build Number: #599
  • Compilation Errors: 0

📦 Installation

  1. Download the latest version
  2. Stop your server
  3. Replace the old NeoEssentials jar
  4. Start your server
  5. Config automatically migrates
  6. Permissions automatically sync with LuckPerms

No manual configuration required!

🔗 Links

  • Wiki: Full documentation
  • Discord: Support & community
  • GitHub: Source code & issue tracker

⚠️ Compatibility

  • Minecraft: 1.21.1 & 1.21.4
  • NeoForge: 21.1.179+ & 21.4.156+
  • LuckPerms: Optional but recommended
  • Breaking Changes: None - fully backward compatible

🙏 Thank You!

Thanks to all users for reporting issues and helping make NeoEssentials better!

NeoEssentials v1.0.2.2 - Critical Fixes & PlaceholderAPI Enhancement

Build #524 | November 10, 2025 | Minecraft 1.21.1 | NeoForge 21.1.179+

🎯 What's New

This major update brings 38 commits of improvements since v1.0.2.1 (September 7, 2025).

🌐 Web Dashboard System

  • Space-themed real-time monitoring
  • Player stats & server metrics
  • Discord authentication
  • Mobile-responsive design
  • Commands: /dashboard start/stop/status/reload

📦 Kit Management

  • Create kits: /createkit <name> <cooldown>
  • Use kits: /kit [name]
  • Admin tools: /delkit, /listkits

💬 Discord Integration

  • DiscordSRV & SDLink adapters
  • Role synchronization
  • Web dashboard Discord auth

💰 Economy Support

  • FTB Money, Lightman's Currency, Magic Coins
  • Transaction history tracking
  • /paytoggle command

🐛 Critical Fixes

  • Fixed config loading errors (absolute paths with ResourceUtil.getConfigFile())
  • Fixed Minecraft color codes being escaped in JSON (&7 saved as \u00267)
  • Added .disableHtmlEscaping() to Gson configuration
  • Prefixes/suffixes in permissions.json now display with correct colors
  • Added 3 new AFK placeholders for third-party integration:
    • {neoessentials_afk} - Status ("AFK" or empty)
    • {neoessentials_afk_time} - Duration ("5m 30s")
    • {neoessentials_afk_reason} - Custom message

✨ New Commands

  • /dashboard - Web interface control
  • /createkit - Kit creation
  • /kit - Kit usage
  • /delkit - Kit deletion
  • /listkits - Kit management
  • /paytoggle - Toggle payments
  • /unmute - Unmute players
  • /repair - Item repair
  • /powertool - Item commands
  • Gamemode shortcuts

🔧 Improvements

  • Permission system enhancements
  • Shop system validation
  • Chat formatting
  • AFK tracking
  • Command registry
  • Message localization
  • Atomic file saves
  • SLF4J logging

📦 New Configs

config/neoessentials/
├── discord_auth.json        # Discord mappings
├── dashboard.json           # Dashboard settings
├── kits.json                # Kit definitions
└── economy_integrations.json

🚀 Upgrade Instructions

  1. Backup config/neoessentials/
  2. Stop server
  3. Replace JAR with neoessentials-1.0.2.3+build.536.jar
  4. Start server (auto-generates new configs)
  5. (Optional) Fix color codes in permissions.json: Replace \u0026 with &
  6. Restart server

✅ Verification Checklist

  • Config files now load properly (no more "file not found")
  • Color codes preserve correctly in JSON (& not \u0026)
  • AFK placeholders available for TabList integration
  • All 28 placeholders working for third-party mods

📦 Build Information

  • Build Number: #524
  • Previous Version: v1.0.2.1 HOTFIX (September 7, 2025)
  • Release Date: November 10, 2025
  • Minecraft Version: 1.21.1
  • NeoForge Version: 21.1.179+
  • Compatible NeoForge Range: 21.1.179 - 21.1.194+
  • Minecraft Version Range: [1.21.1, 1.21.8]
  • Java Version: 21+
  • Compatibility: No breaking changes - Fully compatible with v1.0.2.3

Contributors

🔗 Required Dependancy mod

🔗 Links

Full changelog on GitHub | Report issues on GitHub Issues