OasisWManual 한국어
Section 8. UI and sound How-to Pending 2

Change score and message text

To show text such as scores, messages and titles on top of the game screen, use a 2D Screen (a UI panel attached to the screen) and a Text Element (text) under it. This page shows how to display a piece of text in an empty scene, make Korean characters appear, and change the wording of existing text.

The tests on this page were done on 2026-10-29 in the oasisw.ai editor (version shown as OasisW 7e2aa65, macOS Chrome) with one project. Results were checked on the game screen started with Launch. Behavior without a separate note was tested once.

Before you start

  • You need a font file (.ttf). At the time of testing, searching ASSET STORE for font returned No results. Have a usable font file ready on your computer. The tests used Nanum Gothic (NanumGothic.ttf).
  • Each font file has its own license terms. First check that the font may be included in a game you publish.

Do it in the editor

1. Create a 2D Screen and a Text Element

  1. Click + above HIERARCHY → User Interface → 2D Screen. A 2D Screen entity is created.
  2. With 2D Screen selected, click + → User Interface → Text Element again. A Text is created under 2D Screen.
The User Interface submenu of the HIERARCHY + menu: 2D Screen, 3D Screen, Button, Layout Group, Layout Child, Group Element, Text Element, Image Element, Scrollbar, Scroll View
① User Interface ② 2D Screen ③ Text Element

Text must be under a 2D Screen to stick to the screen. The SCREEN section of 2D Screen starts with Screen Space on, Ref Resolution 1280 × 720 and Scale Mode Blend. When the screen size changes, the text size scales relative to this reference. On a 1920 × 854 screen, it was drawn at 1.334× the reference. The calculation is explained in How on-screen text and buttons are structured.

2. See why the text is invisible

When you select the new Text, the Text field in the ELEMENT section is Text, but Font is Empty. When we clicked Launch in this state, no text appeared on screen at all, and there was no error message. Without a font, there are no glyphs to draw.

The ELEMENT section of the Text entity. Font is Empty and Text is Text
① Text entity ② Font is empty ③ Text shown on screen

3. Upload a font and add Korean characters

  1. Click Upload at the top right of ASSETS and choose a .ttf file. In our tests, a folder with the same name as the file (NanumGothic) was created, containing two items: the source file (large A icon) and the font asset (Aa icon).
  2. Click the font asset with the Aa icon. The FONT section appears on the right.
  3. Characters in the FONT section holds the list of characters this font draws. Initially it contains only Latin letters, digits and symbols (Range (hex) 0x20–0x7E).
  4. Append the Korean characters your game uses to the end of the Characters field. Example: if the text is 점수 (score) and 목숨 (lives), add 점수목숨.
  5. Click REGENERATE FONT ASSETS. The button changed to REGENERATING FONT ASSETS... and returned within 5 seconds.
The font asset selected. On the right: CHARACTER PRESETS, CUSTOM CHARACTER RANGE, the Characters field of FONT, and the REGENERATE FONT ASSETS button
① Upload ② Font asset (Aa) ③ Character set buttons ④ Characters ⑤ REGENERATE FONT ASSETS

CHARACTER PRESETS has only Latin, Latin Supplement, Cyrillic and Greek; there is no Korean set. Enter Korean characters by hand as in step 4. Pending Test the size and time when adding the whole Korean range (0xAC00–0xD7A3) via CUSTOM CHARACTER RANGE

4. Assign the font and change the text

  1. Select Text in HIERARCHY.
  2. Drag the Aa font asset from ASSETS onto Font in the ELEMENT section. Empty changes to the font name.
  3. Type the text to show in the Text field and press Enter.
  4. Check with ▶ Launch.
The ELEMENT section of Text. NanumGothic.ttf is assigned to Font and Text is Score 0 점수
① Font asset placed in Font ② Text
Score 0 점수 appears in the center of the launched game screen
The launched screen. Score 0 점수 appears in the center

Missing characters are silently dropped

Characters you didn't add in step 3 disappear from the screen without even leaving a blank space. No error message appears. In our tests, before Korean was added, Score 0 점수 showed only as Score 0. When the text was changed during the game to 점수 10 목숨 (score 10 lives), only the missing 목숨 was dropped and 점수 10 appeared.

Only 점수 10 appears in the launched game screen; 목숨 is not visible
Changed to 점수 10 목숨, but 목숨 was dropped

If a script changes the text during the game (score, time left, names, etc.), add every character that can appear in that text to Characters. Digits are included from the start.

Change the wording of existing text

If the text already exists, as in games made by the AI, find the entity that holds it in HIERARCHY and edit Text in the ELEMENT section. If you don't know the entity's name, try a likely name such as Text or Score in the HIERARCHY search box.

If you edited the Text field but the game still shows the original wording, a script is overwriting Text when the game starts. In that case the wording is stored in a script attribute. Find the text attribute in the SCRIPT section of the entity that holds the text (or the entity that runs the whole game) and change it. Attribute names differ from game to game. See Change script attribute values.

Let the AI do it

Example prompt:

Show "점수 0" at the top left of the screen, and increase the number by 1 every time a star is collected.
Use NanumGothic from ASSETS as the font, and add the Korean characters that appear on screen to the font's Characters.
Don't touch anything else.

Check whether the AI also fills in the font's Characters, and afterwards check in Launch that no Korean characters are missing. Pending Test Let the AI do it — same prompt 3 times

Next steps

Source ui-sound/edit-ui-text.html