[$Id: hooks.txt 4952 2024-06-24 19:58:24Z dsb $]

Prodigious Progress Callbacks
=============================
So, your addon defines a prodigy with a "cumulative" requirement (for
instance, doing a certain amount of damage in a particular damage type),
and you want Prodigious Progress to be able to show how much progress the
player has made toward completing your requirement.  Well, first off,
thanks for helping to make this addon more useful. ;)  The addon looks for
a .desc_f() method in the .special{}, special2{} and special3{} subtables
of your prodigy definition's .require{} subtable (the same place where you
already have your .desc description strings).

desc_f(self, t, levmod)
-----------------
  Called from Player:getTalentReqDesc() to describe the talent's
  requirements and progress made thereto.  The arguments are:
    self:	The Actor for whom the talent description is being created.
    t:		Talent definition table for the relevant talent.
    levmod:	The 'levmod' argument provided to :getTalentReqDesc().

  The method should return a string describing the prodigy requirement and
  how much progress the player has made toward it.  The string should
  include its own color codes as appropriate, typically #00FF00# for
  satisfied requirements and #FF0000# for unsatisfied requirements (and
  don't forget #LAST# at the end).

  The file hooks/load.lua in this addon includes lots of examples of
  .desc_f() methods for various prodigies.
