Code Diary

Godot 20 - GDScript 표기법

쌍준 — Sat, 29 Nov 2025 14:42:34 +0900

1. 파스칼케이스 (PascalCase)

클래스명, 노드명, 씬명

# 클래스명
class_name PlayerCharacter
class_name EnemyController
class_name HealthBar

# 씬 파일명
PlayerCharacter.tscn
EnemySpawner.tscn
MainMenu.tscn

# 스크립트 파일명
PlayerCharacter.gd
GameManager.gd

2. 스네이크케이스 (snake_case)

변수, 함수, 시그널, 상수(소문자), 그리고 파일시스템 파일명

# 변수
var player_health = 100
var max_speed = 500.0
var is_jumping = false

# 함수
func update_health(amount):
    pass

func calculate_damage(attacker, defender):
    pass

func _ready():
    pass

func _process(delta):
    pass

# 시그널
signal health_changed
signal player_died
signal enemy_spawned

3. 대문자 스네이크케이스 (UPPER_SNAKE_CASE)

상수, enum

# 상수
const MAX_HEALTH = 100
const GRAVITY = 980.0
const PLAYER_SPEED = 200

# enum
enum State {
    IDLE,
    RUNNING,
    JUMPING,
    FALLING
}

enum DamageType {
    PHYSICAL,
    MAGICAL,
    FIRE,
    ICE
}

파일시스템에서는 axe_ability.tscn 이지만 에디터로 가져오면 AxeAbility가 된다.

Godot 19 - 노드 참조, 소통

쌍준 — Thu, 20 Nov 2025 10:55:26 +0900

다른 노드를 연결하는 것을 4가지 방식이 있다.

# 1. @onready (자주 사용)
@onready var sprite = $Sprite2D
# 자식, 형제 노드를 상대경로로 연결
# 가장 빠름

# 2. group (자주 사용)
get_tree().get_first_node_in_group("player")
# 그룹으로 찾음
# 씬 구조 무관, 여러 레벨에서 작동

# 3. @export (가끔 사용)
@export var health_component: Node
# 에디터에서 수동 연결
# 수치 커스터마이징할 때만

# 4. singleton (자주 사용)
GameManager.instance.add_score(100)
# 모든 노드가 자동으로 접근 가능
# 중앙 관리 시스템에 적합

다른 노드와 소통하는 방식은 2가지가 있다.

# 1. signal (자주 사용)
signal took_damage(damage: int)
took_damage.emit(10)
# 한 신호 → 여러 노드 동시 반응
# 순서 상관없을 때

# 2. 함수 직접 호출 (가끔 사용)
velocity_component.accelerate_in_direction(direction)
velocity_component.move(self)
# 순서가 보장됨
# 순서가 중요할 때만 사용

만약 위에 직접 호출 2줄을 신호방출 2개로 바꾸면 신호방출1->처리1->신호방출2->처리2로 보장을 못한다.

신호방출1->신호방출2->처리2->처리1 으로 되어버릴 수가 있다.

Aseprite 4

쌍준 — Tue, 23 Sep 2025 10:56:47 +0900

view - grid - grid setting으로

원하는 크기로 나눠서 볼 수 있다.

왼쪽위를 확대해 오른쪽아래를 그렸다. 이 때 왼쪽위(원본)를 수정해서 오른쪽아래도 같이 바꾸고 싶다면

저번에 적었던 모드 중에서 첫 번째인 수정만 가능한 모드로 해야 한다.

Aseprite 3

쌍준 — Sat, 20 Sep 2025 22:06:04 +0900

메탈느낌을 만들어봤다.

원기둥을 간단한 나무몸통으로 만들어봤다.

귤을 그려보았다.

단순한 hp포션을 그려보았다.

간단한 책을 그려보았다.

Aseprite 2

쌍준 — Thu, 18 Sep 2025 18:55:02 +0900

각 도형에 입체감을 부여하기 위한 연습을 했다

색깔은 밝기에 따라 5가지로 했다.

먼저 광원의 방향이 중요하고 방향에따라서 도형의 밝기를 조절했다.

신기한건 왼쪽아래위 45도 각도로 들어오기 때문에 원기둥, 정육면체에는 모서리가 하얀색이라는 점이다.

