[Mod] Treasurer [0.2.0] [treasurer]

[Wuzzy]

Treasurer
This is a framework to define and distribute random treasures into the world. Treasurer itself does neither define any items nor does it attempt to distribute them because it is a framework.

Player information
To actually get a game with treasures using Treasurer running, you need a couple of mods:

• Treasurer
• At least one TRM (treasure registration mod). This is a mod which tells Treasurer which treasures exist
• At least one TSM (treasure spawning mod). This is a mod which puts random treasures into the world

Minimal usage example

+ Minimal usage example

In this minimal example, Minetest Game is used with 3 mods enabled:

• Treasurer [treasurer]
• TRM Modpack for Minetest Game [trmp_minetest_game]
• Dungeon Treasure Chests [tsm_chests_dungeon]

This will add treasures from Minetest Game into chests in dungeons.
Add more TRMs to get treasures from other mods as well.
Add more TSMs to find treasures in other places.
Add as many TRMs and TSMs you like.

List of TRMs:

• trmp_minetest_game 0.4.10.0: A TRM modpack for Minetest Game. Download
• TRM pack 0.1: See here
• a TRM for useless_mod: See here
• Generic treasurer registration [trm_generic]
• trmp_Pack

All TRMs by me are WTFPL’ed.

List of TSMs:

• Dungeon Treasure Chests [tsm_chests_dungeon]: Adds treasure chests into the default dungeons
• Railway corridors [tsm_railcorridors]: Creates an underground network of mines, with treasure chests and simple railways
• Mines [tsm_mines]: Creates very simple underground mine shafts
• Pyramids [tsm_pyramids]: Creates pyramids in deserts with hidden treasures
• Surprise blocks [tsm_surprise]: Creates randomly floating question mark blocks which drop cheap treasures when broken

Developer information

+ Developer information

The two main interfaces in Treasurer are treasure registration mods (TRMs) and treasure spawning mod (TSM) as explained above.

A treasure is basically just a fancy ItemStack. It consists of:

• name of item
• relative rarity
• a preciousness
• the amount of item (can be randomized)
• a wear (can be randomized)

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.

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.
“Spawning” here means to put the treasures into the world somehow. How a TSM does the task of spawning is up to the TSM.

Recap: The TSMs will spawn treasures into the world out of a pool of treasures which is offered by TRMs. Treasurer manages the pool.

Examples for TRMs are:

• registering bronze, gold, iron ingots and possibly other items of default (see trm_default_example)
• registering bread, wheat, seeds, etc. of farming
• registering super cool item X from awesome mod Y, where X could normally only obtained by “/give” or with creative mode.
• registering the … bla bla bla, you get the idea

Examples for TSMs are:

• let a mob drop a not mob-specific, random treasure on death
• give a random treasure as a “welcome gift” to joining and respawning players (see tsm_gift_example)
• placing chests around the world and spawning treasures into them (see tsm_chests_example)

Some of the above example have been implemented into already working mods, which I distribute as seperate mods along in the same Zip file.

The Zip file contains:

• Treasurer (which is heavily commented)
• three examples (which are heavily commented)
• a long README file (which hopefully covers everything you need)

Included example TSMs:

• tsm_give_example: A simple example, bundled with Treasurer. Gives new player some random treasures at start.
• tsm_chests_example: An example, bundled with Treasurer. Spawns some chests below the sea level and fills them with treasures. The deeper you are, the more valuable the treasures therein.

Here’s the Zip file:
https://forum.minetest.net/download/file.php?id=1302

Download and stuff

• Download: https://forum.minetest.net/download/file.php?id=1302
• Hard dependencies: none
• Strongly recommended mods: At least one TRM and one TSM (see above)
• License of everything: WTFPL

[clarksallador]

Testing soon ;)

[RealBadAngel]

Can i smell Diablo like treasure system here?? ;)

[Wuzzy]

No, it smells more like coincidence here.

[PilzAdam]

I smell pizza.

[rubenwardy]

Lol, Adam, lol.

This looks interesting. Why don't you provide any treasures by default!

[RealBadAngel]

Heavenly Diamond Pickaxe of the Stars...


Coincidence? :)

[Wuzzy]

Why don't you provide any treasures by default!

I don’t really understand your complaint, because I include one working example TRM which includes some treasures from default.

I also think the “examples” tsm_chests_example and trm_default_example are aleady kind of advanced for examples. A bit more game balance tweaking to these and I can call these actual mods.

