Моды/NeoEssentials

NeoEssentials

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

5.0K

Экономика

Управление

Утилиты

5.0K

NeoEssentials 1.0.2.5

beta6 марта 2026 г.

NeoEssentials — Changelog

Minecraft 1.21.1 – 1.21.11 · NeoForge 21.1.179+

1.0.2.5+build.1072 — 2026-03-06

🐛 Fixed: PowerTool System

Powertools now fire on block right-clicks — previously only worked when clicking in empty air; now fires on any right-click (air, block, mob)
/powertooltoggle now actually works — was checking a dead legacy class instead of the real per-player toggle
Dead PowertoolToggleCommand class replaced with a compatibility shim to prevent double command registration

1.0.2.5+build.1065 — 2026-03-05

📋 Tablist Config File

Tablist settings moved to config/neoessentials/tablist.json — a dedicated, fully-documented file separate from the main config.

Auto-deployed on first start, backwards compatible with existing config.json tablist sections
New groupColors — colour player names by permission group in the header/footer
& colour codes work everywhere in the file
New /tablist config command shows a live settings summary
/tablist info now shows the full file path
Reload anytime with /tablist reload

🌍 Lang File Key Audit

~120 missing translation keys added covering Whois, Helpop, List, ChestShop, Vault, and moderation systems
Server lang files now auto-merge new keys on startup — admin edits are never overwritten

🐛 Fixes

Duplicate translation keys in en_us.json removed
/tablist reload resets animation frames immediately

1.0.2.5+build.1057 — 2026-03-05

✨ ChestShop System

Sign-based shops — the classic essentials shop experience, natively in NeoForge.

Sign format (all 4 lines):

[blank or name]   ← auto-assigns your name if left blank
[quantity]        ← e.g. 5
[B buy:S sell]    ← e.g. B 10:S 5  /  B FREE  /  S 2.50
[item or ?]       ← e.g. diamond  — or ? to right-click-assign

Right-click sign = BUY, left-click sign = SELL
Blank line 1 auto-assigns the creating player's name
Write ? on line 4, then right-click the sign holding an item to fill it in
Admin Shops — Admin Shop on line 1 = unlimited stock, no chest required
Shops persist across restarts in neoessentials/shops.json
Full economy integration — uses EconomyManager with rollback safety
Permission-gated creation and usage
/chestshop command suite: list, info, convert, remove, reload

✨ Vault API

Economy, Chat, and Permission Vault providers
Chat prefix/suffix now uses LuckPerms or FTB Ranks when installed
Deposit/withdraw events fire for all Vault-originated transactions

🐛 Fixes

NeoForge 1.21.1 API compatibility fixes across multiple commands
config.json duplicate keys and JSON syntax error fixed
Vault economy currency format now reads live from config
Vault chat prefix/suffix now correctly uses external permission adapters

1.0.2.5+build.908 — 2026-03-03

✨ 50+ New Commands

Player info, world interaction, teleportation, item customisation, admin tools, economy enhancements, and more. Full command list: CHANGELOG_GITHUB.md

🌍 9 Languages

English + French, German, Spanish, Portuguese (BR), Chinese, Dutch, Polish, Russian. Auto-deployed on server start, safe to edit.

🛒 Worth & Sell System

/worth, /sell hand|inventory|all, /setworth — sell multiplier, named item protection.

🎲 Random Teleport

/tpr — even distribution, nether-aware, biome exclusions, async cache, named zones.

🔐 Permissions

50+ missing nodes registered, MODERATION category added, denial messages show required node.

🐛 Key Fixes

Safe teleport detection rewritten (slabs/stairs/glass now safe)
AFK system fully functional
Chat appears in server console
PowerTools follow the item not the slot
Dashboard offline login, auto-update, rich text fixed
Timed jails with full enforcement

1.0.2.3 — initial release

Core economy, chat, moderation, teleportation, kits, warps, web dashboard, permissions, item management.

NeoEssentials 1.0.2.4

beta13 января 2026 г.

NeoEssentials v1.0.2.4

🚨 CRITICAL UPDATE - Module Conflict Resolution + Teleportation Fix

Build #750 | January 13, 2026 | MC 1.21.1 - 1.21.11 | NeoForge 21.1.179+ / 21.11.24-beta

This release fixes critical compatibility issues AND teleportation safety bugs!

🐛 Critical Fixes

Unsafe Teleportation System - FIXED ✅

The Problem:

