ABC - a library to make modding easier (with IDE autocompletion and documentation)

[candid dust]

https://github.com/Aurif/balatro-ABC

Most of the info is in the readme on the github repo, but long story short, this lib allows you to create jokers in a more pleasant way:

ABC.Joker("Voucher Joker")
    :description({"After defeating a Boss Blind", "gain a {C:attention}#tag#{}"})
    :variables({
        tag = ABC.VARS.Tag("tag_voucher"),
    })
    :rarity_uncommon()
    :calculate(function(self, card, context, ABCU)
      ABCU:on_round_boss_defeated(function ()
          ABCU.vars.tag:spawn()
      end)
    end)
    :register()

and has full support for autocompletion and in-IDE documentation!

[candid dust]

There's been a couple of updates already, so I feel like a changelog is in order.

Version 0.1.6

• Added ability to create legendary jokers
• Reworked joker unlock conditions
• added a bunch of new effects: do_mult_multiply, do_chips_multiple, do_joker_destroy, do_probability_add, do_probability_multiply, do_card_bonus_permanent_add
• added a bunch of new triggers: on_card_should_retrigger, on_self_destroyed, on_hand_scored, on_hand_played, on_hand_discarded, on_card_discarded, on_hand_drawn, on_card_drawn
• added new variable types Challenge (for unlock conditions) and Seal, also added function card_is to Suit
• added functions for marking incompatibility with blueprint, eternal and perishable stickers

[lost dawn]

very nice, would love to see this get some use, idk if right now since dependencies aren't very convenient

also, because of the way the github is set up (with some unrelated mods packaged with the library), it wouldnt be possible to have this library work with https://discordapp.com/channels/1116389027176787968/1255696773599592458

and by extension any mod that uses this library

[regal dew]

What is this

[lost dawn]

its an api making creation of certain smods objects a bit easier

[pallid laurel]

peak?

[candid dust]

hmm... that is indeed an issue

will look into it, see if I can restructure the repo to make it compatible

[candid dust]

yeah, like cg said, it's an api which allows you to create jokers using functions like on_card_should_retrigger which you can pick from a list in documentation instead of having to scour the code to find that if context.repetition and context.cardarea == G.play then does the thing you want

so it saves you a lot of guesswork and gives you ready-made "shortcuts" instead

but it does add a dependency to the mod, that is true :/

[wheat needle]

so if I were to use this library for modding, i'd need to make this a dependency?

[candid dust]

yup

no real way around that

[wheat needle]

yeah that's true. but this does sound promising nonetheless for me to get back into modding

ever since that big refactor of smods

[candid dust]

yeah, smods is going through... stuff

recently noticed they removed all examples mods (or moved them somewhere I can't find them xd), which blows

[wheat needle]

yep, that did the finishing blow to me

very nice to see that you're making an effort to help people get into modding

[candid dust]

^^

[loud sky]

@wheat needle @candid dust

https://github.com/Steamodded/examples/tree/master/Mods

this is where they moved it

[wheat needle]

Oh cool

[candid dust]

nice, thx