Did you try the examples yet?

Oh, by the way: If a new (serious) TSM or TRM gets released that depends also on mod X, what do you think? Should it be posted to this thread? Should it get it’s own thread? Or should it be posted to the thread of mod X? And what about mods with multiple dependencies (minus Treasurer)?

[Wuzzy]

Hi! I have written a bunch of TRMs for many mods now to test Treasurer more throughly, also because the default treasures become boring with the time. ;-)
If you activate one of those mods, new treasures become available.

Download: TRM pack 0.1 (size: 9.2 KiB)
Alternative download: It is also in attachment #1.

Mods included (their provided treasures are written in parenthesis):

• bees (honey comb, honey bottle)
• blox (glow dust)
• boats (boat)
• carts (minecart, power rail, brake rail)
• desert_uses (desert tools)
• farming_plus (seeds, saplings, fruit, weed)
• flowers_plus (flower pot)
• food (several food items and unprocessed (!) food)
• glooptest (for now, only the hammer and the handsaw, of course it only works if you have the tools module activated in Glooptest)
• zmobs and lavatemple (lava orb, lava dagger)
• magicbeans (the 3 beans)
• tnt (TNT and gunpowder)

The naming convention is simply “trm_<basename>”.
The dependencies of each TRM are Treasurer and the respective mod from which they take the treasures from. For example, trm_bees depends on Bees and Treasurer.

If you have an idea for a mod to add, either write it on your own or ask me to do it. Writing a TRM is not difficult (Balancing one is! lol). In theory, any mod which has some useful (or useless!) items is a good candidate for a TRM.
I am not sure if it is a good idea to drop so many TRMs into one Zip file. On the other hand, TRMs are naturally very small in file size. The entire TRM pack has a size of 9.2 KiB.

License of the entire pack: WTFPL

PS: It is not forbidden to release TRMs on your own. ;-)

[like2omg]

