From 3f2830cc9ec9b8c45755aeaea21acb0317cebcf7 Mon Sep 17 00:00:00 2001
From: Kekulism <33201764+Kekulism@users.noreply.github.com>
Date: Mon, 16 Jun 2025 21:27:46 -0400
Subject: [PATCH 1/2] Create DeckSkinCrediting.md

---
 DeckSkinCrediting.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 DeckSkinCrediting.md

diff --git a/DeckSkinCrediting.md b/DeckSkinCrediting.md
new file mode 100644
index 0000000..f8f4444
--- /dev/null
+++ b/DeckSkinCrediting.md
@@ -0,0 +1,29 @@
+
+# DeckSkin Crediting
+Steammodded now provides built-in methods to force enable card UI in the Customize Deck menu, which allows you to credit the artists for your DeckSkins. Using similar methods to the `generate_ui` function for Centers, modders can use two functions (`has_ds_card_ui` & `generate_ds_card_ui`) to enable UI to show when hovering over specific cards in your DeckSkin preview.
+
+## Enabling the UI (has_ds_card_ui)
+For every palette you define in your DeckSkin, there is the `display_ranks` list that defines which ranks will show in the preview, and in what order. When the preview is shown on screen, `has_ds_card_ui` is called for each card. If the return of the function is `true`, then the UI will be enabled for that card.
+
+Utilizing the `card`, `deckskin`, and `palette` args, you can filter out the enabled ui by checking the rank of the cards, checking the key of the current palette, and more.
+```lua
+has_ds_card_ui = function(card, deckskin, palette)
+    if card.base.value == "King" then 
+        return true
+    end
+end
+```
+
+## Defining the UI (generate_ds_card_ui)
+For every card that has its UI enabled by `has_ds_card_ui`, you can define the contents of it with `generate_ds_card_ui`, much like you would define the ui with `generate_ui` in Centers. 
+
+The following is a simple method for crediting artists with this function, which is used in the code for Steammodded when crediting the original artists for the vanilla Friends of Jimbo DeckSkins. The first localize function creates the header which says "Artist", and the second is for showing the artist, whose name goes in the vars:
+```lua
+generate_ds_card_ui = function(card, deckskin, palette, info_queue, desc_nodes, specific_vars, full_UI_table)
+    if card.base.value == "King" then
+        localize{type = 'other', key = 'artist', nodes = desc_nodes, vars = {}} 
+        localize{type = 'other', key = 'artist_credit', nodes = desc_nodes, vars = { "ARTIST NAME HERE" }}
+    end
+end
+```
+![Visual example of the default crediting format used in the above code, seen in Balatro: Cardsauce](https://images-ext-1.discordapp.net/external/GKGG7ScABo6P6EzBX4Ih1VePDVXKMkhXhSPbGbIExss/https/i.imgur.com/pZ1XIP2.jpg?format=webp&width=1592&height=1291)

From 67d60ac7ef0eb4d8987fd110ec86775ac52a8583 Mon Sep 17 00:00:00 2001
From: Kekulism <33201764+Kekulism@users.noreply.github.com>
Date: Mon, 16 Jun 2025 21:35:33 -0400
Subject: [PATCH 2/2] Added API Methods to DeckSkin wiki

---
 SMODS.DeckSkin.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/SMODS.DeckSkin.md b/SMODS.DeckSkin.md
index c4f10f3..6fd844a 100644
--- a/SMODS.DeckSkin.md
+++ b/SMODS.DeckSkin.md
@@ -1,3 +1,4 @@
+
 # API Documentation: `SMODS.DeckSkin`
 This API extends the game's Friends of Jimbo collabs screen to create new deck skins for all suits, including modded ones.
 
@@ -28,3 +29,11 @@ Note: Atlases in this class are not automatically prefixed.
 	    - `loc_txt` or localization entry [(reference)](https://github.com/Steamodded/smods/wiki/Localization)
         - `hc_default` (optional): If this is true, use high-contrast textures for unchanged sprites.
 
+## API Methods
+- `has_ds_card_ui(card, deckskin, palette)`
+		- Enable UI on cards in preview
+		- Called for every currently displayed card in preview
+- `generate_ds_card_ui(card, deckskin, palette, info_queue, desc_nodes, specific_vars, full_UI_table)`
+		- Freely define the UI of card descriptions in preview
+		- Called for every card that has a UI in preview, enabled by `has_ds_card_ui`
+