NeoEssentials v1.0.1 - Modrinth Release

Major tablist system overhaul with YAML templates and animation support

Released: June 28, 2025

Overview

Version 1.0.1 introduces a completely rewritten tablist system with YAML-based templates, advanced animation support, and significant performance improvements. This update maintains full backward compatibility while adding powerful new customization options.

New Features

Enhanced Tablist System

• YAML Template Engine: Flexible template system with YAML configuration files
• Advanced Animation Support: Custom animation definitions with configurable timing
• Boss Bar Integration: Dynamic boss bars with real-time content updates
• Group-Based Templates: Different tablist content for different player groups
• Performance Optimization: Improved update algorithms with reduced overhead

Configuration Improvements

• Hybrid Configuration: TOML for settings, YAML for content templates
• Automatic Migration: Seamless upgrade from v1.0.0 configuration format
• Live Reloading: Template changes apply without server restart
• Enhanced Validation: Comprehensive configuration validation with detailed error messages

Developer Features

• Template API: Programmatic template creation and management
• Animation API: Custom animation effects through mod integration
• Enhanced Events: New event system for tablist updates and changes
• Configuration API: Runtime configuration management capabilities

Technical Changes

Architecture Updates

• Modular Design: Tablist system redesigned with pluggable components
• Improved Caching: Smart caching system reduces memory usage and improves performance
• Async Processing: Non-blocking operations for template rendering and updates
• Event Optimization: Reduced event listener overhead for better TPS

Configuration Migration

# Old format (v1.0.0) - automatically migrated
[tablist]
header = "&6Welcome to MyServer"
footer = "&7Visit our website"

# New format (v1.0.1)
[tablist]
template_file = "neoessentials/tablist.yml"
update_interval = 1000
animation_interval = 200

New File Structure

config/neoessentials/
├── general.toml           # Core mod settings
├── economy.toml           # Economy system settings
├── homes.toml             # Home system settings
├── warps.toml             # Warp system settings
├── kits.toml              # Kit system settings
└── database.toml          # Storage backend settings

neoessentials/
├── tablist.yml            # Tablist templates and content
├── animations.yml         # Animation definitions
└── README.md              # Configuration documentation

API Changes

New Classes

• TablistTemplateManager - Manages YAML template loading and parsing
• AnimationEngine - Handles animation processing and frame updates
• BossBarManager - Controls dynamic boss bar display
• TemplateRenderer - Renders templates with placeholder replacement

Events

• TablistUpdateEvent - Fired when tablist content changes
• TemplateLoadEvent - Fired when templates are loaded or reloaded
• AnimationFrameEvent - Fired for each animation frame update

Configuration API

// Access template system programmatically
TablistManager manager = NeoEssentials.getTablistManager();
Template template = manager.getTemplate("vip");
template.setHeader(Arrays.asList("&6VIP Server", "&aWelcome %player%"));
manager.reloadTemplates();

Migration Guide

Automatic Migration

1. Backup Creation: Original v1.0.0 configs saved to backup/ directory
2. TOML Conversion: Settings automatically converted to new format
3. Template Generation: Basic YAML templates created from existing configuration
4. Validation: New configuration validated with error reporting

Manual Customization

After automatic migration, enhance your setup:

settings:
  update_interval: 3000
  enable_animations: true
  enable_headers: true
  enable_footers: true

templates:
  headers:
    - "&6&lMyServer Network"
    - "&aOnline: &e%player_count%&7/&e%max_players%"
    - "<anim:rainbow>Welcome %player%"
  footers:
    - "&7Discord: &b&ndiscord.gg/myserver"
    - "&7Website: &b&nmyserver.com"

bossbars:
  global:
    - "{color:green}{style:progress}{progress:1.0}Server TPS: %server_tps%"

Performance Improvements

Benchmarks

• Update Speed: 40% faster tablist processing
• Memory Usage: 25% reduction in memory footprint
• CPU Usage: 30% reduction in tablist-related CPU overhead
• Network Traffic: 20% reduction in packet overhead

Optimizations

• Smart Caching: Template compilation cached until modification
• Batch Updates: Multiple changes processed together
• Lazy Loading: Templates loaded only when needed
• Memory Pooling: Object reuse reduces garbage collection

Compatibility

Backward Compatibility

• ✅ Configuration: v1.0.0 configs automatically migrated
• ✅ Commands: All existing commands work unchanged
• ✅ Permissions: No permission changes required
• ✅ Storage: Existing data fully compatible

Mod Compatibility

• ✅ LuckPerms: Enhanced integration with group-based templates
• ✅ FTB Ranks: Improved rank display in tablist templates
• ✅ Placeholder Mods: Better placeholder processing and caching

Installation

New Installation

1. Download v1.0.1 JAR file
2. Place in server mods/ directory
3. Start server (new configs auto-generate)
4. Customize templates in neoessentials/tablist.yml

Upgrade from v1.0.0

1. Stop server
2. Replace mod JAR with v1.0.1
3. Start server (automatic migration occurs)
4. Verify configuration in config/neoessentials/
5. Customize new templates as desired

Known Issues

Minor Issues

• Template Editor: In-game template editor needs stability improvements
• Animation Performance: Complex animations may impact performance on low-end hardware
• Boss Bar Positioning: Limited control over boss bar positioning

Workarounds

• Use external text editor for complex template modifications
• Limit animation complexity on servers with performance constraints
• Boss bar customization through configuration only

Documentation

Updated Guides

• Template System: Complete guide to YAML template creation
• Animation Creation: Tutorial for custom animation effects
• Migration Guide: Step-by-step upgrade instructions
• Performance Tuning: Optimization recommendations

API Documentation

• JavaDoc: Complete API documentation for developers
• Examples: Code examples for common use cases
• Integration Guide: How to integrate with other mods

Links

• Documentation: GitHub Wiki
• API Reference: JavaDoc
• Source Code: GitHub Repository
• Issue Tracker: GitHub Issues
• Discord: Community Server

---

Enhanced for the NeoForge modding ecosystem