딱딱 직선으로 나눠놨기 때문에 옆면이 둥글기보다는 각져있는 거로 보이는데 이거는 노이즈를 추가해서 둥글다는 것을 표현했다.

제일 겉에 테두리는 무조건 검은색 고정하고, 그림 중간테두리들은 밝기에 따라서 바꿔줘도 된다. (없애도 된다)

직접 그려본 오른쪽 뒤 위 45도 각도 광원에 대한 물체모습

hsv에 대해서 배웠다.

h는 hue 색조. 우리가 아는 색상 들이다.

r은 0, g는 120, b는 240이다.

s는 saturation 채도. 좀 어려울 수 있는데, 낮아질수록 색의힘을 잃고 흑백이 되어간다고 생각하면 된다.

v는 value 명도. 이건 낮아질수록 어두워진다.

연습을 해보자.

회색은 어떻게 만들까?

음... 아무 h나 선택한 후 s는 무조건 0으로 고정 후 v를 50정도 하면 될 것 같다.

내가 좋아하는 에메랄드바다색은?

음... 일단 파랑에서 초록사이니까 h는 180정도, 채도는 50정도? 명도는 100?

강사님은 색을 주요 사용법 3가지를 알려주셨다.

먼저 보색을 사용하는 것

서로 반대편에 있는 색이 서로의 보색인데 이게 보완이 잘 된다고 한다.

다음으로 한가지 색조만 사용해서 채도와 명도만 조절하는 것

마지막으로 색조가 비슷한 애들을 쓰는 것이라고 한다.

Aseprite 1

쌍준 — Wed, 17 Sep 2025 18:23:57 +0900

New Palette from Sprite로 현재 칠해져있는 색깔들을 팔레트로 가져올 수 있다.

컨트롤 N은 새로운 스프라이트를 만든다. (가장 큰 개념)

쉬프트 N은 그 스프라이트에 새로운 레이어를 만든다. (다음으로 큰 개념)

알트 N은 이 스프라이트의 레이어들에 새 프레임을 만든다.

왼쪽위의 다섯번째 사각형모양 옵션은 각 프레임의 앞뒤를 반투명하게 보여줘서 애니메이션을 그릴 때 도움된다.

특정 구간에 태그(구간)를 만들어서 반복, 뒤로재생, 앞뒤로재생 등을 시킬 수 있다.

타일맵 레이어다.

48X48의 스프라이트에 16X16으로 타일맵레이어를 만들면 총 9개의 타일이 만들어진다.

왼쪽위의 세가지 모드는

각각 1. 수정만 함 (원래 있던 타일들만 수정 가능)

2. 원래 있던 건 수정, 없던 건 추가

3. 원래 있던걸 수정해도 새롭게 다 추가다.

직선을 쉽게 그릴려면 직선도구를 이용해도 되지만

원하는 점에서 쉬프트를 누르고 원하는 끝점에서 클릭하면 끝난다.

가장 마지막에 좌클릭을 한지점부터 직선을 그려주기때문에 시작점에서 한번 클릭해줘야 한다.

Godot 18

쌍준 — Thu, 11 Sep 2025 18:34:08 +0900

MetaProgression 이라는 씬을 오토로드에 등록해놓았다면, 어느 스크립트에서나 MetaProgression.~~~ 이렇게 접근이 가능해진다.

get_tree().call_group("meta_upgrade_card", "update_progress")

의미: 트리에 등록된 "meta_upgrade_card" 그룹에 속한 모든 노드의 update_progress() 함수를 호출.
결과: 화면에 있는 모든 카드 UI가 새로고침됨.

이건 메타업그레이드카드의 스크립트인데, 업그레이드 구매를 누른순간 이 업그레이드 카드 외에도 다른 카드들의 ui도 업데이트해야하기 때문에, 그룹에 넣고 call_group("그룹명", "호출할함수")로 모든 그룹원에게 update_progress를 시킴

이렇게 임시로 ui를 넣어놓고

ready에 컨테이너 자식들을 찾아서 없애게 해놓으면 만들 때 편하다.

코드를 적다가 다른 곳에서도 자주 써야할 것 같다면 함수로 만들어주자.

Godot 17

쌍준 — Tue, 9 Sep 2025 19:19:03 +0900

장면이 전환 될 때 원이 모였다가 다시 커지면서 장면이 전환되는 것을 구현했다.

