NeoEssentials v1.0.2.3 - Quality & Performance Update

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

🎯 Build #698 - Documentation & Final Polish

🛠️ Perfect Code Quality! ✨

Achievement: ZERO Warnings! 🏆

Final fixes:

✅ Performance: StringBuffer → StringBuilder
✅ Modern Java: .length() > 0 → !isEmpty()
✅ Clean code: Removed redundant suppressions
✅ Type safety: Fixed @Nullable annotations
✅ Simplification: Cleaner if statements

Result:

100% clean compilation
Professional code standards
Production-ready quality

🔇 Clean Logs Verified

Debug logging properly controlled by config - clean logs in production!

🎯 Build #680+ - LuckPerms & Quality Improvements

🏷️ LuckPerms Placeholders - Now Working! 🎉

All LuckPerms placeholders fixed and working perfectly:

Available Placeholders:

{luckperms_prefix} - Player's prefix
{luckperms_suffix} - Player's suffix
{luckperms_group} - Primary group name
{luckperms_displayname} - Full formatted name

Example Usage:

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

Result: [Admin] PlayerName: Hello!

What was fixed:

Placeholders now properly query LuckPerms API
Enhanced debug logging for troubleshooting
Full support for weighted prefixes/suffixes

🔇 Clean Logs - No More Console Spam! 🧹

Removed 70+ lines of debug output per chat message!

New config option:

{
  "logging": {
    "enableDebugLogging": false
  }
}

Set to true only when debugging issues, otherwise enjoy clean logs!

What was cleaned:

Chat formatting debug (40+ lines → 0)
Placeholder resolution (6 lines → 0)
Permission queries (7 lines → 0)
LuckPerms integration (20+ lines → 0)

🛠️ Code Quality - 31+ Fixes! ✨

Professional, production-ready code:

✅ 8 critical errors fixed
✅ 23+ warnings resolved
✅ Zero compilation errors
✅ Clean, maintainable codebase

Major fixes:

Constructor issues
File corruption repairs
NPE protection
Duplicate methods removed
Resource handling improved

🎯 Build #627 - Critical Shutdown Fix

🔧 Server Shutdown Hang RESOLVED 🎉

The Problem: Server would freeze forever when stopping/restarting:

[INFO] ThreadedAnvilChunkStorage: All dimensions are saved
[HANGS HERE - Never exits, requires force-kill]

The Solution: Complete thread pool shutdown - server now exits cleanly in 10-30 seconds!

What Was Fixed:

✅ Economy system executors (balances, transactions, toggles)
✅ AFK detection schedulers (manager + movement detector)
✅ Ban cleanup scheduler
✅ Teleport request timeouts
✅ Dashboard HTTP server (5-second graceful shutdown)

Result:

Server exits cleanly every time
No more hanging on /stop
All resources properly released
Detailed shutdown logging

🛠️ New: Thread Diagnostics

Automatic monitoring:

[INFO] Running thread diagnostics...
[INFO] No NeoEssentials threads detected ✓
[INFO] No non-daemon user threads detected ✓

If problems occur, you'll see exactly which threads are blocking shutdown!

📊 Better Visibility

Detailed shutdown logs:

[INFO] Shutting down Economy Manager...
[INFO] EconomyManager shutdown complete.
[INFO] Shutting down AFK Manager...
[INFO] AFK Manager shutdown complete
[INFO] NeoEssentials shutdown complete

🎨 Code Quality

Fixed all code analysis warnings
Optimized lambda expressions
Improved JavaDoc formatting
Better error handling

🎯 Build #599 Highlights

Major quality update with critical fixes and LuckPerms integration!

🆕 New Features

🔐 LuckPerms Auto-Sync

Your NeoEssentials permissions now automatically appear in LuckPerms!

What you get:

✨ Autocomplete in /lp commands
✨ Permissions visible in web editor
✨ 85+ permissions auto-registered
✨ Export to YAML format

Try it:

/lp user PlayerName permission set neoessentials.<TAB>
# All permissions now autocomplete! 🎉

📡 `/tpo` Command

Teleport to offline player's last location!

/tpo OfflinePlayerName

Perfect for:

Finding player bases
Investigating grief
Admin duties

🐛 Major Fixes

Build #575 - Kit System Crash

