Wikis / MythicRPG / Points

Points

Points are a generic resource system for MythicRPG. You define your own point types — Skill Points, Attribute Points, Talent Points, whatever fits your server — and players can earn them from leveling archetypes (or through admin commands and mechanics) and spend them on talent trees.

Defining Point Types

Point types are defined in a points.yml file inside any Mythic pack folder. Each top-level key becomes a point type.

ATTRIBUTE_POINTS:
  Display: '&b&lAttribute Points'

TALENT_POINTS:
  Display: '&a&lTalent Points'

Option	Description	Default
Display	The display name used by menus and placeholders (legacy color codes are supported)	the type's key

Internally, point type keys are case-insensitive — ATTRIBUTE_POINTS, Attribute_Points, and attribute_points all refer to the same type.

Earning Points

Players earn points from two sources:

Persistent — granted by admin commands or skill mechanics. These are never lost, even when archetypes are removed.
Archetype-attributed — granted automatically when leveling up an archetype. These can be reset/refunded when the player loses or resets that archetype.

From Archetypes (`PointRewards`)

An archetype can reward points each level using a PointRewards: block under its config. Each entry awards points of a specific Type, either flat-per-level or on specific levels (or both).

Warrior:
  Leveling:
    MinLevel: 1
    MaxLevel: 50
    ExperienceCurve: STANDARD
    ExperienceSource: COMBAT
  PointRewards:
    - Type: ATTRIBUTE_POINTS
      PerLevel: 1
      SpecificLevel:
        10: 3
        25: 5
        50: 10
    - Type: TALENT_POINTS
      PerLevel: 1

Option	Description
Type	The point type key to award. Must match a type defined in `points.yml`.
PerLevel	Points awarded for every level after `MinLevel` (so first level past starting level = `PerLevel`, etc.). Optional.
SpecificLevel	A map of `level: amount` entries that grant a one-off bonus when the archetype reaches that level. Optional.

Both PerLevel and SpecificLevel can be set on the same entry — they stack.

Spending Points

Talent trees consume points to unlock and rank up talents. Each tree declares which point type it spends via its PointType: field. See Talents for the full talent tree configuration.

WarriorTree:
  Display: '&cWarrior Talents'
  PointType: TALENT_POINTS
  Talents:
    HeavyArmor: ...

If a player loses points (e.g. an admin removes them), invested talents are not automatically refunded — but /rpg points reset will refund them all.

Admin Commands

Command	Description
`/rpg points get [player] [type]`	Show a player's balance for a point type
`/rpg points add [player] [type] [amount]`	Grant persistent points
`/rpg points remove [player] [type] [amount]`	Remove persistent points (cannot remove archetype-attributed earnings)
`/rpg points set [player] [type] [amount]`	Set the persistent point balance directly
`/rpg points reset [player] [type]`	Refund every spent point for the type (talents revert to unspent)

All commands accept an optional -s flag before the player argument to suppress the command's chat output.

Placeholders

Point balances are exposed both as MythicMobs <caster.points.*> placeholders and as PAPI %mythic_point_*% placeholders. See the Placeholders page for the full list.

Core Plugins