이 png파일은 가운데가 밝고 가장자리로갈수록 어둡게 설정되어있다.

ColorRect에 쉐이더메티리얼로

셰이더 코드에서는 uniform이 @export의 역할을 한다. (외부로 노출시킴)

uniform 변수들
- transition_color : 화면을 덮는 색깔 (보통 검은색 페이드용으로 씀).
- transition_texture : 전환용 마스크 텍스처 (위의 png 파일).
- percent : 전환 진행도 (0.0 ~ 1.0 사이, AnimationPlayer가 이 값을 바꿔줌).
fragment() 함수
→ 최종적으로 각 픽셀의 색을 계산하는 곳.
- vec4 transition_texture_color = texture(transition_texture, UV);
  → 지금 픽셀의 UV 좌표에 해당하는 텍스처 색을 가져옴.
- if (transition_texture_color.r > percent)
  → 텍스처의 빨강(R) 값이 percent보다 크면 → 이 픽셀은 아직 안 보여야 함. 왜 R로 하냐면 흑백은 R=G=B값이라 그렇다. R로 그냥 설정한 것!
  → 그래서 COLOR.a = 0.0; (투명하게 만든다).
- else
  → 그 외에는 transition_color로 채운다 (즉, 점점 화면이 색으로 덮인다).

정리하면:
percent 값이 점점 커지면 (0 → 1), transition_texture의 모양에 따라 화면이 가려짐.

ScreenTransition 스크립트

transition() 함수를 보자.

먼저 애니메이션을 이용해 퍼센트값을 0에서 1로 올리면 가장자리부터 가려지게 만듬.

기본적으로 unvisible하게 되어있다가 이 애니메이션이 시작될 때 visible이 켜짐

왜 이렇게 하냐? -> unvisible하게 해서 평소에는 마우스에 영향을 받지 않게 하기위해서다.

그리고 신호를 기다린다.

다 가려지면 transition_halfway. 즉 전환이 절반 도달했다는 신호를 방출

그러면 신호를 받은 후 다시 1에서 0으로 줄여가며 반대로 화면을 보이게 만들어줌.

문제는 반대로 할 때도 신호를 방출하게 되므로 skip_emit 임시신호를 이용해서 되돌아 올때는 신호를 방출하지 않고 return시킨다.

이 씬을 오토로드에 달아놓은 후에

화면 전환 장면이 필요할때마다

전환함수 불러온후에 딱 절반도달해서 가려졌을 때 뒤의 화면을 전환시키도록 설정해놓으면 된다!

Run 내부에서의 업그레이드가 아닌 외부에서 업그레이드를 하는 것을 구현하려고 한다.

어빌리티업그레이드에서 했던 것처럼 메타업그레이드 리소스 클래스를 만들어주고, id, 최대값, 제목, 설명칸을 넣는다.

그리고 그 중 첫 번째로

경험치 물약 드랍률 증가 업그레이드 리소스를 하나 만들었다.

upgrade_currency: 런을 하며 모아두는 재화 → 이후 업그레이드 구입에 씀.
meta_upgrades: 어떤 업그레이드를 몇 번 샀는지 기록.
save() / load_save_file(): 런과 런 사이의 영속성(메타 진척)을 보장.
GameEvents 신호 연결: 런 중에 경험치 아이템을 먹으면 자동으로 저장.

const SAVE_FILE_PATH = "user://game.save"

res:// 는 읽기만 가능한 게임설치폴더고 user:// 에다가

이 설정을 해서 따로 읽고 쓰기가 가능한 폴더를 만들고 game.save로 연결해준다.

save_data는 딕셔너리로 몇개의 경험치를 먹었고, 어떤 영구적인 업그레이드가 들어가있는지 저장된다.

ready에서 호출되는 함수.

그 파일이 있으면 file 변수에 read모드로 연결한 후에

그 file변수에 직렬화되어있는 내용을 딕셔너리로 만듬. 그 딕셔너리를 save_data에 넣음.

반대로 쓰기 모드로 game.save을 file로 연결해서 save_data 딕셔너리를 직렬화해서 file에 쓴다.

업그레이드를 적용하는 함수. 아마 메타업그레이드카드 같은 곳에서 업그레이드 누르면 이거 호출할 듯

