Better Calculation

[Eremel]

Better Calc is made to improve the usability of calculation for mod developers. It will break lots of current existing mods implementations of things.

Better Calc Breaking Changes

• Any lovely patches targetting G.FUNCS.evaluate_play are likely to be broken.
• Edition calculation is likely broken
• Enhancement calculation is 100% broken
• some Joker calculation may show duplicate messages (I think these will be ones that use chips/mult keys rather than chip_mod/mult_mod)
• eval_card now returns two values, eff and post

New functionality

• Every context should be passed to every object (seals, enhancements, editions)
• Almost every context is passed through G.jokers + G.consumeables, scoring_hand, G.hand.cards and the selected Deck's trigger_effect
• Can return sound for custom sounds in messages
• context.main_scoring replaces not context.repetition and not context.individual (preference)
• context.final_scoring_step happens just before plasma's balance effect
• SMODS.calculate_context can be hooked to add different areas to the calculation of non-scoring contexts. If new contexts need to be calculated, this function should be used. See source code for example usage.
• SMODS.calculate_individual_effect can be hooked to add different scoring keys.
• Adds various -- TARGET: description comments throughout card calculation for easy lovely patch targetting.

Returning Calculation Effects

This update simplifies calculation effects. The below return is now valid in any scoring context and the message and card will be handled for you.

return {
    chips = 10
 }

If you want the message to appear on a different card, add card = X as normal.

Adding a message = 'string' will add an extra message as well as the default calculation message. To remove the default add remove_default_message = true. You can alternatively use chip_message = 'string' to replace the chip message. mult_message, xmult_message and dollar_message are also supported.