Skip to content

#99 Patch Notes

Jump to bottom
zThana edited this page Sep 2, 2024 · 1 revision

Update v4.0

Races & Race Configuration

  • Every race is now made out of modules instead of simply being 1 big fetched file. Speaking of fetching; players are now cached internally.
  • Each module can be individually toggled on or off. It can now also simply be left out of the file altogether. Gone are the times of required sections! The only exception to this is the race display name.
  • When enabling modules, some settings may be required. If they're not present in the configuration file despite the module being enabled, it'll be done for you using default settings. For example, if you have potion effects enabled but the bubbles setting is not present, it'll default to false.=
  • race.temp-op has been removed and the race-location module has been renamed to location. Additionally, race-location.location has changed to location.spawn-location.
  • A race item can now also have a player's head as skull by simply using player:<playername> as material.
  • All commands.race-commands-day/night/death/respawn/change have changed to commands.day/night/death/respawn/change.
  • All permissions.permissions-permanent/day/night have changed to permissions.permanent/day/night.

Potion Effects

  • potions.ambient can be set to true/false depending on whether you want the potion effects to show up in the player's inventory.
  • refresh-tick-rate and effect-duration have been removed. Potion effects are now given permanently as long as the conditions are right.
  • Race potion effects can no longer be removed using milk. Splash potions and drinking milk now also respect the potions.override setting.

Attributes

  • All vanilla attributes can now have a modifier. These are added onto the attribute and do not set the base value of that attribute, allowing other plugins to do that instead without clashing with Races of Thana. This also allows you to easily stack it with other plugins, for example if you have classes which alter a player's health as well. For example, another plugin could set a player's base health to 22 but the player's race makes them squisher which should always negate 2 hearts:
attributes:
  enabled: true
  permanent:
  - GENERIC_MAX_HEALTH_MODIFIER: -4 # regardless of the base health, they will always have 2 full hearts subtracted

This works with any vanilla attribute, so you could also do GENERIC_SCALE_MODIFIER: 0.3, GENERIC_ARMOR_MODIFIER: 4, etc.

  • Additionally, for all generic attributes (anything that startas with "GENERIC_"), you can simply leave it out. So MAX_HEALTH: 20 will work just fine.
  • The Vampire attribute now supports multiple settings by turning it into a decimal value. For example, when you set the attribute to VAMPIRE: 1, you can select different settings by doing the following: 1.01: If a vampire is wearing a helmet, they will not take sun damage. 1.02: If a vampire has fire resistance, they will not take sun damage. 1.03: If a vampire is either wearing a helmet or has the fire resistance effect, they will not take sun damage.
  • The Nyctophobia (previously "Nycto") attribute supports multiple settings using the same method: 1.01: When someone with nyctophobia is holding a torch, they will not take damage from darkness. 1.02: When someone with nyctophobia has night vision, they will not take damage from darkness. 1.03: When someone with nyctophobia is either holding a torch or has the night vision effect, they will not take damage from darkness.
  • A new attribute for flight ("FLIGHT") has been introduced. The value determines which height flight will be disabled at. For example, FLIGHT: 80 will enable flight for the race until they hit y80, which will cause them to drop down. Note that as soon as they enter < y80 again, flight will be re-enabled which prevents fall damage and also enables them to fly again mid-fall. 1.01: You may only fly above the y value. 1.02: You may only fly below the y value.
  • A new attribute for swim speed ("SWIM_SPEED") has been introduced. The value determines how the speed will be manipulated: 1.01: Speed will be added. 1.02: Speed will be subtracted. 1.03: Speed will be multiplied.

Commands & Permissions

  • The aliases "traces", "thanar", and "thanaraces" for the main command have been removed.
  • The /race debug command has been updated and is now more organized. Settings not in the race's file won't appear anymore for tidiness.
  • You can now use /races debug if you have the racesofthana.debug permission. Being an OP is no longer necessary.
  • Added a callback command (/racesofthanacallback) for internal use. It's not meant to be used as a regular command and will do nothing if you manually use it.
  • Using the callback feature, /races debug now has a few clickable messages.
  • /races about has been removed.
  • You can now toggle race chat with /racechat.
  • You'll need the racesofthana.token.give permission to give the token to someone.
  • You'll need the racesofthana.token.set permission to modify the race token in-game using the new /races token set command.
  • racesofthana.token.* grants racesofthana.token, racesofthana.token.use and racesofthana.token.give.
  • /races setspawn <race> has changed to /races setspawn <race> [level] [teleportOnLogin] [teleportOnDeath]. If no level is provided, it'll set the spawn location of the base race.

Messages & lang.yml

  • The lang.yml file has been completely revised. It now also supports PAPI so you can use any placeholder.
  • You'll need to redo the previous messages, except for the prefix. I recommend you to save these before updating the plugin, just in case.
  • All messages have been updated to no longer forcefully include the prefix. If you'd like to use the plugin's prefix regardless, you can use %prefix% in any message within the lang.yml file which will parse the configured prefix. If you don't want a message to appear, set it to "".

Hooks & hooks.yml

  • All hooks have been moved from the config.yml file to the hooks.yml file.
  • CombatLogX is now supported and can be modified within the hooks.yml file.
combatlogx:
    enabled: true
    prevent-in-combat:
        home-teleport: true
        change-race: true
        teleport-message: "&cYou cannot teleport to the race spawn while in combat!"

In-game GUI Editor

  • A new in-game GUI editor has been introduced. You can now modify the config.yml, lang.yml, hooks.yml, and any race files using the /races editor command. Autocomplete is still available for your convenience.

Config Settings & config.yml

  • The motd-enabled setting has been removed in favor of update-reminder. More about that below.
  • The sound-volume setting has been removed as the and pitch can now be configured for each individual sound.

Update Checker

  • A new update-reminder setting is available in config.yml. While set to true, it'll tell you whether you're on the latest version or if there's an update available.
  • When a new version is available, the update notice will include a clickable link to the plugin's page.

Events & Triggers

  • RaceChangeEvent now works as intended and properly respects being cancelled.

API

  • ??

Bugfixes

  • The lang.yml file properly reloads using /races reload.
  • Race displaynames would sometimes not properly be displayed if hex colors were being used.
  • The race selection GUI can now be used by multiple players at once.

Levels & Experience

I'm very happy to announce that Races of Thana now supports levels. You can customize the formula used to calculate the amount of experience needed to level up for each level, up to the set level cap. This is the default configuration found in the config.yml file and serves as an example:

levels:
  enabled: true
  # level 1 requires 85 XP, level 2 requires 180 XP, level 3 requires 285 XP, and so on
  formula: 50 + (25 * level) + (10 * (level ^ 2))
  level-cap: 100
Clone this wiki locally