Safety config options (enableHomeTeleportSafety: false) didn't work
Mod blocked teleportation to "unsafe" locations even when safety was disabled
Couldn't teleport to Nether ceiling, lava bases, intentional unsafe builds
All teleportation types affected (homes, warps, spawn, TPA)

The Solution:

✅ Fixed safety check logic in HomeManager, WarpManager, SpawnManager
✅ When safety true: Finds safe alternatives or blocks if none exist
✅ When safety false: Allows teleportation ANYWHERE (even dangerous spots)
✅ Updated all config comments to clearly explain behavior
✅ Tested with Nether ceiling, void platforms, lava builds

The Result:

🎉 Full control over teleportation safety!
🎉 Advanced players can disable safety for legitimate use cases!
🎉 Nether ceiling farms work when safety is disabled!
🎉 Default behavior unchanged (safe by default for casual players)!

Affected Config Options:

"enableHomeTeleportSafety": false  // Now works! Allows homes in lava, void, etc.
"enableWarpSafety": false          // Now works! Allows warps at dangerous locations
"enableSpawnSafety": false         // Now works! Allows spawn anywhere
"enableTeleportSafety": false      // Now works! Allows TPA to unsafe locations

Module Export Conflicts - RESOLVED ✅

The Problem:

Server crashes with "Module neoessentials exports package..." errors
Conflicts with: JadeAddons, SmoothChunk, SDLink, LetMeDespawn, and others
Incompatible with Arclight/hybrid server platforms
"Module neoforge reads more than one module named com.google.gson"

The Solution:

✅ Migrated from Shadow plugin to NeoForge's native JarJar system
✅ Removed Gson dependency (NeoForge already provides it)
✅ Properly isolated Java-WebSocket library
✅ Eliminated module-info.class conflicts
✅ No longer exports Minecraft/NeoForge packages

The Result:

🎉 Works with ALL tested mod combinations!
🎉 Compatible with Arclight & hybrid platforms!
🎉 Clean server startup every time!
🎉 No more module resolution errors!

Technical Changes:

Build system: Shadow → JarJar
Dependencies: Gson removed, Java-WebSocket isolated
JAR structure: Optimized for NeoForge module system
Module metadata: Cleaned up, no package exports

🎉 Previous Updates (v1.0.2.4)

Chat Channels System

FIXED: Channels were configured but commands didn't exist!

/l, /g, /staff commands now work
Prefix support: !message (global), @message (staff)
Local = proximity chat, Global = server-wide, Staff = permission-based
Fully functional and documented

Config Auto-Update System

FIXED: Configs now automatically update when you upgrade the mod!

Detects old _configVersion values
Creates timestamped backups before updating
Replaces old configs with new versions
No more manual config deletion!
All new features work immediately after update

✨ New Features

Config File Splitting (IMPROVED!)

SMART AUTO-DETECTION - New servers get optimized configs automatically!

How it works:

Fresh installs: Auto-creates 9 split config files (no manual steps!)
Existing servers: In-game notification to OPs/admins
Deleted configs: Auto-recovery with split structure

In-game notification shown to admins:

OPs (level 4)
Players with * or neoessentials.* permission
Only shown once per server start
Beautiful formatted message with benefits

Manual migration:

Command: /neoessentials config split
Automatic backup creation
Splits config.json into 9 focused files
Easy rollback support
100% backward compatible

Files created: main.json, commands.json, chat.json, teleportation.json, moderation.json, webdashboard.json, items.json, afk.json, security.json

Benefits:

Easier to find settings
Less syntax errors
Better organization
Per-file version control

✨ New Features (Continued)

💬 Phase 2: Interactive Chat

Clickable URLs - Auto-detect and link http/https URLs
@Mentions - Highlight players with sound notifications
[item] Links - Show held items with hover details

🎨 Phase 3: Advanced Features

Badge System - Rank badges (👑⭐💎) + status icons (💤👻🔇)
Custom Images - Drop PNG files in folder for custom badges
Anti-Spam - Caps, repeat, link, and rate limiting filters
Templates - 7 pre-built chat formats (RPG, Modern, Minimal, etc.)

🌈 Phase 4: Rich Text

Gradients - <gradient:FF0000-0000FF>text</gradient>
✨ - <✨>text</✨>
Conditionals - Time/stat/state-based formatting
- <if:time=morning>Good morning!</if>
- <if:health<50>❤️</if>
- <if:afk>💤</if>

🆕 What's Included

Interactive Elements

