Skip to content

In game Content

CleverNucleus edited this page Sep 20, 2021 · 6 revisions

Attributes

PlayerEx adds some attributes to the game; shown below are the attributes added and their default attribute configuration:

  • Health Regeneration: passively regenerates this amount every second (regardless of hunger/saturation).
  • Heal Amplification: amplifies all healing by this amount (acts as a multiplier).
  • Magic Amplification: amplifies all direct magic damage by this amount (for example, Splash Potions of Instant Damage).
  • Magic Resistance: reduces all incoming magic damage by this amount.
  • Fire Resistance: reduces all incoming fire damage by this amount (this includes all fire-based damage, like lava).
  • Freeze Resistance: reduces all incoming freeze damage by this amount.
  • Falling Resistance: reduces fall damage by this amount.
  • Drowning Resistance: reduces drowning damage by this amount.
  • Wither Resistance: reduces wither damage by this amount.
  • Evasion: provides a chance to completely dodge projectiles (not just damage, but the entire projectile).
  • Lifesteal: heals a percentage of direct damage done (such as attacking).
  • Melee Crit. Chance: the chance for a melee attack to be a critical hit.
  • Melee Crit. Damage: the damage multiplier for a melee critical hit.
  • Ranged Crit. Chance: the chance for a ranged attack to be a critical hit.
  • Ranged Crit. Damage: the damage multiplier for a ranged critical hit.
  • Ranged Bonus Damage: bonus damage applied to a projectile.
  • Skill Points: does nothing by itself.
  • Level: does nothing by itself; however, when modified has the following relations:
    • +1 Skill Point
  • Constitution: does nothing by itself; however, when modified has the following relations:
    • +1 Max Health
    • +0.01 (or 1%) Knockback Resistance (diminishing)
    • +0.01 (or 1%) Magic Resistance (diminishing)
    • +0.01 (or 1%) Freeze Resistance (diminishing)
  • Strength: does nothing by itself; however, when modified has the following relations:
    • +0.01 Health Regeneration
    • +0.25 Attack Damage
    • +0.25 Armor (diminishing)
    • +0.01 (or 1%) Drowning Resistance (diminishing)
  • Dexterity: does nothing by itself; however, when modified has the following relations:
    • +0.25 Bonus Ranged Damage
    • +0.1 Attack Speed (diminishing)
    • +0.002 Movement Speed
    • +5% Melee Crit. Damage (diminishing)
    • +0.01 (or 1%) Falling Resistance (diminishing)
  • Intelligence: does nothing by itself; however, when modified has the following relations:
    • +2% Heal Amplification (diminishing)
    • +5% Ranged Crit. Damage (diminishing)
    • +0.01 (or 1%) Fire Resistance (diminishing)
    • +0.01 (or 1%) Wither Resistance (diminishing)
    • +5% Magic Amplification (diminishing)
  • Luckiness: (not the vanilla Luck attribute) does nothing by itself; however, when modified has the following relations:
    • +0.2 Luck
    • +2% Melee Crit. Chance (diminishing)
    • +2% Ranged Crit. Chance (diminishing)
    • +2% Evasion (diminishing)

Application

The above attributes are added to the game and their functionality is fully implemented for all Living Entities (instances of LivingEntity). By default, PlayerEx only adds these attributes to the Player (PlayerEntity), but datapacks can be used to add these attributes to any living entity (see the Data Attributes Wiki).

Client Side

PlayerEx adds some client-sided content; this includes a new gui screen for attributes, which is available through a new button attached to the survival inventory. This gui screen allows for players to spend experience to level up and gain skill points, which can then be spent to increase attributes. Also included is a multiplayer feature that displays the players level below their username.

Additionally, a hotkey is provided to open/close the attributes screen gui; by default this is r.

Config

The configuration is powered by Cloth Config and exp4j. It is split into server side and client side options:

Server-side:

  • Enable/Disable resetting all PlayerEx attributes on death (requires restart).
  • Enable/Disable displaying the player's level below their username on multiplayer (requires restart).
  • Level Formula: you can define your own levelling equation, which dictates how much experience players need to reach the next level (requires restart).

Client-side:

  • Level Up sound effect volume (from mute to x1.5 times).
  • Skill Up sound effect volume (from mute to x1.5 times).
  • Inventory Button horizontal position in the survival inventory.
  • Inventory Button vertical position in the survival inventory.
  • Text squeeze in the horizontal direction for the playerex gui (in case translations require more space).
  • Text squeeze in the vertical direction for the playerex gui (in case translations require more space).
  • Enable/disable an item tooltip fix that makes items show the true values for attack damage/speed.
    • Toggleable because some mods interfere with tooltips, and this allows playerex to remain more compatible.

Commands

The commands that PlayerEx adds all require the executing party (command block/player/server) to have permission level of 2 or more.

  • /playerex levelup <player> [amount]
    • Levels the player up by the amount.
  • /playerex reset <player>
    • Resets all attributes to default for the player.
  • /playerex refund <player> [amount]
    • Provides the player with the input amount of refunds, which allows the player to refund skilled attributes for skill points.
  • /playerex cache clear
    • Clears the persistent player cache (of offline and online players). Players will have to rejoin the server to be added again (affects text placeholders).
  • /playerex cache remove <uuid>
    • Removes the input uuid/player from the persistent player cache.