Developer

[C#] namespace란?

2026-01-28T17:43:00.000+09:00

1. 네임스페이스란?

코드를 정리하는 폴더 개념이다.

namespace BossSlayer.Models

{

public class PlayerModel { }

public class BossModel { }

}

namespace BossSlayer.Views

{

public class BattleView { }

}

// 실제 사용 시:

using BossSlayer.Models; // Models 폴더의 것들을 사용하겠다!

PlayerModel player = new PlayerModel();

이런 식으로 사용하게 된다.

2. 왜 필요한가?

namespace가 없으면 동일한 class PlayerModel이 다른 파일에 미리 만들어져 있으면 충돌 나게 된다.

이러한 상황을 namespace를 만들어서 BossSlayer.Models.PlayerModel; 로 네임스페이스를 붙여 적으면 어떤 PlayerModel인지 명확하게 할 수 있다.

3. 네임스페이스 구조의 의미

namespace BossSlayer.Models

// ──┬── ──┬───

// 회사/프로젝트 카테고리

// 의미:

// BossSlayer = 프로젝트 이름

// Models = Model 레이어에 속한다는 표시

```

**장점:**

1. **충돌 방지**: 다른 에셋과 이름이 겹쳐도 OK

2. **구조 명확**: 코드가 어디에 속하는지 명확

3. **IntelliSense 정리**: IDE에서 자동완성이 깔끔하게 분류됨

4. **팀 협업**: 누가 봐도 구조 이해 가능

"Claude(Anthropic AI)와의 대화를 바탕으로 작성했습니다"

[유니티][Unity] 한글 Font 사용방법 (한글 깨짐 방지)

2026-01-03T23:17:00.006+09:00

한글이 들어가는 .otf 파일을 받는다. 그리고 저작권에 문제가 없는 것을 사용한다.

내 경우에는 Pretendard-Regular.otf를 사용하였다.

본 글 작성 시점 기준으로, Pretendard는 SIL Open Font License 1.1을 따르며
해당 라이선스는 상업적 사용을 허용합니다.
실제 사용 전에는 반드시 각 폰트의 공식 배포처에 포함된 라이선스 전문을 확인하시기 바랍니다.
라이선스 정책은 변경될 수 있으며, 최종 책임은 사용자인 본인에게 있습니다.

해당 라이센스는

🔐 SIL Open Font License (OFL) 1.1 핵심 요약

✅ 허용되는 것

✔ 상업적 사용 (유료 게임, 광고 수익, 인앱결제)
✔ 수정해서 사용
✔ 게임에 포함해서 배포
✔ 번들링 (APK/IPA 안에 포함)

👉 유니티 게임에 폰트 넣는 것 = 완전 OK

⚠️ 조건 (중요하지만 쉬움)

1️⃣ 폰트 단독 판매 금지

❌ 폰트 파일만 따로 팔면 안 됨
⭕ 게임 리소스 일부로 포함 → OK

2️⃣ 수정한 경우 이름 변경

폰트를 수정했으면
→ 원래 폰트 이름 그대로 쓰면 안 됨
(수정 안 했으면 신경 안 써도 됨)

3️⃣ 라이선스 문서 포함

보통 폰트 다운로드 시 OFL.txt 같이 들어 있음
게임에 같이 포함하거나
크레딧에 한 줄 표기하면 충분

🎮 Unity + 1인 개발 기준으로 현실적인 처리법

가장 안전하고 흔한 방법 (추천)

폰트 파일 그대로 사용 (수정 X)
크레딧에 한 줄 추가


Font: Pretendard
License: SIL Open Font License 1.1

❓ 자주 헷갈리는 오해

❌ “무료니까 출처 표기 필요 없음?”

→ OFL는 출처 표기 강제는 아님
하지만 크레딧 표기 권장 (실무에선 거의 다 함)

❌ “유료 게임이면 안 되는 거 아님?”

→ 완전 가능

❌ “폰트 에셋스토어에 같이 올리면?”

→ ❌ 폰트 단독 배포 성격이면 위험
→ 게임 빌드에 포함은 OK

🔥 1인 개발자 기준 결론

SIL Open Font License 1.1 = 상업 OK
Unity 유료 게임 / 광고 수익 / 인앱결제 전부 OK
크레딧에 한 줄만 써주면 끝

다운 받은 Font를 Asset/Fonts 에 폴더 채로 넣는다.

그 후 사용할려는 Font를 우클릭한 후 Create-> TextMeshPro -> Font Asset을 선택하고

Font Asset 종류 SDF /Bitmap/ Color/ Font Asset Variant 중에서는 SDF를 대부분 선택하면 된다.

4가지 타입 차이 (Unity TMP 기준)

1️⃣ SDF Font Asset ✅ 정답

Signed Distance Field

장점

해상도 바뀌어도 글자 깨짐 없음
모바일 / 태블릿 / PC 전부 대응
Outline / Shadow / Glow 효과 가능
UI 스케일링 자유로움
TextMeshPro의 핵심 기능

단점

Bitmap보다 약간 무거움 (체감 거의 없음)

👉 UI / 카드 설명 / 버튼 / 숫자 전부 여기에 해당

2️⃣ Bitmap Font Asset ❌ 비추천

픽셀 고정
크기 키우면 바로 깨짐
해상도 대응 어려움

👉 레트로 픽셀 게임 아니면 쓰지 말 것

3️⃣ Color Font Asset ❌ 거의 안 씀

컬러 이모지 / 특수 아이콘용
한글 UI에는 쓸 이유 없음
용량 큼, 모바일 비효율

4️⃣ Font Asset Variant ❌ 초보자 금지

기존 Font Asset을 기반으로
- Outline
- Shadow
- Style
관리 난이도 높음
나중에 써도 늦음

👉 처음엔 절대 만들 필요 없음

그 후 Atlas Population Mode -> Dynamic으로 선택하고 Atlas Width Height는 2048로 둘 다 맞추는 것을 권장한다.

이 후 TextMeshPro Text를 눌러 보면 Font 칸이 있는데 여기에 생성한 Font Asset을 선택하면 Font가 바뀌게 된다.

챗 지피티의 도움을 받아 작성하였습니다.

[유니티][Unity][C#] [Range(0f,1f)] public float probaility 뜻

2026-01-02T17:43:00.002+09:00

[Range(0f,1f)]

public float probability;

이렇게 적으면 probability값은 0f-1f 사이로 제한이 되게 된다.

Unity Inspector에서 probability 변수를 슬라이더로 보여주고 값이 0.0 - 1.0 사이로 제한이 된다.

게임 내 코드에서는 따로 값 제한을 해주지 않아도 Inspector에서 입력 범위가 자동으로 제한됨

단, Inspector에서만 0.0 - 1.0 사이 값을 정하는 거지 코드에서는 무슨 값이든 넣을 수 있다.

챗지피티를 참조하여 작성하였습니다.

[유니티][Unity] ScriptableObject란?

2026-01-01T23:21:00.004+09:00

씬에 붙지 않는 데이터 전용 객체 이다.

인스펙터에서 값이 수정가능한 데이터 파일이다.

여러 오브젝트가 같은 데이터를 공유하게 된다.

씬과 생명주기에서 독립 된 에디터에서 관리 가능한 데이터 덩어리

카드 기본 정보, 아이템 스텟, 스킬 쿨타임 등을 저장해 놓는다.

말하자면 스텟을 미리 저장해 놓는 설계도의 역할을 한다고 보면된다.

런타임 상태 관리, 플레이어 마다 다른 값 유지 등은 할 수 없다.

에셋과 붙어있는 데이터이기 때문에 에셋 데이터를 바꾸는 게 되기 때문이다.

챗지피티의 도움을 받아 작성하였습니다.

[유니티][Unity] TextArea

2026-01-01T23:06:00.002+09:00

유니티에서 TextArea를 적으면 Inspector 창에서 텍스트 입력칸이 늘어나는 효과를 준다. 여러줄을 작성해야 되는 스킬 설명과 같은 걸 적을 때 유용하게 쓸 수 있다.

제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity] Serializable 이란

2026-01-01T21:51:00.002+09:00

1. 유니티 인스펙터 노출 : serializable을 쓰면 유니티 inspector 창에 노출이 되어서 inspector 창에서 데이터를 작성해서 쓸 수 있게 된다.

2. 데이터 저장 및 로드: [Serializable]이 붙어 있으면 해당 객체를 JSON이나 바이너리 파일로 변환하여 저장을 해서 유저가 게임을 끄더라도 현재 스탯이나 보유한 카드를 저장할 수 있다.

제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity][C#] as를 이용한 형변환

2025-12-25T20:05:00.002+09:00

IHpBarView hpBar = aView;

BossView bossView = hpBar as BossView;

if(bossView != null)
{ //bossView function 호출

bossView.Die();
}

else

{
Debug.LogWarning("이 뷰는 BossView가 아님");

}

이렇게 as 를 통해서 IHpBarView를 상속받는 BossView 형으로 변환 시킬 수 있다.

제미나이를 참조하여 만들었습니다.

LMAdSize.h 를 찾을 수 없다는 에러가 발생했을 때 해결 방법

2025-12-17T21:36:00.001+09:00

유니티에서 iOS 빌드를 했을 때 .xcodeproj 로 열면 발생하는 이슈이다.

xcodeproj는 내부적인 코드만을 사용하기 때문에 외부 요소들을 배제하여 빌드하기 때문에 외부에 대한 코드를 가져오지 못해서 발생한다.

그래서 .xcworkspace를 열어야 한다.

그런데 보면 xcworkspace가 보이지 않을 수 있다. 이 때 해당 프로젝트에 Podfile 이 만들어졌는지 확인 해보자. 이게 없다면 나도 해결방법을 알지못하는데 이게 있다면 문제는 해결할 수 있다

podfile은 "애드몹이랑 광고를 돌리려면 A,B,C라는 파일들이 필요해" 라는 명단이 적혀 있다. 그런데 이걸 실제로 설치하려면 pod install을 돌려야 한다. 이걸 자동으로 돌리게 되있는데 iOS 환경이 복잡하여 이걸 실행 못하는 상황이 발생한다. 이럴 때 수동으로 pod install을 입력해서 수동 설치를 해줘야 한다.

이렇게 pod install을 하면 xcodeproj에 이런 외부 부품들을 결합하여 xcworkspace를 만들어 주게 된다.

결론: xcworkspace를 열어서 빌드하면 된다. 그런데 이게 없다면 podfile이 있는지 확인해 보고 있다면 해당 폴더에서 pod install을 하여 xcworkspace를 만들어 실행하면 된다.

제미나이의 도움을 받아 작성하였습니다.

other.TryGetComponent(out var damageableTarget) 이란

2025-12-15T21:27:00.001+09:00

충돌한 다른 게임 오브젝트에 특정 컴포넌트가 있는지 확인하고, 있다면 해당 컴포넌트의 참조를 안전하게 가져오는 역할을 함

TryGetComponent<T>(out T component)

<T> 에 대한 컴포넌트를 찾으라는 것 여기서 이번에는 T가 IDamagable임

Try를 붙여 시도한다는 것이다. 찾으면 true, 못찾으면 false를 반환하고 에러를 발생시키지 않음

out T Component(out var damageableTarget)

out 은 찾은 컴포넌트의 참조를 이 변수에 담아서 반환하라는 의미임

var damageableTarget : 컴포넌트를 찾으면 참조가 저장될 새 변수를 선언하고 이름이 damageableTarget이라는 뜻

즉, IDamagable을 구현한 컴포넌트가 other에 있는지 확인하고 있으면 damageableTarget 변수에 그 컴포넌트 정보를 담아주고 찾았는지 못 찾았는지 알려달라는 것이다.

제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity] 볼과 보스가 맞았을 때 OntriggerEnter 처리하는 위치 결정

2025-12-14T14:05:00.001+09:00

결론적으로 볼에서 처리하는게 좋다.

볼이 날라가서 부딪히면 데미지를 준다는 로직에 맞고

보스가 처리하게 되면 보스가 볼만 맞는게 아니고 레이저도 맞고 미사일도 맞는다면

보스가 일일이 이게 볼인지 레이전지 처리를 해줘야 되서 복잡성이 올라가게 된다.

구글 제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity][C#] If ... is ... ... 과 (... as ...)?.Function() 에 대하여

2025-12-14T00:17:00.001+09:00

IMainCharAttackView Interface와

MainCharAttackView: ImainCharAttackView 로 인터페이스를 상속받는 class가 있을때

IMainCharAttackView _view;

MainCharAttackPresenter(IMainCharAttackView view)
{

_view = view;

}

로 되어 있을 때 이런 식으로 사용하게 된다.

if( _view is MainCharAttackView concreteView)
{

concreteView.function();

}

이 뜻은 _view가 MainCharAttackView 라면 concreteView에 _view를 할당해서 쓰라는 것이다.

그래서 MainCharAttackView의 function을 concreteView가 사용하게 된다.

사실은 _view가 이미 MainCharAttackView 타입이기에 그냥 써도 되지만 이런 if문을 씀으로 인해서 정확하게 MainCharAttackView 형임을 확인하고 명확하게 concreteView를 통해 안정적으로 실행하게 된다.

(_view as MainCharAttackView)?.Function() 은

_view를 MainCharAttackView형으로 바꿨을 때 된다면 Function을 실행하고

형이 안 맞으면 null값을 반환하라는 뜻이다.

Google AI의 도움을 받아 작성하였습니다.

[유니티][Unity] 보스HP와 주인공HP를 계산하는 방법이 같을 때 하나의 코드로 처리하는 방법

2025-12-06T18:56:00.001+09:00

보스HP가 애니메이션 효과로 줄어들게 구현하고 보니

(7가지 색의 SingleBar 를 만들고 curHpBar는 빨주노초파남보 라면

밑에 있는 BelowHpBar는 주노초파남보빨 로 나오게 하고

curHpBar가 Singlebar의 끝까지 가면 주황이나오고 belowHpBar는 노랑이 나오도록 설계하고

이를 루프를 돌리고 마지막에 hp가 0이 될 때는 검은색으로 나오게 만들었다.)

이 것을 보스에만 구현해놓고 이제 주인공 HP에 구현하려고 보니, 이 코드를 다시 만들어야 되는 것이다.

그래서 재사용할 수 있게 만들어 보니 몇가지 테크닉이 들어가게 되었다.

1. static class를 지정한다.

사용 이유를 정확하게는 알 수 없으나 공용으로 쓰이는 메소드를 static class에 넣어 쓰면 재사용하기에 좋다고 한다.

이 경우에 GetColorByBarIndex로 7가지 색중 어느 index를 불러와야 할지 정하는 메소드를 static으로 만들어서 공용으로 컬러 값을 가져올 수 있게 하였다.

public static class HpColorHelper

{

public static Color GetColorByBarIndex(int index, List<Color> barColors, Color depletedColor)

{

if (index < 0) return depletedColor;

if (barColors == null || barColors.Count == 0) return Color.white;

return barColors[index % barColors.Count];

}

2. baseHpView를 만들어 거기에 색깔 계산과 애니메이션효과와 현재피/전체피 텍스트를 적게 했다.

이렇게 하면 bassHpView를 상속받으면 bassHpView에서 로딩하는 UpdateHpBar(...) 클래스를

가져오게 되니 한번 만든 코드를 재사용할 수 있게 되었다.

3. Interface를 사용하여 Presenter에서 view를 가져온다.

아직 정확하게 감이 잡힌 건 아닌데 interface를 쓰면 Presenter에서 view가 바뀌어도 코드 바꿀 필요가 없어서 유연성이 증가된다고 한다.

이런 식으로 interface를 선언 하고

public interface IHpBarView

{

void UpdateHpBar(int currentHp, int maxHp);

}

Interface를 상속 받아 같은 구조로 된 메소드에 구현 한다.

using UnityEngine;

using UnityEngine.UI;

public class BaseHpBarView : MonoBehaviour, IHpBarView

{

[SerializeField] private Image hpImage;

// 인터페이스 메서드 구현 → 반드시 public

public void UpdateHpBar(int currentHp, int maxHp)

{

float ratio = (float)currentHp / maxHp;

hpImage.fillAmount = ratio; // 단순 예제

}

그러면 하위 클래스는 코드 없이 사용가능하다.

public class BossHpBarView : BaseHpBarView

{

// IHpBarView 다시 구현할 필요 없음

// 필요 시 UpdateHpBar override 가능

}

public class MainCharHpBarView : BaseHpBarView

{

// 특화 로직 override 가능

}

Presenter에서 호출 할 떄는 아래와 같이 쓴다.

public class HpBarPresenter : MonoBehaviour

{

private IHpBarView view;

private int currentHp = 100;

private int maxHp = 100;

// Init 메서드로 런타임에 View 주입

public void Init(IHpBarView view)

{

this.view = view;

view.UpdateHpBar(currentHp, maxHp); // 초기화

}

public void TakeDamage(int dmg)

{

currentHp = Mathf.Max(0, currentHp - dmg);

view.UpdateHpBar(currentHp, maxHp);

}

핵심은 IHpBarView를 넘겨받아 쓴다는 것이다. 그래서 baseView던지 boss던지 mainchar던지 상관없이 view를 넘겨 받을 수 있다는 게 핵심으로 보인다.

chatGPT의 도움을 받아 작성하였습니다.

[유니티][Unity] Color 값을 메인케릭터와 보스가 같이 공유해서 사용하는 방법

2025-12-06T16:34:00.002+09:00

ScriptableObject를 통해 만들어진 컬러 값을 가져와서 사용하면 된다.

아래 코드 같이 만든 후 사용한다.

using NUnit.Framework;

using UnityEngine;

using System.Collections.Generic;

[CreateAssetMenu(menuName = "UI/HP Color Config")]

public class HpColorConfig : ScriptableObject

{

public List<Color> hpBarColors;

public Color animatedBarColor;

public Color depletedHPColor = Color.black;

}

CreateAssetMenu를 통해 UI -> HP Color Config라는 메뉴가 생겼다.

Project의 Assets 폴더에서 Create -> UI -> HP Color Config를 누르면 생기는데 그 이름을 HP Color Config로 저장하자. 이것을 HP Color Config Asset이라 한다. 그걸 눌러보면 위에 선언한 Color 값들을 Inspector에서 조절할 수 있다. 이렇게 만들어 놓은 값들을 사용하기 위해 사용하려는 곳에 가서

[Header("Config")]

[SerializeField] private HpColorConfig colorConfig;

로 선언하고 이 colorConfig 값에 만들어 놓은 HP Color Config Asset을 넣으면 연동이 된다.

그 후 colorConfig.hpBarColors[index] 라는 식으로 사용하면 된다.

chatGPT의 도움을 받아 작성하였습니다.

[유니티][Unity] Text 보다는 TextMeshPro를 써야 하는 이유와 TextMeshProugui와 tmp_text 비교

2025-12-06T12:04:00.001+09:00

항목	Text	TextMeshPro
선명도	❌ 낮음	✅ 매우 선명
해상도 대응	❌ 깨짐	✅ 완벽
외곽선/그림자	❌ 제한적	✅ 매우 강력
성능	❌ 상대적으로 나쁨	✅ 더 좋음
숫자 전용 폰트	❌ 불편	✅ 최적화 가능

이렇게 차이가 많이 나기에 TextMeshPro를 택하는게 맞다.

TextMeshProUGUI와 TMP_Text는 조금 역할이 달라

UI는 TextMeshProUGUI를 쓰고 TMP_Text는 부모 클래스야

TextMeshProUGUI: 실제 UI에 붙는 컴포넌트로 HP바, 버튼, HUD, 데미지 숫자 전부 이걸로 써

TMP_Text는 TextMeshProUGIUI와 TextMeshPro의 공통 부모 클래스로 추상화용 타입이야. Inspector에서 붙는 컴포넌트는 아니고 스크립트에서 타입 통합용으로 사용하지.

TMP_Text text; 라고 하면

UI용 TextMeshProUGUI 일 수도 있고 3D용 TextMeshPro 일수도 있어

그래서 언제 사용하는 건데?

UI 고정일때 (HP바, HUD) TextMeshProUGUI를 쓰면

가장 안전

Inspector 연결 실수 없음

의도 명확함

UI/3D 텍스트 둘 다 받고자 하면 TMP_Text를 쓰지

공용 처리 가능하고 재사용성이 올라가지만 실수로 3D TMP랑 연결될 수도 있어

chatGPT를 참조하여 만들었습니다.

[유니티][Unity] Anchor 프리셋이 좌우 Stretch일 때 HP 깍이는 에니메이션 코드(feat.DOTween)

2025-12-05T22:50:00.002+09:00

애니메이션 효과를 구현하기 위해서는 세가지 Image가 필요하다.

Background, Animation, Cur Image 가 필요하다.

여기서 백그라운드 이미지는 피 색을 7가지로 했을 경우에 curImage의 색상보다 index -1 값을 가지게 해서 마치 다음 피통을 미리 보여주는 효과를 가지게 한다.

그리고 Animation 은 피가 깍이는 효과를 애니메이션 효과를 넣어서 표현하는 것이다.

여기서 DOTween을 쓰게 되면 애니메이션을 주기위해 lerp timer를 넣어서 어쩌고 저쩌고 해서 마치 선형적으로 내려가는 듯이 보이는 효과를 주는 것을 알아서 해준다. 그래서 코드가 단순해졌다.

그리고 그 위에 현재 피통을 보여주고 피가 깍이는 순간 깍인 곳까지 바로 이동한다.

그렇게 하면 피가 깍이는 순간 바로 내려가고 내려간만큼 애니메이션 효과가 느리게 따라오면서 애니메이션 효과를 주면서 피가 깍이는 듯이 보이게 된다.

이 과정을 다른 블로그를 참조로 해서 만들었더니 대략 100줄 정도의 코드가 필요했는데 이게 Stretch 모드를 아닌 상황에서 구현이 되어 있었는데, Stretch 모드를 적용하니 먹통이 되버린 것이다...

그래서 난감했는데 제미나이에게 물어보니 DOTween을 추천해줬다. AI가 나보다 훨씬 코드를 잘 아는 이상황이 특이점이 이미 와버린듯 하다.

그래서 DOTWEEN을 적용하니 10줄로 깔끔하게 떨어져 버렸다.

아래 코드를 참조하면 된다.

public void AnimateBarWidth(float targetRatio, Color curBarColor, Color backBarColor)

{

Vector2 targetAnchorMax = new Vector2(targetRatio, mainBarRectTransform.anchorMax.y);

// -------------------------------------------------------------

// 1. [즉시 동작] 빠른 바 (mainBarRectTransform) 처리: HP 표시 및 색상 갱신

// A. 앵커를 목표 위치로 즉시 설정 (뒤쪽의 느린 바가 노출되도록)

mainBarRectTransform.anchorMax = targetAnchorMax;

// B. 빠른 바의 색상을 Presenter가 결정한 최종 색상으로 즉시 설정합니다.

if (mainBarImage != null)

{

mainBarImage.color = curBarColor;

backImage.color = backBarColor;

}

// -------------------------------------------------------------

// 2. [천천히 동작] 느린 바 (damageMarkerRectTransform) 처리: 배경 애니메이션

damageMarkerRectTransform.DOKill(true); // 이전 트윈 정리

// A. 색상 고정: 느린 바의 색상을 인스펙터에 설정된 고정 배경 색상으로 즉시 설정

// * 색상 깜빡임 로직이 모두 제거됨 *

if (damageMarkerImage != null)

{

damageMarkerImage.color = slowBarOriginalColor;

}

// B. 앵커(크기) 애니메이션 (천천히 줄어들기)

// 이 부분이 유일한 애니메이션입니다.

damageMarkerRectTransform.DOAnchorMax(targetAnchorMax, duration)

.SetEase(Ease.OutQuad);

제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity] HP bar UI 크기가 폰 화면에 따라 바뀌는 방법

2025-12-05T12:13:00.003+09:00

HP Bar를 만들었다면 게임 할 때 원하는 위치에 원하는 크기로 보이고 싶을 것이다.

그런데, 이럴수가 폰 마다 화면액정이 다 다른데, 이걸 어떻게 하나.

어떻게 하면 HP Bar 크기를 폰 크기에 상관 없이 일정하게 보여줄 수 있을까?

이렇게 하려면, 폰마다의 크기에 맞춰서 크기를 보여줘야 한다.

말하자면, 동적으로 크기가 바뀌어야 하는 것이다.

그렇게 하려면 아래와 같이 하면 된다.

Canvas scalar를 scale with Screen size로 동적으로 변경되도록 설정해준다.

체력바 Rect Transform으로 이동하여 화면 상단에 좌우로 꽉차고 위아래는 화면 크기의 5%인 HP Bar를 만든다고 치자.

1. 앵커 프리셋 설정(가장 중요)

체력바 오브젝트(예: Image 또는 Panel)의 Rect Transform으로 이동

1. Anchor Presets 버튼 클릭

2. Alt 키를 누른 채, 상단 우측에 있는 가로 스트레치(Stretch, Top) 프리셋을 선택한다.

Alt 키를 누르면 앵커와 함께 피벗(Pivot)과 포지션(Position)이 동시에 이동하여 원하는 자리에 배치됨

2. 너비 IWidth) 설정: 좌우 꽉 채우기

앵커를 가로 스트레치로 설정했기 때문에, 너비(Width)대신 Left와 Right 오프셋 값이 활성화 됨

Left: 화면 왼쪽 경계(Anchor)로 부터의 거리를 0부터 설정가능

Right: 화면 오른쪽 경계(Anchor)로 부터의 거리를 0부터 설정가능

3. 높이 (Height) 설정: 화면 높이의 5%

높이는 Canvas Scaler에 설정된 Reference Resolution을 기준으로 계산 된 값을 입력하면 됨

1. 기준 해상도 확인: Canvas Scaler에 설정된 Reference Resolution의 높이 확인 (예: 1080x1920)

2. 높이 계산: 기준 높이의 5% 계산

1920* 0.05 = 96

3. 최종 Rect Transform 값 :

Anchors: Left0, right 1(가로 스트레치)

Pivot: (0.5, 1)

Left: 0

Right: 0

Height: 96 (사용자의 Reference Resolution 에 따라 달라짐)

여기서 Height를 96으로 하드코딩해도 resolution에 따라 값이 변하는 이유는 canvas Scaler 컴포넌트의 Scale with screen size 설정을 했기 때문이다.

이렇게 설정하면, 캔버스 스케일러의 기준 해상도(Reference Resolution)에 대한 상대적인 크기로 계산해 준다.

캔버스 스케일러의 동적 스케일링 원리

1. 기준 해상도 (Reference Reolution)의 역할

96이라는 Height를 설정하면, Reference Resolution에서 96 크기를 가지는 것을 의미함

2. 유니티가 런타임에 접속한 장시의 실제 해상도를 기준 해상도와 비교하여 계산된 스케일링 계수를 캔버스 전체에 적용함

[유니티][Unity] 피벗(Pivot)과 앵커(Anchor)와 포지션(Postion)에 대하여

2025-12-05T11:29:00.002+09:00

앵커, 피벗, 위치는 유니티 UI 시스템에서 요소의 크기, 위치, 그리고 반응성을 결정하는데 사용되는 Rect Transform 컴포넌트의 세 가지 핵심 개념이다.

다양한 화면 크기(해상도)에 대응 하는 UI를 만들 때 매우 중요하다

1. 앵커(Anchor)
부모 요소(화면 또는 다른UI)의 어느 위치를 기준으로 삼을지를 결정하는 네 개의 작은 삼각형 모양의 마커이다.

UI 요소의 위치와 크기를 결정하는 기준점 또는 기준 프레임으로 부모 요소의 크기가 변할 때, 이 기준점에 고정되거나 기준점을 따라 늘어나면서 UI의 반응성(Resilience)을 결정한다.

앵커의 두 가지 주요 모드

앵커 마커가 모여 있느냐, 떨어져 있느냐에 따라 요소의 위치와 크기 작동 방식이 달라진다.

1. 고정 모드(Fixed/Grouped Anchor)

마커 상태: 앵커 마커 네 개가 한점에 모여 있음( 예: 중앙, 좌상단 등)

결과: 요소의 크기는 고정되고, 위치만 앵커를 따라 이동함. Position은 앵커를 기준으로 한 거리가 됨

2. 스트레치 모드 (Stretch/Split Anchor)

마커 상태: 앵커 마커가 서로 떨어져 있음 (예: 좌우로 떨어져 있음)
결과: 요소의 크기가 부모 요소의 크기에 따라 늘어남. Left, Right, Top, Bottom 값이 활성화 되며, 이 값들은 앵커 경계선으로부터의 패딩(Padding) 거리를 지정함

2. 위치(포지션) 및 Offset (오프셋)

위치 값은 UI 요소의 피벗(Pivot)이 앵커가 지정한 기준점 또는 기준 프레임에서 얼마나 떨어져 있는지 나타냄

앵커를 기준으로 측정되는 UI 요소의 실제 중심점 위치 (픽셀 단위)

요소의 정확한 화면상 좌표를 결정함. 앵커가 어디에 있느냐에 따라 값의 의미가 달라진다.

앵커가 고정 모드 일때는 Pos X, Pos Y로 표시되고, 앵커가 스트레치 모드일 때는 Left, Right, Top, Bottom(오프셋) 값으로 표시 된다.

Position(0,0) 이 앵커가 화면 중앙이라면 중앙을 뜻하고 좌상단이면 좌상단 모서리를 의미함

3. 피벗 (Pivot)

피벗은 UI 요소 자체 내에서 변환(크기 조절, 회전 등)이 일어나는 기준점임

요소 자체의 로컬 좌표계에서 (0,0)을 나타내는 회전 및 크기 조절의 중심점

(0,0) 부터 (1,1) 사이의 정규화 된 값으로 표현 됨. (0.5,0.5)가 기본값으로, 요소의 정중앙을 의미함

요소를 회전시키거나 스케일을 변경할 때, 이 피벗을 중심으로 변화가 일어남. 또한 Position 값이 피벗을 기준으로 측정됨.

세 요소의 관계 요약

세 가지 개념은 다음과 같은 순서로 상호작용함

1. 앵커가 부모 화면/요소 내에서 UI의 기준점/기준 영역을 정함 (어디를 따라 움직일 것인가?)

2. 위치 (Position/Offset)가 앵커 기준점에서 피벗(Pivot) 까지의 거리를 결정하여 요소의 최종 위치를 확정함 (기준으로부터 얼마나 떨어져 있을 것인가?)

3. 피벗은 요소 내에서 움직임과 변형의 중심 역할을 함 (내 안에서 어디를 중심으로 돌고 늘어날 것인가?)

따라서 화면 크기가 바뀌어 앵커의 위치가 변하면, Position 값은 유지된 채 요소의 피벗이 애어를 따라가게 되어, UI 요소가 의도한 반응성을 갖게 됨

위치는 피벗 위치를 변경 (0,0) -> (1,1) 로 하면 위치(Position)도 변경하게 된다.

위치(Position)가 피벗 위치에 따라 자동으로 변경되더라도 위치는 수동으로 지정할 필요가 있다.

위치(Position)의 가장 중요한 역할은 UI 요소의 실제 위치를 결정하는 것이기 때문이다.

1. 포지션의 핵심 역할: 배치 (Placement)

UI 요소를 앵커(Anchor)를 기준으로 원하는 곳에 놓기 위해 포지션 값을 사용함

예) 앵커를 화면 정중앙 (0.5,0.5)에 설정했다고 할 때

버튼을 중앙에서 오른쪽으로 50픽셀 떨어진 곳에 배치하고 싶다면, Pos X를 50으로 직접 입력해야 함(Pos X:50, Pos Y: 0)

이 경우에는 유니티가 Position을 자동으로 계산해 주지 않음. 개발자가 원하는 Offset(오프셋) 거리를 포지션 값으로 지정하는 것임

2. 피벗 변경은 일회성 보정

피벗을 변경하는 작업은 보통 UI 요소를 배치하는 작업 중 한 번만 이루어진다. 그 이후에는 앵커를 기준으로 포지션 값을 직접 변경하며 UI요소들을 정렬하고 배치하는 것이 주된 작업 방식임

결론은, 피벗 변경 시의 자동 조정은 위치를 고정하는 기능이고, 포지션을 수동으로 입력하는 것은 위치를 이동시키는 기능이라고 구분하여 이해하면 됨

제미나이의 도움을 받아 작성하였습니다.

[유니티][Unity][MacOS][iOS][Windows] 유니티 Windows 개발 환경에서 아이폰에 앱 빌드하기

2025-12-03T19:33:00.003+09:00

iPhone 에 빌드하려면 macOS를 이용해야만 한다.

이 제약사항으로 인해 Windows -> iPhone으로 앱 빌드하는 과정이 꽤 먼길을 가게 된다.

Git 을 이용해 코드를 받아 오게 되는데 해 보니 Unity Version Control이라는 방법도 있었다.

편한 방법을 쓰면 되겠다. 용량도 체크 해 보고

여기서 gitlab을 사용하게 됐는데 알고보니 .gitignore로 서버에 안 올릴파일과 올릴 파일을 선별하는데

이 전에 프로젝트가 2.5Gb라 큰 용량이 필요하다 했는데 .gitignore를 공식 사이트에서 unity 개발용으

로 받아온 후 서버에 올려 보니 10메가 정도 밖에 안되었다. 그래서 굳이 gitlab을 안 써도 됐을 거 같다.

이렇게 gitlab으로 윈도우즈의 코드를 올리면 그 코드를 맥에서 받을 수 있다. git 을 쓰기 때문에 이렇게 안 하면 매번 빌드 새로 할 때마다 전체코드 혹은 변경된 코드들을 일일이 usb로 복사해서 넘겨야 되는데 사실상 어렵다.

이렇게 해서 gitlab을 통해 맥북에 코드를 옮기게 되었다.

옮기다 보니 알게 된 것이 ssh key 를 통해서 git을 사용하는 게 편했다.

https로 할려고 하니 token 을 발행해야 되는데 이게 발행 시점에만 비밀번호?를 준다. 그리고 닫는 순간 이 비번을 알 수가 없다. 그리고 엄청 길어서 이걸 제대로 쳐 넣기가 어렵다. 물론 복사 붙여 넣기 하면 되는데 윈도우즈에서 복사 붙여 넣기 해서 해결 했더니 맥에서 다시 비번을 물어보는데 이걸 가져와서 쓰기가 어렵고 번거롭다. ssh key는 각 각 windows 나 맥에서 받아 쓰면 되고 한번만 입력하면 되니 편리했다.

이렇게 맥북에서 project 코드를 다 받고 유니티로 실행해 보니 아니 hierarchy에 Main Camera만 덩그러니 있는 거 아닌가.. 여기서 뭐가 잘못 됐지 하고 많이 헤맸는데 찾다찾다 보니 그냥 scene을 로딩 안해서 그랬던 것이었다. 매우 간단한데 처음 써보면 헤깔릴만 하지 않나 쉽다.

이렇게 macOS에 코드를 옮기면 이제 iOS (iPhone)에 빌드를 해 넣으면 된다.

물론 또 첨부터 이런 저런 이슈들로 한번에 안되는데 구글 AI한테 물어 보니 해결이 된다.

그렇게 iOS에서 처음으로 게임을 빌드 해 봤는데 UI가 너무 작게 나오고 터치 패드도 말을 안듣고 할 일이 참 많아졌다.

구글 AI의 도움을 받아 작성하였습니다.

[Windows] dcctrldrv.sys 라는 호환되지 않는 드라이버 때문에 메모리 무결성을 켤 수 없을 때

2025-12-02T22:33:00.003+09:00

dcctrldrv.sys를 삭제 하고 재부팅하니 동작한다.

dcctrldrv.sys는 c:\Windows\System32\ 에 있다.

삭제 후 재부팅하고

데이터 무결성은 검색에 윈도우즈 보안을 치고 들어가서 장치 보안에 가면 나타난다.

키고 재부팅하면 된다.

구글 AI 도움을 받아 작성하였습니다.

[유니티][Unity] 윈도우에서 개발 중인 iOS 게임(모바일)을 맥북에서 받아서 빌드하는 편한 방법은(gitHub,GitLab,BitBucket)

2025-12-02T20:43:00.001+09:00

웹 기반 코드 호스팅 및 협업 플랫폼을 쓰면 좋다.

GitHub,GitLab, Bitbucket은 모두 Git을 기반으로 한다.

조금씩 차이점이 있다. 이 부분은 직접 검색해 보면 좋겠다.

유니티가 용량이 커서 용량을 많이 주는 GitLab을 선택하게 될 거 같다.

이러한 플랫폼을 쓰면 굳이 usb로 윈도우 -> 맥 으로 코드를 옮기는 불편함을 없앨 수 있다.

거기다가 새로 만든 코드를 올리면 그걸 맥에서 받아서 쓰면 된다.

USB로 옮긴다면 계속해서 덮어쓰기를 해줘야 하는데 그런 작업을 안해도 된다.

구글 AI를 참조하여 만들었습니다.

[유니티][Unity][iOS] 유니티 소스 iOS 폰에서 앱 테스트 할 때 Apple Developer Program(애플 개발자 프로그램)을 사야만 되는가

2025-12-02T16:41:00.007+09:00

꼭 Apple Developer Program(애플 개발자 프로그램)을 써야만 할 필요는 없다.

아래 제약사항이 있음에도 무료로 쓰고자 한다면 쓸 수 있다.

설치 유효 기간 (가장 큰 차이): 기기에 설치된 앱은 7일 동안만 실행 가능합니다. 7일이 지나면 Xcode를 통해 다시 빌드하고 설치해야 합니다. 유료 계정은 앱이 만료되지 않습니다.
서비스 제한: 푸시 알림, Game Center, CloudKit 등 특정 유료 개발자 서비스는 사용할 수 없습니다.
배포 불가: App Store에 앱을 제출할 수는 없습니다.

구글 AI의 도움을 받아 작성하였습니다.

[유니티][Unity] 구글 애드몹 광고 개발 시에 애드몹 계정을 만들거나 활성화 해야 하나?

2025-12-01T13:15:00.008+09:00

개발 과정에서는 테스트 ID를 사용하면 되기 때문에 애드몹을 활성화할 필요가 없다.

실제로 6개월 동안 광고 게재를 하지 않으면 다시 비활성화 되기 때문에 개발 기간이 6개월 이상 걸릴 것으로 보인다면 테스트 ID로 개발 하다가 출시 직전에 애드몹을 활성화하고 애드몹 연동 테스트 및 실제 배포를 하면 된다.

샘플 ios 앱 ID

Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511

출처: https://developers.google.com/admob/ios/quick-start?hl=ko

구글 AI 도움을 받아 작성하였습니다.

[유니티][Unity] Windows 로 개발 중이던 게임 IOS로 변경하기

2025-11-30T20:33:00.001+09:00

프로젝트 오픈

File -> Build Profiles 오픈

iOS 선택 -> 우측의 Switch Platform 선택

이 후 작업이 진행되고 종료 후

iOS 옆에 Active 가 뜨는지 확인

Active가 뜨면 아래 설정을 해줘야한다.

Player Settings 설정

Edit -> Project Settings -> Player -> iOS 탭 선택 -> Other Settings 열기

하위의 Identification 하위의 Bundle Identifer 입력란 확인

com.yourcompanyname.yourappname 으로 작성해야 되고 유니크해야 한다.

영문 소문자,숫자,마침표만 사용가능함

마침표로 시작하거나 끝낼 수 없고, 숫자나 마침표로 시작은 권장하지 않음

한번 정하면 변경이 어렵기에 쉰중하게 결정 필요함

구글 AI의 도움을 받아 작성하였습니다.

[유니티][Unity] 현재 개발 중인 환경이 Windows 인지 IOS인지 Android 인지 확인하는 방법

2025-11-30T20:20:00.001+09:00

프로젝트를 연다.

File -> Build Profiles 확인

하면 다양한 OS 가 나타나는데 그 중 오른쪽에 Active 라고 적혀있는 OS가 개발 중인 OS 이다.

[유니티][Unity] Instantiate(uiPrefab) 이 화면에 안 나오는 이유

2025-11-28T22:00:00.001+09:00

uiPrefab을 연결 시켜주고 Instantiate(uiPrefab)을 해도 UI가 보이지 않았다.

이유는 연결하려는 부모 캔버스를 연결해줘야 되기 때문이다.

using UnityEngine;
using UnityEngine.UI; // UI 관련 기능을 사용하려면 이 네임스페이스가 필요합니다.

public class UIManager : MonoBehaviour
{
    // 유니티 인스펙터에서 캔버스 오브젝트를 드래그하여 할당해주세요.
    [SerializeField] private Transform parentCanvasTransform;

    // 인스턴스화할 UI 프리팹 (예: 버튼, 패널 등)
    [SerializeField] private GameObject uiPrefab;

    void Start()
    {
        // Start 시점에 UI 생성 함수 호출 예시
        SpawnUIElement();
    }

    public void SpawnUIElement()
    {
        if (parentCanvasTransform != null && uiPrefab != null)
        {
            // 1. Instantiate() 메서드를 사용하여 프리팹 생성과 동시에 캔버스의 자식으로 설정합니다.
            // 두 번째 매개변수로 부모 Transform을 전달합니다.
            GameObject newUIElement = Instantiate(uiPrefab, parentCanvasTransform);

            // 추가적으로 생성된 UI 요소의 이름이나 위치를 조정할 수 있습니다.
            newUIElement.name = "DynamicUI_Instance";
            // newUIElement.GetComponent<RectTransform>().anchoredPosition = new Vector2(0, 0);
        }
        else
        {
            Debug.LogError("Canvas Transform 또는 UI Prefab이 할당되지 않았습니다. 인스펙터를 확인해주세요.");
        }
    }
}

이렇게 parentCanvasTransform을 할당해줘야 한다.

그래서 GameObject newUIElement = Instantiate(uiPrefab, parentCanvvasTransform);

으로 부모 Transform을 전달해주면 화면에 나타나게 된다.

구글 AI의 도움을 받아 작성하였습니다.