❌ Error: NoSuchMethodError on Minecraft 1.21.4
✅ Fixed: Updated to new Registry API
🎯 Result: Server starts successfully with kits

Build #580 - Log Spam Eliminated

❌ Problem: Thousands of WARN logs per minute
✅ Fixed: Removed duplicate event handlers
🎯 Result: 50% less event processing, clean logs

Build #585 - Permission Nodes

❌ Missing: 15 utility command permissions
✅ Added: All portable workstations + utilities
🎯 Result: Full LuckPerms integration

Build #590 - TPA System

❌ Crash: /tpahere NullPointerException
✅ Fixed: ConcurrentHashMap null handling
🎯 Result: All teleport requests working

Build #595 - Debug Logging

❌ Duplicate: Two debug config options
✅ Merged: Single logging.enableDebugLogging
🎯 Result: Consistent debug control

📋 Complete Changes

Added ✨

/tpo command for offline teleports
LuckPerms automatic permission sync
15 missing permission nodes:
- neoessentials.anvil
- neoessentials.crafting
- neoessentials.stonecutting
- neoessentials.smithing
- neoessentials.fletching
- neoessentials.realname
- neoessentials.whois
- neoessentials.seen
- neoessentials.sign
- neoessentials.rules
- neoessentials.suicide
- neoessentials.ping
- And more!

Fixed 🔧

Kit system crash (MC 1.21.4 Registry API)
/tpahere NullPointerException
Dashboard port config ignored
Duplicate event handlers (log spam)
Ops bypassing LuckPerms
40 code analysis warnings (27 + 13)
Debug logging consolidation
Visibility scope issues
Potential NPE in teleport commands

Improved 📈

50% event processing reduction
Modern Java features (switch expressions, pattern matching, method references)
Zero compilation warnings
Enhanced error handling
Thread-safe field declarations
Cleaner lambda usage

🎮 Quick Start

Using New Features

LuckPerms Integration:

# Autocomplete now works!
/lp user Steve permission set neoessentials.<TAB>

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

# Use web editor - NeoEssentials permissions now visible!
/lp editor

Offline Teleport:

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

Clean Logs:

// config.json
{
  "logging": {
    "enableDebugLogging": false  // Clean production logs
  }
}

⚙️ Technical

Performance:

50% reduction in AFK event processing
Eliminated duplicate handler registration
Optimized permission checking order

Code Quality:

0 compilation warnings (fixed 40 total)
1000+ lines improved
18+ files updated
Modern Java 16+ features
Build #599

Compatibility:

Minecraft 1.21.1 ✅
Minecraft 1.21.4 ✅
NeoForge 21.1.179+ ✅
NeoForge 21.4.156+ ✅
LuckPerms (optional) ✅

📦 Installation

Download latest version
Stop server
Replace old jar
Start server
Done! Auto-migrates config

No breaking changes - fully backward compatible!

📚 Documentation

New Guides Created:

Debug Logging Consolidation
Enhanced Handler Fix
Teleportation System Guide
TPA/TPAHERE Implementation
LuckPerms Integration
Permission Registry Guide
Missing Permissions Fix

All available in GitHub repository!

🔗 Useful Links

Issues: Report bugs on GitHub
Wiki: Full command reference
Discord: Community support
Source: Available on GitHub

🎉 What's Next?

Planned for v1.0.2.4:

Additional performance optimizations
More system audits
Enhanced features

⭐ Support the Project

Enjoying NeoEssentials? Consider:

⭐ Starring on GitHub
📝 Writing a review
🐛 Reporting bugs
💡 Suggesting features

📊 Stats

Build: #599
Date: January 4, 2026
Changes: 1000+ lines
Fixes: 40 warnings + 8 bugs
New Features: 3 major

NeoEssentials v1.0.2.2 - Major Update

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

🎯 Highlights

38 commits with major features since v1.0.2.1 (Sept 7, 2025):

🌐 Web Dashboard System

Space-themed real-time monitoring interface
Player stats, server metrics, live logs
Discord login integration
Mobile-responsive design
Commands: /dashboard start/stop/status/reload

📦 Kit Management

Create custom kits from inventory
Cooldown system & usage tracking
Commands: /createkit, /kit, /delkit, /listkits

💬 Discord Integration

DiscordSRV & SDLink adapters
Role-to-permission sync
Web dashboard Discord auth

