DUXPLIMA Documentation

Trade effects and the log

What every trade says and plays, and the audit trail.

Each moment of a trade is a list in config.conf under effects.

MomentWhenFilled in
boughtA purchase went through<item>, <amount>, <price>
soldA sale went through<item>, <amount>, <price>
taxedOn top of those, when the trade was taxed<tax>
cannot-affordThe player has not got the money<price>, <balance>
out-of-stockThe line has less than was asked<left>
quota-reachedThe player has traded their share for now<cap>, <time>
no-roomThe player has nowhere to put itnone

The shipped lines are a message for each, with the orb pickup sound on a trade and a bass note on a refusal. Text starting with @ is a line of the language files. The verbs are [message], [broadcast], [actionbar], [title], [subtitle], [bossbar], [particle], [sound], [effect], [console] and [player], each able to carry {delay=, chance=, repeat=, every=, if=}. An empty list is silence. These run for every trade; a line's actions run for that line only.

The log

Every trade of both halves is a row. log.keep-days (30; 0 keeps everything) is how long a row is kept, and /uxmshop prune <days> deletes older rows by hand. Operators read it with /uxmshop logs; an owner reads their profit report with /myshop profits.

Related: config.conf