# minyee2913 — Game Developer Portfolio > Unity·C# 게임 클라이언트 개발자 minyee2913의 포트폴리오. PC·모바일로 2027년 상반기 출시 예정인 IGNOTUS, Google Play에 출시한 발!도!!, 2020년부터 개발 중인 Minecraft Bedrock RPG 서버 Luminous Wanderlust(구 Luminous RPG) 등 프로젝트별 구현 기능과 기술 기록을 정리했습니다. Claude Code·Unity MCP 같은 AI 코딩 에이전트를 실제 개발에 활용합니다. 이 사이트는 게임 개발자 minyee2913의 포트폴리오입니다. 모든 페이지는 JavaScript 없이도 HTML 본문에 내용이 포함되도록 정적으로 생성됩니다. ## 개발자 - 소개: Unity·C# 기반 게임 클라이언트 개발자 - 주요 기술: Unity, C#, Go, TypeScript, Multiplayer, AI Systems, Claude Code - GitHub: https://github.com/minyee2913 - YouTube: https://www.youtube.com/channel/UCZQUWTcP51kOFG0TWeHnr_g - KakaoTalk Open Chat: https://open.kakao.com/me/minyee2913 - [프로필](https://human.minyee2913.net/profile): Unity·C# 게임 클라이언트 개발자 - 학력: KAIST 새내기과정학부 (2026 ~) - 학력: 선린인터넷고등학교 3년 재학 (2023 ~ 2025) - 소속·활동: 팀 네로폰 — 팀장 (1인 팀) · IGNOTUS 기획·개발 총괄 (2026 ~) - 소속·활동: KAIST 게임 개발 동아리 HAJE — 2026 하제 게임잼 1등 (2026 ~) - 소속·활동: 선린인터넷고 게임 동아리 C,Real — 구해줘 홈즈 팀장 · UI·시스템 개발 (2024) ## AI 활용 개발 AI에게 코드를 맡기는 데서 그치지 않고, 에이전트가 게임 에디터와 서버를 직접 다루게 연결하고, 지켜야 할 규칙과 검증 절차를 문서로 만들어 결과를 믿을 수 있게 합니다. - 도구: Claude Max (Claude Code · 터미널 코딩 에이전트), ChatGPT Plus, Unity MCP (Unity 에디터 ↔ 에이전트 연결), Claude Code 스킬 (반복 작업 자동화) - 바이브 코딩으로 출시까지: 발!도!!와 제발 꺼져 용사야는 바이브 코딩 프로젝트다. Unity MCP로 에디터와 연결한 에이전트가 코드를 쓰고 기획·방향·검증을 맡았다. 발!도!!는 지하 1000층, 최소 풀이 솔버, 광고 연동까지 갖춰 2026년 8월 말에 시작해 10월에 Google Play에 출시했고, 제발 꺼져 용사야는 약 나흘 만에 Android 빌드를 만들었다. - 에디터에 에이전트 연결 (Unity MCP): Unity MCP로 Unity 에디터와 AI 에이전트를 연결해, 에이전트가 프로젝트를 직접 다루며 작업하게 한다. 발!도!!, 제발 꺼져 용사야, IGNOTUS 프로젝트에 설정되어 있다. - 에이전트 작업 규칙 문서화: Luminous 서버 저장소에 에이전트용 규칙 문서를 두었다. 라이브 서버에서 재시작·접속 테스트 금지, 업스트림 병합 검증 절차, 프로토콜 변경 절차, 증거 없이 '고쳤다'라고 보고하지 않기, 측정 수치는 조건과 함께 보고하기 등을 정해 두고 에이전트와 일한다. - 게임 편집기를 에이전트가 직접 조작: 루미너스 런처 안의 UI 디자이너와 스토리 편집기에 AI 에이전트용 로컬 HTTP API를 만들었다. 에이전트가 편집기를 직접 조작해 UI와 스토리 장면을 만들 수 있고, 127.0.0.1 전용·토큰 인증·웹 페이지 요청 차단으로 안전하게 열었다. - 반복 작업을 스킬로 자동화: Claude Code 스킬을 직접 만들었다. 실행 중인 서버에 콘솔 명령을 보내고 로그를 읽는 스킬, 로컬 서버에서 실제 플레이를 녹화하고 편집해 장비 소개 영상(롱폼·숏폼·썸네일)을 만드는 스킬이 있다. - 검증까지 맡기는 개발: 이 포트폴리오 사이트는 Claude Code와 함께 다시 만들었다. 정적 생성 구조, 모든 페이지를 HTTP로 확인하는 검증 스크립트, 게임별 연출과 효과음을 에이전트와 만들고, 화면 겹침과 프레임까지 자동 측정으로 확인했다. ## 수상·활동 ([전체 목록](https://human.minyee2913.net/awards)) - 2026.08 · 출품·발표: 2026 대전 인디 게임잼 참가 · [하늘오름](https://human.minyee2913.net/projects/haneul-oreum) - 2026.05 · 수상: 2026 하제 게임잼 1등 · [내가 찻잔이라니!](https://human.minyee2913.net/projects/i-am-cup) - 2026 · 선정: 경기게임오디션 2026 학생부문 선정 · [IGNOTUS](https://human.minyee2913.net/projects/ignotus) - 2025.07 · 선정: GIGDC 2025 제작부문 본선 진출 · [IGNOTUS](https://human.minyee2913.net/projects/ignotus) - 2025 · 수상: 직업계고 창업UP 게임개발대회 은상 · [IGNOTUS](https://human.minyee2913.net/projects/ignotus) - 2025 · 출품·발표: 선린톤 11th 출품 · [Albedo](https://human.minyee2913.net/projects/albedo) - 2024.07 ~ 2025 · 외주: 한국해양과학기술원 제주연구소 「마인크래프트에서 만나는 제주바다」 외주 개발 · (주)우마공크리에이티브와 계약 · [마인크래프트에서 만나는 제주바다](https://human.minyee2913.net/projects/kiost-jeju) - 2024 · 출품·발표: 선린톤 10th 출품 · [탈귀](https://human.minyee2913.net/projects/talgwi) - 2024 · 수상: 디지털 콘텐츠 개발대회 게임 부문 금상 · 선린인터넷고등학교 교내 대회 · [KOROSHITE](https://human.minyee2913.net/projects/koroshite) - 2023.11 · 출품·발표: 2023 대한민국 SW·AI 교육 페스티벌 발표 · [유클리우드 Edge](https://human.minyee2913.net/projects/eucliwood) - 2023.07 ~ 2023.11 · 프로그램: Better Ground 게임 제작 멘토링 참여 · KRAFTON · JA Korea · [유클리우드 Edge](https://human.minyee2913.net/projects/eucliwood) - 출품·발표: UNICON 루키 부문 전시 · 전국 게임개발 동아리 연합 UNIDEV · [IGNOTUS](https://human.minyee2913.net/projects/ignotus) ## 대표 프로젝트 - [IGNOTUS](https://human.minyee2913.net/projects/ignotus): 실시간 액션과 전략적인 타일 전투가 결합된 로그라이크 덱빌딩 액션 RPG. 전투 도중 시간을 멈추고 [영역]을 전개해 스킬을 타일에 배치한다. PC(Steam)와 모바일로 2027년 상반기 출시 예정. (PC (Steam), Mobile · 개발 중 · 2027년 상반기 출시 예정 · Unity 6 (URP), C#, HLSL, Python (개발 도구)) — Markdown: https://human.minyee2913.net/projects/ignotus.md - [발!도!!](https://human.minyee2913.net/projects/baldo): 검을 발도하면 그 방향 끝까지 돌진하며 스친 적을 모두 벤다. 정해진 발도 횟수 안에 층의 모든 적을 처치하며 지하 1000층까지 내려가는 모바일 액션 퍼즐 게임. (Mobile (Android) · 출시 · Unity 6 (URP 2D, Pixel Perfect), C#) — Markdown: https://human.minyee2913.net/projects/baldo.md - [루미너스 런처](https://human.minyee2913.net/projects/luminous-launcher): Minecraft Bedrock RPG 서버 Luminous를 위해 Godot 4(.NET)로 직접 만든 전용 게임 클라이언트. 블록 월드 렌더링, 엔티티 모델·애니메이션, 서버 UI, Xbox 로그인, 설치 파일까지 갖춰 Windows·macOS·Android에서 마인크래프트 없이 바로 접속한다. (Windows · macOS · Android · 개발 중 · Godot 4.7 (.NET), C#) — Markdown: https://human.minyee2913.net/projects/luminous-launcher.md - [생존 전략!](https://human.minyee2913.net/projects/survival-strategy): 모션 그래픽을 이용한 스토리 전개와 플레이어의 행동이 다음 회차 스탯에 반영되는 액션 게임. (PC · 개발 완료 · Unity 6 (URP), C#) — Markdown: https://human.minyee2913.net/projects/survival-strategy.md - [Luminous Wanderlust](https://human.minyee2913.net/projects/luminous-wanderlust): 유물·장비·직업 특성을 조합해 나만의 전투 스타일을 만드는 반오픈월드 액션 RPG. Go 기반 서버 엔진 Dragonfly를 포크해 게임 서버와 전용 클라이언트, 게이트웨이까지 직접 개발하고 운영한다. (Minecraft Bedrock / Java 서버 + 전용 클라이언트 · 개발 중 · Go, C# (Godot 클라이언트), Java (Java Edition 게이트웨이), Python (개발 도구)) — Markdown: https://human.minyee2913.net/projects/luminous-wanderlust.md ## 게임 개발 - [IGNOTUS](https://human.minyee2913.net/projects/ignotus): 실시간 액션과 전략적인 타일 전투가 결합된 로그라이크 덱빌딩 액션 RPG. 전투 도중 시간을 멈추고 [영역]을 전개해 스킬을 타일에 배치한다. PC(Steam)와 모바일로 2027년 상반기 출시 예정. - [발!도!!](https://human.minyee2913.net/projects/baldo): 검을 발도하면 그 방향 끝까지 돌진하며 스친 적을 모두 벤다. 정해진 발도 횟수 안에 층의 모든 적을 처치하며 지하 1000층까지 내려가는 모바일 액션 퍼즐 게임. - [루미너스 런처](https://human.minyee2913.net/projects/luminous-launcher): Minecraft Bedrock RPG 서버 Luminous를 위해 Godot 4(.NET)로 직접 만든 전용 게임 클라이언트. 블록 월드 렌더링, 엔티티 모델·애니메이션, 서버 UI, Xbox 로그인, 설치 파일까지 갖춰 Windows·macOS·Android에서 마인크래프트 없이 바로 접속한다. - [제발 꺼져 용사야!](https://human.minyee2913.net/projects/goaway-knight): 마왕이 되어 카드 덱으로 몬스터를 소환하고, 마을을 점령해 보급선을 넓히며 끝없이 강해지는 용사로부터 마왕성을 지키는 모바일 역 타워 디펜스 게임. - [하늘오름](https://human.minyee2913.net/projects/haneul-oreum): 멈추지 않는 캐릭터가 적과 발판을 베어 생기는 반동만으로 우주까지 올라가는 2D 원버튼 스코어 어택 게임. - [내가 찻잔이라니!](https://human.minyee2913.net/projects/i-am-cup): 어느 날 찻잔이 되어 버린 주인공이 3D 카페 안을 뛰어다니며 재료를 모아 음료를 완성하고, 시간 안에 손님의 주문을 처리하는 2.5D 액션 게임. - [생존 전략!](https://human.minyee2913.net/projects/survival-strategy): 모션 그래픽을 이용한 스토리 전개와 플레이어의 행동이 다음 회차 스탯에 반영되는 액션 게임. - [Albedo](https://human.minyee2913.net/projects/albedo): 빛 효과로 스타일을 강조하고, 플레이어가 직접 스킬을 쓰지 않고 다른 주체에게 맡기는 방식으로 전투가 진행되는 탈출 액션 게임. - [고아의 공장](https://human.minyee2913.net/projects/orphans-factory): 부도 직전의 부모님 공장을 물려받은 주인공이 되어, 박스를 주문하고 컨베이어로 오는 물품을 포장해 출고하는 아케이드 게임. 다른 공장 게임과 달리 모든 일을 캐릭터가 직접 움직여서 한다. - [KOROSHITE](https://human.minyee2913.net/projects/koroshite): 서로 다른 스킬을 가진 캐릭터로 8인 대전과 보스전을 즐길 수 있는 PC 액션 게임. - [Hunger of War](https://human.minyee2913.net/projects/hunger-of-war): 3차 세계대전 뒤 식량 보급이 끊긴 마을들이 서로의 식량을 빼앗아 자기 마을 주민을 살리는 PC 멀티플레이 생존 대전 게임. - [탈귀](https://human.minyee2913.net/projects/talgwi): 놓고 온 물건을 찾으러 밤의 학교에 온 학생이 복도에서 귀신을 만나, 낮이 될 때까지 손전등에 의지해 도망치는 2D 공포 생존 게임. - [버튼을 눌렀더니 판타지 게임속 주인공이 되어버린 건에 대하여](https://human.minyee2913.net/projects/isekai-button): 이전 회차 플레이어의 행동이 그림자가 되어 다음 플레이에 영향을 주는 다회차 기반 로그라이크 액션 게임. - [구해줘 홈즈 김배달의 우당탕탕 대모험](https://human.minyee2913.net/projects/deliver-homez): 점프 버튼 대신 마우스 드래그로 캐릭터를 던지는 방식으로 진행되는 아케이드 플랫포머 게임. - [ECHO](https://human.minyee2913.net/projects/echo): 집에 들어온 NPC들이 벌이는 돌발 행동을 아이템으로 막아내는 아케이드 시뮬레이션 전략 게임. - [범근러쉬](https://human.minyee2913.net/projects/bumgeun-rush): 학교 친구를 등장인물로 내세운 엽기적인 감성의 러닝 아케이드 게임. - [ESCAPE THE MUSIC](https://human.minyee2913.net/projects/escape-the-music): 노트 상호작용에 따라 뒤의 플랫포머 캐릭터가 반응하는 구조의 플랫포머 리듬 게임. - [유클리우드 Edge](https://human.minyee2913.net/projects/eucliwood): 전투마다 두더지 잡기 같은 퍼즐을 진행하고, 퍼즐 성취도에 따른 버프를 받은 뒤 실시간 전투가 이어지는 퍼즐 액션 로그라이크. - [도장을 지켜라!](https://human.minyee2913.net/projects/protect-dojo): 두 플레이어가 도장에서 맞붙는 대전 격투 게임. 2라운드부터는 배경에 있던 보스가 전투에 끼어들어, 상대와 보스를 동시에 상대해야 한다. - [로프앤파이터](https://human.minyee2913.net/projects/rope-fighter): 발차기 공격과 로프 액션을 연계해 화려하게 싸우는 2D 플랫포머 액션 게임. - [스릴있는 점프게임](https://human.minyee2913.net/projects/thrilling-jump): 공중으로 뛰어올라 적을 내리찍어 처치하는 2D 점프 액션 게임. 동아리 1학년 때 만들었다. - [파머의 해피 라이프](https://human.minyee2913.net/projects/farmer-happy-life): 오염되어 가는 타일을 빠르게 이동하며 중화시켜 땅을 지키는 아케이드 퍼즐 게임. ## 마인크래프트 개발 - [Luminous Wanderlust](https://human.minyee2913.net/projects/luminous-wanderlust): 유물·장비·직업 특성을 조합해 나만의 전투 스타일을 만드는 반오픈월드 액션 RPG. Go 기반 서버 엔진 Dragonfly를 포크해 게임 서버와 전용 클라이언트, 게이트웨이까지 직접 개발하고 운영한다. - [마인크래프트에서 만나는 제주바다](https://human.minyee2913.net/projects/kiost-jeju): 한국해양과학기술원 제주연구소의 '찾아가는 해양과학교실'에서 쓰는 Minecraft Bedrock 교육 콘텐츠. 조간대 생물 채집, 생물 도감, 배양 실험 미니게임을 Script API로 개발하고 기존 기능을 유지보수했다. - [Valorant Addon](https://human.minyee2913.net/projects/valorant): 마인크래프트에서 발로란트의 캐릭터와 총기 시스템을 구현한 마인크래프트 BE 애드온 프로젝트. - [Video Particle](https://human.minyee2913.net/projects/video-particle): 영상 파일 데이터를 추출해서 마인크래프트 내 파티클로 영상을 그대로 구현하고 재생하는 외부 프로그램. - [Block Beat](https://human.minyee2913.net/projects/blockbeat): 키 입력이 아닌 마우스로 에임을 돌려 노트를 치는 마인크래프트 BE 맵 기반 리듬게임. ## 프로그램 개발 - [UnityUtils](https://human.minyee2913.net/projects/unity-utils): Unity 개발을 간소화하려고 만든 C# 공용 모듈 모음. 체력·스탯·버프·카메라 연출·사운드·데미지 표시 등을 IGNOTUS, 생존 전략! 등 여러 게임에서 함께 쓴다. - [myPage (이 포트폴리오 사이트)](https://human.minyee2913.net/projects/mypage): 지금 보고 있는 포트폴리오 사이트. React로 만들고 빌드할 때 모든 페이지를 정적 HTML로 미리 그려, JavaScript 없이도 내용이 보이고 검색엔진과 AI가 읽을 수 있게 했다. - [mcCmd](https://human.minyee2913.net/projects/mccmd): 마인크래프트 명령어처럼 생긴 문법으로 코딩해 보고 싶어서 만든 스크립트 언어. C++로 토큰 분해부터 스코프와 함수 호출까지 인터프리터를 직접 구현했다. - [2913SimpleDB](https://human.minyee2913.net/projects/2913-simple-db): 클래스 필드에 데코레이터를 붙이면 SQLite 테이블과 쿼리가 만들어지는 TypeScript 데이터베이스 패키지. 마인크래프트 서버 프레임워크 BDSX에서 쓰려고 만들어 npm에 공개했다. - [ChikChat](https://human.minyee2913.net/projects/chikchat): 실시간 채팅, 회원 관리, 로그인·회원가입, 시스템 트레이 최소화를 지원하는 PC용 채팅 앱. 과제로 만들었다. ## 기계가 읽기 쉬운 자료 - [전체 내용 한 파일 (llms-full.txt)](https://human.minyee2913.net/llms-full.txt): 프로필·수상·모든 프로젝트 상세를 한 문서로 - [전체 프로젝트 JSON](https://human.minyee2913.net/projects.json): 화면과 같은 원본 데이터 - 프로젝트별 Markdown: https://human.minyee2913.net/projects/.md (예: https://human.minyee2913.net/projects/ignotus.md) - [프로젝트 목록 페이지](https://human.minyee2913.net/projects/) - [사이트맵](https://human.minyee2913.net/sitemap.xml) --- # 프로필 minyee2913 (이강민) — Unity·C# 게임 클라이언트 개발자 2019년 마인크래프트 맵 제작으로 개발을 시작했고, 2020년부터 Minecraft Bedrock RPG 서버 Luminous Wanderlust를 지금까지 만들고 있습니다. 선린인터넷고등학교에서 대회·해커톤·동아리 프로젝트로 Unity 게임을 꾸준히 만들었고, 지금은 KAIST 새내기과정학부에 다니며 1인 팀 네로폰으로 로그라이크 덱빌딩 액션 RPG IGNOTUS를 개발하고 있습니다 (2027년 상반기 출시 목표). 액션 전투와 멀티플레이(LAN·전용 서버·Steam P2P, Photon)부터 모바일 출시, 게임 서버 개발까지 직접 다뤄 왔습니다. 2026년부터는 Claude Code 같은 AI 코딩 에이전트를 실제 개발에 깊게 쓰고 있습니다. 발!도!!는 바이브 코딩으로 Google Play 출시까지 했고, 에디터와 서버에 에이전트를 직접 연결하고 에이전트가 지킬 작업 규칙과 반복 작업용 스킬을 만들어 혼자서도 큰 프로젝트를 진행합니다. ## 학력 - 2026 ~ · KAIST — 새내기과정학부 - 2023 ~ 2025 · 선린인터넷고등학교 — 3년 재학 ## 소속·활동 - 2026 ~ · 팀 네로폰 — 팀장 (1인 팀) · IGNOTUS 기획·개발 총괄 - 2026 ~ · KAIST 게임 개발 동아리 HAJE — 2026 하제 게임잼 1등 - 2024 · 선린인터넷고 게임 동아리 C,Real — 구해줘 홈즈 팀장 · UI·시스템 개발 ## 외주 - 2024.07 ~ 2025 · 한국해양과학기술원 제주연구소 「마인크래프트에서 만나는 제주바다」 — (주)우마공크리에이티브와 계약 · 확장 기능 개발과 유지보수 ## 기술 - 게임 클라이언트: Unity 6 (URP), C#, HLSL·ShaderGraph, Cinemachine, Input System, DOTween - 멀티플레이: Netcode for GameObjects, Steamworks.NET, Photon PUN 2, PlayFab - 출시·서비스: Google Play 출시, Google Play Games, AdMob - 서버·도구: Go (Dragonfly), SQLite, WebRTC, TypeScript·Node.js, C++, Python - 마인크래프트: Bedrock Script API, BDSX, mcfunction, Blockbench - AI 활용: Claude Code, Unity MCP, 바이브 코딩, Claude Code 스킬 제작, 에이전트 작업 규칙 설계, ChatGPT - 웹: React, 정적 사이트 생성 --- # IGNOTUS > 액션 속에서, 잠시 멈춰 생각하라 > 실시간 액션과 타일 전략 전투를 결합한 로그라이크 덱빌딩 액션 RPG 실시간 액션과 전략적인 타일 전투가 결합된 로그라이크 덱빌딩 액션 RPG. 전투 도중 시간을 멈추고 \[영역\]을 전개해 스킬을 타일에 배치한다. PC(Steam)와 모바일로 2027년 상반기 출시 예정. - 페이지: https://human.minyee2913.net/projects/ignotus - 카테고리: 게임 개발 - 개발 기간: 2025.03 ~ 현재 - 개발 상태: 개발 중 - 출시 일정: 2027년 상반기 출시 예정 - 플랫폼: PC (Steam), Mobile - 장르: 로그라이크, 덱빌딩, 액션 RPG - 팀 구성: 1인 개발 - 게임 엔진: Unity 6 (URP) - 사용 언어: C#, HLSL, Python (개발 도구) - 프레임워크 / 라이브러리: Netcode for GameObjects, Unity Transport, Steamworks.NET, Google Play Games, Cinemachine, Input System, AI Navigation (NavMesh), DOTween, UnityUtils (직접 만든 라이브러리) - 주요 기술: 시간 정지 중 동작하는 타일 선택·연출, ScriptableObject 기반 아이템 데이터, ASCII 레이아웃 기반 절차적 방 조립, 런타임 NavMesh 베이크, 커스텀 URP 지형 셰이더, LAN / 전용 서버 / Steam P2P 멀티플레이, Steam Cloud · Google Play 저장 게임, 픽셀 VFX 베이킹 에디터 도구, AI 코딩 에이전트(Claude Code 등) 활용 개발 ## 프로젝트 소개 실시간 게임과 턴제 게임의 융합을 연구하면서 2025년 3월에 시작한 **1인 개발** 게임이다. 첫 커밋 다음 날 \[영역\](시간 정지) 시스템을 만들었고, 이후 카드·보드·멀티플레이·크로스플랫폼을 차례로 붙여 **PC(Steam)와 모바일(Android) 출시**를 준비하고 있다. 목표 출시 시기는 2027년 상반기다. 2D 픽셀 캐릭터가 코드로 조립한 3D 픽셀 지형 위에서 싸우는 2.5D 구성이다. 전투 중 \[영역\]을 펼치면 시간이 멈추고 플레이어 주변에 **7×7 타일**이 깔린다. 획득한 스킬을 원하는 타일에 배치하고 범위와 적 위치를 확인한 뒤 다시 실시간 전투로 돌아간다. 두 왕국 사이의 전쟁에서 패해 포로가 된 기사가 가까스로 탈출해 고향으로 돌아오지만, 왕국은 정체불명의 저주에 잠식되어 거대한 미궁이 되어 있다. 주인공은 미궁을 내려가며 저주의 원인과 남겨진 인물들의 이야기를 마주한다. 2026년 6월부터는 **Claude Code 같은 AI 코딩 에이전트**를 개발 과정에 적극적으로 활용하고 있다. ### 주요 특징 - 실시간 액션 + 타일 기반 전략 전투 - 전투의 시간을 멈추는 핵심 시스템 \[영역\] - 원하는 위치에 직접 배치하는 다양한 스킬 - 스킬과 키워드의 상호작용을 활용하는 로그라이크 덱빌딩 - 무기 공격과 스킬을 연결하는 실시간 전투 - 플레이할 때마다 달라지는 스킬 조합과 빌드 - 저주에 잠식된 왕국과 그 안에 남겨진 인물들의 이야기 - 평상시와 전투 돌입 후 분위기가 변화하는 인카운터 연출 ## 게임 플레이 - 에너지가 초당 10씩 차고, 100을 넘길 때마다 \[영역\] 전개 횟수가 1 쌓인다. 전투 중 \[영역\]을 펼치면 시간이 멈추고, 스킬을 타일에 끌어다 놓거나(또는 눌러서 추천 위치에 자동 배치) 발동한다. - 무기 슬롯은 4개다. 슬롯마다 무기, 스크롤(영역 밖에서 쓰는 무기 능력), 스킬 목록이 묶여 있고, 무기를 바꾸면 대시와 강제 공격, 짧은 슬로 모션이 이어진다. - 공격, 대시(대시 중 피격 시 피해를 무효화하는 회피, 쿨다운 10초), 방어(성공 시 반격 넉백)로 실시간 전투를 한다. - 층에 들어갈 때마다 장점과 대가가 함께 붙은 저주 카드 3장 중 하나를 고른다(5층마다는 스킬을 주는 마녀 이벤트). 필드에 오래 머물면 미궁이 카드를 강제로 하나 더 붙인다. - 층마다 보드에서 다음 방을 고르며 내려간다. 방 종류는 전투, 강적 전투, 이벤트, 보상, 상점, 휴식, 모루(스킬을 스크롤로 강화), 보스다. - 층 구간은 하층(1~5층), 중층(6~10층), 상층(11~15층), 최상층(16~20층)으로 나뉜다. 구간을 끝까지 돌파한 무기 구성은 '낙인'으로 저장되어 다음 도전에 들고 갈 수 있다. ## 개발 연혁 - 2025-03: \[영역\] 시간 정지 시스템 첫 구현, 모바일 조작 - 2025-04: Android 빌드로 전환 - 2025-06: 카드 시스템 - 2025-08: URP로 렌더 파이프라인 전환 - 2025-10: 보드(방 선택) 시스템, LAN 멀티플레이 테스트 - 2025-11: Google Play Games 연동 - 2026-04: PC·모바일 크로스플랫폼 구조로 전환 - 2026-05: 쿼터뷰 시점 작업, 헤드리스 전용 서버 - 2026-06: Claude Code 등 AI 코딩 에이전트를 개발에 본격 도입 - 2026-10: Steam 연동 (친구 로비, P2P, Cloud 저장, 리더보드) ## 설계 / 패턴 - 아이템: Item(ScriptableObject) → SkillItem / ScrollItem / WeaponItem 상속 구조, 공통 팩토리 에셋에 등록 - 전투 상태: Field / Fight / Converting 상태로 필드와 전투 전환 관리 - 스킬 훅: 선택·발동과 피격·대시·처치·필드 전환 등의 패시브 훅을 스킬이 재정의 - 퀘스트: 게임 이벤트를 보고(Report)받아 누적/최고 기록으로 진행하는 이벤트 기반 구조 - 멀티플레이: 이동은 소유자 권한, 적 AI·전투 진행은 서버 권한 - 플랫폼 분기: 저장·리더보드는 Android(Google Play Games)와 PC(Steam) 구현을 컴파일 조건으로 나눔 ## 핵심 구현 기능 ### \[영역\] 시간 정지 타일 스킬 시스템 실시간 전투 중 시간을 멈추고 7×7 타일 위에 스킬을 배치해 발동하는 핵심 전투 시스템. **구현 목적**: 실시간 액션 안에 턴제·SRPG식 판단을 넣기 위해 만든 시스템으로, 프로젝트 시작 직후부터 게임의 중심이다. **동작 방식** - 전투 상태에서 \[영역\] 전개 횟수가 있으면 전개할 수 있다. 전개하면 **전역 시간 배율(Time.timeScale)을 0으로** 만들고, 애니메이터와 \[영역\] 카메라는 시간 배율의 영향을 받지 않게 바꾼다. - 플레이어 주변에 4유닛 간격의 7×7 타일을 맵 보드 방향에 맞춰 깔고, 칸마다 아래로 레이를 쏴서 **지형 높이에 맞춘다**. 바닥이 없는 칸은 비활성화한다. - 스킬을 타일에 끌어다 놓으면 스킬이 유효 칸 조건과 범위를 표시하고, 발동 시 에너지를 쓰고 효과를 실행한다. 누르기만 하면 스킬이 추천하는 칸에 자동 배치한다. - \[영역\]을 닫으면 카메라와 시간을 되돌리고 실시간 전투로 돌아간다. 대시를 해도 \[영역\]이 닫힌다. - 멀티플레이에서는 \[영역\]이 **최대 6초**로 제한되고, **다른 플레이어도 함께 멈춘다**. 일부 적과 보스도 자신의 \[영역\]을 펼친다. **사용 기술**: Time.timeScale, Cinemachine, Raycast 지형 정렬, Netcode RPC ### 무기·스킬·스크롤 아이템 구조 ScriptableObject 상속 구조로 **스킬 108종, 스크롤 108종, 무기 19종**을 관리한다. **동작 방식** - 추상 Item(ScriptableObject) 아래에 SkillItem, ScrollItem, WeaponItem이 있고, 개별 아이템이 이를 상속해 동작을 채운다. 모든 아이템 에셋은 하나의 팩토리 데이터에 등록된다. - 스킬은 등급, 비용, 쿨다운, 배치 가능 조건, 선택·발동 로직을 정의하고, 피격·대시·처치·필드 전환 같은 상황에 반응하는 패시브 훅을 가진다. - 스크롤은 무기가 \[영역\] 밖에서 쓰는 능력이다. 스크롤마다 원본 스킬이 연결되어 있어 모루 방에서 스킬을 스크롤로 바꿀 수 있다. - 공격 범위는 이름 붙은 범위(오프셋·크기·박스/구 형태)를 재사용하고 배율만 바꿔 쓴다. 적 공격은 바닥 경고 표시로 미리 알린다. - 상태이상은 기절(치명타 확률 증가), 에어본(받는 피해 1.5배), 빙결(게이지 누적, 해제 시 저장된 피해 폭발), 화상이 있고 넉백과 8종의 가드 유형, 14종의 키워드가 있다. **사용 기술**: ScriptableObject, 추상 클래스 / override, 코루틴 ### 저주 카드와 런 구조 장점과 대가가 함께 있는 저주 카드, 층 구간, 방 선택 보드, 런 사이 성장으로 이어지는 로그라이크 루프. **동작 방식** - 저주 카드는 플레이어 강화와 적 강화를 함께 적용하는 클래스로, **일반 카드 49종과 해금형 카드 16종**이 있다. 가중치에 따라 3장을 뽑아 하나를 고른다. - 해금형 카드는 기본 가중치가 0이고, 로비의 저주 메뉴에서 재화(골드바)로 해금하거나 카드 등장 가중치를 조절한다. - 층마다 방 후보를 보드로 보여 주고, 방 가중치·등장 층 범위·최근 3개 방 제외 규칙으로 후보를 고른다. - 런 사이에는 낙인(돌파한 무기 구성), 저주, 도감, 퀘스트(14종, 이벤트 기반 진행), 출석 보상이 이어진다. 층 구간별 최고 기록은 리더보드에 올라간다. - 튜토리얼은 감옥 탈출부터 \[영역\] 전개, 마녀, 상점, 방 선택까지 단계별 입력 제한과 스포트라이트 안내로 진행하고, 컷신은 레터박스·타자기 자막을 쓰는 인게임 연출로 만들었다. 행사 시연용 데모 모드도 있다. **사용 기술**: 가중치 랜덤, PlayerPrefs / JSON 저장 ### ASCII 레이아웃 기반 절차적 방 조립 텍스트로 그린 방 레이아웃, 지역 테마, 시드로 지형 메시·충돌·소품을 코드로 조립한다. **동작 방식** - 방 레이아웃은 높이·바닥 재질·계단과 입구/출구/스폰/소품 표시를 문자 격자로 적은 텍스트다. 에디터 도구가 텍스트를 레이아웃 에셋으로 가져오고, 인스펙터에서 높이를 색으로 미리 본다. - 레이아웃과 지역 테마, 시드로 **지형 메시와 충돌 메시, 소품을 한 번에** 만들고, 레이아웃을 무작위로 좌우 반전해 변화를 준다. - 조립이 끝나면 **런타임에 NavMesh를 구워** 적 AI가 바로 길을 찾게 한다. - 시드를 네트워크 오브젝트 ID에서 뽑아 **멀티플레이의 모든 참가자가 같은 방을 조립**한다. - 원하는 방에서 바로 게임을 시작하는 방 테스트 창을 만들어 반복 작업을 줄였다. **사용 기술**: Mesh 생성, NavMeshBuilder, Custom Editor ### 인카운터 연출과 저주 셰이더 전투가 시작되면 평온하던 방이 저주에 잠식되는 연출을 셰이더와 조명으로 만든다. **동작 방식** - 전투에 들어가면 필드 음악을 멈추고 시간을 0.1배로 늦춘 뒤 글리치 효과와 층 구간별 색 효과를 서서히 켠다. - **전역 셰이더 값 하나**를 올리면 커스텀 URP 지형 셰이더가 노이즈 경계를 따라 '평온' 텍스처 아틀라스 위로 '저주' 아틀라스를 번지게 하고, 경계에 빛나는 줄기를 그린다. - 같은 값으로 횃불 색, 환경광, 카메라 배경색도 함께 바꾸고, 전투가 끝나면 모두 되돌린다. - 지형 셰이더는 SPUM 캐릭터의 픽셀 크기에 맞춘 텍셀 밀도로 포인트 샘플링하고, 정점 색 AO와 단계형 조명을 쓴다. URP Forward+를 지원한다. **사용 기술**: HLSL, URP Forward+, Volume / 포스트 프로세싱 ### 협동 멀티플레이 (개발 중) Netcode for GameObjects로 LAN, 전용 서버, Steam 친구 접속을 모두 지원하는 협동 파티 플레이. **동작 방식** - 파티가 함께 낙인을 고르고 출발한다. 서버는 게임이 시작되면 참가자 명단을 잠그고, 명단에 있는 플레이어만 재접속을 허용한다. - 접속 방식은 세 가지다: LAN 호스트(UDP 브로드캐스트로 방 검색), IP 직접 접속, 헤드리스 전용 서버(서버 빌드에서 카메라·화면 효과·터치 조작을 끔). - Steam 친구 플레이를 위해 LAN(Unity Transport)과 Steam P2P(Steam Datagram Relay)를 한 방에서 동시에 받는 **복합 트랜스포트를 직접 만들었다**. 친구 전용 로비, 초대, Rich Presence 참가를 지원한다. - **이동은 소유자 권한, 적 AI와 전투 진행은 서버 권한**으로 처리한다. 로딩·층·파티 준비·전투 상태 등은 NetworkVariable과 RPC로 동기화한다. **사용 기술**: Netcode for GameObjects, Unity Transport, Steamworks.NET, Dedicated Server **고려 사항** - 온라인·LAN 통합 테스트는 아직 진행 중이다. ### PC·모바일 크로스플랫폼과 클라우드 저장 **하나의 코드베이스**에서 PC(Steam)와 Android(Google Play Games)를 함께 지원한다. **동작 방식** - Input System에 키보드·마우스, 게임패드, 터치 조작 체계를 두고, 모바일은 직접 만든 가상 조이스틱과 화면 버튼을 쓴다. - 저장과 리더보드는 Android에서 Google Play Games(로그인, 저장 게임, 리더보드), PC에서 Steam(Cloud 저장, 리더보드)을 쓰도록 컴파일 조건으로 나눴다. - 로컬 저장은 JSON을 백업 키부터 쓰는 이중 기록으로 남기고, 로컬과 클라우드 저장이 다르면 진행도 점수가 높은 쪽을 고른다. - 모바일에서는 MSAA·SSAO·실시간 그림자를 끄고 해상도 긴 변을 1920으로 제한하며, 파티클 밀도를 낮춘다. 쓰지 않는 전체 화면 효과는 모든 플랫폼에서 꺼 둔다. **사용 기술**: Input System, Google Play Games, Steamworks.NET, URP 설정 튜닝 ### 픽셀 VFX 파이프라인 일반 파티클 이펙트를 게임의 픽셀 아트 톤에 맞추는 도구와 런타임 처리. **동작 방식** - 런타임에 파티클 텍스처를 저해상도·포인트 필터·단계 색으로 바꾼 사본을 만들어 픽셀 느낌을 낸다. - 에디터 도구로 파티클 이펙트를 게임 카메라와 같은 40° 시점에서 픽셀 스프라이트 시트로 굽는다. **검은 배경과 흰 배경에 각각 렌더링해 알파를 복원**한다. - 이펙트마다 오브젝트를 만들지 않고 방출만 하는 파티클 시스템을 쓰며, 프레임당 타격 수를 제한하고 데미지 숫자는 풀링한다. **사용 기술**: ParticleSystem, RenderTexture, Editor 도구, Object Pooling ### UnityUtils 공통 모듈 활용 직접 만든 Unity 공용 라이브러리를 서브모듈로 넣어 사용한다. **동작 방식** - 체력, 스탯(문자열 키 기반 버프 계산), 카메라 연출, 사운드, 데미지 표시, 싱글톤 같은 공통 기능을 UnityUtils에서 가져온다. - UnityUtils는 여러 프로젝트에서 반복되는 기능을 모은 라이브러리로, GitHub에 공개되어 있다. - [UnityUtils 저장소](https://github.com/minyee2913/unityUtils) ## 기술적 문제 해결 ### 시간 정지 중 타일 선택이 엉뚱한 칸을 잡는 문제 [해결] - 문제 상황: \[영역\]을 펼친 상태에서 마우스로 타일을 고르면 실제와 다른 칸이 선택됐다. - 원인 분석: \[영역\] 중에는 시간 배율이 0이라 물리 갱신이 없고 Transform 자동 동기화도 꺼져 있어서, **타일을 옮긴 뒤에도 충돌체가 이전 위치에 남아 있었다**. - 해결 과정: - **타일 선택을 물리 레이캐스트에 의존하지 않도록** 바꿨다. - 타일마다 그 타일 높이의 수평면과 마우스 광선의 교점을 구하고, 교점이 칸 안에 드는 타일 중 카메라에 가장 가까운 것을 고른다. - 범위 미리보기용 판정이 필요한 곳에서는 Transform 동기화를 직접 호출한다. - 결과: 단차가 있는 지형에서도 **시간이 멈춘 상태로 정확한 칸**을 고를 수 있게 됐다. ### 시간이 멈춘 동안 연출과 연속 발사가 멈추는 문제 [해결] - 문제 상황: \[영역\] 중에 나온 타일 연출 파티클이 멈춰 보이고, 연속 발사 스킬의 간격 대기가 시간 복귀 후 불안정했다. - 원인 분석: 파티클과 WaitForSeconds가 모두 시간 배율의 영향을 받는데, \[영역\]은 시간 배율을 0으로 만든다. - 해결 과정: - 파티클 시스템을 **시간 영향을 받는 것과 받지 않는 것 두 벌**로 두고, 시간이 멈춘 동안 나온 연출은 영향을 받지 않는 쪽으로 보낸다. - 연속 발사 간격은 직접 만든 타이머로 재고, 시간 정지 중에는 멈췄다가 풀리면 남은 시간을 이어서 쓴다. - 결과: 시간 정지 중에도 연출이 자연스럽게 재생되고, 정지 전후로 연속 발사 간격이 유지된다. ### 모바일에서 지형이 통째로 사라지는 셰이더 문제 [해결] - 문제 상황: PC에서는 정상인 커스텀 지형 셰이더가 모바일 기기에서 지형 전체를 그리지 못했다. - 원인 분석: GLES3·Vulkan에서 **half(최소 정밀도) 값이 정수 연산에 섞이면 셰이더 컴파일이 실패**했다. - 해결 과정: - 셰이더의 정밀도를 **전부 float로 통일**했다. - 적용한 기술 / 접근: HLSL, URP - 결과: 모바일에서도 지형이 정상적으로 그려진다. ### 지형이 분홍색으로 바뀌며 UI 위에 그려지는 문제 [해결] - 문제 상황: 카메라와 캐릭터 사이를 가리는 물체를 반투명하게 만드는 가림 페이드 기능이 동작하면 방 전체가 분홍색으로 변해 UI 위에 그려졌다. - 원인 분석: 방 지형 전체가 메시 하나라서 페이드 대상이 되면 방 전체가 **URP에서 지원하지 않는 레거시 투명 셰이더**로 바뀌고 투명 렌더 큐로 들어갔다. - 해결 과정: - 방을 조립할 때 지형 메시에 페이드 제외 옵션(최종 알파 1 고정)을 붙였다. - 결과: 벽·소품은 계속 페이드되고 지형은 정상 셰이더를 유지한다. ### LAN과 Steam P2P를 동시에 받을 때 연결 ID 충돌 [부분 해결] - 문제 상황: 한 방에서 LAN 플레이어와 Steam 친구를 함께 받으려면 두 전송 계층의 연결 ID가 하나의 네트워크 세션 안에서 겹치지 않아야 했다. - 원인 분석: **Unity Transport가 내부에서 Netcode의 ID 매핑을 직접 조회**하기 때문에, LAN 쪽 ID를 바꾸면 전송이 막힌다. - 해결 과정: - LAN 쪽 ID는 그대로 넘기고, **Steam 쪽 ID만 LAN과 겹치지 않는 별도 범위**(하위 32비트를 모두 1로 채운 값)를 쓰도록 했다. - 호스트는 두 전송 계층을 동시에 열고, 클라이언트는 둘 중 하나로만 접속하는 복합 트랜스포트로 묶었다. Steam을 쓸 수 없는 환경에서는 기존 트랜스포트만 쓴다. - 적용한 기술 / 접근: Netcode for GameObjects, Unity Transport, SteamNetworkingSockets - 결과: LAN과 Steam P2P 접속을 한 세션에서 받는 구조를 구현했다. - 남은 문제: 온라인·LAN 통합 테스트 항목은 아직 확인 중이다. ### 클라우드 저장이 빈 데이터로 덮어써질 위험 [해결] - 문제 상황: 게임 시작 직후 아이템 데이터가 준비되기 전에 저장이 일어나면 빈 무기 목록이 저장되어 기존 진행이 사라질 수 있었다. - 해결 과정: - **아이템 팩토리가 준비될 때까지(최대 15초) 저장을 막고**, 준비에 실패하면 계속 막아 둔다. - 로컬 저장은 백업 키부터 쓰는 이중 기록으로 남긴다. - 로컬과 클라우드(Steam Cloud, Google Play 저장 게임) 데이터가 다르면 무기 수·재화·최고 층으로 계산한 진행도 점수가 높은 쪽을 고른다. - 결과: 로드가 끝나기 전의 저장 시도는 무시되고, 기기 간 저장 충돌도 진행도가 큰 쪽으로 정리된다. ## 개발 결과 및 성과 - [선정] 경기게임오디션 2026 학생부문 선정 (2026) - [수상] 직업계고 창업UP 게임개발대회 은상 (2025) - [선정] GIGDC 2025 제작부문 본선 진출 (2025) - [출품] UNICON 루키 부문 전시 - 전국 게임개발 동아리 연합 UNIDEV 행사 ## 링크 - [Steam 스토어 페이지](https://store.steampowered.com/app/5281610/IGNOTUS/) - [Google Play 스토어 페이지](https://play.google.com/store/apps/details?id=com.minyee2913.ignotus) - [공식 Discord](https://discord.gg/Qyp2xqrczE) - [게임플레이 트레일러](https://youtu.be/lFor-bfjdXk) - [2차 시연 영상](https://youtu.be/knDdXG--Q_w) ## 미디어 - 영상: https://youtu.be/lFor-bfjdXk (IGNOTUS 게임플레이 트레일러 (개발 진행 중 버전)) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-area-skill.jpg (\[영역\]을 펼쳐 스킬 범위를 타일에 지정하는 전투 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-dungeon.jpg (미궁 탐사 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-equipment.jpg (장비와 스탯 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-weapon-slot.jpg (무기 슬롯 교체 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-shop.jpg (상점 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-floor-select.jpg (층 선택 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-encounter.jpg (인카운터 연출) - 이미지: https://human.minyee2913.net/img/games/ignotus/steam-skill-dex.jpg (스킬 도감) - 이미지: https://human.minyee2913.net/img/games/ignotus/1.jpg (모바일 버전(이전 빌드): 시간이 멈춘 상태에서 타일로 스킬 범위를 지정하는 화면) - 이미지: https://human.minyee2913.net/img/games/ignotus/2.jpg (모바일 버전: 보스 '해골 기마대장' 전투. 가상 조이스틱과 공격·특수·회피·스킬 버튼) - 이미지: https://human.minyee2913.net/img/games/ignotus/3.jpg (모바일 버전: 인트로 컷씬) - 영상: https://youtu.be/knDdXG--Q_w (IGNOTUS 2차 시연 영상) 원문 페이지: https://human.minyee2913.net/projects/ignotus --- # 발!도!! > Slash!! > 한 번의 발도로 이동과 공격을 함께 하는 1000층 액션 퍼즐 (Google Play 출시) 검을 발도하면 그 방향 끝까지 돌진하며 스친 적을 모두 벤다. 정해진 발도 횟수 안에 층의 모든 적을 처치하며 지하 1000층까지 내려가는 모바일 액션 퍼즐 게임. - 페이지: https://human.minyee2913.net/projects/baldo - 카테고리: 게임 개발 - 개발 기간: 2026.08 - 개발 상태: 출시 - 플랫폼: Mobile (Android) - 장르: 액션, 퍼즐 - 팀 구성: 1인 개발 - 게임 엔진: Unity 6 (URP 2D, Pixel Perfect) - 사용 언어: C# - 프레임워크 / 라이브러리: Google Mobile Ads (AdMob), Input System, NUnit (Unity Test Framework) - 주요 기술: 바이브 코딩 (AI 코딩 에이전트 + Unity MCP), 엔진 독립 순수 C# 규칙 코어, IDDFS 최소 풀이 솔버, 솔버 검증형 절차적 레벨 생성 (1000층), 상태 기반 실시간 힌트, 히트스톱·화면 흔들림 타격감, 보상형·전면 광고 연동 ## 프로젝트 소개 **바이브 코딩**으로 혼자 만들어 Google Play에 출시한 모바일 액션 퍼즐 게임이다(현재 버전 1.7). Unity MCP로 에디터와 연결한 **AI 코딩 에이전트**가 코드를 쓰고, 기획과 방향, 플레이 검증을 맡아 2026년 8월 말에 시작해 10월에 출시했다. '발도 한 번 = 이동 + 공격'이라는 규칙 하나로, 남은 횟수 안에 모든 적을 벨 경로를 찾는 퍼즐을 만들었다. 퍼즐 규칙은 Unity에 의존하지 않는 **순수 C# 코어**로 분리했고, 실제 플레이·조준 미리보기·힌트·자동 풀이·검증이 모두 **같은 시뮬레이터 하나**를 호출한다. 지하 1000층은 손으로 그린 튜토리얼 4층을 빼고 모두 **에디터 도구로 생성한 뒤 솔버로 최소 풀이를 검증**했고, 층마다 허용 발도 횟수를 그 최소값에 맞춰 정했다. ## 게임 플레이 - 방향을 한 번 탭하면 돌진 경로가 점선으로 미리 보이고, 같은 방향을 한 번 더 탭하면 발도한다. 8방향(대각선 포함)으로 벨 수 있다. - 발도하면 벽이나 보드 끝, 정면 방패, 버튼에 막힐 때까지 돌진하고, 경로 위의 몬스터에게 피해를 준다. - 부서지는 벽, 경로를 꺾는 거울, 같은 방향으로 이어지는 포탈, 닿으면 죽는 가시, 발도 횟수를 1 돌려주는 충전 아이템, 연결된 폭탄을 터뜨리는 버튼(3×3 범위) 같은 기믹이 층이 내려갈수록 하나씩 등장한다. - 몬스터는 일반(체력 1), 정면을 막는 방패, 체력 2의 중갑, 발도할 때마다 정해진 길을 따라 움직이는 이동형, 2×2 크기의 대형이 있다. - 모든 몬스터를 처치하면 클리어, 발도 횟수를 다 쓰거나 가시에 닿으면 실패다. 막히면 광고를 보고 지금 상태에서의 힌트를 받을 수 있다. ## 설계 / 패턴 - 어셈블리 분리: Core(엔진 참조 없는 순수 C# 규칙·솔버) / Runtime(화면·입력·저장·설정) / Editor(층 생성기·검증 도구) / Tests - 규칙 단일화: 발도 시뮬레이터 하나를 실제 플레이, 조준 미리보기, 힌트, 솔버, 검증기가 모두 공유한다 - 상태 표현: 층 상태를 비트마스크와 상태 키로 표현해 탐색 중 빠르게 복사·비교한다 - 데이터: 층 1000개를 ScriptableObject 에셋으로 두고 층 데이터베이스에서 불러온다 - 장면 구성: 씬과 UI를 코드(빌더)로 만들어 수동 배치 없이 재현할 수 있게 했다 ## 핵심 구현 기능 ### 하나의 시뮬레이터로 통일한 발도 규칙 돌진·피해·기믹 판정을 한 곳에만 구현하고, 게임의 모든 기능이 그것을 호출한다. **구현 목적**: 플레이 화면, 조준 미리보기, 힌트, 자동 풀이가 서로 다른 규칙으로 계산하면 '힌트대로 했는데 안 풀리는' 버그가 생긴다. 규칙을 한 곳에만 두어 이런 불일치를 원천적으로 막았다. **동작 방식** - 발도 시뮬레이터가 돌진 경로, 벽·방패·버튼에서의 정지, 거울 반사, 포탈 이동, 가시 사망, 충전 아이템, 폭탄 폭발, 대형 몬스터의 1회 피격을 모두 처리한다. - 규칙 코어는 **Unity를 참조하지 않는 순수 C# 어셈블리**라서 에디터 도구와 단위 테스트에서 그대로 돌릴 수 있다. - 무한 반복을 막기 위해 이동 단계 상한과 반복 감지를 두었다. **사용 기술**: C#, Assembly Definition, 비트마스크 상태 ### 1000층 절차적 생성 파이프라인 '정답 경로를 먼저 만들고 그 위에 퍼즐을 채우는' 방식으로 지하 1000층을 생성하고 솔버로 검증한다. **동작 방식** - 층 번호에 따라 보드 크기(7×7 → 최대 11×13), 목표 최소 발도 횟수(2 → 9), 몬스터 수(3 → 최대 30), 벽 비율, 특수 몬스터 비율이 커지는 난이도 곡선을 만들었다. - 벽과 기믹을 놓고, 8방향 발도를 무작위로 이어 기준 경로를 만든 뒤 **그 경로가 지나는 칸에만 몬스터를 배치**한다. - 기준 경로로 다시 재생해 살아남는 특수 몬스터는 일반 몬스터로 바꾸고, **솔버로 실제 최소 발도 횟수를 구해** 목표보다 너무 쉬운 배치는 버린다. - 허용 발도 횟수는 최소값에 여유 1회를 더하고, 10층마다는 여유 없이 딱 맞춘다. 층마다 시드를 바꿔 최대 200번까지 다시 시도한다. - 중갑(16층), 방패(28층), 충전(36층), 이동형(45층), 포탈(55층), 대형(64층), 버튼·폭탄(72층), 거울(80층) 순서로 새 요소를 소개하고, 소개 구간에서는 다른 기믹과 겹치지 않게 해 규칙이 또렷이 보이게 했다. **사용 기술**: Procedural Generation, Seeded Random, Editor 도구 ### IDDFS 최소 풀이 솔버 반복 심화 깊이 우선 탐색으로 층의 최소 발도 횟수와 그 순서를 찾는다. **동작 방식** - 깊이를 1회씩 늘려 가며 탐색하므로 처음 찾은 답이 곧 **최소 발도 횟수**다. - 한 상태에서 모든 방향을 먼저 시뮬레이션해 바로 끝나는 수가 있으면 즉시 답으로 쓰고, 나머지는 **많이 베는 수부터** 파고든다. - 한 번의 발도로 줄 수 있는 최대 피해량으로 남은 체력을 나눠, 남은 횟수로 절대 깰 수 없는 가지를 잘라낸다. - 이미 풀 수 없다고 증명된 상태를 상태 키로 기억해 다시 탐색하지 않고, 노드 예산을 넘으면 '판정 불가'로 구분해 멈춘다. **사용 기술**: IDDFS, 가지치기 (Pruning), 메모이제이션 ### 지금 상태에서 다시 푸는 힌트 힌트는 미리 저장한 정답이 아니라, 플레이어가 지금까지 둔 수를 반영해 그 자리에서 다시 푼다. **동작 방식** - 현재 상태에서 솔버를 돌려 다음 발도 방향과 '남은 발도 N회로 클리어 가능' 정보를 보여 주고, 경로를 금색으로 미리 그린다. - **광고를 보여 주기 전에 먼저 풀어 보고**, 풀 수 없는 상태면 광고를 띄우지 않는다. - 광고 전후로 상태가 바뀌었는지 확인해, 바뀌었으면 다시 풀어서 틀린 힌트를 주지 않는다. - 이미지: https://human.minyee2913.net/img/games/baldo/2.jpg (힌트 표시: '오른쪽으로 발도해보세요. (남은 발도 5회로 클리어 가능)') ### 타격감 연출 짧은 퍼즐 한 수에도 손맛이 느껴지도록 베기 순간을 강조했다. **동작 방식** - 처치 수에 비례해 길어지는 히트스톱(기본 0.035초 + 처치당 0.028초, 최대 0.16초)을 넣었다. - 픽셀 단위로 맞춘 화면 흔들림, 돌진 전 예비 동작과 잔상, 칼날 궤적·불꽃·충격 링·폭발 섬광·파편을 풀링해서 재사용한다. - Android 진동으로 상황별 짧은 피드백(20~60ms)을 준다. **사용 기술**: Hit-stop, Object Pooling, Pixel Perfect Camera - 이미지: https://human.minyee2913.net/img/games/baldo/aim.jpg (대각선 조준 미리보기 (점선이 돌진 경로)) ### 출시와 운영 기능 Google Play 출시에 필요한 광고·저장·설정·현지화를 갖췄다. **동작 방식** - 힌트는 보상형 광고, 20층마다 클리어 후 전면 광고(준비되지 않았으면 건너뜀)를 보여 준다. - 진행 상황은 JSON으로 저장하되 임시 파일과 백업 파일을 거쳐 써서 저장 중 손상을 막는다. 층별 최소 발도 기록, 클리어 횟수, 힌트 사용 여부를 남긴다. - 기기 언어에 따라 한국어·영어를 고르고, 음악·효과음 볼륨과 진동을 설정할 수 있다. - Android 대상 API 36으로 빌드한다. **사용 기술**: AdMob, JSON 저장, 현지화 - 이미지: https://human.minyee2913.net/img/games/baldo/settings.jpg (설정 화면 (음악·효과음·진동·언어)) ## 기술적 문제 해결 ### 1000개 층이 모두 풀린다는 보장 [해결] - 문제 상황: 층을 자동으로 1000개 만들면, 사람이 하나하나 풀어 보지 않고도 모든 층이 정해진 횟수 안에 풀린다는 것을 보장해야 했다. - 해결 과정: - 생성 단계에서 모든 층을 솔버로 풀어 최소 발도 횟수를 구하고, 허용 횟수를 그 값에 맞춰 정했다. - 에디터에 층 검증 창을 만들어 데이터 오류와 풀이 가능 여부를 확인한다. - 자동 테스트에서 층을 표본으로 골라 솔버가 찾은 답을 실제 게임 세션에 그대로 재생해 클리어되는지 확인한다. - 적용한 기술 / 접근: IDDFS 솔버, NUnit 테스트, Editor 검증 도구 - 결과: 규칙 테스트·기믹 테스트·솔버 일치 테스트·광고 흐름 테스트 등 29개 테스트 케이스로 규칙과 생성 결과를 검증한다. ### 광고를 봤는데 힌트를 줄 수 없는 상황 [해결] - 문제 상황: 보상형 광고를 다 본 뒤에야 풀 수 없는 상태라는 걸 알게 되거나, 광고를 보는 사이 상태가 바뀌어 틀린 힌트를 줄 위험이 있었다. - 해결 과정: - 광고를 띄우기 전에 현재 상태에서 먼저 풀이를 계산하고, 답이 없으면 광고를 띄우지 않는다. - 광고 전에 상태 서명을 저장해 두고 광고 후 비교해, 달라졌으면 다시 푼다. - 결과: 광고를 본 플레이어는 항상 지금 상태에 맞는 힌트를 받는다. ## 개발 결과 및 성과 - [출시] Google Play 출시 - Android 무료 게임으로 공개되어 있다 (버전 1.7). ## 링크 - [Google Play](https://play.google.com/store/apps/details?id=com.minyee2913.baldo) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/baldo/aim.jpg (대각선 조준 미리보기 (점선이 돌진 경로)) - 이미지: https://human.minyee2913.net/img/games/baldo/1.jpg (지하 63층. 발도 경로가 점으로 표시된 화면) - 이미지: https://human.minyee2913.net/img/games/baldo/gimmicks.jpg (거울·폭탄·방패 몬스터가 섞인 후반 층) - 이미지: https://human.minyee2913.net/img/games/baldo/2.jpg (지하 41층. 힌트를 사용한 화면) - 이미지: https://human.minyee2913.net/img/games/baldo/3.jpg (지하 15층. 발도 동작) - 이미지: https://human.minyee2913.net/img/games/baldo/tutorial.jpg (튜토리얼 1층) - 이미지: https://human.minyee2913.net/img/games/baldo/settings.jpg (설정 화면) 원문 페이지: https://human.minyee2913.net/projects/baldo --- # 루미너스 런처 > Luminous Wanderlust 전용 런처 > Luminous Wanderlust를 마인크래프트 클라이언트 없이 플레이하는 Godot 전용 게임 클라이언트 (Windows·macOS·Android) Minecraft Bedrock RPG 서버 Luminous를 위해 Godot 4(.NET)로 직접 만든 전용 게임 클라이언트. 블록 월드 렌더링, 엔티티 모델·애니메이션, 서버 UI, Xbox 로그인, 설치 파일까지 갖춰 Windows·macOS·Android에서 마인크래프트 없이 바로 접속한다. - 페이지: https://human.minyee2913.net/projects/luminous-launcher - 카테고리: 게임 개발 - 개발 기간: 2026.09 ~ 현재 - 개발 상태: 개발 중 - 플랫폼: Windows · macOS · Android - 장르: 액션 RPG, 게임 클라이언트 - 게임 엔진: Godot 4.7 (.NET) - 사용 언어: C# - 프레임워크 / 라이브러리: Godot 4 (.NET), WebRTC, Godot WRY (앱 내 웹뷰), Inno Setup (Windows 설치 파일) - 주요 기술: 블록 섹션 메시 생성, Bedrock 엔티티 모델·Molang 애니메이션, Bedrock JSON UI 렌더링, 서버 권한 이동과 예측·보간, 콘텐츠 주소 기반 리소스 캐시, OAuth PKCE · Xbox XSTS 인증, Discord Rich Presence (라이브러리 없이 IPC), AI 에이전트용 편집기 API ## 프로젝트 소개 Luminous RPG 서버에 접속하기 위해 처음엔 Electron 클라이언트를 썼지만, Godot 4(.NET)로 새로 만들면서 **사실상 별도의 게임**이 되었다. 마인크래프트를 설치하지 않아도 런처 하나로 로그인하고, 서버에 접속하고, 필요한 리소스를 받아 플레이한다. 서버와는 Bedrock 네트워크를 쓰지 않는다. 서버에 내장한 게이트웨이와 직접 설계한 프로토콜로 통신하고, 블록과 엔티티는 Mojang이 공개한 기본 리소스 팩과 서버 리소스 팩을 읽어 클라이언트가 **직접 그린다**. 타이틀 화면에서 로그인과 서버 주소를 정하고, 런처 홈에서 접속자 수와 진행 중인 이벤트를 본 뒤 게임 시작 한 번으로 접속한다. 이벤트·커뮤니티·라이브·설정 메뉴가 있다. 배포 페이지에서 Windows·Android·macOS용 설치 파일을 받을 수 있다. ### 주요 특징 - Godot 4 .NET으로 만든 **독립 게임 클라이언트** (C# 약 9만 줄) - 블록 메시·바이옴 색·엔티티 모델·Molang 애니메이션을 **직접 렌더링** - Bedrock 네트워크 대신 서버 게이트웨이와 **자체 프로토콜**(WebRTC·WebSocket)로 통신 - 앱 안 **Xbox 로그인**, Discord 활동 표시, 터치 조작 - Windows 설치 마법사 · macOS 유니버설 앱 · Android APK 배포 ## 게임 플레이 - Xbox 계정으로 로그인한 뒤 게임 시작을 누르면 캐릭터가 서버에 접속한다. 기본 서버 주소가 미리 들어 있고, 타이틀 화면에서 바꿀 수 있다. - WASD 이동, 스페이스 점프, Ctrl 달리기, Shift 웅크리기, 마우스 시점, 좌·우클릭 공격·사용, 숫자 키·휠 단축 슬롯, T 채팅으로 조작한다. - 모바일에서는 터치 조작으로 플레이하고, 자동 달리기·자동 점프·조준 보조와 버튼 크기·투명도·감도를 설정할 수 있다. ## 개발 연혁 - 2026-09: Godot 클라이언트로 새로 시작, 런처 배포 페이지와 릴리스 1.0.0 (Windows·Android·macOS) ## 설계 / 패턴 - Core: 경로, 사용자 설정, 팩 JSON 파싱, 로그 - Net: 주소 정규화, 리소스 목록 동기화, 플레이 세션(접속·이동·섹션·행동·종료), 연결 품질 - Auth: Microsoft/Xbox 로그인, 기억한 토큰 암호화 저장 - Resources: 기본+서버 팩 스택, 블록 아틀라스, 바이옴 색, 번역 - World / Entities: 섹션 메시·조명·안개·구름·시간대, 엔티티 모델·애니메이션 - Game / UI / JsonUi: 세션 루프, 이동 예측, 런처 화면·HUD·서버 폼 - Dev: 클라이언트 안에서 쓰는 스토리 편집기·던전 편집기·UI 디자이너 ## 핵심 구현 기능 ### 블록 월드와 엔티티를 직접 그리는 렌더러 마인크래프트 엔진 없이 Bedrock 리소스 팩을 읽어 월드를 그린다. **동작 방식** - 블록 아틀라스를 만들고, 섹션 단위로 메시를 만든다. 가려진 면 제거, 조명 곡선, 면별 음영, 바이옴 색을 적용하고 정육면체·교차형 식물·반 블록·액체 모양을 지원한다. - 바이옴 색은 색 지도와 색조 규칙을 따라 계산하고, 안개·구름·시간대·색 보정으로 분위기를 낸다. - 엔티티는 Bedrock 모델과 애니메이션을 읽고 Molang 식을 계산해 움직인다. Molang 의미 검사 하네스로 결과를 확인한다. - Mojang이 공개한 기본 리소스 팩은 설치 파일에 넣지 않는다. 실행할 때 공식 저장소의 최신 리비전을 확인해 바뀌었을 때만 받고, 검증을 통과해야 교체한다. 실패하면 이전 팩을 그대로 쓰고, 한 번 받은 뒤에는 오프라인에서도 실행된다. **사용 기술**: Godot 4, Molang ### 서버 게이트웨이와 자체 프로토콜 **동작 방식** - 서버에 내장한 게이트웨이와 WebRTC 또는 WebSocket으로 직접 설계한 프로토콜을 주고받는다. Bedrock 패킷은 이 연결로 오가지 않는다. - 이동은 서버가 최종 결정하고, 클라이언트는 이동·블록 예측과 보간으로 지연을 가린다. 지형 섹션은 받는 속도를 조절하며 스트리밍한다. - 서버 리소스는 SHA-256 콘텐츠 주소로 캐시하고, 모두 받은 뒤 한 번에 활성화해 중간 상태가 섞이지 않게 했다. - 서버가 보내는 Bedrock JSON UI(HUD, 채팅, 폼)를 클라이언트가 해석해 그린다. **사용 기술**: WebRTC, WebSocket, SHA-256 ### 앱 안 Xbox 로그인과 Discord 활동 표시 **동작 방식** - 로그인 화면의 Xbox 로그인 버튼을 누르면 Microsoft 계정 페이지가 외부 브라우저 없이 앱 안에서 열린다. 데스크톱은 네이티브 웹뷰, Android는 APK에 넣은 로그인 플러그인을 쓴다. - 인증 코드 + PKCE(S256), 무작위 state, 콜백 주소 정확 일치를 지키고 Xbox 사용자 토큰과 XSTS를 검증한다. 런처는 비밀번호 입력 화면을 직접 만들지 않는다. - Windows·macOS에서는 Discord 데스크톱 앱과 로컬 IPC로 직접 통신해, 라이브러리 없이 '런처 / 리소스 받는 중 / 플레이 중'과 레벨·직업·던전 정보를 Discord 활동에 띄운다. 설정에서 끌 수 있다. **사용 기술**: OAuth 2.0 PKCE, Xbox Live, Discord IPC ### 세 플랫폼 배포 **동작 방식** - Windows는 설치 경로·바로가기·제거 프로그램을 갖춘 설치 마법사로 배포하고, 필요한 WebView2 런타임 설치기를 함께 넣었다. 업그레이드하거나 지워도 설정·받은 리소스·로그인 정보는 사용자 폴더에 남는다. - macOS는 Intel과 Apple Silicon을 함께 담은 유니버설 앱으로 만들고, DMG·PKG 설치 파일을 만든다. 패키징 전에 앱 서명과 실제 실행을 검사한다. - Android는 arm64 APK로 빌드한다. ### 자동 검사와 에이전트용 편집기 API **동작 방식** - 리소스 → 접속 → 지형 → 폼 → 종료까지 이어지는 헤드리스 통합 검사를 돌리고, 같은 과정을 화면에 그려 스크린샷으로 남길 수 있다. - 렌더링·메시·파티클·HUD 성능, 섹션 스트리밍, 폼 회귀, 그래픽 설정 등을 확인하는 검사 장면을 따로 두었다. - 클라이언트 안의 UI 디자이너와 스토리 편집기는 **AI 에이전트가 직접 조작할 수 있는 로컬 HTTP API**를 연다. 127.0.0.1에서만 열리고, 편집기가 만든 토큰이 있어야 하며, 웹 페이지에서 온 요청은 거부한다. ## 기술적 문제 해결 ### 접속 직후 엔티티가 늦게 보이고 메모리를 많이 쓰던 문제 [해결] - 문제 상황: 상태 응답이 한 프레임씩 늦게 적용되고 메모리를 많이 썼다. 접속 직후 다른 엔티티 모델이 몇 초 동안 보이지 않았다. - 원인 분석: 엔티티 모델 준비가 리소스 팩 색인 작업 뒤에 한 줄로 서 있었고, 그 색인이 접속한 뒤에야 시작됐다. 지형 데이터와 상태 처리에도 불필요한 복사와 할당이 많았다. - 해결 과정: - 리소스를 준비하는 동안 엔티티 색인을 미리, 병렬로 만들어 두게 했다. - 도착한 프레임에 바로 응답을 적용하고, 지형 배열과 섹션 인코딩 형식을 줄였다. - 결과: 개발 PC의 로컬 서버에 WebRTC로 접속해 같은 위치·입력으로 반복 측정한 결과다. 휴대폰에서는 따로 측정하지 않았다. | 항목 | 개선 전 | 개선 후 | | --- | --- | --- | | 접속 후 첫 엔티티 모델 표시 | 3.1 s | 중앙값 60~130 ms | | 상태 왕복 RTT p50 (로컬 서버) | 12.3 ms | 6.0 ms | | 클라이언트 관리 힙 (GC 후) | 643 MB | 191 MB | ## 링크 - [런처 다운로드 (Windows·Android·macOS)](https://luminousrpg.github.io/luminous_launcher/) - [루미너스 런처 배포 페이지](https://luminousrpg.github.io/luminous_launcher/) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/luminous-launcher/title.jpg (타이틀 화면) - 이미지: https://human.minyee2913.net/img/games/luminous-launcher/home.jpg (런처 홈: 접속자, 진행 중인 이벤트, 게임 시작) - 이미지: https://human.minyee2913.net/img/games/luminous-launcher/ingame.jpg (런처로 접속한 게임 화면 (마을 NPC와 HUD)) 원문 페이지: https://human.minyee2913.net/projects/luminous-launcher --- # 제발 꺼져 용사야! > RAISE YOUR LEGION. DEFEND YOUR CITADEL. > 마왕이 되어 카드로 몬스터를 소환해 용사를 막는 세로형 모바일 역(逆) 타워 디펜스 마왕이 되어 카드 덱으로 몬스터를 소환하고, 마을을 점령해 보급선을 넓히며 끝없이 강해지는 용사로부터 마왕성을 지키는 모바일 역 타워 디펜스 게임. - 페이지: https://human.minyee2913.net/projects/goaway-knight - 카테고리: 게임 개발 - 개발 기간: 2026.09 - 개발 상태: 프로토타입 - 플랫폼: Mobile (Android) - 장르: 역 타워 디펜스, 카드, 전략 - 팀 구성: 1인 개발 - 게임 엔진: Unity 6 - 사용 언어: C# - 프레임워크 / 라이브러리: Input System, ScriptableObject 데이터 - 주요 기술: 바이브 코딩 (AI 코딩 에이전트 + Unity MCP), 자동 전투 시뮬레이션, 보급선(연결된 거점) 판정, JSON 이어하기 저장, 한국어/영어 현지화, Android 진동(JNI), 에디터 자동 검사·빌드 도구 ## 프로젝트 소개 용사가 고향에서 출발해 마을 세 곳을 지나 마왕성으로 쳐들어오고, 플레이어는 마왕이 되어 몬스터 카드로 그 길을 막는다. 전투는 자동으로 진행되고 플레이어는 **어떤 카드를 언제, 어디에 쓸지**만 고른다. 용사는 쓰러뜨려도 더 강해져서 다시 살아나기 때문에 승리 조건이 없고, 마왕성이 버틴 시간과 성과로 점수를 겨룬다. 한국어와 영어를 지원하며, Android 빌드를 기준으로 만들었다. **바이브 코딩** 프로젝트다. Unity MCP로 에디터와 연결한 **AI 코딩 에이전트**가 코드를 쓰고, 혼자 기획과 방향, 검증을 맡아 약 나흘 만에 Android 빌드까지 만들었다. ## 게임 플레이 - 슬라임 6장으로 시작하는 덱에서 4장을 손에 들고, 카드를 누르면 마나를 써서 가장 앞쪽 거점에 몬스터를 소환한다. 마나는 초당 1씩 차고, 몬스터가 죽으면 비용을 돌려받는다. - 용사 레벨이 오를수록 해골, 해골 검사, 유령 카드가 차례로 열린다. 카드는 끌어서 버릴 수 있다. - 마을을 점령하면 소환 거점이 되지만, **마왕성까지 이어진 마을만** 보급선으로 쓸 수 있다. - 영혼을 모으면 강화 3개 중 하나를 고른다. 용사는 베기·처형·돌진·방어·흡혈·광폭화·성검 같은 스킬과 장비로 점점 강해진다. - 점수는 생존 시간, 용사 처치, 마을 점령, 강화 획득으로 쌓이고 최고 기록 5개와 최근 기록 5개를 저장한다. ## 핵심 구현 기능 ### 카드 소환과 보급선 규칙 마나로 몬스터 카드를 쓰고, 마왕성과 이어진 점령 마을에서만 소환할 수 있게 한 핵심 규칙. **동작 방식** - 덱에서 4장을 손패로 유지하고, 카드를 쓰면 마나를 차감해 가장 앞쪽의 연결된 거점에 몬스터를 소환한다. - 점령한 마을 중 **마왕성까지 끊기지 않고 이어진 마을만** 보급선으로 인정해, 마을을 어디까지 지킬지가 전략이 되게 했다. - 몬스터가 죽으면 소환 비용을 돌려받아 공격적인 소환을 부담 없이 시도할 수 있다. **사용 기술**: ScriptableObject (카드·몬스터 데이터) - 이미지: https://human.minyee2913.net/img/games/goaway-knight/card-draw.jpg (카드를 뽑아 몬스터를 소환하는 화면) ### 성장하는 용사와 강화 선택 쓰러뜨릴수록 강해지는 용사와, 영혼을 모아 고르는 강화로 끝없는 생존 구조를 만든다. **동작 방식** - 용사는 레벨에 따라 스킬과 장비를 얻고, 쓰러지면 더 강해진 상태로 부활한다. - 영혼을 모으면 약 37종의 강화 효과 중 3개가 제시되고 하나를 고른다. - 마왕성 근처에서는 4초마다 포격이 떨어져 마지막 방어선 역할을 한다. ### 데이터 기반 구성과 에디터 도구 카드·몬스터·마을·강화·용사 스킬과 장비를 ScriptableObject 데이터로 분리하고, 검사·빌드를 에디터 도구로 자동화했다. **동작 방식** - 게임 설정, 카드, 몬스터, 강화, 마을, 용사 장비와 스킬을 각각 데이터 에셋으로 두어 코드 수정 없이 밸런스를 바꿀 수 있다. - 덱·마나·보급선·부활·번역 키를 한 번에 검사하는 에디터 메뉴를 만들었다. - 장면과 데이터를 코드로 생성하는 도구와, 그래픽 없이 Android 빌드를 만드는 빌드 스크립트를 두었다. **사용 기술**: Custom Editor, Headless Build ### 모바일 대응 세로 화면, 터치 조작, 짧은 진동 피드백, 자동 저장으로 모바일 플레이에 맞췄다. **동작 방식** - 세로 고정 화면에 카드 손패를 아래에 두고, 전투 장면은 카메라 확대·히트스톱·흔들림으로 타격감을 준다. - Android 진동 API를 JNI로 직접 호출해 14~46ms의 짧은 진동을 상황별로 낸다. - 진행 상황을 JSON으로 자동 저장해 앱을 다시 열어도 이어서 할 수 있다. - 241개 문구를 한국어·영어로 현지화하고, 설정에서 언어를 바꿀 수 있다. **사용 기술**: JNI, JSON 저장, 현지화 ## 미디어 - 이미지: https://human.minyee2913.net/img/games/goaway-knight/title.jpg (타이틀 화면) - 이미지: https://human.minyee2913.net/img/games/goaway-knight/gameplay.jpg (플레이 화면: 용사가 마을을 지나 마왕성으로 진격한다) - 이미지: https://human.minyee2913.net/img/games/goaway-knight/card-draw.jpg (카드로 몬스터를 소환하는 화면) - 이미지: https://human.minyee2913.net/img/games/goaway-knight/result.jpg (마왕성 함락 후 점수 결과 화면) - 이미지: https://human.minyee2913.net/img/games/goaway-knight/gameplay-en.jpg (영어 설정 플레이 화면) 원문 페이지: https://human.minyee2913.net/projects/goaway-knight --- # 하늘오름 > 베는 반동으로만 하늘을 오르는 2D 원버튼 상승 게임 (2026 대전 인디 게임잼) 멈추지 않는 캐릭터가 적과 발판을 베어 생기는 반동만으로 우주까지 올라가는 2D 원버튼 스코어 어택 게임. - 페이지: https://human.minyee2913.net/projects/haneul-oreum - 카테고리: 게임 개발 - 개발 기간: 2026.08 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 액션, 스코어 어택, 원버튼, 게임잼 - 팀 구성: 4인 팀 (커밋 기록 기준 분담: 플레이어·연출·사운드 / 타이틀·HUD·콤보 / 적·발판 / 프로젝트 설정) - 담당 역할: 플레이어 이동·조작 시스템, HTML 프로토타입, 연출·사운드·포스트 프로세싱, 구간별 난이도·스폰, 튜토리얼, 빌드·통합 - 기여도: 커밋 125개 중 51개 - 게임 엔진: Unity 6 (URP 2D) - 사용 언어: C#, JavaScript (프로토타입) - 프레임워크 / 라이브러리: Input System, Cinemachine, DOTween, UnityUtils (직접 만든 라이브러리) - 주요 기술: 반동 기반 물리 이동, HTML5 Canvas 프로토타입, 고도별 볼륨·BGM 블렌딩, 구간별 스폰 가중치 ## 프로젝트 소개 2026 대전 인디 게임잼에서 4인 팀으로 사흘 동안 만든 게임이다. 기획서 이름은 INFINITY MOVE였고, 최종 타이틀은 '하늘오름'이다. 캐릭터는 멈추지 않고 움직이며, 플레이어는 **벨 방향만 정한다**. 베면 반대 방향으로 튕겨 나가는 반동으로 이동하기 때문에, 무엇을 어느 각도로 벨지가 곧 조작이다. 팀에서 **플레이어 이동·조작의 핵심 시스템**을 맡았고, 이를 위해 엔진 작업 전에 HTML 프로토타입으로 조작감을 먼저 검증했다. ## 게임 플레이 - 왼쪽 버튼을 누른 채 끌어 120도 부채꼴 베기 방향을 정하고, 놓으면 벤다. 조준하는 동안에는 시간이 느려진다. - 적이나 고정 발판을 베면 강한 반동, 벽만 베면 약한 반동이 생긴다. 벽이나 몸통에 부딪히면 방향이 바뀌고, 곧게 날아가면 속도가 붙는다. 중력은 없다. - 목표물을 벨 때만 콤보가 오르고, 콤보 게이지는 시간이 지나면 줄어든다. 벽이나 몸통에 부딪히면 콤보가 끊기고 게이지가 깎인다. - 게이지가 0이 되거나 바닥으로 떨어지면 끝난다. 목표는 우주를 포함한 세 구간을 지나 100,000m까지 오르는 것이다. ## 핵심 구현 기능 ### 베기 반동 이동 시스템 조준한 방향의 반대로 튕겨 나가는 반동만으로 움직이는 플레이어 핵심 시스템. **구현 목적**: 중력도 점프도 없이 '베는 행동' 하나로 이동·전투·생존을 모두 하게 만드는 게임의 중심 규칙이다. **동작 방식** - 누른 채 끌어 베기 방향을 정하는 동안 시간을 느리게 하고, 조준선으로 120도 베기 범위를 보여 준다. - 벤 대상(적·고정 발판·벽)에 따라 반동 세기를 다르게 주고, 벽과 몸통 충돌에서는 튕김으로 방향을 바꾼다. - 곧게 날아가는 동안 속도를 조금씩 올려, 반동을 이어 갈수록 빨라지게 했다. - 프로토타입에서 맞춘 수치와 조준선 표현을 그대로 Unity로 옮겼다. **사용 기술**: Rigidbody2D, Input System, Time Scale - 이미지: https://human.minyee2913.net/img/games/haneul-oreum/guide.jpg (베기(ATTACK)와 반동(RECOIL), 속도 방향을 설명하는 튜토리얼 그림) ### HTML 프로토타입으로 조작감 먼저 검증 잼 초반에 브라우저에서 바로 돌아가는 프로토타입을 만들어 반동 조작감을 팀과 함께 맞췄다. **동작 방식** - HTML5 Canvas와 JavaScript로 베기·반동·적 부활·벽 반사를 구현하고, 반동 세기 같은 수치를 한곳에 모아 바로 바꿔 볼 수 있게 했다. - 디버그 표시와 즉시 재시작으로 수치를 빠르게 반복 조정했다. - 검증한 수치를 Unity 플레이어 물리와 조준선에 옮겨, 엔진 구현 전에 핵심 재미를 확인했다. **사용 기술**: HTML5 Canvas, JavaScript - 이미지: https://human.minyee2913.net/img/games/haneul-oreum/prototype.jpg (직접 만든 HTML 프로토타입: 조준 중 화면 (속도·시간·베기 횟수 표시)) ### 고도에 따라 바뀌는 연출과 난이도 높이 올라갈수록 화면 분위기, 음악, 적 구성이 바뀐다. **동작 방식** - 구간별 배경 음악을 나누고, 고도에 따라 포스트 프로세싱 볼륨을 섞어 하늘에서 우주로 넘어가는 분위기를 만들었다. - 팀원이 만든 적 스폰 시스템에 난이도 곡선과 구간별 스폰 가중치를 더해, 올라갈수록 적 구성이 바뀌게 했다. - 콤보 궤적, 목표물 강조, 피격 이펙트와 데미지 표시, 베기 애니메이션과 카메라 흔들림으로 타격감을 더했다. **사용 기술**: URP Volume, Cinemachine ### 튜토리얼과 통합·빌드 첫 플레이를 위한 튜토리얼 흐름을 만들고, 게임 씬을 조립해 최종 빌드까지 맡았다. **동작 방식** - 튜토리얼 흐름과 게임 오버 낙하 연출을 구현했다. - 팀원들의 작업을 게임 씬에 합치고 다수의 Pull Request를 병합해 최종 빌드를 만들었다. - 공용 유틸리티(싱글톤, 사운드, 카메라 연출, 데미지 표시 등)를 프로젝트 초기에 넣어 팀이 함께 썼다. ## 링크 - [플레이 영상](https://youtu.be/PxXznDr4lW0) ## 미디어 - 영상: https://youtu.be/PxXznDr4lW0 (하늘오름 플레이 영상) - 이미지: https://human.minyee2913.net/img/games/haneul-oreum/title-bg.jpg (타이틀 배경 아트) - 이미지: https://human.minyee2913.net/img/games/haneul-oreum/prototype.jpg (HTML 프로토타입 플레이 화면) - 이미지: https://human.minyee2913.net/img/games/haneul-oreum/guide.jpg (튜토리얼 조작 안내 그림) 원문 페이지: https://human.minyee2913.net/projects/haneul-oreum --- # 내가 찻잔이라니! > 찻잔이 되어 카페 주문을 처리하는 2.5D 액션 게임 (2026 하제 게임잼 1등) 어느 날 찻잔이 되어 버린 주인공이 3D 카페 안을 뛰어다니며 재료를 모아 음료를 완성하고, 시간 안에 손님의 주문을 처리하는 2.5D 액션 게임. - 페이지: https://human.minyee2913.net/projects/i-am-cup - 카테고리: 게임 개발 - 개발 기간: 2026.04 ~ 2026.05 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 액션, 2.5D, 게임잼 - 팀 구성: 4인 팀 (커밋 기록 기준 분담: 게임플레이 프로그래밍 / UI·데이터·스토리 / 맵 제작 / 초기 프로토타입) - 담당 역할: 게임플레이 프로그래밍 전반, 보스전, 연출, 공용 유틸리티 - 기여도: 커밋 64개 중 37개 - 게임 엔진: Unity 6 (URP) - 사용 언어: C# - 프레임워크 / 라이브러리: Cinemachine, Input System, DOTween, UnityUtils (직접 만든 라이브러리) - 주요 기술: 2.5D 평면 이동과 평면 회전, ScriptableObject 레시피 데이터, LineRenderer 절차적 로프, 보스 패턴 상태 머신 ## 프로젝트 소개 2026 하제 게임잼에서 4인 팀으로 사흘 동안 만들어 **1등**을 한 게임이다. 2D 스프라이트 찻잔이 3D 카페 공간을 평면처럼 이동하고, 회전 지점에서 이동 평면을 90도씩 돌려 카페 구석구석을 오간다. 팀에서 **게임플레이 프로그래밍 전반**을 맡아 플레이어, 주문·제조 루프, 상호작용, 보스전, 연출을 구현했다. ## 게임 플레이 - 손님이 들어와 무작위 메뉴를 주문하면 제한 시간이 시작된다. 제한 시간은 120초에서 주문마다 10초씩 줄어 최소 30초까지 짧아진다. - 찻잔이 재료와 기계 단계를 순서대로 모으면 음료가 완성된다. 레시피는 에스프레소, 라테, 에이드, 스무디, 차 등 16종이다. - 카운터의 벨을 울려 음료를 내면, 맞으면 손님이 마시고 틀리면 찻잔을 던진다. 시간이 다 되면 손님이 카운터를 내리쳐 피해를 입는다. - 높은 곳에서 떨어지면 높이만큼 피해를 입고, 개수대에서 씻으면 회복하지만 모은 재료가 사라진다. 로프와 로켓으로 이동할 수도 있다. - 부엌칼을 들고 빈손으로 벨을 울리면 손님과의 보스전이 시작된다. 손님은 조준 공격과 찻잔 던지기를 쓰고, 몸에 생기는 약점을 부숴야 한다. ## 핵심 구현 기능 ### 주문·제조 루프 손님 주문, 제한 시간, 재료 수집, 음료 판정, 제출 연출로 이어지는 게임의 기본 흐름. **동작 방식** - 재료·기계·주문을 ScriptableObject로 정의하고, 찻잔이 모은 순서가 레시피와 맞으면 음료로 바꾼다. - 주문마다 제한 시간이 10초씩 줄어 점점 바빠지도록 했다. - 정답이면 손님이 찻잔을 들어 마시고, 오답이면 찻잔을 던지는 장면을 DOTween으로 연출했다. - 상황에 따라 번호가 붙은 상호작용 안내를 동적으로 띄워, 숫자 키로 고르게 했다. **사용 기술**: ScriptableObject, DOTween - 이미지: https://human.minyee2913.net/img/games/i-am-cup/order.jpg (주문 화면: 주문 번호와 메뉴, 남은 시간, 레시피 버튼) ### 2.5D 이동과 카메라 3D 공간 안에서 2D 찻잔이 평면 이동하고, 회전 지점에서 이동 평면을 돌린다. **동작 방식** - 찻잔은 자신의 오른쪽 축을 따라 좌우로 움직이고, 회전 지점이나 비누 버프로 이동 평면을 90도 회전한다. - 점프, 대시, 낙하 높이에 비례한 피해를 구현했다. - Cinemachine 카메라가 레이캐스트로 벽을 피해 찻잔을 따라간다. **사용 기술**: Cinemachine, Raycast ### 절차적 로프 마우스로 조준해 쏘는 로프를 여러 가닥의 LineRenderer로 그렸다. **동작 방식** - 로프를 여러 가닥으로 나눠 나선형으로 꼬고 Perlin 노이즈로 흔들어 살아 있는 느낌을 냈다. - 마우스 광선을 플레이어의 이동 평면에 투영해 2.5D 공간에서도 정확히 조준한다. **사용 기술**: LineRenderer, Perlin Noise ### 손님 보스전 쿨다운 기반 패턴과 예고 공격, 약점 파괴로 진행되는 보스전. **동작 방식** - 손님이 쿨다운에 따라 조준 공격과 찻잔 던지기를 고르고, 공격 전에 예고 표시를 띄운다. - 손님 몸에 약점이 생기고, 약점을 부술 때마다 체력 100 중 10씩 깎인다. - 피격을 이벤트로 알리고 상황에 따라 취소할 수 있는 체력 컴포넌트(직접 만든 공용 라이브러리)를 썼다. - 이미지: https://human.minyee2913.net/img/games/i-am-cup/boss.jpg (손님 보스전: 식칼을 들고 손님의 공격 예고 범위를 피하는 화면) ## 개발 결과 및 성과 - [수상] 2026 하제 게임잼 1등 ## 링크 - [itch.io 페이지 (브라우저에서 플레이)](https://minyee2913.itch.io/i-am-cup) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/i-am-cup/title.jpg (타이틀 화면) - 이미지: https://human.minyee2913.net/img/games/i-am-cup/order.jpg (주문 화면: 찻잔이 된 주인공과 손님의 주문) - 이미지: https://human.minyee2913.net/img/games/i-am-cup/boss.jpg (손님 보스전) - 이미지: https://human.minyee2913.net/img/games/i-am-cup/cafe-front.jpg (스토리 컷신 아트: 카페 외관) - 이미지: https://human.minyee2913.net/img/games/i-am-cup/counter.jpg (스토리 컷신 아트: 카운터) - 이미지: https://human.minyee2913.net/img/games/i-am-cup/cafe-inside.jpg (스토리 컷신 아트: 카페 내부) 원문 페이지: https://human.minyee2913.net/projects/i-am-cup --- # 생존 전략! > 죽어도, 강해져서 다시 깨어난다 > 타이머가 끝나면 불꽃의 거인이 나타나는 3회차 루프 3D 액션 게임 (1인 개발) 모션 그래픽을 이용한 스토리 전개와 플레이어의 행동이 다음 회차 스탯에 반영되는 액션 게임. - 페이지: https://human.minyee2913.net/projects/survival-strategy - 카테고리: 게임 개발 - 개발 기간: 2025.03 ~ 2025.06 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 스토리, 액션 - 팀 구성: 1인 개발 - 게임 엔진: Unity 6 (URP) - 사용 언어: C# - 프레임워크 / 라이브러리: UnityUtils (직접 만든 라이브러리), NiloToon 예제 셰이더, ShaderGraph, UnityChan SpringBone, Cinemachine, AI Navigation, DOTween, UniVRM - 주요 기술: 카툰 렌더링, SDF 얼굴 라이팅, Blend Tree, 코루틴 컷씬, ScriptableObject, NavMesh, VRoid Studio, Blender ## 프로젝트 소개 넓은 방에서 깨어난 소녀가 타이머가 끝나면 나타나는 불꽃의 거인 이프리트에게 쓰러지고, 다시 같은 자리에서 깨어나는 회차 반복 구조의 액션 게임이다. 1·2회차는 이프리트를 쓰러뜨려도 결국 죽게 되어 있고, **3회차에서 지난 죽음의 흔적을 찾아야** 진짜 결전이 시작된다. 쓰러진 자리에는 해골이 남아 다음 회차의 단서와 무기가 된다. 만화 같은 캐릭터 표현을 위해 카툰 렌더링과 SDF 기반 얼굴 라이팅을 적용했다. ### 주요 특징 - **1인 개발** 3D 액션, 기획·코드·캐릭터·연출 전부 - 죽어도 스탯이 이어지는 **3회차 루프** 구조 - 카툰 렌더링과 **SDF 얼굴 라이팅** 셰이더 구현 - 콤보·대시를 데이터로 조합하는 **ScriptableObject 무기** - 걷는 애니메이션에 맞춰 밟는 **보스 발구르기 판정** ## 게임 플레이 - 매 회차 시작 시 캐릭터가 깨어나는 컷씬이 나온다. - 맵의 타이머(1·2회차 60초)가 끝나면 보스가 나타난다. 3회차는 지난번에 쓰러진 자리를 찾아가면 컷씬과 함께 40초 타이머가 시작된다. - 타이머가 끝나기 전 플레이어의 행동에 따라 스탯이 오르고, 이 스탯은 회차가 넘어가도 유지된다. 때리면 공격력, 점프로 물건을 차면 방어력, 여러 해골에서 무기를 주우면 민첩이 오른다. - 2회차부터 해골 유해에 놓인 무기를 F로 주워 쓸 수 있다. 좌클릭은 콤보 공격, 우클릭을 누르고 있으면 힘을 모아 들고 있는 무기를 던진다. - Shift 구르기로 공격을 피하면 잠깐 슬로 모션이 걸린다. ## 개발 연혁 - 2025-03: 개발 시작 - 2025-05: SDF 얼굴 셰이더 구현 - 2025-06: 3회차 결전과 엔딩 완성 - 2025-11: Unity 6 최신 버전으로 업데이트 ## 설계 / 패턴 - Singleton: 제네릭 Singleton\로 매니저 클래스 관리 - 상태 머신: 회차 진행(준비·전투·사망·승리·탐색)을 상태 값으로 관리 - Observer: 체력 오브젝트의 피격·가해·사망 이벤트를 구독하고, 이벤트 안에서 피해를 취소하거나 줄인다 - 모듈화: ScriptableObject 데이터만으로 다양한 무기 제작 - Component: 플레이어 기능(입력·이동·애니메이션·카메라·전투·장비)을 컴포넌트 단위로 분리 ## 핵심 구현 기능 ### 죽어도 이어지는 회차 루프와 스탯 죽음이 실패가 아니라 다음 회차를 위한 준비가 되도록 만든 게임 흐름. **동작 방식** - 죽으면 화면이 지지직거리는 글리치 효과와 함께 암전되고, 깨어나는 컷씬으로 다음 회차가 시작된다. 쓰러진 자리에는 해골이 남는다. - 스탯은 기본값과 버프(더하기·퍼센트 증가)로 계산한다. 공격이 맞을 때마다 공격력 +25%, 점프 착지로 새 물건을 찰 때마다 방어력 +0.2, 다른 해골에서 무기를 주울 때마다 민첩 +1이 붙는다. - 스탯은 게임을 시작할 때 한 번만 초기화해서 회차가 바뀌어도 유지된다. 민첩이 오르면 무기를 줍는 동작이 빨라진다. - 승리 화면에는 플레이 시간과 죽은 횟수가 나온다. ### ScriptableObject로 조합하는 무기 코드를 고치지 않고 데이터만으로 새 무기와 콤보를 만든다. **동작 방식** - 무기는 이름·모델·공격력을 가진 ScriptableObject이고, 콤보 단계마다 대기·쿨타임·슬로·화면 흔들림·피해 배율·애니메이션·범위·대시 세기와 방향·추가타를 설정한다. - 해골에 놓일 무기는 확률 가중치가 있는 무기 세트에서 고른다. 검 5종을 만들었다. - 우클릭을 누르고 있던 시간만큼(최대 1.5배) 피해가 커지는 무기 던지기는 무기를 잃는 대신 회전하며 날아가 맞힌다. **사용 기술**: ScriptableObject, Coroutine ### 보스 이프리트 **동작 방식** - NavMesh로 플레이어를 쫓고, 걷는 애니메이션의 진행도에 맞춰 왼발·오른발이 땅에 닿는 순간마다 발구르기 피해와 넉백을 준다. - 가까이 있으면 일정 간격으로 발차기를 해 더 큰 피해를 준다. - 타이머가 0이 되면 타이머 자리에서 폭발과 함께 나타나고 화면이 흔들린다. **사용 기술**: NavMeshAgent, Animator normalizedTime ### 카툰 렌더링과 SDF 얼굴 라이팅 만화 같은 캐릭터 표현을 위한 렌더링 구성. **동작 방식** - 캐릭터 재질에는 NiloToon의 공개 예제 셰이더를 써서 카툰 렌더링과 외곽선을 적용했다. - 얼굴의 명암 경계는 SDF(Signed Distance Field) 텍스처와 머리 방향·빛 방향의 각도를 비교해 정하도록 ShaderGraph로 구현했고, 머리 방향은 스크립트로 셰이더에 넘긴다. **사용 기술**: NiloToon, ShaderGraph, SDF ### 캐릭터 제작 파이프라인과 컷씬 **동작 방식** - 시간이 부족해 캐릭터 기초 모델은 VRoid Studio로 만들고 Unity에서 추가 조정했다. 필요한 모션(기상, 던지기 등)은 Blender로 제작했다. - 머리카락 물리는 Unity Japan이 공개한 UnityChanToon 프로젝트의 SpringBone을 사용했다. - 모션이 끊기는 느낌을 없애기 위해 이동·구르기 모션을 세분화하고 Blend Tree로 전환을 처리했다. - 컷씬은 코루틴으로 Cinemachine 카메라 전환, 표정(눈 깜빡임·슬픔·놀람) 변경, 대사, 효과음을 한 곳에서 순서대로 처리했다. ## 기술적 문제 해결 ### 카툰 렌더링에서 얼굴 명암이 부자연스러운 문제 [해결] - 문제 상황: 카툰 렌더링에 일반적인 빛 처리를 적용하면 얼굴 명암이 부자연스럽거나 계단 현상이 생긴다. - 원인 분석: 카툰 렌더링은 빛을 밝음과 어두움 두 단계로 나누기 때문에, 얼굴처럼 곡면이 복잡한 부위에서 경계가 거칠게 나타난다. - 해결 과정: - SDF(공간의 각 점이 경계까지 얼마나 떨어져 있는지를 거리로 표현하는 방법)를 이용한 카툰 얼굴 라이팅 기법을 조사했다. - 국내 자료를 찾지 못해 중국어 자료를 번역기로 읽으며 학습했다. - 학습한 내용을 일반 셰이더 코드보다 이해하기 쉬운 ShaderGraph로 구현했다. - 적용한 기술 / 접근: SDF 기반 거리 보정, ShaderGraph - 결과: 명암 경계선이 매끄러워지고, 빛이 닿는 경계를 자유롭게 조정할 수 있게 되었다. 최종 빌드에서는 얼굴 재질도 몸과 같은 NiloToon 셰이더로 맞췄다. ### 보스 발구르기 피해가 엉뚱하게 들어가던 문제 [해결] - 문제 상황: 이프리트가 멈춰 있을 때도 발구르기 피해가 나거나, 한 걸음에 피해가 두 번 들어갔다. - 원인 분석: 걷는 애니메이션의 진행도만 보고 판정해서, 실제로 움직이는지와 상관없이 판정이 났고 반 바퀴 지점 검사가 여러 프레임에 걸쳐 겹쳤다. - 해결 과정: - 실제로 이동 중일 때만 판정하고, 멈추면 걸음 카운터를 초기화했다. - 반 바퀴 지점 검사를 좁은 구간으로 제한해 한 걸음에 한 번만 판정되게 했다. - 발차기를 발구르기 판정에서 떼어 내 거리 조건을 따로 두었다. - 결과: 발이 땅에 닿는 순간에만 한 번씩 피해가 들어간다. ## 링크 - [GitHub](https://github.com/minyee2913/survival_strategy) - [YouTube](https://youtu.be/qY3b2b_TLA0) ## 미디어 - 영상: https://youtu.be/qY3b2b_TLA0 (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/survival_strategy/1.png - 이미지: https://human.minyee2913.net/img/games/survival_strategy/2.png - 이미지: https://human.minyee2913.net/img/games/survival_strategy/3.png 원문 페이지: https://human.minyee2913.net/projects/survival-strategy --- # Albedo > 빛 효과와 로봇 동료로 싸우는 탈출 액션 게임 (선린톤 11th) 빛 효과로 스타일을 강조하고, 플레이어가 직접 스킬을 쓰지 않고 다른 주체에게 맡기는 방식으로 전투가 진행되는 탈출 액션 게임. - 페이지: https://human.minyee2913.net/projects/albedo - 카테고리: 게임 개발 - 개발 기간: 2025 - 플랫폼: PC - 장르: 액션, 탈출 - 팀 구성: 4인 팀 (개발 3인, 아트 1인) - 담당 역할: 팀장, 광원 효과, 플레이어, 상호작용, 로봇, 맵 시스템 - 기여도: 75% - 게임 엔진: Unity - 사용 언어: C# - 프레임워크 / 라이브러리: UnityUtils (직접 만든 라이브러리) ## 프로젝트 소개 추락해 미지의 행성에 고립된 주인공이 괴물 사이에서 광물을 캐 본함에 에너지를 보내고, 그 지원으로 탈출선을 찾는 게임이다. 선린톤 11th에서 '담다'라는 주제에 맞춰 팀으로 제작했다. ## 게임 플레이 - 로봇이 플레이어를 따라다니고, 플레이어는 계속 오른쪽으로 나아가야 한다. - 광물 근처에서 우클릭을 연타해 캐고, E로 들어 로봇에게 가져가 F로 로봇 에너지를 충전한다. - 좌클릭으로 공격하고, 로봇과 상호작용하면 로봇 에너지를 써서 우주선에 스킬을 요청한다. 요청한 스킬은 주문 대기열에 담겼다가 발동된다. ## 설계 / 패턴 - Singleton: 매니저 클래스 관리 - Observer: 상황에 대응하는 이벤트 시스템 - Component: 플레이어 기능을 컴포넌트 단위로 분리 ## 핵심 구현 기능 ### 대각선 지면 이동 보정 기울어진 지면을 따라 자연스럽게 이동하도록 입력 벡터를 보정했다. **구현 목적**: 단순한 좌우 이동이 아닌 입체적인 느낌을 주기 위해 지면을 약간 대각선으로 만들었고, 플레이어 이동 경로를 지면과 맞춰야 했다. **동작 방식** - 입력 축 값에 보정값을 더해 이동 방향을 지면 기울기에 맞춘다. - 보정 수치는 직접 반복 테스트하며 맞췄다. *포트폴리오에 실은 코드 캡처를 옮겨 적음* ```csharp public void Move(Vector2 axis) { if (stopMove > 0) return; moveDelta = axis; moveDelta.y += axis.x * 0.08f; moveDelta.x -= axis.y * 0.1f; transform.Translate(moveDelta.normalized * stat.GetResultValue("moveSpeed") * Time.deltaTime); } ``` ### 로봇을 통한 스킬 요청과 대기열 **동작 방식** - 로봇 에너지를 소모해 우주선에 스킬을 요청하고, 요청된 스킬은 대기열에 담겼다가 순서대로 발동된다. ### UnityUtils 기반 공격 처리 **동작 방식** - 직접 만든 UnityUtils의 HealthObject로 대상에게 데미지를 주는 방식으로 공격 코드를 간결하게 처리했다. - [UnityUtils 저장소](https://github.com/minyee2913/unityUtils) ## 기술적 문제 해결 ### 대각선 지면에서 무작위 좌표 구하기 [해결] - 문제 상황: 지면이 대각선이라 x, y를 각각 무작위로 뽑으면 맵 밖의 좌표가 나온다. - 원인 분석: 맵의 유효 범위가 축에 평행한 사각형이 아니라 기울어진 형태라서 x와 y의 범위가 서로 종속된다. - 해결 과정: - 먼저 전체 맵 범위 안에서 무작위 X 좌표를 구한다. - 그 X 좌표를 넣어 해당 위치에서 맵 범위 안에 있는 무작위 Y 좌표를 구하는 함수를 만들었다. - 적용한 기술 / 접근: 맵 X 범위 계산(GetXBoundsOfMaps), X 기준 맵 내부 좌표 계산(GetPosInMap) - 결과: 기울어진 맵 안에서 무작위 위치를 얻을 수 있게 되었다. ## 개발 결과 및 성과 - [출품] 선린톤 11th 출품작 - 주제 '담다'에 맞춰 제작 ## 링크 - [YouTube](https://youtu.be/eC4HczYUfWA) - [GitHub](https://github.com/sunrinton2025/amazing_something) - [다운로드](https://github.com/sunrinton2025/amazing_something/releases/download/dd/albedo.zip) ## 미디어 - 영상: https://youtu.be/eC4HczYUfWA (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/albedo/1.png - 이미지: https://human.minyee2913.net/img/games/albedo/2.png - 이미지: https://human.minyee2913.net/img/games/albedo/3.png 원문 페이지: https://human.minyee2913.net/projects/albedo --- # 고아의 공장 > 캐릭터가 직접 뛰어다니며 포장·출고를 해내는 아케이드 공장 게임 (1인 개발) 부도 직전의 부모님 공장을 물려받은 주인공이 되어, 박스를 주문하고 컨베이어로 오는 물품을 포장해 출고하는 아케이드 게임. 다른 공장 게임과 달리 모든 일을 캐릭터가 직접 움직여서 한다. - 페이지: https://human.minyee2913.net/projects/orphans-factory - 카테고리: 게임 개발 - 개발 기간: 2025 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 아케이드 - 팀 구성: 1인 개발 - 게임 엔진: Unity - 사용 언어: C# - 주요 기술: Blend Tree 4방향 이동, 경로 기반 컨베이어, Gizmos 경로 시각화 ## 프로젝트 소개 다른 공장 게임처럼 자동화 설비를 짓는 대신, **플레이어가 캐릭터를 직접 움직여 모든 일을 해야 하는** 아케이드 게임이다. 부도 직전의 부모님 공장을 물려받은 주인공이 공장을 살려 낸다는 이야기다. ## 게임 플레이 - 화면 오른쪽 위에 이번에 생산할 물품(PLAN 1~3)이 나온다. - 초기 자금으로 박스를 주문하고, 박스를 연 뒤 왼쪽 컨베이어로 들어온 물품을 담아 닫고 오른쪽 컨베이어로 내보낸다. - 잘못 포장하면 클레임이 늘어난다. 화면에는 남은 업무 시간, 생산량(예: 0/60), 클레임 수가 표시된다. ## 설계 / 패턴 - Singleton: 매니저 클래스 - State: 게임 진행 상태 - Observer: 플레이어 주변 오브젝트를 실시간으로 추적 ## 핵심 구현 기능 ### 4방향 이동 애니메이션 **동작 방식** - 위·아래·왼쪽·오른쪽 걷기 모션을 Blend Tree(2D Simple Directional)로 묶어 이동 방향 값만으로 전환한다. **사용 기술**: Blend Tree ### 조립식 컨베이어 **동작 방식** - 컨베이어를 방향·모양별 파츠로 나누고, 파츠마다 시작점·끝점·중간 지점 좌표를 저장했다. - 물품은 그 좌표를 차례로 따라 이동하고, 다음 파츠로 넘어가며 이어진다. - Gizmos로 이동 경로를 에디터 화면에 그려 파츠를 배치할 때 바로 확인한다. ## 링크 - [GitHub](https://github.com/minyee2913/orphans_factory) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/orphans-factory/1.jpg (공장 바닥: 컨베이어와 박스) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/2.jpg (박스를 주문하고 포장하는 장면) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/3.jpg (포장한 박스를 출고 컨베이어로) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/plan.jpg (계획 목표 PLAN 1~3) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/worklog.jpg (업무 기록: 남은 시간·생산량·클레임) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/conveyor.jpg (방향·모양별 컨베이어 파츠) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/path.jpg (Gizmos로 그린 컨베이어 이동 경로) - 이미지: https://human.minyee2913.net/img/games/orphans-factory/blendtree.jpg (4방향 이동 Blend Tree) 원문 페이지: https://human.minyee2913.net/projects/orphans-factory --- # KOROSHITE > 잊혀진 영웅들의 난투 > 8인 대전과 보스전을 지원하는 PC 멀티플레이 액션 게임 (2024 디지털콘텐츠개발대회 금상) 서로 다른 스킬을 가진 캐릭터로 8인 대전과 보스전을 즐길 수 있는 PC 액션 게임. - 페이지: https://human.minyee2913.net/projects/koroshite - 카테고리: 게임 개발 - 개발 기간: 2024.02 - 플랫폼: PC - 장르: 대전, 멀티플레이, 액션, 스토리 - 팀 구성: 1인 개발 - 게임 엔진: Unity 6 (URP) - 사용 언어: C# - 프레임워크 / 라이브러리: Photon PUN 2, PlayFab, Cinemachine, DOTween - 주요 기술: RPC, OnPhotonSerializeView, PlayFab 사용자 데이터, 코루틴 컷씬 ## 프로젝트 소개 여러 세계에서 죽음을 맞이한 영웅들이 불가사의한 장소에 모여 사명을 잊고 싸운다는 설정의 멀티플레이 액션 게임이다. 컷씬과 다이얼로그로 스토리를 전개하고, 모두 다른 스킬을 가진 캐릭터로 8명이 함께하는 대전 모드와 혼자서도 할 수 있는 보스전을 제공한다. 기획부터 네트워크, 캐릭터·보스, UI까지 **혼자 개발**했고, 개발 도중 Unity 6로 프로젝트를 옮겼다. ### 주요 특징 - **1인 개발**, 2024 디지털콘텐츠개발대회 **금상** - Photon PUN 기반 **최대 8인** 실시간 대전 - 스킬 구성이 모두 다른 **캐릭터 5종** - 2페이즈 보스와 슬로 모션 반격 연출 - 온·오프라인 분기로 **싱글플레이도 같은 네트워크 코드**를 사용 ## 게임 플레이 - 로그인 또는 회원가입(게스트 로그인 지원) 후 첫 시작 시 스토리 컷씬과 싱글플레이 튜토리얼이 진행된다. 튜토리얼은 건너뛸 수 있다. - 로비에서는 캐릭터들이 NPC로 돌아다니고, 클릭하면 캐릭터와 스킬 정보를 볼 수 있다. 멀티플레이 방 목록과 싱글플레이 스테이지도 여기서 고른다. - J 공격, K 스킬(누르고 있기), L 궁극기(에너지 소모), Shift 대시, 2단 점프로 싸운다. - 데스매치는 5분 동안 처치 수로 순위를 매기고(동률이면 처치당한 수), 처치되면 5초 뒤 무작위 위치에서 부활한다. 게임 중 F로 캐릭터를 바꿀 수 있고, 남은 시간이 150초가 되면 서든 데스가 시작되어 에너지가 매초 차오른다. - 1:1 듀얼은 2분 동안 체력 1.5배로 겨루며, 먼저 처치한 쪽이 이긴다. ## 개발 연혁 - 2024-02: 개발 시작 - 2024-10: Unity 6로 프로젝트 이전, 맵 동기화 수정 - 2024-11: 보스 '기억의 환영' 패턴 작업 ## 설계 / 패턴 - Singleton: 매니저 클래스 관리 - Observer: RPC를 이용한 이벤트 기반 네트워크 동기화 - Strategy: 추상 Character 클래스를 상속해 캐릭터별 기능 구현 - Proxy: 온라인이면 RPC로, 오프라인이면 로컬로 호출하는 래퍼로 싱글플레이와 코드 공유 - Template Method: 추상 Monster 클래스로 몬스터 기본 행동(이동·피격·사망·넉백) 정의 - Builder: 체이닝으로 대사를 쌓는 다이얼로그 API - 캐릭터 id 문자열로 프리팹을 불러와 생성 ## 핵심 구현 기능 ### PlayFab 계정과 캐릭터 보유 정보 **구현 목적**: 별도 서버를 구축할 시간과 비용이 없어 PlayFab API로 계정 정보를 저장하고 불러왔다. **동작 방식** - 이메일·비밀번호 로그인(LoginWithEmailAddress), 표시 이름을 포함한 회원가입(RegisterPlayFabUser), 게스트 로그인을 지원한다. 첫 로그인 때 표시 이름을 정하게 한다. - 요청 전에 빈 칸을 검사하고, 성공·실패 콜백으로 결과를 처리한다. - 튜토리얼 완료 여부와 보유 캐릭터를 PlayFab 사용자 데이터에 저장해, 로그인하면 튜토리얼 또는 로비로 보낸다. 사무라이와 파이터는 기본 제공한다. **사용 기술**: PlayFab Client API ### Photon 기반 멀티플레이 동기화 **구현 목적**: 많이 써 봐서 익숙하고 빠르게 구현할 수 있는 Photon 네트워크로 멀티플레이를 구현했다. **동작 방식** - 로그인 → Photon 로비 → 방 목록 → 방 만들기(최대 8명)로 이어지고, 모드 선택과 시작은 방장만 할 수 있다. 경기마다 5초 카운트다운 후 시작 위치를 섞는다. - OnPhotonSerializeView로 이름, 체력, 실드, 킬·데스, 바라보는 방향, 이동·달리기·착지·대시 상태를 주고받고, 위치는 PhotonTransformView로 맞춘다. - 피해·회복·넉백·애니메이션 트리거처럼 한 번만 일어나는 일은 RPC로 전달한다. - 공격 판정은 공격한 쪽 클라이언트에서 하고, 가드·무적 같은 피격 처리는 각 클라이언트가 맞은 캐릭터 기준으로 한다. - 방장 권한으로 채팅 차단·강퇴·방장 넘기기를 할 수 있고, 관전 모드가 있다. **사용 기술**: Photon PUN, RPC, OnPhotonSerializeView ### 캐릭터 5종 체력과 스킬 구성이 모두 다른 캐릭터를 추상 클래스 하나로 구현했다. **동작 방식** - **사무라이**(체력 800): 2연속 돌진 베기, 정면 공격을 막는 가드와 타이밍을 맞추면 발동하는 반격, 넓은 범위를 연속으로 베는 궁극기. - **파이터**(체력 1000): 빠른 잽, 자세를 잡고 버티며 힘을 모아 차는 킥(모은 만큼 피해와 회복), 궁극기 동안 킥을 바로 쓸 수 있는 스택 8개. - **시노비**(체력 650): 앞뒤를 연달아 베는 공격, 은신 돌진, 맞은 직후 잠깐 무적이 되는 회피. - **뱀파이어 걸**(체력 1200): 자기 체력을 쓰며 공격하고, 연속 공격으로 강화된 할퀴기로 체력과 에너지를 빼앗는다. 궁극기는 적 하나를 삼켜 연속 피해를 준다. - **뱀파이어 맨**(체력 600): 공격으로 실드를 쌓고, 실드를 써서 질주하며 적에게 표식을 남긴 뒤 표식을 터뜨린다. - Player 오브젝트가 입력과 판정을, Character 오브젝트가 스킬과 애니메이션을 맡는다. 각 Character는 소유자의 Photon UserId로 자기 Player 밑에 붙는다. ### 보스 '기억의 환영'과 스토리 스테이지 **동작 방식** - 튜토리얼 → 로비 튜토리얼 → 스테이지 → 보스전 순서로 진행되고, 컷씬은 코루틴으로 카메라 확대·말풍선·트윈을 순서대로 실행한다. - 다이얼로그는 대사를 체이닝으로 쌓는 API로 만들었고, 타자 치듯 글자가 나오며 좌우에 초상화를 띄운다. - 보스는 체력 40%에서 회복을 시전한 뒤 붉게 변해 2페이즈로 넘어가고, 표창·돌진, 멀리 떨어진 대상에게 순간이동하는 패턴을 쓴다. - 보스는 무작위로 가드하고, 2페이즈 후반에는 가드에 성공하면 **슬로 모션(시간 배율 0.6)**과 함께 반격한다. - 몬스터 AI는 소유자 클라이언트에서만 돌고 체력·방향·이동을 동기화한다. **사용 기술**: Coroutine, DOTween, Time.timeScale ### 타격감 연출 **동작 방식** - 카메라 흔들림, 넉백, 피격 시 하얗게 번쩍이는 효과, 대시 잔상을 조합해 타격감을 강조했다. - 효과음은 내 캐릭터와 일정 거리(15) 안에서 난 소리만 재생해, 8명이 싸워도 멀리서 난 소리가 섞이지 않게 했다. - 사무라이의 가드 반격은 공격자의 동작을 취소하고 밀쳐 내며 공격 쿨타임을 준 뒤, 카메라 흔들림·사운드·넉백과 회복을 코루틴으로 순서대로 실행한다. ## 기술적 문제 해결 ### 캐릭터가 엉뚱한 플레이어에게 붙던 문제 [해결] - 문제 상황: 멀티플레이에서 캐릭터 오브젝트가 다른 플레이어 밑에 붙는 경우가 있었다. - 원인 분석: 캐릭터가 자기 주인을 이름과 클라이언트마다 따로 만든 난수로 찾고 있어서, 클라이언트끼리 같은 플레이어를 가리킨다는 보장이 없었다. - 해결 과정: - 방을 만들 때 Photon UserId를 공개하도록 설정하고, 캐릭터 생성 데이터에 소유자의 UserId를 실어 각 클라이언트가 같은 기준으로 주인을 찾게 했다. - 적용한 기술 / 접근: Photon UserId, PublishUserId - 결과: 모든 클라이언트에서 캐릭터가 같은 플레이어에게 붙는다. ### 클라이언트마다 맵이 다르게 나오던 문제 [해결] - 문제 상황: 같은 방에 있는 플레이어들이 서로 다른 맵에서 경기를 시작했다. - 원인 분석: 맵을 각 클라이언트가 로컬에서 무작위로 고르고 있었다. - 해결 과정: - 맵 관리자를 네트워크 오브젝트로 바꾸고, 정해진 맵 번호를 RPC로 모두에게 보내 같은 맵을 켜게 했다. - 적용한 기술 / 접근: PhotonView, RPC - 결과: 같은 방의 플레이어들이 RPC로 받은 같은 맵 번호로 시작한다. ### 싱글플레이에서도 네트워크 코드를 그대로 쓰기 [해결] - 문제 상황: 스킬·피해 처리가 모두 RPC로 짜여 있어, 서버에 연결하지 않는 싱글플레이 스테이지에서는 그대로 쓸 수 없었다. - 해결 과정: - RPC 호출을 래퍼 함수로 감싸, Photon에 연결되어 있으면 RPC를 보내고 아니면 같은 함수를 로컬에서 바로 부르게 했다. - 적용한 기술 / 접근: Proxy 패턴 - 결과: 캐릭터·보스 코드를 멀티플레이와 싱글플레이가 함께 쓴다. ## 개발 결과 및 성과 - [수상] 2024 디지털콘텐츠개발대회 금상 (2024) ## 링크 - [기획 문서 (Notion)](https://heady-whitefish-4a4.notion.site/KOROSHITE-9ff743039ac14d0d82d8bc23cca036e7) - [GitHub](https://github.com/minyee2913/koroshite) - [YouTube](https://youtu.be/Q3kyJ8awLgo?si=BF6WCymrgMlv2S9o) ## 미디어 - 영상: https://youtu.be/Q3kyJ8awLgo (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/koroshite/koro0.png - 이미지: https://human.minyee2913.net/img/games/koroshite/koro1.png - 이미지: https://human.minyee2913.net/img/games/koroshite/koro2.png 원문 페이지: https://human.minyee2913.net/projects/koroshite --- # Hunger of War > 마을이 곧 플레이어가 되어 식량을 빼앗는 멀티플레이 생존 대전 (4인 팀) 3차 세계대전 뒤 식량 보급이 끊긴 마을들이 서로의 식량을 빼앗아 자기 마을 주민을 살리는 PC 멀티플레이 생존 대전 게임. - 페이지: https://human.minyee2913.net/projects/hunger-of-war - 카테고리: 게임 개발 - 개발 기간: 2024 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 대전, 멀티플레이, 생존 - 팀 구성: 4인 팀 (개발 3인, 아트 1인) - 담당 역할: 통신 구축, UI 디자인, 플레이어, 전투 시스템 - 기여도: 40% - 게임 엔진: Unity - 사용 언어: C# - 프레임워크 / 라이브러리: Photon PUN - 주요 기술: Photon 방 관리, OnPhotonSerializeView 상태 동기화, 상태 머신 NPC·동물 ## 프로젝트 소개 3차 세계대전이 끝난 뒤 식량 보급이 끊긴 세계가 배경이다. **마을 자체가 하나의 플레이어**가 되어, 다른 플레이어에게서 식량을 빼앗아 자기 마을 주민을 살려야 한다. 개발 3명·아트 1명 팀에서 **통신 구축, UI 디자인, 플레이어, 전투 시스템**을 맡았다 (기여도 40%). ## 게임 플레이 - 게스트로 로그인하면 레벨이 표시되는 로비로 들어가고, 멀티플레이 방에 모인다 (방 화면에 '마을 2/8'처럼 표시). - 마을 주민 한 명을 골라 마을 밖으로 나가 식량을 구한다. - 주민이 죽으면 관이 되고, RIP 화면에 귀환 카운트다운이 뜬다. ## 설계 / 패턴 - PlayerSession: 플레이어 접속 단위 - GameManager: Photon 방 입장·생성 관리 - Damageable(추상) → NpcBase(추상)·AnimalBase(추상, 상태 머신) → 개별 NPC·동물 - Inventory · FieldItem · ItemBase: 아이템 획득과 사용 ## 핵심 구현 기능 ### Photon 멀티플레이 **동작 방식** - PhotonNetwork로 방을 만들고 들어가며, 마스터 서버 연결과 방 입장 후 플레이어 세션 오브젝트를 네트워크로 생성한다. - OnPhotonSerializeView로 위치·상태 값을 주기적으로 주고받아 동기화한다. **사용 기술**: PUN ## 미디어 - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/village.jpg (마을 전경) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/villagers.jpg (외출할 주민 고르기) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/field.jpg (마을 밖 필드) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/lobby.jpg (로비 (게스트 로그인)) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/room.jpg (멀티플레이 방 (마을 2/8)) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/rip.jpg (주민이 죽으면 나오는 RIP 화면) - 이미지: https://human.minyee2913.net/img/games/hunger-of-war/structure.jpg (클래스 구조도) 원문 페이지: https://human.minyee2913.net/projects/hunger-of-war --- # 탈귀 > 한밤중 학교에서 낮이 될 때까지 귀신을 피해 도망치는 공포 생존 게임 (선린톤 10th) 놓고 온 물건을 찾으러 밤의 학교에 온 학생이 복도에서 귀신을 만나, 낮이 될 때까지 손전등에 의지해 도망치는 2D 공포 생존 게임. - 페이지: https://human.minyee2913.net/projects/talgwi - 카테고리: 게임 개발 - 개발 기간: 2024 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 공포, 생존 - 팀 구성: 4인 팀 (개발 2인, 아트 2인) - 담당 역할: 플레이어, 손전등, 맵 기믹 - 기여도: 30% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 선린톤 10th에서 개발 2명·아트 2명 팀으로 만들었다. 놓고 온 물건을 찾으러 한밤중 학교에 온 학생이 복도에서 귀신을 만나고, **낮이 될 때까지 살아남아야** 한다. **플레이어, 손전등, 맵 기믹**을 맡았다 (기여도 30%). ## 개발 결과 및 성과 - [출품] 선린톤 10th 출품작 (2024) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/talgwi/1.jpg (밤의 학교 복도) 원문 페이지: https://human.minyee2913.net/projects/talgwi --- # 버튼을 눌렀더니 판타지 게임속 주인공이 되어버린 건에 대하여 이전 회차 플레이어의 행동이 그림자가 되어 다음 플레이에 영향을 주는 다회차 기반 로그라이크 액션 게임. - 페이지: https://human.minyee2913.net/projects/isekai-button - 카테고리: 게임 개발 - 개발 기간: 2024 - 플랫폼: PC - 장르: 로그라이크, 액션 - 팀 구성: 4인 팀 (개발 3인, 아트 1인) - 담당 역할: 전투 시스템, 플레이어, 무기 시스템, 몬스터 - 기여도: 50% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 버튼을 누르면 다른 세상에서 5억 년을 살고 기억을 잃은 채 돌아와 돈을 받는다는 제안을 받아들인 소녀가, 판타지 세계에서 5억 년 동안 던전을 도는 이야기다. ## 게임 플레이 - 게임 시작 시 앞에 무기가 떨어져 있다. - 좌클릭을 홀드하면 공격 범위가 보이고 놓으면 공격한다. - 숫자 키로 스킬을 사용한다. ## 링크 - [YouTube](https://youtu.be/XC09-MKsyCw) - [GitHub](https://github.com/counterSpellkuku/something) ## 미디어 - 영상: https://youtu.be/XC09-MKsyCw (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/isekai-button/intro.jpg (게임 진입 전 대화) - 이미지: https://human.minyee2913.net/img/games/isekai-button/1.jpg (던전 방: 남은 몬스터 표시와 스킬 슬롯) - 이미지: https://human.minyee2913.net/img/games/isekai-button/2.jpg (게임 시작 시 앞에 무기가 떨어진다) - 이미지: https://human.minyee2913.net/img/games/isekai-button/3.jpg (좌클릭을 홀드하면 공격 범위가 보이고, 놓으면 공격한다) - 이미지: https://human.minyee2913.net/img/games/isekai-button/4.jpg (숫자키를 눌러 스킬을 사용한다) 원문 페이지: https://human.minyee2913.net/projects/isekai-button --- # 구해줘 홈즈 김배달의 우당탕탕 대모험 > 던져라, 배달부! > 점프 대신 드래그로 몸을 던지는 3분 배달 플랫포머 (5인 팀, 팀장) 점프 버튼 대신 마우스 드래그로 캐릭터를 던지는 방식으로 진행되는 아케이드 플랫포머 게임. - 페이지: https://human.minyee2913.net/projects/deliver-homez - 카테고리: 게임 개발 - 개발 기간: 2024.07 ~ 2024.09 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 아케이드, 플랫포머 - 팀 구성: 5인 팀 (개발 4인, 아트 1인) - 담당 역할: 팀장, UI·시스템 개발, 배달·점수·보급 흐름, 아이템 효과 시스템, 오프닝 연출, 랭킹·결과 화면 - 기여도: 60% (커밋 81개 중 43개) - 게임 엔진: Unity 2022.3 - 사용 언어: C# - 프레임워크 / 라이브러리: Cinemachine, LeanTween, TextMeshPro - 주요 기술: Rigidbody2D 임펄스, 포물선 궤적 예측, Tilemap, PlayerPrefs 랭킹, 코루틴 컷신 ## 프로젝트 소개 월세 납부일이 다가온 피자 배달부 김배달 씨가 배달 단가가 높은 협곡 마을에서 배달하는 이야기다. 선린인터넷고 게임 동아리 C,Real에서 5인 팀(개발 4·아트 1)으로 만들었고, **팀장이자 UI·시스템 개발**을 맡았다. 점프 버튼이 없다. 마우스를 끌어 당긴 방향과 세기로 김배달 씨를 던지고, 거칠게 착지하면 피자를 떨어뜨린다. **조작 자체가 웃음 포인트가 되도록** 설계한 아케이드 게임이다. ### 주요 특징 - 5인 팀(개발 4·아트 1)의 **팀장**, UI·시스템 개발 - 드래그 세기·방향으로 던지는 **포물선 궤적 점프** - 제한 시간 3분 동안 **배달·점수·보급** 루프 - 아이템 버프·디버프를 공통 **Effect 클래스**로 구조화 - 이름 기반 **로컬 랭킹**과 결과 화면 ## 게임 플레이 - A·D로 걷고, 땅에 서 있을 때 마우스 왼쪽 버튼이나 Space를 누른 채 끌었다 놓으면 당긴 반대 방향으로 몸을 던진다. 당긴 거리가 짧으면 점프하지 않는다. - 날아가는 동안 A·D로 방향을 더해 더 멀리 갈 수 있다. 점프 직후 바로 누르면 '초가속' 문구가 뜬다. - 피자 가게에서 피자 3판을 받아 화살표가 가리키는 배달지에 착지하면 배달 성공이다. 다음 배달지는 무작위로 정해진다. - 높은 곳에서 세게 떨어지면 들고 있던 피자를 한 판 떨어뜨린다. 떨어진 피자는 다시 주울 수 있다. - 피자가 떨어지면 가게로 돌아가 다시 받고, 이때 남은 시간이 40초 늘어난다. 제한 시간 3분이 끝나면 점수와 순위가 나온다. - 맵 곳곳의 아이템 상자는 속도 증가·속도 감소·점프 강화·좌우 반전 중 하나를 10초 동안 건다. ## 개발 연혁 - 2024-07: 저장소 생성, 시작 씬과 엔딩 크레딧 제작 - 2024-08: 드래그 점프·이동, 협곡 맵 타일, UI, 아이템 통합 - 2024-09: 배달지 화살표, 말풍선, 랭킹, 효과음 추가 후 1.0 → 1.1 빌드 ## 핵심 구현 기능 ### 드래그로 던지는 포물선 점프 당긴 거리와 방향이 곧 점프 세기와 방향이 되는, 이 게임의 핵심 조작. **구현 목적**: 점프 버튼 하나로 끝나는 플랫포머 대신, 힘 조절에 실패하는 것까지 재미가 되는 조작을 만들고 싶었다. **동작 방식** - 누른 지점과 현재 커서 사이의 거리를 최대값으로 자르고, 반대 방향 벡터에 곱해 던질 힘을 구한다. - 끄는 동안 **15개 점으로 포물선 궤적을 미리 보여 준다**. 시간 간격마다 위치 = 시작점 + 힘×t − ½·g·t² 로 계산한다. - 많이 당길수록 카메라가 조금씩 확대되고, 놓으면 원래대로 돌아와 힘을 모으는 느낌을 준다. - 놓을 때 Rigidbody2D에 임펄스로 힘을 주고, 당긴 거리가 최대의 20% 이하이면 점프를 취소한다. - 점프 직후 0.2초 안에 방향키를 누르면 '초가속' 문구를 띄워 숨은 조작을 알려 준다. **사용 기술**: Rigidbody2D, ForceMode2D.Impulse, Cinemachine ### 배달·점수·보급 루프 3분 안에 최대한 많이, 최대한 빨리 배달하게 만드는 게임 흐름. **동작 방식** - 배달지마다 가게에서 떨어진 거리에 비례해 기본 점수를 주고, 직전 배달 이후 걸린 시간만큼 깎는다. 성공한 배달마다 30점을 더한다. - 모든 배달지를 한 번씩 돌면 목록을 다시 채우고, 남은 곳 중 하나를 무작위로 켠다. - 피자를 다 쓰면 목표가 가게로 바뀌고, 가게에 착지하면 컷신과 함께 피자 3판과 추가 시간 40초를 준다. - 세게 착지하면(세로 충돌 속도 기준) 피자를 떨어뜨리고, 남은 개수에 따라 다른 말풍선 대사를 띄운다. - 60초 동안 아무 조작이 없으면 경고 후 시작 화면으로 돌아간다. ### 화면 밖 목표를 가리키는 화살표 배달지가 화면 밖에 있으면 화면 가장자리에 방향 화살표를 띄우고, 화면 안이면 목표 위에 표시한다. **동작 방식** - 플레이어에서 목표로 향하는 각도를 화면 대각선 각도와 비교해 위·아래·왼쪽·오른쪽 중 어느 가장자리에 붙일지 정한다. - 가장자리 안에서의 위치는 비례식으로 구하고, 화면 밖으로 넘어가지 않게 잘라 낸다. - HUD에 목표까지 남은 거리(m)를 함께 보여 준다. ### 아이템 효과 시스템 버프·디버프를 공통 Effect 추상 클래스로 묶어, 새 효과를 클래스 하나로 추가할 수 있게 했다. **동작 방식** - Effect는 지속 시간과 경과 시간을 관리하고, 시작·종료 시 하위 클래스의 OnStart·OnEnd를 부른다. - 효과마다 HUD 아이콘을 만들어 남은 시간을 원형 게이지로 보여 주고, 캐릭터 색으로도 상태를 알린다. - 속도 증가(1.3배)·감소(0.5배), 점프 강화(최대 당김 거리 1.3배), 좌우 반전 효과를 구현했다. 좌우 반전은 이동 방향과 스프라이트 방향을 함께 뒤집는다. - 같은 효과를 다시 얻으면 기존 효과를 끝내고 지속 시간을 더한 새 효과로 바꾼다. **사용 기술**: 추상 클래스, Image.fillAmount - 이미지: https://human.minyee2913.net/img/games/deliver-homez/tuto-air.jpg (튜토리얼: 점프 중 방향키 입력) ### 오프닝 컷신과 말풍선 **동작 방식** - 게임 시작 시 코루틴으로 카메라 확대, 피자가 하나씩 떨어지는 연출, 무작위 대사, 튜토리얼, 'GO! GO!'를 순서대로 진행한다. - 캐릭터 머리 위 말풍선이 몇 초 뒤 서서히 사라지고, 캐릭터가 돌아서도 글자가 뒤집히지 않게 했다. **사용 기술**: Coroutine, LeanTween ### 이름 기반 랭킹과 결과 화면 **동작 방식** - 시작할 때 이름을 입력받고, 게임이 끝나면 같은 이름의 기록이 있으면 최고 점수만 갱신하고 없으면 새로 추가한다. - 랭킹은 PlayerPrefs에 저장하고, 결과 화면에서 배달 수·점수·내 최고 기록·현재 순위와 '신기록!'·'첫기록!' 문구를 보여 준다. **사용 기술**: PlayerPrefs ## 기술적 문제 해결 ### 같은 이름으로 다시 하면 랭킹이 갱신되지 않고 중복되던 문제 [해결] - 문제 상황: 같은 이름으로 여러 번 플레이하면 기록이 줄마다 새로 쌓여, 한 사람이 랭킹을 여러 칸 차지했다. - 원인 분석: 게임이 끝날 때마다 무조건 새 기록을 추가했고, 기록 타입이 값 타입(struct)이라 찾아낸 기록을 고쳐도 목록 안의 원본이 바뀌지 않았다. - 해결 과정: - 기록 타입을 참조 타입(class)으로 바꿔 찾은 기록을 직접 고칠 수 있게 했다. - 같은 이름이 있으면 점수가 더 높을 때만 점수와 배달 수를 갱신하고, 없을 때만 새로 추가하게 바꿨다. - 결과: 이름마다 최고 기록 한 줄만 남고, 결과 화면에서 신기록과 첫 기록을 구분해 보여 줄 수 있게 되었다. ### 같은 아이템을 연속으로 먹으면 오류가 나던 문제 [해결] - 문제 상황: 효과가 남아 있는 상태에서 같은 아이템을 또 먹으면 오류가 발생했다. - 원인 분석: 기존 효과를 새 효과로 바꿀 때 HUD 아이콘을 먼저 지웠는데, 기존 효과의 갱신·종료 처리가 이미 지워진 아이콘에 다시 접근했다. - 해결 과정: - 아이콘을 지운 뒤 참조를 비우고, 갱신·종료 처리에서는 아이콘이 남아 있을 때만 접근하도록 고쳤다. - 결과: 같은 효과를 이어서 얻어도 오류 없이 새 효과로 교체된다. ## 링크 - [플레이 영상](https://youtu.be/KInJwl4cEj0) ## 미디어 - 영상: https://youtu.be/KInJwl4cEj0 (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/deliver-homez/hero.jpg (시작 화면 일러스트) - 이미지: https://human.minyee2913.net/img/games/deliver-homez/tuto-jump.jpg (튜토리얼: 클릭 또는 Space를 누른 채 끌어 점프) - 이미지: https://human.minyee2913.net/img/games/deliver-homez/tuto-move.jpg (튜토리얼: A·D로 이동) - 이미지: https://human.minyee2913.net/img/games/deliver-homez/game-over.jpg (엔딩 화면: "집값을 다 벌지 못했어...") 원문 페이지: https://human.minyee2913.net/projects/deliver-homez --- # ECHO 집에 들어온 NPC들이 벌이는 돌발 행동을 아이템으로 막아내는 아케이드 시뮬레이션 전략 게임. - 페이지: https://human.minyee2913.net/projects/echo - 카테고리: 게임 개발 - 개발 기간: 2024 - 플랫폼: PC - 장르: 아케이드, 시뮬레이션, 전략 - 팀 구성: 3인 팀 (개발 3인) - 담당 역할: 상호작용 시스템, 아이템 시스템 - 기여도: 60% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 복지센터를 연 플레이어가 찾아오는 진상 NPC들의 돌발 행동을 아이템으로 막아내는 게임이다. ## 미디어 - 이미지: https://human.minyee2913.net/img/games/echo/1.jpg (집 안에 들어온 NPC를 아이템으로 막아 내는 화면) 원문 페이지: https://human.minyee2913.net/projects/echo --- # 범근러쉬 학교 친구를 등장인물로 내세운 엽기적인 감성의 러닝 아케이드 게임. - 페이지: https://human.minyee2913.net/projects/bumgeun-rush - 카테고리: 게임 개발 - 개발 기간: 2023 - 플랫폼: PC - 장르: 러닝, 아케이드 - 팀 구성: 1인 개발 - 게임 엔진: Unity - 사용 언어: C# ## 링크 - [GitHub](https://github.com/minyee2913/beomgeun_rushv2) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/bumgeun-rush/1.jpg (점프와 슬라이드로 달리는 화면) 원문 페이지: https://human.minyee2913.net/projects/bumgeun-rush --- # ESCAPE THE MUSIC 노트 상호작용에 따라 뒤의 플랫포머 캐릭터가 반응하는 구조의 플랫포머 리듬 게임. - 페이지: https://human.minyee2913.net/projects/escape-the-music - 카테고리: 게임 개발 - 개발 기간: 2023 - 플랫폼: PC - 장르: 플랫포머, 리듬 - 팀 구성: 4인 팀 (개발 3인, 아트 1인) - 담당 역할: 노트 저장·출력·인식 시스템, 플레이어 - 기여도: 80% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 판정과 노트 외에는 변수가 없는 리듬 게임에 플랫포머를 결합해 다양한 변수를 만들고 보는 재미를 높이려 했다. ## 링크 - [GitHub](https://github.com/zerOpen-is-on-RG/escape_the_music) - [YouTube](https://youtu.be/hjJWSH370Qw) ## 미디어 - 영상: https://youtu.be/hjJWSH370Qw (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/escape-the-music/1.jpg (노트 판정 PERFECT 연출) 원문 페이지: https://human.minyee2913.net/projects/escape-the-music --- # 유클리우드 Edge 전투마다 두더지 잡기 같은 퍼즐을 진행하고, 퍼즐 성취도에 따른 버프를 받은 뒤 실시간 전투가 이어지는 퍼즐 액션 로그라이크. - 페이지: https://human.minyee2913.net/projects/eucliwood - 카테고리: 게임 개발 - 개발 기간: 2023 - 플랫폼: PC - 장르: 퍼즐, 액션, 로그라이크 - 팀 구성: 1인 개발 - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 대기업의 탐욕으로 오염된 땅을 정화하며 기업에 맞서 싸우는 이야기다. ## 개발 결과 및 성과 - [기타] KRAFTON · JA Korea Better Ground 게임 제작 멘토링 참여 (2023) - 2023-07 ~ 2023-11, 아트·개발 멘토링을 받아 게임을 개선 - [출품] 2023 대한민국 SW·AI 교육 페스티벌 발표 (2023-11) ## 링크 - [YouTube](https://youtu.be/qeY9_LM9LVc?si=74Ngadrt-ges73ge) - [GitHub](https://github.com/minyee2913/eucliwood) ## 미디어 - 영상: https://youtu.be/qeY9_LM9LVc (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/eucliwood/1.jpg (땅이 썩기 전에 오염 물질을 중화하는 퍼즐) - 이미지: https://human.minyee2913.net/img/games/eucliwood/2.jpg (퍼즐 뒤에 이어지는 실시간 전투) 원문 페이지: https://human.minyee2913.net/projects/eucliwood --- # 도장을 지켜라! > 2라운드부터 배경의 보스가 끼어드는 1:1 대전 격투 게임 (3인 팀) 두 플레이어가 도장에서 맞붙는 대전 격투 게임. 2라운드부터는 배경에 있던 보스가 전투에 끼어들어, 상대와 보스를 동시에 상대해야 한다. - 페이지: https://human.minyee2913.net/projects/protect-dojo - 카테고리: 게임 개발 - 개발 기간: 2023 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 대전, 액션, 격투 - 팀 구성: 3인 팀 (개발 2인, 아트 1인) - 담당 역할: 플레이어, 방 시스템, UI 디자인 - 기여도: 50% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 두 플레이어가 맞붙는 대전 격투 게임인데, **2라운드부터 배경에 있던 보스가 전투에 끼어들어** 상대와 보스를 함께 신경 써야 한다. 개발 2명·아트 1명 팀에서 **플레이어, 방 시스템, UI 디자인**을 맡았다 (기여도 50%). ## 미디어 - 이미지: https://human.minyee2913.net/img/games/protect-dojo/1.jpg (도장에서 맞붙은 두 플레이어와 배경의 보스) 원문 페이지: https://human.minyee2913.net/projects/protect-dojo --- # 로프앤파이터 > 발차기와 로프 액션을 이어 붙이는 플랫포머 액션 (4인 팀) 발차기 공격과 로프 액션을 연계해 화려하게 싸우는 2D 플랫포머 액션 게임. - 페이지: https://human.minyee2913.net/projects/rope-fighter - 카테고리: 게임 개발 - 개발 기간: 2023 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 플랫포머, 액션 - 팀 구성: 4인 팀 (개발 2인, 아트 2인) - 담당 역할: 플레이어, 전투 시스템, 밧줄 시스템 - 기여도: 60% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 발차기 공격과 **로프 액션을 연계하는 화려한 전투**가 특징인 플랫포머 액션 게임이다. 개발 2명·아트 2명 팀에서 **플레이어, 전투 시스템, 밧줄 시스템**을 맡았다 (기여도 60%). ## 미디어 - 이미지: https://human.minyee2913.net/img/games/rope-fighter/1.jpg (발차기로 적을 공격하는 장면) 원문 페이지: https://human.minyee2913.net/projects/rope-fighter --- # 스릴있는 점프게임 > 공중에서 적을 내리찍어 처치하는 점프 액션 (동아리 1학년 제작) 공중으로 뛰어올라 적을 내리찍어 처치하는 2D 점프 액션 게임. 동아리 1학년 때 만들었다. - 페이지: https://human.minyee2913.net/projects/thrilling-jump - 카테고리: 게임 개발 - 개발 기간: 2023 - 개발 상태: 개발 완료 - 플랫폼: PC - 장르: 점프, 액션 - 담당 역할: 플레이어, 전투 시스템 - 기여도: 70% - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 공중에서 **적을 내리찍어 처치하는** 점프 액션 게임이다. 동아리 1학년 때 만들었고, **플레이어와 전투 시스템**을 맡았다 (기여도 70%). ## 미디어 - 이미지: https://human.minyee2913.net/img/games/thrilling-jump/1.jpg (도시 위로 뛰어오른 장면) 원문 페이지: https://human.minyee2913.net/projects/thrilling-jump --- # 파머의 해피 라이프 > 오염되는 농장을 지키는 아케이드 퍼즐 (첫 게임 프로젝트) 오염되어 가는 타일을 빠르게 이동하며 중화시켜 땅을 지키는 아케이드 퍼즐 게임. - 페이지: https://human.minyee2913.net/projects/farmer-happy-life - 카테고리: 게임 개발 - 개발 기간: 2023 - 플랫폼: PC - 장르: 아케이드, 퍼즐 - 팀 구성: 1인 개발 - 게임 엔진: Unity - 사용 언어: C# ## 프로젝트 소개 **처음으로 만든 게임 프로젝트**다. 마을에 들어선 공장의 오염 물질로 오염되어 가는 농장 땅을 빠르게 중화해 지키는 게임이다. ## 링크 - [YouTube](https://youtu.be/TaHivs_WtP8?si=7QDLd0qb6IpfMDti) - [GitHub](https://github.com/minyee2913/unity-project1) ## 미디어 - 영상: https://youtu.be/TaHivs_WtP8 (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/farmer-happy-life/1.jpg (오염된 타일을 빠르게 이동하며 중화하는 화면) 원문 페이지: https://human.minyee2913.net/projects/farmer-happy-life --- # Luminous Wanderlust > 루미너스 : 원더러스트 > Go로 직접 만든 Minecraft 서버 위의 반오픈월드 액션 RPG (구 Luminous RPG) 유물·장비·직업 특성을 조합해 나만의 전투 스타일을 만드는 반오픈월드 액션 RPG. Go 기반 서버 엔진 Dragonfly를 포크해 게임 서버와 전용 클라이언트, 게이트웨이까지 직접 개발하고 운영한다. - 페이지: https://human.minyee2913.net/projects/luminous-wanderlust - 카테고리: 마인크래프트 개발 - 개발 기간: 2020 ~ 현재 - 개발 상태: 개발 중 - 플랫폼: Minecraft Bedrock / Java 서버 + 전용 클라이언트 - 장르: 액션 RPG, 반오픈월드, MMO 서버 - 사용 언어: Go, C# (Godot 클라이언트), Java (Java Edition 게이트웨이), Python (개발 도구) - 프레임워크 / 라이브러리: Dragonfly (포크해서 사용), gophertunnel (Bedrock 프로토콜), ent ORM + SQLite, Pion WebRTC, Godot 4 (.NET), MCProtocolLib · ViaVersion, Discord Activity - 주요 기술: 서버 사이드 RPG 시스템, JSON 기반 퀘스트·스토리 저작, 학습형 NPC 에이전트 (LLM 미사용), 자체 클라이언트 프로토콜 (WebRTC / WebSocket), Bedrock 프로토콜 버전 업그레이드, 월드 정지 감시와 자동 프로파일링, 헤드리스 밸런스 시뮬레이션, AI 코딩 에이전트 협업 규칙 ## 프로젝트 소개 2020년에 시작한 장기 프로젝트로, 2023년 12월부터 Go로 작성된 Minecraft Bedrock 서버 엔진 **Dragonfly를 포크해 게임 서버를 처음부터 다시 만들었다**. 이전 이름은 Luminous RPG다. 구르기·발차기·패링과 연출이 붙은 궁극기로 싸우는 액션 전투에, 4개 계열의 직업, 유물·장비 성장, 스토리 퀘스트, 던전과 협동 던전, 생활 콘텐츠와 길드까지 갖춘 RPG를 **서버 쪽 코드로 구현**했다. Bedrock 클라이언트뿐 아니라 직접 만든 전용 클라이언트(Windows·macOS·Android)와 **Java Edition 접속 게이트웨이**, Discord 안에서 보는 관전 모드까지 붙여 여러 경로로 같은 세계에 들어올 수 있다. 실제 플레이어가 접속하는 라이브 서버로 운영하고 있으며, 운영 공지(2026년 10월) 기준 공개 후 약 3개월 동안 누적 이용자는 약 800명이다. 지금의 Dragonfly 기반 서버는 게임 코드를 사실상 전부 직접 작성했고(게임 패키지 커밋 1,028개 중 1,025개), 2026년 6월부터는 AI 코딩 에이전트와 함께 작업하면서 에이전트용 검증 규칙을 따로 두고 개발하고 있다. ## 게임 플레이 - 4개 계열(전사·수호자·저격수·지원가) 아래 48개의 직업이 있고, NPC에게 배운 직업을 같은 계열 안에서 바꿀 수 있다. 직업 레벨 3·4·5에 특성 칸이 열린다. - 무기 45종, 유물 51종, 방어구 12종을 조합한다. 장비 레벨 상한은 기본 45이고 세계를 하나 클리어할 때마다 15씩 오른다. 15레벨마다 돌파 효과 3개 중 하나를 고르고, 같은 장비를 넣어 초월한다. - 숲 지대, 언덕 마을, 차가운 동굴 지역을 오가며 필드 전투, 던전, 극한 도전, 층을 오르는 '절망의 탑'을 진행한다. 2~4인 협동 던전도 있다. - 낚시·농사·채광·벌목·요리 같은 생활 콘텐츠와 길드, 플레이어 거래소와 떠돌이 상인이 있다. - 스스로 플레이하며 성장하고 기억하는 모험가 NPC와, 욕구에 따라 생활하며 심부름과 개인 이야기를 주는 마을 주민이 함께 살아간다. ## 개발 연혁 - 2020: Luminous RPG 프로젝트 시작 - 2021-03: Bedrock 서버 모딩 프레임워크 BDSX 오픈소스에 기능 기여 시작 (2022-03까지 PR 11건 병합) - 2021-05: BDSX 기반 첫 서버 저장소 구성: 던전·퀘스트·길드·직업·낚시·상점·강화·스킬 - 2021-07: 스토리 시스템, 인챈트 - 2021-11: 던전 카운트다운, 스토리 시스템 개편, 몬스터 생성 비동기 처리 - 2021-12: 새 서버 저장소로 이전, 자동 백업·우편·스토리 데이터 - 2022-03: 상자 UI, 퀘스트·길드 개편 - 2022-06: 레이드 보스와 기간 한정 도전 - 2022-07: 유물·투사체 시스템, 벌목 채집 - 2023-04: 웹 관리 페이지, 서버 렉 개선 - 2023-05: 새 UI, 절망의 탑 첫 버전 - 2023-08: 메인 퀘스트와 스토리 음악, 밸런스 패치 - 2023-12: Go 서버 엔진 Dragonfly를 포크해 새로 개발 시작, 멀티 월드 - 2024-08: 프로토콜 업데이트 대응 - 2025-01: 스토리 시스템 - 2025-07: 직업 시스템 - 2025-08: 틱 처리 성능 개선, 1.21.100 엔진 병합 - 2026-01: 서버 성능 분석과 DB 개선 - 2026-06: AI 코딩 에이전트와 본격 협업 시작, 소환·거래소 - 2026-07: 월드 정지 감시(워치독), 절망의 탑 - 2026-08: Bedrock 1.26.40 프로토콜 업그레이드, 에이전트 작업 규칙 - 2026-09: Discord 관전 모드, Godot 전용 클라이언트와 게이트웨이 - 2026-10: 주민 NPC 에이전트, Java Edition 게이트웨이, 밸런스 시뮬레이터, 1.26.60 대응 - 2026-11: 협동 던전 ## 설계 / 패턴 - 엔진/게임 분리: 포크한 Dragonfly 엔진 위에 약 90개 게임 패키지(전투·직업·아이템·던전·퀘스트·스토리·길드·거래소·주민 등)를 얹은 구조 - 전투: 입력을 이벤트 버스로 받아 아이템 스킬 훅을 실행하고, 하나의 공격 처리 경로에서 10단계 피해 계산을 거친다 - 데이터: 계정·프로필·길드·랭킹은 ent ORM으로 SQLite(WAL)에, 콘텐츠(던전 122·퀘스트 200·스토리 44)는 JSON 설정으로 분리 - 접속 경로: Bedrock 직접 접속, 전용 클라이언트 게이트웨이, Java Edition 게이트웨이가 모두 같은 서버 세션 경로로 들어온다 - 운영 안전장치: 라이브 서버에서는 에이전트가 재시작·접속 테스트를 하지 못하게 하는 규칙, 업스트림 병합 검증 절차 ## 핵심 구현 기능 ### 전투와 빌드 시스템 무기·유물·방어구·직업 특성을 조합하는 빌드와, 10단계로 계산되는 피해 공식. **동작 방식** - 플레이어 입력을 이벤트 버스로 받아 장착 아이템의 스킬 훅을 실행하고, 모든 피해는 하나의 공격 처리 경로를 지난다. - 피해는 기본 피해 → 전체·속성 피해 보너스 → 속성 상성 → 피해 증가 → 치명타 → 방어(대상의 남은 체력 비율 반영) → 받는 피해 보정 → 속성 특수 효과 → 최종 증가 → 후처리 순서로 계산한다. - 속성은 없음·빛·어둠·불·물·번개·대지 7종이고, 번개와 대지는 고유 규칙이 있다. - 장비는 레벨, 인챈트(최대 6칸), 한계 돌파(I~V), 15레벨마다 고르는 돌파 효과, 같은 장비로 하는 초월로 성장한다. 계정 레벨(명성)은 기본 능력치를 올리지 않아 성장이 장비에 묶이게 했다. **사용 기술**: Go, 이벤트 버스 ### 퀘스트·스토리 저작 파이프라인 코드를 고치지 않고 JSON과 게임 안 도구로 퀘스트·스토리·던전·길 안내를 만든다. **동작 방식** - 퀘스트(메인·사이드·일일·주간·랭크·월드·도전)와 스토리, 던전을 JSON 설정으로 정의한다. 현재 던전 122개, 퀘스트 200개, 스토리 44개다. - 스토리는 컷신 상태 머신이다. 스토리가 태그를 붙이면 퀘스트 단계가 진행되고, 그 단계가 NPC와 던전을 열고, 던전 클리어가 다음 스토리를 시작한다. - 전용 클라이언트 안에서 동작하는 스토리 장면 편집기와 던전 편집기를 만들었다. - 게임 안에서 '경로 막대'로 길 그래프를, '구역 막대'로 다각형 구역을 그린다. 퀘스트 목표까지 **다익스트라로 경로를 찾아** 플레이어별 화살표 입자로 안내한다. **사용 기술**: JSON, Dijkstra, In-game 에디터 ### 주민·모험가 NPC 에이전트 사람과 같은 방식으로 접속해 스스로 플레이하고 배우는 NPC. LLM을 쓰지 않는다. **동작 방식** - NPC가 전용 클라이언트 게이트웨이를 통해 **실제 플레이어 세션으로 접속**해, 사람과 같은 관찰과 입력으로 움직인다. - 직접 짠 행동 계획에 더해, 빌드 연구에는 UCB 기반 문맥 다중 슬롯 밴딧을 쓰고 아이템을 직접 써 보고 결과를 보며 아이템의 의미를 배운다. - 감정·성격·용량이 정해진 기억(망각 포함)과 세대가 이어지는 '환생'이 있고, 형태소 사전과 활용·조사 규칙으로 고정 문장 없이 한국어 문장을 만든다. - 마을 주민은 욕구에 따라 생활하며 심부름, 생활 사건, 소문, 선택지가 갈리는 4단계 개인 이야기를 준다. **사용 기술**: Multi-armed Bandit (UCB), 규칙 기반 한국어 문장 생성 **고려 사항** - 설계 문서상 일부 기능은 단위 테스트까지만 확인했고 라이브 서버에서 관찰은 아직이다. ### 협동 던전과 콘텐츠 2~4인 협동 던전, 절망의 탑, 거래소 등 함께 즐기는 콘텐츠. **동작 방식** - 협동 던전은 교회·벌집·소굴·농장·절벽 5종의 절차 생성 맵과 로비, 공유 목숨, 제한 시간, 계열별 파티 버프, 협동 토큰 상점으로 구성했다. - 보스는 파괴수, 엔더 군주, 슬라임 왕, 여왕벌, 거대 워든, 트렌트, 예티 등 커스텀 엔티티로 구현했다. - 떠돌이 상인의 가격은 전체 거래 평균과 최근 평균을 30:70으로 섞어 정하고, **NPC 판매는 가격 계산에서 빼서** 가격이 스스로를 끌어올리지 않게 했다. ### 전용 클라이언트와 게이트웨이 Godot로 만든 전용 클라이언트가 서버에 내장된 게이트웨이로 접속한다. **동작 방식** - 전용 클라이언트는 Godot 4(.NET)로 Windows·macOS·Android용으로 만들었고, 서버의 Bedrock 리소스 팩을 직접 읽어 렌더링한다. 이전의 Electron 클라이언트를 대체했다. - 서버에 내장한 게이트웨이가 WebRTC 또는 WebSocket으로 자체 프로토콜을 말하고, Xbox 로그인을 거쳐 일반 Dragonfly 세션 경로로 연결한다. Bedrock 패킷 형식은 이 연결로 오가지 않는다. - Molang 의미 검사 하네스와 헤드리스 접속 테스트로 클라이언트를 검증한다. **사용 기술**: Godot 4 (.NET), Pion WebRTC, WebSocket, Xbox Live 인증 - [루미너스 런처 (전용 클라이언트) 자세히 보기](https://human.minyee2913.net/projects/luminous-launcher) ### Java Edition 접속 게이트웨이 수정하지 않은 Minecraft Java Edition 클라이언트로도 같은 서버에 접속한다. **동작 방식** - Go 서버가 MCProtocolLib 기반 JVM 프런트엔드를 띄우고 관리한다. ViaVersion으로 Java 1.21.6~26.3 클라이언트를 받는다. - Microsoft/Xbox 계정을 연결해 Bedrock과 같은 저장 데이터를 쓴다. - Bedrock 리소스를 버전별 Java 리소스 팩으로 변환하고, Bedrock 폼 UI는 대화창이나 상자 UI로 바꿔 보여 준다. **사용 기술**: Java, MCProtocolLib, ViaVersion **고려 사항** - Bedrock과의 기능 동등성은 아직 일부만 확인됐다. ### Discord 관전 모드 (LUMINOUS LIVE) Discord Activity 안에서 서버의 실제 세계를 실시간으로 보는 관전 모드. **동작 방식** - WebSocket 백엔드가 세계 영역을 스트리밍하고, 브라우저 렌더러가 서버의 실제 Bedrock 리소스 팩 구성을 읽어 그린다. - 게임 서버에는 읽기 전용 접근자 세 개만 추가해 관전 기능이 게임 로직에 영향을 주지 않게 했다. **사용 기술**: Discord Activity, WebSocket ### 운영 자동화와 개발 도구 라이브 서버 운영과 대규모 개발을 받치는 도구들. **동작 방식** - 월드마다 심장 박동 트랜잭션을 보내 10초 안에 처리되지 않으면 정지로 보고, CPU·블록·뮤텍스 프로파일과 고루틴 스택을 자동으로 남긴다. - 네트워크 세션 없이 실제 플레이어 객체를 조종하는 헤드리스 밸런스 시뮬레이터로 전투 밸런스를 확인한다. - 장비·유물·직업 데이터를 Notion으로 단방향 동기화하고, 리소스 팩을 6개로 나눠 빌드하며, 실제 플레이를 녹화해 영상을 편집하는 도구와 신규 유저 이탈 분석 도구를 만들었다. - 테스트 파일 111개(그중 110개 직접 작성)로 메모리 월드 위 통합 테스트를 돌린다. - AI 코딩 에이전트를 위한 규칙을 문서로 두었다: 증거 없이 '고쳤다/검증했다'라고 쓰지 않기, 측정 수치는 조건과 함께 보고하기, 봇 결과를 사람 테스트로 내세우지 않기, 업스트림 병합 후 양쪽 부모 비교와 2인 접속 테스트. - 반복 작업은 Claude Code 스킬로 만들었다: 실행 중인 서버에 콘솔 명령을 보내고 로그를 읽는 스킬, 실제 플레이를 녹화·편집해 장비 소개 영상(롱폼·숏폼·썸네일)을 만드는 스킬. **사용 기술**: pprof, Go test, Notion API ## 기술적 문제 해결 ### Bedrock 1.26.40 업그레이드 후 접속이 끊기는 문제 [해결] - 문제 상황: Bedrock 1.26.30(프로토콜 1001)에서 1.26.40(프로토콜 2168)으로 올린 뒤 클라이언트가 접속 중 끊겼고, 일부 문제는 두 번째 플레이어가 들어올 때만 나타났다. - 원인 분석: Dragonfly가 플레이어 목록 항목의 **빌드 플랫폼 값을 채우지 않았는데**, 1.26.40부터 클라이언트가 이를 거부했다. 플레이어 추가 패킷에도 같은 문제가 있어 2인 접속에서만 드러났다. - 해결 과정: - 경쟁하던 업스트림 PR 두 개 중 하나를 골라 그 위에서 작업했다. - Mojang의 프로토콜 스키마 문서와 패킷 추적·검증 도구로 패킷을 비교했다. - 오래된 아이템 목록과 블록 팔레트도 고쳤지만 원인은 아니었고, 추측으로 넣었던 스킨 관련 수정 세 개는 되돌렸다. - 세션의 플레이어 목록·추가 처리에 빌드 플랫폼 값을 넣어 해결하고, 빗나간 추측 네 가지를 회고 문서로 남겼다. - 적용한 기술 / 접근: gophertunnel, 패킷 추적, 프로토콜 스키마 비교 - 결과: 1.26.40에 이어 1.26.45, 1.26.50, 1.26.60(프로토콜 2225)까지 버전을 따라 올렸다. ### 트랜잭션이 끝난 플레이어 객체로 인한 서버 패닉 [해결] - 문제 상황: 던전을 클리어할 때 퀘스트 점수를 올리는 과정에서 서버가 패닉으로 멈췄다. - 원인 분석: 월드 트랜잭션 안에서 얻은 플레이어 객체를, 그 트랜잭션이 끝난 뒤 클리어 처리에서 다시 썼다. 퀘스트 점수 API에 새로 넣은 월드 확인이 이 낡은 객체에 접근했다. - 해결 과정: - 클리어와 보상 처리를 **새 트랜잭션 안에서** 다시 실행하도록 바꾸고, 접속이 끊긴 플레이어는 건너뛴다. - 퀘스트 점수 API는 바뀌지 않는 엔티티 핸들로 플레이어를 찾아 단계마다 새 트랜잭션에서 실행하게 했다. - 지연 실행되는 상태 이상 처리에도 같은 방식을 적용했다. - 결과: 트랜잭션이 끝난 뒤에 호출해도 안전한 API 계약을 지키면서 패닉이 사라졌다. ### 호위 NPC가 땅에 묻히고 점프가 초기화되는 문제 [해결] - 문제 상황: 호위 퀘스트의 NPC가 시작할 때 땅속에 묻히고, 점프가 계속 초기화되어 길을 따라오지 못했다. - 원인 분석: 틱마다 엔티티 래퍼가 새로 만들어지는데 점프 속도를 래퍼에 저장해서 매번 사라졌다. - 해결 과정: - 속도를 엔티티 데이터 쪽으로 옮겼다. - 발판 탐색을 위아래 3블록으로 제한하고, 수평은 길 그래프를 따르고 높이는 중력에 맡겼다. - 3초 이상 막히면 몇 블록 앞으로 옮기고, 플레이어가 12블록 넘게 떨어지면 기다린다. - 던전의 강제 경유 지점 대신 경로 30%·70% 지점에 조우 이벤트를 두었다. - 결과: 호위 NPC가 지면을 따라 길을 안정적으로 이동한다. ### 서버 정지와 DB 대기 병목 [부분 해결] - 문제 상황: 월드 처리가 막히면 서버가 통째로 종료되거나, 플레이어 저장이 줄줄이 밀렸다. - 원인 분석: 월드 처리가 10ms 넘게 막히면 프로세스를 강제 종료하는 코드가 있었고, 실행 시간 측정이 채널 전송 시간만 재고 있었다. SQLite 연결 하나에 동시 저장이 몰렸고, 사용자 조회가 동기식이었다. - 해결 과정: - 성능 분석 보고서로 원인을 정리하고 SQLite를 WAL 모드로 바꿨다. - 강제 종료를 없애고, 월드 정지를 감지하면 프로파일과 고루틴 스택을 자동으로 남기는 워치독을 만들었다. - 결과: 정지가 생겨도 서버가 죽지 않고, 원인을 추적할 자료가 자동으로 쌓인다. - 남은 문제: 워치독 보고서에 간헐적으로 긴 틱이 기록되어 계속 추적하고 있다. ### 전용 클라이언트의 지연과 메모리 [해결] - 문제 상황: 전용 클라이언트에서 상태 응답이 한 프레임씩 늦게 적용되고, 메모리를 많이 썼다. 접속 직후 다른 엔티티 모델이 몇 초 동안 보이지 않았다. - 원인 분석: 엔티티 모델 준비가 리소스 팩 색인 작업 뒤에 한 줄로 서 있었고, 그 색인이 접속한 뒤에야 시작됐다. 지형 데이터와 상태 처리에도 불필요한 복사와 할당이 많았다. - 해결 과정: - 리소스를 준비하는 동안 엔티티 색인을 미리, 병렬로 만들어 두게 했다. - 도착한 프레임에 바로 응답을 적용하고, 지형 배열과 섹션 인코딩 형식을 줄였다. - 결과: 개발 PC의 로컬 서버에 WebRTC로 접속해 같은 위치·입력으로 반복 측정한 결과다. 휴대폰에서는 따로 측정하지 않았다. | 항목 | 개선 전 | 개선 후 | | --- | --- | --- | | 접속 후 첫 엔티티 모델 표시 | 3.1 s | 중앙값 60~130 ms | | 상태 왕복 RTT p50 (로컬 서버) | 12.3 ms | 6.0 ms | | 클라이언트 관리 힙 (GC 후) | 643 MB | 191 MB | | 서버 섹션 인코딩 | 3.98 ms | 1.29 ms | | 섹션 데이터 크기 | 39.7 KB | 8.6 KB | ## 링크 - [전용 클라이언트(루미너스 런처) 다운로드](https://luminousrpg.github.io/luminous_launcher/) - [소개 영상](https://youtu.be/KXWGr7WgbKQ) - [개발 과정 재생목록](https://www.youtube.com/playlist?list=PL8M1DnGkh0qNDJc4cs4UIvycqQP5NVUkv) - [기획 문서 (Notion)](https://luminous-rpg.notion.site/146ab655c564453c8ce716dc37aabda6) ## 미디어 - 영상: https://youtu.be/KXWGr7WgbKQ (루미너스 원더러스트: 당신만의 조합으로 펼치는 모험) - 이미지: https://human.minyee2913.net/img/games/luminous/woodland-skill.jpg (우드랜드 수호자의 유산: 장비 스킬 '대지의 이름으로!') - 이미지: https://human.minyee2913.net/img/games/luminous/woodland-combo.jpg (우드랜드 수호자의 유산: 추천 조합 연계) - 이미지: https://human.minyee2913.net/img/games/luminous/scythe-trait.jpg (투옥의 낫: 특성 '판결') - 이미지: https://human.minyee2913.net/img/games/luminous/scythe-transcend.jpg (투옥의 낫: 초월 효과) - 이미지: https://human.minyee2913.net/img/games/luminous/staff-attack.jpg (레드스톤 흑마 스태프: 일반 공격 '폭렬을 다루는 자') - 이미지: https://human.minyee2913.net/img/games/luminous/staff-combo.jpg (레드스톤 흑마 스태프: 추천 조합 연계 '영창 선언') 원문 페이지: https://human.minyee2913.net/projects/luminous-wanderlust --- # 마인크래프트에서 만나는 제주바다 > 한국해양과학기술원 제주연구소 교육용 Minecraft 맵의 확장 기능 개발 (외주 개발·유지보수) 한국해양과학기술원 제주연구소의 '찾아가는 해양과학교실'에서 쓰는 Minecraft Bedrock 교육 콘텐츠. 조간대 생물 채집, 생물 도감, 배양 실험 미니게임을 Script API로 개발하고 기존 기능을 유지보수했다. - 페이지: https://human.minyee2913.net/projects/kiost-jeju - 카테고리: 마인크래프트 개발 - 개발 기간: 2024.07 ~ 2025 - 개발 상태: 개발 완료 - 플랫폼: MCBE ADDON - 장르: 교육, 외주 - 사용 언어: JavaScript - 프레임워크 / 라이브러리: Minecraft Script API (@minecraft/server), @minecraft/server-ui, Blockbench (커스텀 엔티티) - 주요 기술: dynamicProperty 저장, 비동기 처리, 커스텀 엔티티 UI ## 프로젝트 소개 한국해양과학기술원 제주연구소가 학생들을 찾아가 진행하는 '상상이 현실이 되는 찾아가는 해양과학교실'에서 쓰는 마인크래프트 콘텐츠다. 네이버 카페 '우리들의 마인크래프트 공간'을 운영하는 (주)우마공크리에이티브와 계약해 참여했다. KIOST가 교육 페이지에서 제주바다 맵과 워크북·관찰 가이드북을 공개 배포하고, 채집·배양·추출·양식배양·관찰 퀘스트로 해양과학 실험을 체험하게 한다. 그중 **QUEST 4 양식배양 실험**(수조에 알맞은 설정값 찾기)과 **QUEST 5 조간대 관찰 탐구**(조간대 생물 채집·관찰)가 아래 작업에 해당한다. 조간대 맵을 추가하는 계획에 맞춰 **조간대 콘텐츠 전반**(생물 추가·배치·채집, 도감, 배양 실험)을 맡았고, 기존 기능의 유지보수와 개선도 함께 했다. 연구소에서 구역별 생물 수와 종류, 점수 계산 방법, 기획안을 받아 협의하며 진행했다. ## 개발 연혁 - 2024-07: 제주연구소 홍보 교육기부 콘텐츠 제2차 개발 용역 (~2024-12) - 2025-02: 온라인 교육 홍보 콘텐츠 유지보수 용역 시작 ## 핵심 구현 기능 ### 조간대 생물 채집 블록을 캐서 얻는 채집과 채집통으로 찾는 탐사 채집 두 가지. **동작 방식** - 채집할 수 있는 블록 근처에 가면 효과음과 좌클릭 아이콘으로 알려 준다. 플레이어 주변 블록을 검사하되, 아이콘이 너무 많이 뜨지 않게 확률로 표시한다. - 캐낸 블록은 주기적으로 복구하고, 그 위치의 청크가 로드되지 않았으면 다음 복구 때 다시 시도한다. - 연구소 자료대로 좌표 구역을 나누고, 구역 안의 무작위 좌표에 정해진 수만큼 생물을 소환한다. - 멀리 있는 생물 엔티티는 잠시 없애 엔티티가 너무 많아져 느려지는 것을 막는다. ### 조간대 생물 도감 **동작 방식** - 현황실 전광판과 PC 화면에서 도감을 본다. 처음 얻은 생물은 '???'로 보이고, 현미경으로 관찰해야 도감에 등록된다. - 생물마다 크기·수심·서식 위치·식성 같은 상세 정보를 보여 주고, 기록은 dynamicProperty에 저장한다. - Bedrock Edition에는 월드 안에 글과 그림을 그대로 띄우는 기능이 없어서, 별도 엔티티로 전광판을 만들고 주기적으로 갱신했다. **사용 기술**: dynamicProperty, @minecraft/server-ui ### 배양 실험 미니게임 **동작 방식** - 클로렐라·미역·성게·돌돔 수조의 온도와 광주기를 정하면, 설정에 따라 손실이 생겨 생물 수가 줄어든다. 회차마다 슬러지를 걷어 내야 한다. - 끝나면 회차별 점수와 살아남은 개체 수가 적힌 결과지가 나온다. 점수는 연구소가 준 계산 방법대로 구현했다. - 연구소의 처음 기획은 정답을 입력하는 퀴즈였는데, 더 게임답게 바꾸자고 제안해 협의 끝에 지금 형태가 되었다. ## 링크 - [KIOST 공식 페이지: 마인크래프트에서 만나는 제주바다](https://www.kiost.ac.kr/edu/sub05_05.do) - [제주바다 맵·워크북 다운로드 (KIOST)](https://www.kiost.ac.kr/edu/sub05_05.do) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/map.jpg (마인크래프트로 옮긴 제주 바다 맵) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/collect.jpg (조간대 생물 채집: 채집할 수 있는 곳에 좌클릭 아이콘이 뜬다) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/board.jpg (현황실 전광판 도감 (처음 얻은 생물은 ???)) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/dex.jpg (PC 화면의 생물 도감) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/microscope.jpg (현미경으로 관찰해 도감에 등록) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/dex-detail.jpg (생물 상세 정보 (크기·수심·서식 위치·식성)) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/aquarium.jpg (배양 실험 수조) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/tank.jpg (수조 컨트롤러: 클로렐라·미역·성게·돌돔) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/tank-ui.jpg (수조 온도와 광주기 설정) - 이미지: https://human.minyee2913.net/img/games/kiost-jeju/result.jpg (실험 결과지: 회차별 점수와 생존 개체 수) 원문 페이지: https://human.minyee2913.net/projects/kiost-jeju --- # Valorant Addon 마인크래프트에서 발로란트의 캐릭터와 총기 시스템을 구현한 마인크래프트 BE 애드온 프로젝트. - 페이지: https://human.minyee2913.net/projects/valorant - 카테고리: 마인크래프트 개발 - 개발 기간: 2023 - 플랫폼: MCBE ADDON - 사용 언어: mcfunction ## 링크 - [GitHub](https://github.com/minyee2913/valorant-addon) - [YouTube](https://youtu.be/27_Dz3ObTzc) ## 미디어 - 영상: https://youtu.be/27_Dz3ObTzc (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/valorant/1.jpg (마인크래프트 안에 구현한 발로란트 총기) 원문 페이지: https://human.minyee2913.net/projects/valorant --- # Video Particle 영상 파일 데이터를 추출해서 마인크래프트 내 파티클로 영상을 그대로 구현하고 재생하는 외부 프로그램. - 페이지: https://human.minyee2913.net/projects/video-particle - 카테고리: 마인크래프트 개발 - 개발 기간: 2023 - 플랫폼: STANDALONE PROGRAM - 사용 언어: TypeScript - 프레임워크 / 라이브러리: Node.js, fluent-ffmpeg (영상 프레임 추출), Jimp (이미지 픽셀 읽기) ## 링크 - [GitHub](https://github.com/minyee2913/videoParticle) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/video-particle/1.jpg (영상을 마인크래프트 파티클로 재생한 화면) 원문 페이지: https://human.minyee2913.net/projects/video-particle --- # Block Beat 키 입력이 아닌 마우스로 에임을 돌려 노트를 치는 마인크래프트 BE 맵 기반 리듬게임. - 페이지: https://human.minyee2913.net/projects/blockbeat - 카테고리: 마인크래프트 개발 - 개발 기간: 2023 - 플랫폼: MCBE MAP - 장르: 리듬 ## 링크 - [YouTube](https://youtu.be/ndHBnaODyos?si=-V5IA7Lzn82Enl7G) ## 미디어 - 영상: https://youtu.be/ndHBnaODyos (플레이 영상) - 이미지: https://human.minyee2913.net/img/games/blockbeat/1.jpg (Block Beat 타이틀과 플레이 화면) 원문 페이지: https://human.minyee2913.net/projects/blockbeat --- # UnityUtils > 게임마다 반복되는 체력·스탯·카메라 연출을 모아 둔 Unity 공용 라이브러리 Unity 개발을 간소화하려고 만든 C# 공용 모듈 모음. 체력·스탯·버프·카메라 연출·사운드·데미지 표시 등을 IGNOTUS, 생존 전략! 등 여러 게임에서 함께 쓴다. - 페이지: https://human.minyee2913.net/projects/unity-utils - 카테고리: 프로그램 개발 - 개발 기간: 2025.03 ~ 현재 - 개발 상태: 개발 중 - 플랫폼: Unity 라이브러리 - 게임 엔진: Unity - 사용 언어: C# - 프레임워크 / 라이브러리: Cinemachine 3 (필수 패키지) - 주요 기술: 이벤트 기반 데미지 파이프라인, 버프 기반 스탯 계산, 코루틴 카메라 연출, 제네릭 싱글톤 ## 프로젝트 소개 Unity 개발을 간소화하려고 여러 게임에서 반복해서 쓰는 체력, 스탯, 카메라 연출, 쿨타임 같은 기능을 한 저장소로 모았다. 이 사이트의 **IGNOTUS, 생존 전략!, Albedo, 하늘오름, 내가 찻잔이라니!**가 UnityUtils를 쓴다. ## 핵심 구현 기능 ### HealthObject: 취소·수정할 수 있는 데미지 이벤트 피격·가해·처치·회복을 이벤트로 열어 두고, 최종 피해가 정해지기 전에 끼어들 수 있게 했다. **동작 방식** - OnDamage·OnGiveDamage·OnKill·OnHeal·OnDamageFinal 같은 이벤트를 Start/Awake에서 등록한다. - 피해를 주고받는 단계의 이벤트에서는 피해량을 바꾸거나 피해 자체를 취소할 수 있다. - Final 계열 이벤트는 모든 계산이 끝난 최종 피해를 받기만 한다. ### StatController: 기초값은 고정, 변화는 버프로만 **동작 방식** - 처음 정한 기초값은 바뀌지 않고, 이후의 모든 수치 변화는 버프로만 일어난다. 그래서 버프를 지우면 언제나 원래 값으로 돌아간다. - 버프는 기초값에 더하기, 퍼센트 증가처럼 계산 방식을 고를 수 있다. - 스탯은 문자열 키로 구분해서, 키만 새로 주면 스탯 종류를 얼마든지 늘릴 수 있다. ### CamEffector: 어디서나 부르는 카메라 연출 **동작 방식** - CamEffector.Current로 지금 화면을 찍는 카메라의 연출 컴포넌트를 바로 가져온다. - 화면 흔들기(Shake), 확대(CloseUp), 원래대로(CloseOut)를 코루틴으로 구현했다. Cinemachine 3을 기반으로 한다. **사용 기술**: Cinemachine, Coroutine ### 그 밖의 모듈 **동작 방식** - Cooldown(쿨타임), RangeController(범위 안 오브젝트 감지), Projectile2D, SoundManager, UIBasePanel(UI 패널 추상 클래스) - IndicatorManager(데미지 숫자 같은 텍스트 오브젝트 생성), Singleton(제네릭 추상 클래스), Kits(편의 함수) - 저장소에는 그라디언트 이미지·텍스트, 로딩 화면 전환, 레이어 설정, 회전 오브젝트 스크립트도 들어 있다. ## 링크 - [GitHub](https://github.com/minyee2913/unityUtils) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/unity-utils/health.jpg (HealthObject 인스펙터) - 이미지: https://human.minyee2913.net/img/games/unity-utils/health-events.jpg (HealthObject 이벤트 등록 예시) - 이미지: https://human.minyee2913.net/img/games/unity-utils/stat.jpg (StatController 인스펙터 (키별 스탯 정의)) - 이미지: https://human.minyee2913.net/img/games/unity-utils/stat-buff.jpg (스탯 버프 추가와 계산 예시) 원문 페이지: https://human.minyee2913.net/projects/unity-utils --- # myPage (이 포트폴리오 사이트) > 프로젝트 데이터 하나로 화면·검색엔진·AI용 문서를 함께 만드는 정적 포트폴리오 지금 보고 있는 포트폴리오 사이트. React로 만들고 빌드할 때 모든 페이지를 정적 HTML로 미리 그려, JavaScript 없이도 내용이 보이고 검색엔진과 AI가 읽을 수 있게 했다. - 페이지: https://human.minyee2913.net/projects/mypage - 카테고리: 프로그램 개발 - 개발 기간: 2024.01 ~ 현재 - 개발 상태: 개발 중 - 플랫폼: Web (GitHub Pages) - 사용 언어: TypeScript - 프레임워크 / 라이브러리: React 18, React Router, esbuild (프리렌더 번들) - 주요 기술: 빌드 타임 정적 생성, JSON-LD, Canvas 2D, Web Audio ## 프로젝트 소개 직접 만든 게임을 게시하려고 2024년에 만든 사이트다. 처음엔 내용을 많이 채우지 못했고, 이후 프로젝트마다 공식 사이트 같은 상세 페이지와 크롤러·AI 접근성을 갖추도록 다시 만들었다. 모든 프로젝트 정보는 TypeScript 데이터 파일 하나에서 나온다. 같은 데이터로 화면, 정적 HTML, 메타 태그와 구조화 데이터(JSON-LD), sitemap.xml, llms.txt, projects.json, 프로젝트별 Markdown을 만들어 내용이 서로 어긋나지 않는다. ## 핵심 구현 기능 ### 빌드 타임 정적 생성 **동작 방식** - 빌드 마지막 단계에서 앱을 서버 렌더링(renderToString)해 페이지마다 완성된 HTML을 쓴다. 브라우저에서는 그 위에서 앱이 다시 시작된다. - 봇에게만 다른 내용을 주지 않고, 사람과 크롤러가 같은 HTML을 받는다. - 빌드할 때 데이터 형식을 검사하고, 공개 산출물에 비밀값처럼 보이는 문자열이 섞였으면 빌드를 멈춘다. - 배포 전후로 모든 페이지의 상태 코드, 제목, 핵심 문구, 이미지 응답을 HTTP로 확인하는 검증 스크립트를 돌린다. ### 게임별 진입 연출과 효과음 **동작 방식** - 상세 페이지를 열 때 게임마다 다른 연출이 화면을 걷어 낸다. 발도 일섬, 불타는 종이, 깨지는 유리, 피자 상자 던지기 등을 Canvas 2D로 그린다. - 효과음은 음원 파일 없이 Web Audio로 합성한다. 16비트 게임기처럼 펄스파·FM 음색을 32kHz로 계산하고, 연출의 충돌 순간에 맞춰 재생한다. 기본은 꺼져 있다. - 동작 줄이기 설정을 켠 사용자에게는 연출을 건너뛴다. ### YouTube 지연 로딩 **동작 방식** - 영상은 썸네일만 먼저 보여 주고, 눌렀을 때 플레이어를 불러온다. 영상이 재생되는 동안에는 미디어 카드가 자동으로 넘어가지 않는다. ## 링크 - [사이트](https://human.minyee2913.net/) - [GitHub](https://github.com/minyee2913/mypage) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/mypage/2024.jpg (2024년에 처음 만든 사이트 메인 화면) 원문 페이지: https://human.minyee2913.net/projects/mypage --- # mcCmd > 마인크래프트 명령어 문법으로 코딩하는 스크립트 언어 (C++ 인터프리터) 마인크래프트 명령어처럼 생긴 문법으로 코딩해 보고 싶어서 만든 스크립트 언어. C++로 토큰 분해부터 스코프와 함수 호출까지 인터프리터를 직접 구현했다. - 페이지: https://human.minyee2913.net/projects/mccmd - 카테고리: 프로그램 개발 - 개발 기간: 2023.09 ~ 2023.10 - 개발 상태: 개발 완료 - 플랫폼: 인터프리터 (콘솔) - 사용 언어: C++ - 주요 기술: 토큰 분해, 스코프 체인, 인터프리터, VS Code 확장 ## 프로젝트 소개 마인크래프트 명령어로 코딩을 해 보고 싶다는 생각에서 시작한 언어다. 같은 저장소 그룹에 문법 문서와 VS Code 확장도 있다. ## 핵심 구현 기능 ### 문법 **동작 방식** - @는 변수·함수 정의, /는 명령·함수 호출, #...!#는 코드 블록이다. - 전역 변수와 지역 변수를 모두 지원한다. *포트폴리오 114쪽의 문법 예시를 옮겨 적었다.* ```mccmd @ data[type=string]; @ /input # @ data1[type=string]; /say "지역 변수를 입력하세요: "; /replaceitem @data1; /say "전역 변수를 입력하세요: "; /replaceitem @data; !#; @ /output # /input; /say "전역변수 @data*"; /say "지역변수 @data1*"; !#; /output; ``` ### 토큰 분해와 명령 구조 **동작 방식** - 코드 파일 전체를 문자열로 읽고 한 글자씩 검사한다. ;를 만나면 직전 위치부터 지금까지를 잘라 한 줄로 저장하는 식으로 코드를 줄 단위로 나눈다. - 나눈 줄은 Command 구조체에 담기고, 이때 정의(define)인지 호출(callFunction)인지가 정해진다. - 매개변수·문자열·코드 블록은 띄어쓰기를 기준으로 한 번 더 나눈다 (ChildToken). ### 스코프와 함수 **동작 방식** - 전역·지역 스코프가 함수와 변수를 저장하고 찾는다. 실행은 전역 스코프에서 시작한다. - 함수는 자기 지역 스코프를 가진다. 블록 안의 코드는 토큰 상태로 보관해 두었다가 호출될 때 실행한다. - 함수나 코드 블록이 만든 스코프는 그것을 정의한 스코프를 부모로 삼아, 바깥 변수를 차례로 찾아 올라간다. ## 링크 - [mcCmd-plus (C++ 인터프리터)](https://github.com/mcCmd-language/mcCmd-plus) - [문법 문서](https://github.com/mcCmd-language/mcCmd-docs/tree/main/docs) - [VS Code 확장](https://github.com/mcCmd-language/mcCmd-vsCode-extension) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/mccmd/logo.jpg (mcCmd 로고) - 이미지: https://human.minyee2913.net/img/games/mccmd/syntax.jpg (문법 예시: 변수 정의(@), 명령 호출(/), 코드 블록(#…!#)) - 이미지: https://human.minyee2913.net/img/games/mccmd/tokenize.jpg (코드를 한 글자씩 검사해 ; 단위로 나누는 부분) - 이미지: https://human.minyee2913.net/img/games/mccmd/command.jpg (나눈 코드를 Command 구조체에 담고 종류(정의·호출)를 정한다) - 이미지: https://human.minyee2913.net/img/games/mccmd/childtoken.jpg (매개변수·문자열·코드 블록을 다시 나누는 ChildToken) - 이미지: https://human.minyee2913.net/img/games/mccmd/implement.jpg (Command 정보로 실제 기능을 수행하는 Implementing) - 이미지: https://human.minyee2913.net/img/games/mccmd/scope.jpg (전역·지역 스코프에서 함수와 변수를 저장하고 찾는다) - 이미지: https://human.minyee2913.net/img/games/mccmd/function.jpg (함수는 지역 스코프를 갖고, 정의한 스코프를 부모로 삼는다) 원문 페이지: https://human.minyee2913.net/projects/mccmd --- # 2913SimpleDB > 데코레이터로 테이블을 정의하는 BDSX용 SQLite 패키지 (npm 공개) 클래스 필드에 데코레이터를 붙이면 SQLite 테이블과 쿼리가 만들어지는 TypeScript 데이터베이스 패키지. 마인크래프트 서버 프레임워크 BDSX에서 쓰려고 만들어 npm에 공개했다. - 페이지: https://human.minyee2913.net/projects/2913-simple-db - 카테고리: 프로그램 개발 - 개발 기간: 2023.09 - 개발 상태: 개발 완료 - 플랫폼: npm 패키지 (@bdsx/2913simpledb) - 사용 언어: TypeScript - 프레임워크 / 라이브러리: sqlite-sync, BDSX - 주요 기술: 데코레이터, SQLite, 스키마 자동 반영 ## 프로젝트 소개 마인크래프트 Bedrock 서버 프레임워크 BDSX(Node.js·ChakraCore)에서 쓰려고 만든 패키지라 sqlite-sync를 기반으로 했다. 쿼리를 손으로 쓰다 빠뜨릴 걱정 없이 데이터를 다루는 것이 목표다. ## 핵심 구현 기능 ### 데코레이터로 테이블 정의 **동작 방식** - @Database.field(TEXT / INTEGER / NUMERIC / REAL / BOOLEAN)를 클래스 필드에 붙이고, PRIMARY\_KEY·NOTNULL·AUTOINCREMENT·UNIQUE 옵션을 준다. - 클래스 필드를 읽어 쿼리를 만든 뒤 SQLite에 보내서, 쿼리를 손으로 쓰지 않아도 된다. ### 필드 변경 즉시 반영과 JSON 저장 **동작 방식** - 필드 구성이 바뀌면 테이블을 다시 만들고 값을 다시 넣어 바로 반영한다. - 객체 값은 JSON\_TEXT 타입으로 저장하고, 읽을 때 다시 객체로 돌려준다. - insert / get / update / hasData / delete / values와 파일에서 일괄 입력하는 insertFromFile을 제공하고, 서버가 닫힐 때 DB를 자동으로 닫는다. ## 링크 - [GitHub](https://github.com/minyee2913/2913simpleDB) - [npm](https://www.npmjs.com/package/@bdsx/2913simpledb) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/2913-simple-db/table.jpg (데코레이터로 테이블을 정의하는 예시) 원문 페이지: https://human.minyee2913.net/projects/2913-simple-db --- # ChikChat > 과제로 만든 PC용 실시간 채팅 앱 실시간 채팅, 회원 관리, 로그인·회원가입, 시스템 트레이 최소화를 지원하는 PC용 채팅 앱. 과제로 만들었다. - 페이지: https://human.minyee2913.net/projects/chikchat - 카테고리: 프로그램 개발 - 개발 기간: 2023.11 - 개발 상태: 개발 완료 - 플랫폼: PC (데스크톱 앱) - 사용 언어: JavaScript ## 프로젝트 소개 과제로 만든 PC용 채팅 앱이다. 실시간 채팅과 회원 관리, 로그인·회원가입을 지원하고, 시스템 트레이로 최소화할 수 있다. ## 핵심 구현 기능 ### 주요 기능 **동작 방식** - 실시간 채팅 - 회원 관리, 로그인·회원가입 - 시스템 트레이 최소화 ## 링크 - [GitHub](https://github.com/mcCmd-language/chikchat) ## 미디어 - 이미지: https://human.minyee2913.net/img/games/chikchat/1.jpg (채팅 화면) 원문 페이지: https://human.minyee2913.net/projects/chikchat