⭐️ Mythical Races Engine (Premium) ⭐️

MC Plugin ⭐️ Mythical Races Engine (Premium) ⭐️ 2.8.1-SE-V2
A flexible, advanced plugin with races, abilities, potion effects, attributes, and classes

Summary of Changes
1. Velocity System Overhaul

  • Radial Knockback / Push & Pull
    • pushaway <hMag> [yMag] / addpushaway / setpushaway: Radially knocks targets away from the caster (or backward from look direction if targeting self).

    • pulltoward <hMag> [yMag] / addpulltoward / setpulltoward: Radially pulls targets toward the caster horizontally.
  • Directional & Caster Vector Look
    • addcasterlookvelocity <xMag> <yMag> <zMag> / setcasterlookvelocity: Propels the target along the caster's look direction (for beam/wave effects).

    • addlookvelocity / setlookvelocity: Applies velocity along the target's look direction.

    • addvelocity / setvelocity: Applies velocity in world coordinate axes.
  • Duration / Repeating Loop Directives
    • REPEATFORTIME:intervalTicks:durationTicks <command>

    • DURATION:intervalTicks:durationTicks <command>

    • Function: Automatically runs the command repeatedly at defined tick intervals until the total duration expires.
2. Event System & Stand-Only Triggers
  • Jump Events
    • Added JUMPEVENT, SHIFTJUMPEVENT, and NOSHIFTJUMPEVENT triggers via PlayerStatisticIncrementEvent (Statistic.JUMP).
  • Swap Hands Events ('F' Key)
    • Standard triggers: SWAPHANDS, SHIFTSWAPHANDS, NOSHIFTSWAPHANDS

    • Cancel variants: SWAPHANDSCANCEL, SHIFTSWAPHANDSCANCEL, NOSHIFTSWAPHANDSCANCEL

    • Handled via PlayerSwapHandItemsEvent.
  • Stand-Only Click Triggers (NOSHIFT... / NOTSHIFT...)
    • Includes: NOSHIFTRIGHTCLICKAIR, NOSHIFTLEFTCLICKAIR, NOSHIFTRIGHTCLICKBLOCK, NOSHIFTLEFTCLICKBLOCK, NOSHIFTRIGHTCLICKBLOCKHAND, NOSHIFTLEFTCLICKBLOCKHAND, and consume variants.

    • Function: Allows abilities to fire exclusively when standing without interfering with sneaking abilities.
  • Health Threshold Triggers
    • Triggers: HEALTHUNDER, HEALTHOVER, HEALTHPERCENTUNDER, HEALTHPERCENTOVER, LOWHEALTH (plus SHIFT... and NOSHIFT... variants).

    • Evaluation: Evaluated periodically. Supports inline thresholds (e.g., HEALTHUNDER-6, HEALTHPERCENTUNDER-25) or material argument numbers (6, 25%).
3. Scripting Engine
  • Added {playerMaxHealth()} and {playerHealthPercent()} functions and placeholder evaluation.
4. Configuration & Documentation
  • config.yml
    • Added comprehensive documentation comments and configuration examples for all new event types, velocity directives, duration repeating triggers, and health triggers/placeholders.
  • WikiPageMRAddons.js
    • Updated the official website documentation with dedicated sections and examples for the new velocity system, REPEATFORTIME, jump/swap hand events, NOSHIFT stand-only actions, and scripting functions.
Bug Fixes:
  • Fixed a priority issue with RESTRICT WEAPON
  • Fixed a race editor GUI not opening
  • Fixed critical hits bypass with RESTRICT WEAPON
New Features:
  • N/A
Configuration Changes:
  • Some small changes to the configuration, nothing important
Changelog (BETA)
  • Admin & Content Suite: Added unified in-game admin hub for player tools, plugin utilities, GUI shortcuts, editors, scoreboard toggles, and support links, recipe manager GUI, quest manager GUI. mythicalraces.admin.gui | /races admin
  • Player Profile GUI: Added configurable player info interface with permission gating and filler/custom items, accessible via /races profilegui.