💰 Economy Integrations

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

🐛 Critical Fixes

Build #520 - Config Loading

✅ Fixed: config.json not found error
🔧 Solution: Absolute paths with ResourceUtil.getConfigFile()

Build #521 - Color Codes

✅ Fixed: &7 saved as \u00267
🔧 Solution: Added .disableHtmlEscaping() to Gson

Build #523 - AFK Placeholders

🆕 Added 3 new placeholders:

{neoessentials_afk} - Status ("AFK" or empty)
{neoessentials_afk_time} - Duration ("5m 30s")
{neoessentials_afk_reason} - Custom message

✨ New Features

Commands

/dashboard - Web dashboard control
/createkit <name> - Create kits
/kit [name] - Use/list kits
/delkit <name> - Delete kits
/listkits - Admin kit management
/paytoggle - Toggle payments
/unmute <player> - Unmute players
/repair [all] - Repair items
/powertool [cmd] - Item command binding
Gamemode shortcuts (survival, creative, etc.)

Systems

Permission System: Enhanced with admin validation, reload, list commands
Shop System: Item tag support, dynamic linking, better validation
Chat System: Custom formatting, clickable components, debug utilities
AFK System: Activity tracking, custom messages, admin controls

🔧 Improvements

ManagerRegistry - Centralized manager system
SLF4J Logging - Better error tracking
Dynamic Commands - Config-based registration
Message Localization - 100+ new translation keys
Atomic File Operations - Better data integrity
Command Validation - Permission checks across board

📦 New Config Files

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

🚀 Upgrade

Backup config/neoessentials/
Stop server
Replace JAR: neoessentials-1.0.2.3+build.536.jar
Start server (auto-generates new configs)
Optional: Fix color codes in permissions.json (\u0026 → &)

✅ Verification

# Check logs
[ChatManager] Loaded chat-format (object): default=[...]

# Test features
/dashboard start
/createkit starter 3600
/afk Testing

📊 Stats

38 commits
15+ new commands
100+ translation keys
28 total placeholders
3 economy integrations

Contributors

@WillxRv Pull Request #13
@L8-Alphine #11

🔗 Required Dependancy mod

🔗 Links

Full compatibility with v1.0.2.1 | No breaking changes | Minecraft 1.21.1-1.21.8

NeoEssentials

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Creators

Details

NeoEssentials 1.0.2.3

Changelog

NeoEssentials v1.0.2.3 - Quality & Performance Update

🎯 Build #698 - Documentation & Final Polish

🛠️ Perfect Code Quality! ✨

🔇 Clean Logs Verified

🎯 Build #680+ - LuckPerms & Quality Improvements

🏷️ LuckPerms Placeholders - Now Working! 🎉

🔇 Clean Logs - No More Console Spam! 🧹

🛠️ Code Quality - 31+ Fixes! ✨

🎯 Build #627 - Critical Shutdown Fix

🔧 Server Shutdown Hang RESOLVED 🎉

🛠️ New: Thread Diagnostics

📊 Better Visibility

🎨 Code Quality

🎯 Build #599 Highlights

🆕 New Features

🔐 LuckPerms Auto-Sync

📡 /tpo Command

🐛 Major Fixes

Build #575 - Kit System Crash

Build #580 - Log Spam Eliminated

Build #585 - Permission Nodes

Build #590 - TPA System

Build #595 - Debug Logging

📋 Complete Changes

Added ✨

Fixed 🔧

Improved 📈

🎮 Quick Start

Using New Features

⚙️ Technical

📦 Installation

📚 Documentation

🔗 Useful Links

🎉 What's Next?

⭐ Support the Project

📊 Stats

NeoEssentials v1.0.2.2 - Major Update

🎯 Highlights

🌐 Web Dashboard System

📦 Kit Management

💬 Discord Integration

💰 Economy Integrations

🐛 Critical Fixes

Build #520 - Config Loading

Build #521 - Color Codes

Build #523 - AFK Placeholders

✨ New Features

Commands

Systems

🔧 Improvements

📦 New Config Files

🚀 Upgrade

✅ Verification

📊 Stats

Contributors

🔗 Required Dependancy mod

🔗 Links

Dependencies

Files

Metadata

Release channel

Version number

Loaders

Game versions

Environment

Downloads

Publication date

Version ID

📡 `/tpo` Command