Treasurer_ANNOUNCEMENT

   1 == Treasurer [treasurer] ==
   2
   3 With Treasurer I want to introduce a new way to define and distribute random treasures into the world. Treasurer itself does neither define any items nor does it attempt to distribute them.
   4
   5 Instead Treasurer provides two interfaces.
   6
   7 To actually get a game with treasures using Treasurer running, you need at least the following:
   8 [list]
   9 [*]Treasurer
  10 [*]at least one treasure registration mod
  11 [*]at least one treasure spawning mod
  12 [/list]
  13
  14 A treasure is basically just a fancy ItemStack. It consists of:
  15 - name of item
  16 - relative rarity
  17 - a preciousness
  18 - the amount of item (can be randomized)
  19 - a wear (can be randomized)
  20
  21
  22 A TRM does nothing more than telling Treasurer a bunch of treasures it has to offer. Note, however, that a TRM should really do nothing more than just that. The actual mods where the items originate from does most likely NOT have to be changed in order to register its items as treasures. TRMs are simple,
  23
  24 A TSM distributes (“spawns”) treasures, where it has to ask Treasurer for some treasures. Treasurer then chooses some treasures out of the pool of available treasures and returns a list of ItemStacks. The TSM also may ask Treasurer to filter out treasures which have an either too high or too low preciousness (“preciousness” is defined by the TRMs). Be warned: Treasurer may return no treasures at all, either because no TRM is activated or no treasure that matches the filter exists.
  25 “Spawning” here means to put the treasures into the world somehow. How a TSM does the task of spawning is up to the TSM. Treasurer
  26
  27 Recap: The TSMs will spawn treasures into the world out of a pool of treasures which is offered by TRMs. Treasurer manages the pool.
  28
  29 Examples for TRMs are:
  30 - registering bronze, gold, iron ingots and possibly other items of default (see trm_default_example)
  31 - registering bread, wheat, seeds, etc. of farming
  32 - registering super cool item X from awesome mod Y, where X could normally only obtained by “/give” or with creative mode.
  33 - registering the … bla bla bla, you get the idea
  34
  35 Examples for TSMs are:
  36 - let a mob drop a not mob-specific, random treasure on death
  37 - give a random treasure as a “welcome gift” to joining and respawning players (see tsm_gift_example)
  38 - placing chests around the world and spawning treasures into them (see tsm_chests_example)
  39
  40 Some of the above example have been implemented into already working mods, which are distributed with Treasurer
  41 as seperate mods.
  42
  43
  44 Dependencies of Treasurer: None!
  45 Minimal dependencies of all TRMs: treasurer and all mods that define the registered items
  46 Minimal dependency of all TSMs: treasurer
  47
  48 License: WTFPL