I have yet to take a dive into making mods yet (haven't played Minetest enough anyways O_o ) but if it is possible to spawn items with "data" attached in Minetest (Minecraft map makers would call this data "NBT tags"), maybe we could have it so a specially formatted spawn line argument(s) could give set or ranged (chosen randomly) argument values.

As I have said, I have yet to take a dive into making mods, so I don't know if this is possible as of yet in Minetest. Oh and by the way, I like this idea... next up is equipment for mobs (once we can see what mobs hold/wear first)

[EDIT] Oops... am I reviving an old thread?

[Wuzzy]

I have no idea what you are talking about.
And no, this thread never goes old. ^_°

[like2omg]

spawn items with "data" attached
Items with specific, TRM-chosen named properties of the item already set (ex: durability)

specially formatted spawn line argument(s) could give set or ranged (chosen randomly) argument values
Adding one or two optional arguments to the TRM "add an item" line; have specifc, TRM-chosen named property of the item set to a specific value, or chosen randomly in the range of n1 to n2.
Possibly the argument could be (with property names replacing the named indexes):

Your phone or window isn't wide enough to display the code box. If it's a phone, try rotating it to landscape mode.

Code: Select all

{
    "specificItemProperty": 2,
    "rangedItemProperty": { 5, 8 },
    "specifcCouldAlsoUseNonNumbers": <imagine an item list here>
    ... and on and on ...
}

next up is equiptment for mobs
I was mostly joking here (it's a "very far down the road" idea). When mobs can hold weapons and have equipped armor (and we can see them having it), having a modification for mobs to randomly get gear choices (probably this would be a part of the mob mod)

- insert non-signature divider -

I did come up with an idea (while doing the first compose and before I accidentally hit the keyboard's built-in back button) that we could possibly specify multiple "categories" that an item belongs to with TRM and ask for those "categories" to be in the selection when getting items with a TSM. I currently would say, have the TRM and TSM choose their names (instead of restrict them)
Examples:
- If a TSM wants any ol' block or a weapon {"block", "weapon"} or just anything --> nil
- Have a TRM specify that an item is in multiple categories {"tool", "pickaxe"} or have it not specify a category --> nil or {}

Then when it comes time to deside:
1. TSM descides a "block" or a "weapon"
2. Treasurer searches for those types in its database which were specified by the TRMs
3. Treasurer then does its normal limiting/choosing and sends the result

These are just some ideas I had. I hope you enjoy the ideas, even if you consider them to be too "high-tier" for your mod. *wink*

Edit: a bit of fixing (nothing content-breaking)

[Wuzzy]

Hi again. Sorry I answer so late. I have read your posts and I must say that your ideas are very good and I think it would greatly enhance Treasurer, when I just would actually built them in. ;-)

I also release version 0.2.0 today which was long overdue. From now on, Semantic Versioning applies.

Basically this update implements Treasurer groups. Something which you, like2omg, described as “categories”. It basically works like you described. I also have made a few mistakes in the documentation which are fixed now.

About the new groups:
TRMs can put treasures into groups and TSMs can filter out by groups. Any treasure can be assigned to one or more groups. Any TSM can shrink the treasure pool with a list of groups. Only treasures which belong to at least 1 of these groups will be in the pool.

I also suggested some groups in another text file, for a bit standardization. Stuff like “food”, or “crafting_component”, “melee_weapon”, etc. But technically, group names can be chosen freely. Using groups is optional. There is a group “default” in which all treasures go when no group is specified.

The details can be all found in the README file.

Version 0.2.0 is fully backwards-compatible to 0.1.

Download is in attachment.

Also, there’s a Git repository online now, find it at:
http://repo.or.cz/w/minetest_treasurer.git
This only contains the treasurer mod, not the examples! The examples are in treasurer0.2.0.zip (attachment).



I also distribute a new TRMP. The “P” stands for “pack”. It is a modpack entirely of TRMs. This TRMP is for minetest_game, not only default, so it should be more interesting. It is a bit more balanced than the old example for default. I’ll start with version 0.4.10.0. The version scheme follows the same of minetest_game, appended with a fourth digit, which will increase whenever I update the TRMP as long as minetest_game did not change.

IMO Treasurer seems to be pretty stable. I think I will increase the version number to 1.0.0 as soon like2omg’s other suggestions are implemented.


Maybe, for the future, I try focus more on writing TRMs for many mods, subgames and, more importantly, do more work on TSMs.
I think I could fork the mods pyramids, mines and railcorridors to include Treasurer support. All those mods already use treasure chests, but none of them use Treasurer. I tried to convince the author of the first 2 mods to use Treasurer, but it did not work. I won’t even bother trying with the third one, the author is new to modding. So I decided the only way to get anything done is to fork it and do it myselves. Well, that’s my plan at least.

If you know any other mods which generate treasure chests (or some other kind of treasure) and choose random treasures on their own, please let me know!

And maybe I can also use some of my (more or less) own ideas.

Treasurer has a lot of potential, I think. It is about time to use it! :)



Edit:
I have converted three mods into TSMs! See the initial post for links.

[rubenwardy]

Thank you for this mod. I use it on my Capture the Flag server.

[Byakuren]

Is there a way to provide item stacks with metadata attached, e.g. books with prewritten text? And it would be useful to be able to provide a function to treasurer to randomly (or non-randomly) generate the metadata, for example if a potion mod used metadata to store information about the potion.

[Martno]

Is there a way to provide item stacks with metadata attached, e.g. books with prewritten text? And it would be useful to be able to provide a function to treasurer to randomly (or non-randomly) generate the metadata, for example if a potion mod used metadata to store information about the potion.

That would be awesome.

[Byakuren]

Looks like the ability to specify metadata exists, but is undocumented. No metadata-generator support, though. For something like potions it would be possible to just register once for each preset potion effect.

[bell07]

Hi @all,

please have a look to the new trm_generic mod that I started this week: https://forum.minetest.net/viewtopic.php?f=9&t=15843

[xisd]

Hi !
I packed together a few more trms
Some are for mod included in minetest_game but that were not in trmp_minetest
other are for other some mods I use.
Its available there : https://github.com/xisd/trmp_Pack
Only carts is redundant with the other mod pack posted in this thread (it's the same but with the categories support)

[Wuzzy]

Nothing new about Treasurer itself (it is NOT on my list of priorities), but I updated the first post to make it more readable. I figured it was WAY too technical. Now hopefully it should be understandable by non-technical users as well.
To use Treasurer, you do NOT have to be a modder. :D
If you still have difficulties in understanding Treasurer, please let me know.

I also updated the list of TRMs and TSMs and added a simple usage example.

In other news, I just added a new treasure spawning mod which puts treasures into dungeon chests:
[Mod] Dungeon Treasure Chests [tsm_chests_dungeon]


I also noticed that trmp_minetest_game is very outdated. :-/
But note that Treasurer and related projects will probably remain frozen for quite a while. As I said, it is NOT a priority.