적용할 업그레이드가 없으면 수량 0 으로 자리를 만들어주고, 수량 +1 해주고,

있으면 그냥 바로 수량 +1 해준다.

경험치 물약 먹었을 때 currency를 경험치양 만큼 더해주고 game.save에도 저장

오늘의 질문 (간단)

1. 화면 전환용 효과를 어떻게 구현할까?

2. 메타 (영구) 업그레이드를 어떻게 구현할까? 그걸 어떻게 게임을 껐다 켜도 유지 시킬 수 있을까?

Godot 16

쌍준 — Sun, 7 Sep 2025 15:50:23 +0900

테마만 적용: 특정 옷장(테마)을 선택하고, 그 안에 있는 기본 옷(기본 스타일)을 입는 것과 같습니다.
타입 바리에이션만 적용: 옷장 선택 없이 '파란색 옷'이라는 이름의 옷을 달라고 하는 것입니다. 이 경우, 기본 옷장(프로젝트 기본 테마)에서 파란색 옷을 찾아 입게 됩니다.
둘 다 적용: '파티용 옷장'을 선택하고, 그 안에서 '빨간 드레스'라는 특정 옷(바리에이션)을 골라 입는 것입니다. 가장 정확하고 의도한 스타일을 적용할 수 있습니다.

여기서는 테마 없이 그냥 바로 옷입힌 것

이 옷은 theme.tres에 저장되어 있는 옷 중 하나

테마는 무엇인가요?: Godot의 UI 노드(Label, Button, Panel 등)에 적용되는 시각적 속성(폰트, 색상, 크기, 스타일 등)을 하나의 파일로 묶어놓은 리소스입니다. 게임 내 모든 UI 요소의 디자인을 일관성 있게 만들고, 손쉽게 변경할 수 있게 해줍니다.

기본적으로 ui, 글꼴, label 이런건 다 Godot 기본 테마를 따라가고 있는데, 테마를 넣어주면 그 테마의 설정들을 따라가게된다.

예를 들어 그 테마에 label이 들어있으면 그 label을 따라가게 되고, 없으면 그냥 고도 기본 테마를 따라가는데, 특별한 label은 기본 노드 유형으로 블루프린트라벨 같이 추가로 테마에 넣어놓은 label을 바리에이션을 적용하면 되는 것!

main.gd스크립트의 일부

func _unhandled_input(event: InputEvent) -> void:

Godot의 입력 처리 함수 중 하나.
다른 노드들(InputEvent 처리한 노드들)에서 처리되지 않은 입력만 여기로 전달

if event.is_action_pressed("pause"):

"pause"라는 Input Action이 눌렸는지를 검사
이 "pause"는 Input Map에 정의된 이름이야. 예: ESC, P이 매핑되어 있음

add_child(pause_menu_scene.instantiate())

미리 로드한 Pause Menu 씬을 인스턴스화해서 현재 노드에 자식으로 추가

get_tree().root.set_input_as_handled()

현재 입력 이벤트(예: ESC 누름)를 여기서 처리 완료했다! 라고 Godot에게 알려줌.
그러면 이 이벤트는 다른 _unhandled_input()으로 더 이상 전파되지 않음.

$AnimationPlayer.play_backwards("default")

이렇게 하면 애니메이션을 역재생할 수 있다.

panel_container.pivot_offset = panel_container.size / 2

이거로 피벗 오프셋을 중앙에 두어서 중앙에서 등장해서 중앙으로 사라지도록 만들 수 있다.

오늘 만든 pause_menu.gd이다.

Git 사용법

쌍준 — Sat, 6 Sep 2025 22:08:22 +0900

1. 깃허브에 원격 리포지토리를 만든다.

2. 사용한 폴더에 git init으로 깃을 사용하겠다고 선언한다.

3. git remote ~~~~~ 으로 로컬과 리포지토리를 연결한다.

4. git add . 으로 택배상자에 담는다.

5. git commit -m "example" 로 뭐가 바뀌는지 메시지를 넣어준다.

6. git push origin main 으로 main branch에 박아넣는다.

다른 로컬에서 이 파일을 불러오려면

1. git init으로 깃 사용한다고 선언하고

2. git remote ~~~ 으로 연결하고

3. git pull origin main 하면 된다.