URLs auto-convert to clickable links (blue, underlined)
@PlayerName mentions with sound notifications
[item] shows held item with enchantments on hover

Badge & Icon System

Emoji badges per rank: 👑 Owner, ⭐ Admin, 💎 VIP, 🛡️ Moderator
Custom badge images: Place PNG files in config/neoessentials/badges/
Status icons: 💤 AFK, 👻 Vanished, 🔇 Muted
Flexible positioning options

Anti-Spam Protection

Caps Filter - Converts SHOUTING to lowercase or blocks
Repeat Filter - Blocks duplicate messages (5s cooldown)
Link Filter - Whitelist/blacklist URLs
Rate Limit - Prevents flooding (5 msgs per 10s)
Bypass permissions for staff

Format Templates

Choose from pre-built styles:

RPG: [Lv.30] [Admin] Steve: Hello!
Modern: ● [VIP] Alex › Hey!
Minimal: Steve: message
Detailed: [world] <[Admin] Steve> message
Custom: Your own format

Rich Text Effects

Gradient Text: Smooth color transitions
- Example: <gradient:FFD700-FF1493>VIP</gradient> (gold→pink)
✨ Text: 7-color spectrum
- Example: <✨>✨ Road!</✨>

Conditional Formatting

Dynamic chat based on:

Time: morning, afternoon, evening, night, weekday, weekend
Stats: health, level, food, armor, xp
State: afk, flying, creative, survival, vanished, op
Dimension: nether, end, overworld
Actions: sneaking, sprinting, swimming, onfire, wet, underground

🆕 New Permissions

# Phase 2
neoessentials.chat.color
neoessentials.chat.color.hex
neoessentials.chat.format
neoessentials.chat.mention
neoessentials.chat.itemlink

# Phase 3
neoessentials.chat.caps.bypass
neoessentials.chat.repeat.bypass
neoessentials.chat.links.bypass
neoessentials.chat.spam.bypass

# Phase 4
neoessentials.chat.richtext
neoessentials.chat.gradient
neoessentials.chat.✨

⚙️ Configuration

All features are highly configurable:

{
  "chat": {
    "enableChatEnhancements": true,
    "autoLinkUrls": true,
    "allowItemLinks": true,
    "mentions": { "enabled": true, "playSound": true },
    "badges": {
      "enabled": true,
      "useCustomImages": false,
      "rankBadges": { "admin": "⭐", "vip": "💎" }
    },
    "antiSpam": {
      "capsFilter": { "enabled": true },
      "repeatFilter": { "enabled": true },
      "spamFilter": { "enabled": true }
    },
    "formatTemplates": { "enabled": false },
    "richText": { "enabled": false },
    "conditionalFormatting": { "enabled": false }
  }
}

🎯 Example Usage

Gradient VIP Prefix

{
  "group:vip": "<gradient:FFD700-FF1493>{prefix}</gradient> {name}: {MESSAGE}"
}

Time-Based Greeting

{
  "default": "<if:time=morning>☀️ </if>{prefix}{name}: {MESSAGE}"
}

Health Warning

{
  "default": "{prefix}{name} <if:health<50>❤️ </if>: {MESSAGE}"
}

Complex Multi-Feature

{
  "group:admin": "<gradient:FF0000-00FF00>{prefix}</gradient> <if:flying>✈️ </if>{name}: {MESSAGE}"
}

🐛 Bug Fixes

Fixed LuckPerms prefix/suffix integration
Fixed Stream resource leaks
Fixed null pointer warnings
Improved error handling and logging
Removed unused imports and redundant code
Fixed color code restriction logic
Debug logging now config-controlled

📚 Documentation

Complete documentation included:

Phase 2-4 implementation guides
Custom badge setup guide
Placeholder reference
Permission documentation
Configuration examples
Testing checklists

📊 Performance

Minimal overhead (~10-15ms with all features)
Optimized concurrent data structures
Cached badge lookups
Pre-compiled regex patterns
No database queries for chat

🎮 Getting Started

Update the mod to v1.0.2.4
Check config at config/neoessentials/config.json
Enable features you want (all disabled by default)
Set permissions for your ranks
Customize badges, templates, and formats
Test in-game and enjoy!

⚠️ Notes

Custom badge images require client resource pack (auto-generation included)
Resource pack auto-send pending NeoForge API update (use server.properties)
All Phase 4 features disabled by default (opt-in)

🔗 Links