A considerable amount of config changes, if you are updating with a custom config, please add the following to the "other" section in MythicalRaces/config.yml
YAML:
  adminGui:
      enabled: true
      size: 45
      mainTitle: '&4MythicalRaces Admin (BETA)'
      playerSelectorTitle: '&4Admin | Select Player'
      playerToolsTitle: '&4Admin | Managing {player}'
      raceSelectorTitle: '&4Admin | Race -> {player}'
      classSelectorTitle: '&4Admin | Class -> {player}'
      kitSelectorTitle: '&4Admin | Kits -> {player}'
      pluginToolsTitle: '&4Admin | Plugin Tools'
      guiShortcutsTitle: '&4Admin | Shortcuts'
      infoToolsTitle: '&4Admin | Info Tools'
      kitToolsTitle: '&4Admin | Kit Tools'
      filler: 'GRAY_STAINED_GLASS_PANE'
      questManagerTitle: '&4Admin | Quest Manager'
      questEditorTitle: '&4Admin | Edit Quest -> {quest}'
      labels:
        back: '&cBack'
        close: '&4Close'
        next: '&aNext Page'
        previous: '&cPrevious Page'
        page: '&7Page {page}/{pages}'
      messages:
        disabled: '&cThe admin GUI is disabled in the configuration.'
        needPlayer: '&cThis command can only be used by players.'
        promptNumeric: '&eEnter the value to {action} for {player}. Type &ccancel &eto abort.'
        invalidNumber: '&cPlease enter a valid number or type cancel.'
        actionCancelled: '&cAction cancelled.'
        raceLevelSet: '&aSet {player}&a''s race level to {value}.'
        classLevelSet: '&aSet {player}&a''s class level to {value}.'
        raceXpAdded: '&aAdded {value} race XP to {player}.'
        classXpAdded: '&aAdded {value} class XP to {player}.'
        noKits: '&cNo kits are configured.'
        noPlayers: '&cThere are no players online.'
        targetOffline: '&c{player} is no longer online.'
        noTarget: '&cSelect a player first.'
        cooldownReset: '&aReset cooldown for {player}.'
        playerReset: '&aReset race and class data for {player}.'
        attributesReset: '&aRemoved attribute modifiers from {player}.'
        togglePlayer: '&aToggled abilities for {player}.'
        kitGiven: '&aAttempted to give {kit} to {player}.'
        recipeExists: '&cA recipe named {kit} already exists.'
        questExists: '&cA quest named {kit} already exists.'
        reload: '&aCommand executed.'
        help: '&aHelp command executed.'
        leaderboard: '&aLeaderboard command executed.'
        raceSet: '&aSet {player}&a''s race to {race}.'
        classSet: '&aSet {player}&a''s class to {class}.'

   playerInfoGui:
      enabled: true
      command: 'profilegui'
      aliases:
       - 'playergui'
      permission: ''
      title: '&dMythical Profile'
      size: 27
      filler:
         enabled: true
         material: 'BLACK_STAINED_GLASS_PANE'
         name: ' '
      messages:
         disabled: '&cThe player info GUI is disabled.'
         needplayer: '&cThis command can only be used by players.'
         nopermission: '&cYou do not have permission to open this GUI.'
      items:
         overview:
            slot: 13
            material: 'PLAYER_HEAD'
            playerHead: true
            name: '&d{player}'
            lore:
              - '&7Race: &f{race_display}'
              - '&7Level: &f{race_level}'
              - '&7XP: &f{race_xp}&7/&f{race_xp_required}'
              - '&7Level Type: &f{race_level_type}'
              - '&7Class: &f{class_display}'
              - '&7Class Level: &f{class_level}'
              - '&7Class XP: &f{class_xp}&7/&f{class_xp_required}'
              - '&7Class Level Type: &f{class_level_type}'
         race-details:
            slot: 11
            material: 'ENCHANTED_BOOK'
            name: '&bRace Information'
            lore:
             - '{race_lore}'
         class-details:
            slot: 15
            material: 'BOOK'
            name: '&6Class Information'
            lore:
             - '{class_lore}'
         class-traits:
            slot: 22
            material: 'PAPER'
            name: '&aClass Traits'
            lore:
             - '&aSkills'
              - '{class_skills}'
              - ' '
              - '&aAttributes'
              - '{class_attributes}'
Bug Fixes:
  • Fixed another issue with MySQL races/effects
New Features:
  • N/A
Configuration Changes:
  • N/A
Look at previous changelog
Bug Fixes:
  • Add look velocity now works as intended
New Features:
  • Added custom item recipes that you can craft, which can execute custom abilities, this is completely customizable, and very powerful considering its attached to the abilities executor that you may be familiar with (disabled by default)
  • Added a scoreboard feature, (the panel on the right you usually see on servers, it supports PAPI, disabled by default)
  • Both are disabled by default unless you enable it in their respective configurations
  • New command - /mraddons item <player> <itemKey> (need permission mraddons.execute)
Configuration Changes:
  • Added a configuration file for custom recipes that you can craft in game
  • Added a configuration file for the new scoreboard
  • Both are disabled by default unless you enable it in their respective configurations
Bug Fixes:
  • N/A
New Features:
  • When the plugin is starting up, it will pinpoint what is exactly wrong in a certain race if it fails validation, no more vague errors, if you have an improper race set up, it will say exactly what is wrong with it, stop the plugin and log the exact, race, path, and value that needs correction.
    This is for both mythical races and mrpremiumaddons
Configuration Changes:
  • N/A
Bug Fixes:
  • Fixed an issue with the console log filter, when many players are online, it would not properly filter console commands
New Features:
  • N/A
Configuration Changes:
  • N/A
Bug Fixes:
  • Fixed some attributes being applied incorrectly at night causing warning errors in console
New Features:
  • N/A
Configuration Changes:
  • N/A
Bug Fixes:
  • Fixed attributes being applied consistently in 1.21+
    (Important - if a player has more hearts than they should, reset them using /races attribute-reset)
New Features:
  • A new command has been introduced called /races attribute-reset
Configuration Changes:
  • All attribute names were changed, please delete classes.yml and config.yml, and let them generate a new file
Major Changes:
Support below 1.21 has been dropped
Top Bottom