Summary of Changes
1. Velocity System Overhaul
2. Event System & Stand-Only Triggers
- 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.
3. Scripting Engine
- 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%).
4. Configuration & Documentation
- Added {playerMaxHealth()} and {playerHealthPercent()} functions and placeholder evaluation.
- 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:
New Features:
- Fixed a priority issue with RESTRICT WEAPON
- Fixed a race editor GUI not opening
- Fixed critical hits bypass with RESTRICT WEAPON
Configuration Changes:
- N/A
- Some small changes to the configuration, nothing important
Changelog (BETA)
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
- 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.
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:
New Features:
- Fixed another issue with MySQL races/effects
Configuration Changes:
- N/A
- N/A
Bug Fixes:
New Features:
- Add look velocity now works as intended
Configuration Changes:
- 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)
- 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:
New Features:
- N/A
Configuration Changes:
- 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
- N/A
Bug Fixes:
New Features:
- Fixed an issue with the console log filter, when many players are online, it would not properly filter console commands
Configuration Changes:
- N/A
- N/A
Bug Fixes:
New Features:
- Fixed some attributes being applied incorrectly at night causing warning errors in console
Configuration Changes:
- N/A
- N/A
Bug Fixes:
New Features:
- Fixed attributes being applied consistently in 1.21+
(Important - if a player has more hearts than they should, reset them using /races attribute-reset)
Configuration Changes:
- A new command has been introduced called /races attribute-reset
Major Changes:
- All attribute names were changed, please delete classes.yml and config.yml, and let them generate a new file
Support below 1.21 has been dropped