SMODS.Sticker

API Documentation: SMODS.Sticker

• Required parameters:
  • key
  • loc_txt or localization entry (reference)
    • loc_txt should contain a label string used for the card's badge text
• Optional parameters (defaults):
  • atlas = 'stickers', pos = { x = 0, y = 0 } (reference)
  • config = {}, prefix_config, dependencies, badge_colour, text_colour (reference)
    • config values will be saved to card.ability[sticker_key]
  • badge_colour: Colour of this sticker's badge.
  • hide_badge: If set to true, no badge is shown for this sticker.
  • default_compat: Default compatibility with cards. If true, all cards can have this sticker unless otherwise specified.
  • compat_exceptions: Array of keys of centers that have non-default compatibility with this sticker.
    • default_compat = true: sticker cannot be applied to centers in compat_exceptions
    • default_compat = false: sticker can only be applied to centers in compat_exceptions
  • sets, list of pools that this sticker is allowed to be applied on, format:

   	{
   		Joker = true
   	}

  • rate = 0.3: Chance of the sticker applying on an eligible card
  • needs_enable_flag: If set to true, this sticker requires G.GAME.modifiers['enable_'..self.key] to be true before it can be applied.
  • always_scores: If true, editioned card always counts in scoring.
  • never_scores: If true, editioned card never counts in scoring (supersedes always_scores).

API methods

• calculate(self, card, context) (reference)
• loc_vars (reference)
  • Due to some constraints, the functionality of loc_vars on stickers is limited. Out of all possible return values, only vars, key and set are supported.
• should_apply(self, card, center, area, bypass_roll) -> bool
  • Returns true if the sticker can be applied to the card.
  • bypass_roll skips the RNG check and only looks for compatibility
  • If this function is redefined it will ignore all optional parameter flags listed above. You can call and store the return of SMODS.Sticker.should_apply(self, card, center, area, bypass_roll) in this function to retain the default functionality.
• apply(self, card, val)
  • Handles applying and removing the sticker
  • By default, sets card.ability[self.key] to config if it exists and val is truthy or to val otherwise.
  • It is recommended to not redefine this function. If you still need to, you can call SMODS.Sticker.apply(self, card, val) in this function to retain the default functionality.
• draw(self, card, layer)
  • Draws the sprite and shader of the sticker.

Sticker methods

• Card:add_sticker(sticker, bypass_check) Use this function to add a sticker to a card

  • sticker, key of sticker as a string
  • bypass_check, boolean

• Card:remove_sticker(sticker) Use this function to remove a sticker from a card

  • sticker, key of sticker as a string