Discord: https://discord.gg/dUGAQF2Mga
GitHub: https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials
Wiki: https://github.com/ZeroG-Network-PTY-LTD/NeoEssentials/wiki

This is the most comprehensive chat update ever! 🎉

4 phases, 50+ new features, 11 new permissions, complete documentation!

Enjoy! 🚀 - Changelog

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

🎯 What's New

💬 Interactive Chat Revolution! ✨

Modern chat features that make communication fun and intuitive!

Features:

🔗 Clickable URLs

Auto-detects and links URLs
Click to open in browser
Blue and underlined

📢 @Mentions

Type @PlayerName to ping someone
Bold yellow highlight
Plays notification sound
Click to message

💎 Item Links

Use [item] to show held item
Hover for full details
Clickable and stylish

🎨 Full Color Support

Basic colors (&c for red)
Hex colors (&#FF5500)
Format codes (bold, italic, etc.)

Config:

{
  "enableChatEnhancements": true,
  "autoLinkUrls": true,
  "allowItemLinks": true,
  "mentions": {
    "enabled": true,
    "playSound": true,
    "highlightColor": "&e"
  }
}

Permissions:

neoessentials.chat.color       - Colors
neoessentials.chat.color.hex   - Hex colors
neoessentials.chat.format      - Formatting
neoessentials.chat.mention     - @mentions
neoessentials.chat.itemlink    - [item] links

Example:

Input:  @Steve check my [item] at https://example.com
Output: @Steve check my [Diamond Sword] at https://example.com
        ^^^^^^          ^^^^^^^^^^^^^^^^    ^^^^^^^^^^^^^^^^^^^
        mention         item link            URL link
        (yellow,        (aqua, hover         (blue,
         sound)         shows stats)         clickable)

Installation

Download the .jar file
Place in mods folder
Restart server
Enjoy!

Support

🐛 Found a bug? Report it on our issue tracker
💬 Need help? Join our Discord
📖 Read the wiki for detailed documentation

Previous Versions

Check Modrinth version history for older changelogs.

NeoEssentials 1.0.2.3

beta7 января 2026 г.

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 1.0.2.2

beta10 ноября 2025 г.

NeoEssentials v1.0.2.2-HotFix - 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.2-HotFix+build.524.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

🔗 Links

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

NeoEssentials 1.0.2.1 HOTFIX

beta7 сентября 2025 г.

NeoEssentials 1.0.2.1 Hotfix

Critical Fixes & Stability Improvements

🛠️ Major System Updates

Translation System Rebuilt: Complete overhaul of the language management system with proper server-side localization
Data Persistence Fixed: Resolved critical issues where player homes, economy data, and settings were not saving correctly
Permission System Enhanced: Fixed permission group assignments and individual permissions not persisting across server restarts

🐛 Bug Fixes

Fixed compilation errors in PermissionEventListener causing server startup failures
Resolved type safety conflicts between Player and ServerPlayer throughout the codebase
Fixed memory leaks in the translation system affecting server performance
Corrected import conflicts and missing dependencies preventing successful builds
Fixed data loading synchronization issues during player join events

🔧 Technical Improvements

Rebuilt PlayerDataManager integration with enhanced permission storage
Implemented proper fallback systems for non-server player contexts
Added comprehensive error handling and debug logging
Optimized permission cache management for better performance
Enhanced CustomPermissionsManager with proper data persistence

📁 Codebase Cleanup

Removed 14 unnecessary development files and artifacts
Streamlined project structure for production readiness
Cleaned documentation and removed temporary development files
Optimized build configuration for stable releases

⚠️ Important Information

Backup Recommended: While this update includes automatic data migration, backing up your world is always recommended before major updates.

What's Fixed: This hotfix specifically addresses the persistent data loss issues where player homes would disappear, economy balances would reset, and permission groups wouldn't save properly.

Compatibility: Fully compatible with existing worlds and configurations. No manual intervention required.

🎯 For Server Owners

This hotfix resolves the critical stability issues that were causing data loss and server crashes. Your players' homes, money, and permissions will now persist correctly across server restarts.

Minecraft Version: 1.21.1
NeoForge Version: 21.1.179+
Mod Version: 1.0.2.1_HOTFIX

Совместимость

Minecraft: Java Edition

1.21.x

Платформы

NeoForge

Поддерживаемые окружения

Сервер

Ссылки

Сообщить о проблеме Исходный код Wiki Сервер Discord

Детали

Лицензия:MIT

Опубликован:10 месяцев назад

Обновлён:1 месяц назад