From 4c98f8b987269e5a15cfe7484696d02ad65e8e2d Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 13:21:01 +0100 Subject: [PATCH 01/22] Create SMODS.Font.md --- SMODS.Font.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 SMODS.Font.md diff --git a/SMODS.Font.md b/SMODS.Font.md new file mode 100644 index 0000000..5c5572d --- /dev/null +++ b/SMODS.Font.md @@ -0,0 +1,50 @@ +# API Documentation: `SMODS.Font` +This class allows you to use custom Fonts. Your mod must be located in its own subdirectory of the `Mods` folder. To make sure your font works, you have to put it in a `fonts` subdirectory inside `assets` The file structure should look something like this: +```bash +Mods +└──FontMod + ├── main.lua + └── assets + └── fonts + └── HelveticaNeue.ttf + +``` + +- **Required parameters:** + - `key`: The key used to indentify your font (e.g. `'HelveticaNeue` *(`modname_HelveticaNeue`)*) + - `path`: The font's name, including the extension (e.g. `'HelveticaNeue.ttf'`). + +- **Optional parameters** *(defaults)*: + - `render_scale`: Sets the font size. This is generally better as a higher value so it can be scaled down. The default value is `200`. + - `FONTSCALE` : Multiplier to scale down the font to the intended display size. Multiplies `render_scale` so that it renders at a proper size. The default value is `0.1`. + - `DESCSCALE` : Determines how big the description text should be in relation to normal text. Keep in mind that mobile UI makes this 1.5x bigger. The default font's value is `1`. + - `squish` : Determines horizontal width of each character. The default value is `1`. + - `TEXT_HEIGHT_SCALE` : Determines line spacing. The default value is `0.83`. + - `TEXT_OFFSET`(table) : Determines the offset that the font is rendered. You might need to adjust this if the font renders in unexpected places. The default value is `{x=0, y=0}`. + +- **Example Code** +```lua +SMODS.Font{ + key = "HelveticaNeue", + path = "HelveticaNeue.ttf", + render_scale = 200, + TEXT_HEIGHT_SCALE = 0.83, + TEXT_OFFSET = {x=0,y=0}, + FONTSCALE = 0.1, + squish = 1, + DESCSCALE = 1 +} +``` + +## Applying fonts to text +For your font to show up in game, you can assign it to formatted text using the *style modifier code* `f:` Example: +```lua +j_modname_example = { + name = "{f:modname_HelveticaNeue}Example", + text = { + { + "{C:chips,f:modname_HelveticaNeue}+#1#{} Chips", + }, + }, +}, +``` From 02b94fff2e6d2d0f13aea5787ff9962fc34ae0d2 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:22:51 +0100 Subject: [PATCH 02/22] Update Text-Styling.md --- Text-Styling.md | 197 +++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 195 insertions(+), 2 deletions(-) diff --git a/Text-Styling.md b/Text-Styling.md index 40f3097..bf61cfe 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -111,6 +111,14 @@ Valid style modifiers are as follows: {s:scale} + + + + Font + + + {f:font_key} + @@ -123,7 +131,7 @@ Valid style modifiers are as follows: > [!IMPORTANT] -> Modifiers are **case sensitive** – `{s:}` must be lowercase, while all other modifiers are UPPERCASE. +> Modifiers are **case sensitive** – `{s:}` and `{f:}` must be lowercase, while all other modifiers are UPPERCASE. --- @@ -546,13 +554,197 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. +## Text font modifier `{f:}` +> [!IMPORTANT] +> This modifier requires the **lowercase** `f`, unlike other modifiers which must be UPPERCASE. +{f:font} changes the font of the text. + +*`font`* is a f value ranging from `1` to `9` in vanilla, to add [custom fonts](https://github.com/Steamodded/smods/wiki/SMODS.Font) you need to set the value as the font's full key (`modname_font`). + +### Examples + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Text string Font Name Language Result
+ ```pas{f:1}Hello{}``` + + m6x11 plus + + Default + + + + Hello + +
+ ```pas{f:2}Hello, 你好{}``` + + Noto Sans SC Bold + + Simplified Chinese + + + + Hello, 你好 + +
+ ```pas{f:3}Hello, 您好{}``` + + Noto Sans TC Bold + + Traditional Chinese + + + + Hello, 您好 + +
+ ```pas{f:4}Hello, 안녕하세요{}``` + + Noto Sans KR Bold + + Korean + + + + Hello, 안녕하세요 + +
+ ```pas{f:5}こんにちは{}``` + + Noto Sans JP Bold + + Japanese + + + + Hello, こんにちは + +
+ ```pas{f:6}Hello, Здравствуйте{}``` + + Noto Sans Bold + + All, assigned to Russian + + + + Hello, Здравствуйт + +
+ ```pas{f:7}Hello{}``` + + m6x11 plus + + unassigned, see notes at bottom* + + + + Hello + +
+ ```pas{f:8}Hello{}``` + + Go Noto Current Bold + + All, assigned to `All1` + + + + Hello + +
+ ```pas{f:9}Hello{}``` + + Go Noto CJK Core + + All, assigned to `All2` + + + + Hello + +
+ ```pas{f:modname_fontkey}Hello{}``` + + [Custom Font](https://github.com/Steamodded/smods/wiki/SMODS.Font) (in this example, *Wingdings*) + + Any + + + + Hello + +
+*It differs from the default font used by English from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` ## Combinations Some style codes can be combined within one set of curly braces, like `{X:mult,C:white}`. -- `{T:}` and `{s:}` are compatible with all other modifiers. +- `{T:}`, `{f:}` and `{s:}` are compatible with all other modifiers. - Background modifiers `{X:}` or `{B:}` can be used in conjunction with text colour modifiers `{C:}` or `{V:}`. @@ -1068,3 +1260,4 @@ Steamodded automatically adds additional entries to `LOC_COLOURS` for all custom which can be used as colour keys in the same way by `{C:}` and `{X:}`. When referring to custom Rarity, Gradient, Consumable or Suit colours added by SMODS, the key must be prefixed with the [mod prefix](https://github.com/Steamodded/smods/wiki/Mod-Metadata#metadata). + From 15185fe25c6726fca05d79a617f9af929ac99270 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:23:23 +0100 Subject: [PATCH 03/22] Add files via upload --- .../example_font_hello_10_dark.svg | 30 +++++++++++++++++++ .../example_font_hello_10_light.svg | 30 +++++++++++++++++++ .../example_font_hello_1_dark.svg | 14 +++++++++ .../example_font_hello_1_light.svg | 14 +++++++++ .../example_font_hello_2_dark.svg | 14 +++++++++ .../example_font_hello_2_light.svg | 14 +++++++++ .../example_font_hello_3_dark.svg | 14 +++++++++ .../example_font_hello_3_light.svg | 14 +++++++++ .../example_font_hello_4_dark.svg | 14 +++++++++ .../example_font_hello_4_light.svg | 14 +++++++++ .../example_font_hello_5_dark.svg | 14 +++++++++ .../example_font_hello_5_light.svg | 14 +++++++++ .../example_font_hello_6_dark.svg | 14 +++++++++ .../example_font_hello_6_light.svg | 14 +++++++++ .../example_font_hello_7_dark.svg | 14 +++++++++ .../example_font_hello_7_light.svg | 14 +++++++++ .../example_font_hello_8_dark.svg | 14 +++++++++ .../example_font_hello_8_light.svg | 14 +++++++++ .../example_font_hello_9_dark.svg | 14 +++++++++ .../example_font_hello_9_light.svg | 14 +++++++++ 20 files changed, 312 insertions(+) create mode 100644 Assets/Text-Styling/example_font_hello_10_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_10_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_1_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_1_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_2_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_2_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_3_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_3_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_4_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_4_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_5_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_5_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_6_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_6_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_7_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_7_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_8_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_8_light.svg create mode 100644 Assets/Text-Styling/example_font_hello_9_dark.svg create mode 100644 Assets/Text-Styling/example_font_hello_9_light.svg diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg new file mode 100644 index 0000000..ccc8563 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -0,0 +1,30 @@ + + + + + + + + + Hello + + + + + Hello + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg new file mode 100644 index 0000000..50c12b2 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_10_light.svg @@ -0,0 +1,30 @@ + + + + + + + + + Hello + + + + + Hello + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_1_dark.svg b/Assets/Text-Styling/example_font_hello_1_dark.svg new file mode 100644 index 0000000..89fc459 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_1_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_1_light.svg b/Assets/Text-Styling/example_font_hello_1_light.svg new file mode 100644 index 0000000..34f085c --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_1_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_2_dark.svg b/Assets/Text-Styling/example_font_hello_2_dark.svg new file mode 100644 index 0000000..175b08b --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_2_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_2_light.svg b/Assets/Text-Styling/example_font_hello_2_light.svg new file mode 100644 index 0000000..702f384 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_2_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_3_dark.svg b/Assets/Text-Styling/example_font_hello_3_dark.svg new file mode 100644 index 0000000..3e1e04a --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_3_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_3_light.svg b/Assets/Text-Styling/example_font_hello_3_light.svg new file mode 100644 index 0000000..fdd3d37 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_3_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_4_dark.svg b/Assets/Text-Styling/example_font_hello_4_dark.svg new file mode 100644 index 0000000..1969a6c --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_4_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_4_light.svg b/Assets/Text-Styling/example_font_hello_4_light.svg new file mode 100644 index 0000000..53923e5 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_4_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_5_dark.svg b/Assets/Text-Styling/example_font_hello_5_dark.svg new file mode 100644 index 0000000..06aae5d --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_5_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_5_light.svg b/Assets/Text-Styling/example_font_hello_5_light.svg new file mode 100644 index 0000000..a3c24f8 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_5_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_6_dark.svg b/Assets/Text-Styling/example_font_hello_6_dark.svg new file mode 100644 index 0000000..b56aba9 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_6_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_6_light.svg b/Assets/Text-Styling/example_font_hello_6_light.svg new file mode 100644 index 0000000..86cdcab --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_6_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_7_dark.svg b/Assets/Text-Styling/example_font_hello_7_dark.svg new file mode 100644 index 0000000..731ceca --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_7_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_7_light.svg b/Assets/Text-Styling/example_font_hello_7_light.svg new file mode 100644 index 0000000..a435917 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_7_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_8_dark.svg b/Assets/Text-Styling/example_font_hello_8_dark.svg new file mode 100644 index 0000000..6932ef8 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_8_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_8_light.svg b/Assets/Text-Styling/example_font_hello_8_light.svg new file mode 100644 index 0000000..f6dd285 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_8_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_9_dark.svg b/Assets/Text-Styling/example_font_hello_9_dark.svg new file mode 100644 index 0000000..1b87083 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_9_dark.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_9_light.svg b/Assets/Text-Styling/example_font_hello_9_light.svg new file mode 100644 index 0000000..3b4a094 --- /dev/null +++ b/Assets/Text-Styling/example_font_hello_9_light.svg @@ -0,0 +1,14 @@ + + + + + + + + + + + \ No newline at end of file From 2b713707794288a89e9fdc97c9272bc7b9690f0e Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:27:30 +0100 Subject: [PATCH 04/22] Add files via upload --- Assets/Text-Styling/example_font_hello_10_dark.svg | 4 ++-- Assets/Text-Styling/example_font_hello_10_light.svg | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg index ccc8563..ed26162 100644 --- a/Assets/Text-Styling/example_font_hello_10_dark.svg +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -1,5 +1,5 @@ + width="250" height="53.5"> - Hello diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg index 50c12b2..491c5c9 100644 --- a/Assets/Text-Styling/example_font_hello_10_light.svg +++ b/Assets/Text-Styling/example_font_hello_10_light.svg @@ -1,5 +1,5 @@ + width="250" height="53.5"> - Hello From d19908e4501c509ef764a2dfad32e1b63671259b Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:28:08 +0100 Subject: [PATCH 05/22] Update Text-Styling.md --- Text-Styling.md | 47 ++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 38 insertions(+), 9 deletions(-) diff --git a/Text-Styling.md b/Text-Styling.md index bf61cfe..81985fa 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -569,7 +569,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:1}Hello{}``` + + ```pas + {f:1}Hello{} + ``` m6x11 plus @@ -586,7 +589,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:2}Hello, 你好{}``` + + ```pas + {f:2}Hello, 你好{} + ``` Noto Sans SC Bold @@ -603,7 +609,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:3}Hello, 您好{}``` + + ```pas + {f:3}Hello, 您好{} + ``` Noto Sans TC Bold @@ -620,7 +629,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:4}Hello, 안녕하세요{}``` + + ```pas + {f:4}Hello, 안녕하세요{} + ``` Noto Sans KR Bold @@ -637,7 +649,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:5}こんにちは{}``` + + ```pas + {f:5}こんにちは{} + ``` Noto Sans JP Bold @@ -654,7 +669,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:6}Hello, Здравствуйте{}``` + + ```pas + {f:6}Hello, Здравствуйте{} + ``` Noto Sans Bold @@ -671,7 +689,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:7}Hello{}``` + + ``` + pas{f:7}Hello{} + ``` m6x11 plus @@ -688,7 +709,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:8}Hello{}``` + + ```pas + {f:8}Hello{} + ``` Go Noto Current Bold @@ -705,6 +729,7 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
+ ```pas{f:9}Hello{}``` @@ -722,7 +747,10 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:modname_fontkey}Hello{}``` + + ```pas + {f:modname_fontkey}Hello{} + ``` [Custom Font](https://github.com/Steamodded/smods/wiki/SMODS.Font) (in this example, *Wingdings*) @@ -1261,3 +1289,4 @@ Steamodded automatically adds additional entries to `LOC_COLOURS` for all custom which can be used as colour keys in the same way by `{C:}` and `{X:}`. When referring to custom Rarity, Gradient, Consumable or Suit colours added by SMODS, the key must be prefixed with the [mod prefix](https://github.com/Steamodded/smods/wiki/Mod-Metadata#metadata). + From 98d9099b5e4aad0b32f1facc6869f5d316e3e1bb Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:36:21 +0100 Subject: [PATCH 06/22] Update Text-Styling.md --- Text-Styling.md | 168 +++++++++++++++++++++--------------------------- 1 file changed, 73 insertions(+), 95 deletions(-) diff --git a/Text-Styling.md b/Text-Styling.md index 81985fa..d520204 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -565,21 +565,21 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. ### Examples
- + + + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + ```pas +{f:9}Hello{} +``` + + + - - - + + + +
Text string Font Name Language ResultText stringFont NameAssigned LanguageResult
- - ```pas - {f:1}Hello{} - ``` - - m6x11 plus - - Default + + ```pas +{f:1}Hello{} +``` m6x11 plusDefault @@ -587,19 +587,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas - {f:2}Hello, 你好{} - ``` - - Noto Sans SC Bold - - Simplified Chinese + ```pas +{f:2}Hello, 你好{} +``` Noto Sans SC BoldSimplified Chinese @@ -607,19 +604,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas - {f:3}Hello, 您好{} - ``` - - Noto Sans TC Bold - - Traditional Chinese + ```pas +{f:3}Hello, 您好{} +``` Noto Sans TC BoldTraditional Chinese @@ -627,19 +621,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas - {f:4}Hello, 안녕하세요{} - ``` - - Noto Sans KR Bold - - Korean + ```pas +{f:4}Hello, 안녕하세요{} +``` Noto Sans KR BoldKorean @@ -647,59 +638,50 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas - {f:5}こんにちは{} - ``` - - Noto Sans JP Bold - - Japanese + ```pas +{f:5}こんにちは{} +``` Noto Sans JP BoldJapanese - Hello, こんにちは + こんにちは
- ```pas - {f:6}Hello, Здравствуйте{} - ``` - - Noto Sans Bold - - All, assigned to Russian + ```pas +{f:6}Hello, Здравствуйте{} +``` Noto Sans BoldRussian - Hello, Здравствуйт + Hello, Здравствуйте
- ``` - pas{f:7}Hello{} - ``` - - m6x11 plus - - unassigned, see notes at bottom* + ```pas +{f:7}Hello{} +``` m6x11 plusNone* @@ -707,19 +689,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
```pas - {f:8}Hello{} - ``` - - Go Noto Current Bold - - All, assigned to `All1` +{f:8}Hello{} +``` Go Noto Current Bold`All1`** @@ -727,17 +706,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- ```pas{f:9}Hello{}``` - - Go Noto CJK Core - - All, assigned to `All2` - Go Noto CJK Core`All2`** @@ -745,19 +723,16 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
- - ```pas - {f:modname_fontkey}Hello{} - ``` - - [Custom Font](https://github.com/Steamodded/smods/wiki/SMODS.Font) (in this example, *Wingdings*) -
- Any + + ```pas +{f:modname_fontkey}Hello{} +``` Custom Font (example: Wingdings)Custom @@ -766,7 +741,9 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales.
-*It differs from the default font used by English from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` + +* It differs from the default font from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` +** These are the language names given in the original `game.lua` file. ## Combinations @@ -1290,3 +1267,4 @@ which can be used as colour keys in the same way by `{C:}` and `{X:}`. When refe + From 8c827900a676f5a03f246ffa6a28b10ce949988f Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:37:01 +0100 Subject: [PATCH 07/22] Delete Assets/Text-Styling/example_font_hello_10_light.svg --- .../example_font_hello_10_light.svg | 30 ------------------- 1 file changed, 30 deletions(-) delete mode 100644 Assets/Text-Styling/example_font_hello_10_light.svg diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg deleted file mode 100644 index 491c5c9..0000000 --- a/Assets/Text-Styling/example_font_hello_10_light.svg +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - - - Hello - - - - - Hello - - - \ No newline at end of file From 3c9529e9a1e8e57d80aea2ac5cb326a361736450 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:38:47 +0100 Subject: [PATCH 08/22] Update example_font_hello_10_dark.svg --- Assets/Text-Styling/example_font_hello_10_dark.svg | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg index ed26162..37c5088 100644 --- a/Assets/Text-Styling/example_font_hello_10_dark.svg +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -5,7 +5,7 @@ + + + + + Hello + + + + + Hello + + + \ No newline at end of file From 8f0a9d36f8e81b931297eaad472ebd5150842656 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:39:31 +0100 Subject: [PATCH 10/22] Update example_font_hello_10_dark.svg --- Assets/Text-Styling/example_font_hello_10_dark.svg | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg index ed26162..169bae9 100644 --- a/Assets/Text-Styling/example_font_hello_10_dark.svg +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -5,7 +5,7 @@ - - - - - Hello - - - - - Hello - - - - + + + + + + + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg index 491c5c9..3e26958 100644 --- a/Assets/Text-Styling/example_font_hello_10_light.svg +++ b/Assets/Text-Styling/example_font_hello_10_light.svg @@ -1,30 +1,14 @@ + width="128.0" height="39.6328125" + viewBox="0 -36.1328125 128.0 39.6328125"> - - - + + + - - - Hello - + + + - - - Hello - - - \ No newline at end of file + \ No newline at end of file From 42196535df1df1ade348ac71b50512a3c87563a8 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:44:28 +0100 Subject: [PATCH 15/22] Add files via upload --- Assets/Text-Styling/example_font_hello_10_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_10_light.svg | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg index 1a6d3b3..61054aa 100644 --- a/Assets/Text-Styling/example_font_hello_10_dark.svg +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -1,14 +1,14 @@ + width="122.482421875" height="44.80859375" + viewBox="0 -39.2822265625 122.482421875 44.80859375"> - + - + \ No newline at end of file diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg index 3e26958..3d7e2db 100644 --- a/Assets/Text-Styling/example_font_hello_10_light.svg +++ b/Assets/Text-Styling/example_font_hello_10_light.svg @@ -1,14 +1,14 @@ + width="122.482421875" height="44.80859375" + viewBox="0 -39.2822265625 122.482421875 44.80859375"> - + - + \ No newline at end of file From 7c0689e02926a8c9c0596f31bb56831b3bb7cb9d Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:45:15 +0100 Subject: [PATCH 16/22] Update Text-Styling.md --- Text-Styling.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Text-Styling.md b/Text-Styling.md index d520204..856cc5f 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -731,7 +731,7 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. {f:modname_fontkey}Hello{} ``` - Custom Font (example: Wingdings) + Custom Font (example: Comic Sans MS) Custom @@ -1268,3 +1268,4 @@ which can be used as colour keys in the same way by `{C:}` and `{X:}`. When refe + From 34aa8e6ca1a91e253d5d78c86e5a247f68658a5c Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:46:09 +0100 Subject: [PATCH 17/22] Add files via upload --- Assets/Text-Styling/example_font_hello_10_dark.svg | 2 +- Assets/Text-Styling/example_font_hello_10_light.svg | 2 +- Assets/Text-Styling/example_font_hello_1_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_1_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_2_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_2_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_3_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_3_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_4_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_4_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_5_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_5_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_6_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_6_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_7_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_7_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_8_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_8_light.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_9_dark.svg | 8 ++++---- Assets/Text-Styling/example_font_hello_9_light.svg | 8 ++++---- 20 files changed, 74 insertions(+), 74 deletions(-) diff --git a/Assets/Text-Styling/example_font_hello_10_dark.svg b/Assets/Text-Styling/example_font_hello_10_dark.svg index 61054aa..74facd3 100644 --- a/Assets/Text-Styling/example_font_hello_10_dark.svg +++ b/Assets/Text-Styling/example_font_hello_10_dark.svg @@ -3,7 +3,7 @@ viewBox="0 -39.2822265625 122.482421875 44.80859375"> + fill="black" opacity="0.3"> diff --git a/Assets/Text-Styling/example_font_hello_10_light.svg b/Assets/Text-Styling/example_font_hello_10_light.svg index 3d7e2db..ee717f6 100644 --- a/Assets/Text-Styling/example_font_hello_10_light.svg +++ b/Assets/Text-Styling/example_font_hello_10_light.svg @@ -3,7 +3,7 @@ viewBox="0 -39.2822265625 122.482421875 44.80859375"> + fill="black" opacity="0.3"> diff --git a/Assets/Text-Styling/example_font_hello_1_dark.svg b/Assets/Text-Styling/example_font_hello_1_dark.svg index 89fc459..484cd17 100644 --- a/Assets/Text-Styling/example_font_hello_1_dark.svg +++ b/Assets/Text-Styling/example_font_hello_1_dark.svg @@ -1,9 +1,9 @@ + width="87.375" height="37.875" + viewBox="0 -28.125 87.375 37.875"> - + diff --git a/Assets/Text-Styling/example_font_hello_1_light.svg b/Assets/Text-Styling/example_font_hello_1_light.svg index 34f085c..2805aa9 100644 --- a/Assets/Text-Styling/example_font_hello_1_light.svg +++ b/Assets/Text-Styling/example_font_hello_1_light.svg @@ -1,9 +1,9 @@ + width="87.375" height="37.875" + viewBox="0 -28.125 87.375 37.875"> - + diff --git a/Assets/Text-Styling/example_font_hello_2_dark.svg b/Assets/Text-Styling/example_font_hello_2_dark.svg index 175b08b..d450ec5 100644 --- a/Assets/Text-Styling/example_font_hello_2_dark.svg +++ b/Assets/Text-Styling/example_font_hello_2_dark.svg @@ -1,9 +1,9 @@ + width="260.3" height="56.60000000000001" + viewBox="0 -42.400000000000006 260.3 56.60000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_2_light.svg b/Assets/Text-Styling/example_font_hello_2_light.svg index 702f384..c4dbcf8 100644 --- a/Assets/Text-Styling/example_font_hello_2_light.svg +++ b/Assets/Text-Styling/example_font_hello_2_light.svg @@ -1,9 +1,9 @@ + width="260.3" height="56.60000000000001" + viewBox="0 -42.400000000000006 260.3 56.60000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_3_dark.svg b/Assets/Text-Styling/example_font_hello_3_dark.svg index 3e1e04a..68c7637 100644 --- a/Assets/Text-Styling/example_font_hello_3_dark.svg +++ b/Assets/Text-Styling/example_font_hello_3_dark.svg @@ -1,9 +1,9 @@ + width="260.3" height="56.900000000000006" + viewBox="0 -42.7 260.3 56.900000000000006"> - + diff --git a/Assets/Text-Styling/example_font_hello_3_light.svg b/Assets/Text-Styling/example_font_hello_3_light.svg index fdd3d37..db781c7 100644 --- a/Assets/Text-Styling/example_font_hello_3_light.svg +++ b/Assets/Text-Styling/example_font_hello_3_light.svg @@ -1,9 +1,9 @@ + width="260.3" height="56.900000000000006" + viewBox="0 -42.7 260.3 56.900000000000006"> - + diff --git a/Assets/Text-Styling/example_font_hello_4_dark.svg b/Assets/Text-Styling/example_font_hello_4_dark.svg index 1969a6c..22c3a5c 100644 --- a/Assets/Text-Styling/example_font_hello_4_dark.svg +++ b/Assets/Text-Styling/example_font_hello_4_dark.svg @@ -1,9 +1,9 @@ + width="390.3" height="56.10000000000001" + viewBox="0 -41.900000000000006 390.3 56.10000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_4_light.svg b/Assets/Text-Styling/example_font_hello_4_light.svg index 53923e5..bfcdbcb 100644 --- a/Assets/Text-Styling/example_font_hello_4_light.svg +++ b/Assets/Text-Styling/example_font_hello_4_light.svg @@ -1,9 +1,9 @@ + width="390.3" height="56.10000000000001" + viewBox="0 -41.900000000000006 390.3 56.10000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_5_dark.svg b/Assets/Text-Styling/example_font_hello_5_dark.svg index 06aae5d..ebc0e27 100644 --- a/Assets/Text-Styling/example_font_hello_5_dark.svg +++ b/Assets/Text-Styling/example_font_hello_5_dark.svg @@ -1,9 +1,9 @@ + width="410.3" height="54.35000000000001" + viewBox="0 -40.150000000000006 410.3 54.35000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_5_light.svg b/Assets/Text-Styling/example_font_hello_5_light.svg index a3c24f8..7dca8c5 100644 --- a/Assets/Text-Styling/example_font_hello_5_light.svg +++ b/Assets/Text-Styling/example_font_hello_5_light.svg @@ -1,9 +1,9 @@ + width="410.3" height="54.35000000000001" + viewBox="0 -40.150000000000006 410.3 54.35000000000001"> - + diff --git a/Assets/Text-Styling/example_font_hello_6_dark.svg b/Assets/Text-Styling/example_font_hello_6_dark.svg index b56aba9..248e95b 100644 --- a/Assets/Text-Styling/example_font_hello_6_dark.svg +++ b/Assets/Text-Styling/example_font_hello_6_dark.svg @@ -1,9 +1,9 @@ + width="510.85" height="54.1" + viewBox="0 -38.6 510.85 54.1"> - + diff --git a/Assets/Text-Styling/example_font_hello_6_light.svg b/Assets/Text-Styling/example_font_hello_6_light.svg index 86cdcab..083dac3 100644 --- a/Assets/Text-Styling/example_font_hello_6_light.svg +++ b/Assets/Text-Styling/example_font_hello_6_light.svg @@ -1,9 +1,9 @@ + width="510.85" height="54.1" + viewBox="0 -38.6 510.85 54.1"> - + diff --git a/Assets/Text-Styling/example_font_hello_7_dark.svg b/Assets/Text-Styling/example_font_hello_7_dark.svg index 731ceca..ec91179 100644 --- a/Assets/Text-Styling/example_font_hello_7_dark.svg +++ b/Assets/Text-Styling/example_font_hello_7_dark.svg @@ -1,9 +1,9 @@ + width="87.375" height="34.4375" + viewBox="0 -25.3125 87.375 34.4375"> - + diff --git a/Assets/Text-Styling/example_font_hello_7_light.svg b/Assets/Text-Styling/example_font_hello_7_light.svg index a435917..ee86b2a 100644 --- a/Assets/Text-Styling/example_font_hello_7_light.svg +++ b/Assets/Text-Styling/example_font_hello_7_light.svg @@ -1,9 +1,9 @@ + width="87.375" height="34.4375" + viewBox="0 -25.3125 87.375 34.4375"> - + diff --git a/Assets/Text-Styling/example_font_hello_8_dark.svg b/Assets/Text-Styling/example_font_hello_8_dark.svg index 6932ef8..deb74d2 100644 --- a/Assets/Text-Styling/example_font_hello_8_dark.svg +++ b/Assets/Text-Styling/example_font_hello_8_dark.svg @@ -1,9 +1,9 @@ + width="132.25" height="42.0" + viewBox="0 -38.0 132.25 42.0"> - + diff --git a/Assets/Text-Styling/example_font_hello_8_light.svg b/Assets/Text-Styling/example_font_hello_8_light.svg index f6dd285..5b5d13b 100644 --- a/Assets/Text-Styling/example_font_hello_8_light.svg +++ b/Assets/Text-Styling/example_font_hello_8_light.svg @@ -1,9 +1,9 @@ + width="132.25" height="42.0" + viewBox="0 -38.0 132.25 42.0"> - + diff --git a/Assets/Text-Styling/example_font_hello_9_dark.svg b/Assets/Text-Styling/example_font_hello_9_dark.svg index 1b87083..b4468c0 100644 --- a/Assets/Text-Styling/example_font_hello_9_dark.svg +++ b/Assets/Text-Styling/example_font_hello_9_dark.svg @@ -1,9 +1,9 @@ + width="124.30000000000001" height="42.0" + viewBox="0 -38.0 124.30000000000001 42.0"> - + diff --git a/Assets/Text-Styling/example_font_hello_9_light.svg b/Assets/Text-Styling/example_font_hello_9_light.svg index 3b4a094..e239d84 100644 --- a/Assets/Text-Styling/example_font_hello_9_light.svg +++ b/Assets/Text-Styling/example_font_hello_9_light.svg @@ -1,9 +1,9 @@ + width="124.30000000000001" height="42.0" + viewBox="0 -38.0 124.30000000000001 42.0"> - + From 39d26950bf4e203d1ed13b0e8b16fc0aeabd6b33 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:47:59 +0100 Subject: [PATCH 18/22] Add files via upload From d412fd6030a2280740d26fdc456e815805f81708 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:48:28 +0100 Subject: [PATCH 19/22] Update Text-Styling.md From e37c03c9c692362eacad852a7b22567f5a05a7b6 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:52:16 +0100 Subject: [PATCH 20/22] Update Text-Styling.md --- Text-Styling.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Text-Styling.md b/Text-Styling.md index 856cc5f..993c6eb 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -698,7 +698,7 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. ``` Go Noto Current Bold - `All1`** + All1** @@ -715,7 +715,7 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. ``` Go Noto CJK Core - `All2`** + All2** @@ -742,8 +742,8 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. -* It differs from the default font from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` -** These are the language names given in the original `game.lua` file. +*It differs from the default font from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` +**These are the language names given in the original `game.lua` file. ## Combinations @@ -1269,3 +1269,4 @@ which can be used as colour keys in the same way by `{C:}` and `{X:}`. When refe + From 6530fc78b18f187388a930ee3072eb1347fdfd4e Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:53:04 +0100 Subject: [PATCH 21/22] Update Text-Styling.md --- Text-Styling.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Text-Styling.md b/Text-Styling.md index 993c6eb..8efdcd8 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -743,6 +743,7 @@ Vanilla Balatro only uses `s:0.8`, `s:0.85` and `s:1.1` text scales. *It differs from the default font from the parameters `TEXT_HEIGHT_SCALE = 0.9` and `TEXT_OFFSET = {x=10,y=15}` + **These are the language names given in the original `game.lua` file. @@ -1270,3 +1271,4 @@ which can be used as colour keys in the same way by `{C:}` and `{X:}`. When refe + From 1e0b01a16a97a642aca239bb5057072635344446 Mon Sep 17 00:00:00 2001 From: LasagnaFelidae <87911854+LasagnaFelidae@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:55:53 +0100 Subject: [PATCH 22/22] Update Text-Styling.md --- Text-Styling.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Text-Styling.md b/Text-Styling.md index 8efdcd8..a3829a1 100644 --- a/Text-Styling.md +++ b/Text-Styling.md @@ -117,7 +117,7 @@ Valid style modifiers are as follows: Font - {f:font_key} + {f:font} @@ -1272,3 +1272,4 @@ which can be used as colour keys in the same way by `{C:}` and `{X:}`. When refe +