AdvanceMMO

AdvanceMMO Changelog

v2.3.1 - RP Features & Tutorial System (December 18, 2025)

✨ New Features

RP Features & Tutorial System

• Emote System - Complete emote system for roleplay actions implemented

  • New command /emote <emote> for predefined emotes (wink, wave, laugh, smile, etc.)
  • New command /me <action> for custom actions
  • Range-based display - only nearby players see emotes
  • Actionbar display for current emote
  • Emote list viewable via /emote list

• Dice System - Complete dice system for RP dice rolls implemented

  • New command /roll [XdY] for complex dice rolls (e.g. 3d6, 2d20)
  • New command /dice as alias for /roll
  • Simple dice roll /roll [number] (1-100)
  • Beautiful chat formatting with result display
  • Range-based display - only nearby players see dice rolls
  • Dice statistic tracking per player
  • Validation of dice parameters (max. 100 dice, max. 100 sides)

• Voice Range Chat - Extended chat system with local chat and configurable range

  • New command /local [message] or /l [message] for local chat (20 block range)
  • New command /shout [message] or /s [message] for shouting (50 block range)
  • Particle effects for shout messages (optional)
  • Automatic chat forwarding based on active channel
  • All ranges configurable in config

• Tutorial Book System - Complete written book with plugin guide implemented

  • Bilingual (German/English) based on configured language
  • New command /tutorial (aliases: /guide, /helpbook) to retrieve the book
  • Automatic giving on first login (optionally configurable)
  • Contains all important information about the plugin:
    • Races & Classes
    • Skills & Professions
    • Guilds & Parties
    • Quests & Dungeons
    • Shop & Economy
    • RP Features (Emotes, Voice Range, Dice)
    • Command Overview
  • Automatic page splitting for long content

🛒 Shop System & Integrations

• Shop System

  • Complete shop system with GUI implemented
  • Shop GUI with pagination (45 items per page)
  • Support for EssentialsX Economy via Vault
  • Fallback to internal CurrencyManager system
  • Buy and sell items
  • Dynamic price adjustment (1% per purchase)
  • New command /shop [shopId] to open shops

• Integrations

  • NBTAPI integration added (optional, reflection-based)
  • ItemsAdder integration added (optional, reflection-based)
  • EssentialsX integration added for direct economy access
  • All integrations work without plugin installation (reflection)

• Event System

  • NBT Item Event system implemented (every 60 minutes)
  • Temporary event items can be added to shops
  • Automatic event broadcasts to all players
  • Configurable event duration and intervals
  • Event items are automatically removed after expiration

🐛 Bug Fixes & Improvements

Language System

• Complete overhaul of the language system - German/English now works correctly
• Language files are now correctly copied to the languages/ folder
• Config reload now automatically updates the language setting
• Dynamic fallback to configured default language instead of hardcoded "de"
• GUI texts fully translatable (e.g. "Stat Modifiers:" in race and class selection)

Database & Migrations

• Automatic detection of missing tables and re-execution of migrations
• MariaDB compatibility: Automatic conversion of AUTOINCREMENT to AUTO_INCREMENT
• Reserved words automatically wrapped in backticks (e.g. read)
• TIMESTAMP columns correctly adjusted for MariaDB (NULL values and DEFAULT values)
• SQL comments correctly removed from migrations
• Added missing column mythicmob_type to dungeon_bosses
• Added player_currencies table to migrations

Integrations

• MythicMobs is now fully optional - Plugin works without MythicMobs
• MythicMobs integration now uses Reflection for better compatibility
• Integrations are only enabled if they are enabled in the config

Code Quality

• Fixed all linter errors (unused imports, unused fields)
• Improved error handling and logging in migrations

v2.3.0 - Shop System & Integrations (December 18, 2025)

✨ New Features

• Complete shop system with GUI
• NBTAPI and ItemsAdder integration support
• EssentialsX economy integration
• NBT Item Event system

for mor info see here