워크숍 로직 구성 요소의 이해
에기 파티(Eggy Party) 워크숍은 에기 코드(Eggy Code)를 스크립팅에 활용하여 정교한 로직 시스템을 갖춘 인터랙티브 맵을 제작할 수 있게 해줍니다. 단순한 드래그 앤 드롭 방식의 에디터와 달리, 에기 코드는 변수, 트리거, 이벤트 기반 로직 블록을 통해 진정한 프로그래밍 환경을 제공합니다.
워크숍은 정수(카운트다운 값과 같은 정수), 실수(소수점 정밀도), 불리언(참/거짓 상태), 문자열(텍스트 데이터), Vector3(3D 좌표), 위치(공간 참조) 등 6가지 변수 유형을 지원합니다. 정수 변수는 카운트다운 메커니즘을 만드는 데 필수적입니다.
프리미엄 아이템과 장식 아이템을 원하신다면, BitTopup을 통한 에기 파티 코인 충전으로 빠르고 안전하게, 경쟁력 있는 가격으로 에기 코인을 이용해 보세요.
변수 명명 규칙:
- 문자, 숫자, 언더바(_)만 사용 가능
- 특수 문자나 공백 포함 불가
- 숫자나 언더바로 시작 불가
- 각 트리거 또는 요소 범위 내에서 고유해야 함
타이머 제작을 위한 필수 구성 요소
카운트다운 타이머를 만들려면 시간 값을 저장할 변수, 일정 간격으로 로직을 실행할 트리거, 카운트다운을 표시할 텍스트 위젯이라는 세 가지 핵심 요소가 필요합니다.
이벤트 트리거 영역은 플레이어의 존재를 감지하고 이벤트를 시작합니다. 원뿔형(Cone)과 반구형(Half Sphere) 트리거 영역이 가장 효과적입니다. 감지 범위를 플레이어 엔티티 유형으로 설정하고, 안정적인 활성화를 위해 트리거 중심을 지면에서 1에기(Eggy) 단위 위에 배치하세요.
트리거 크기 설정 권장 사항:
- 지면 설치 트리거: 직경 2~3에기 단위
- 벽면 설치 트리거: 직경 1.5~2에기 단위
- 트리거 간 최소 2에기 단위 간격을 유지하여 중복 충돌 방지
전역 변수는 맵의 모든 트리거에서 사용할 수 있어 여러 요소가 참조하는 카운트다운 타이머에 이상적입니다. 지역 변수는 해당 트리거 그룹 내에서만 존재하며 임시 계산에 유용합니다.
카운트다운 타이머 스크립트 작성하기
'더 보기' 메뉴 > 대상 유닛 선택 > '에기 코드 편집'을 통해 에기 코드에 접속하세요. 그러면 비주얼 스크립팅 인터페이스가 열립니다.
타이머 변수 생성:
- 기본값이 30인
timeRemaining이라는 이름의 정수 변수를 생성합니다. - 맵 전체에서 접근할 수 있도록 전역 범위로 설정합니다.
- 표시를 위해 텍스트 위젯에 '텍스트 내용 설정' 블록을 추가합니다.
- '문자열로 변환' 블록을 사용하여 정수를 표시 가능한 텍스트로 바꿉니다.
카운트다운 로직 구현:
- 1초 간격으로 반복되는 이벤트 트리거를 생성합니다.
timeRemaining에서 1을 빼는 감소 블록을 추가합니다.- '문자열로 변환'을 사용하여 업데이트된 값을 텍스트 위젯에 연결합니다.
timeRemaining이 0에 도달했을 때를 위한 조건부 확인을 설정합니다.- 카운트다운이 완료되면 축하 효과를 트리거합니다.
블록 메뉴의 변수 카테고리에서 변수를 참조하세요. 각 변수 블록은 로직 시퀀스, 수학 연산 또는 표시 기능으로 드래그하여 사용할 수 있습니다.
디스플레이 구성 요소 설정
텍스트 위젯은 카운트다운 값을 표시합니다. '텍스트 내용 설정' 블록을 추가한 후, 이를 '문자열로 변환' 블록을 통해 timeRemaining에 연결하세요. 텍스트 위젯은 정수 값을 직접 표시할 수 없으므로 이 과정이 필수적입니다.
디스플레이는 서 있는 플레이어의 눈높이인 지면에서 보통 3~4에기 단위 높이의 중앙 위치에 배치하세요. 스폰 지점과 같이 유동 인구가 많은 구역에 배치하면 가시성을 극대화할 수 있습니다.
디스플레이 커스터마이징:
- 여러 개의 텍스트 위젯을 레이어링하여 그림자 효과 주기
- 다양한 배경에서도 잘 보이도록 대비되는 색상 사용
- 시청 거리에 따라 텍스트 크기 조절
추가적인 워크숍 리소스가 필요하다면, BitTopup에서 에기 코인 저렴하게 구매하여 필요한 모든 아이템을 빠르게 확보해 보세요.
고급 타이머 메커니즘
기본적인 카운트다운 외에도 고급 구현 방식에는 여러 타이머 상태와 조건부 동작이 포함됩니다. 예를 들어 30초 비활성 타이머로 플레이어 위치를 초기화하거나, 60초 자동 리셋으로 맵을 초기 상태로 되돌릴 수 있습니다.
다단계 카운트다운:
- 분과 초를 위한 별도의 정수 변수 생성
- 나머지 연산(Modulo)을 사용하여 총 초 수를 MM:SS 형식으로 변환
- 임계점(예: 10초는 노란색, 5초는 빨간색)에서 색상 변경 구현
- 텍스트 위젯의 크기 속성을 빠르게 전환하여 펄스(박동) 효과 추가
0.5초의 inputLocked 지속 시간은 카운트다운의 동기화를 해칠 수 있는 급격한 트리거 활성화를 방지합니다. 이 잠금 장치는 매 초가 정확히 한 번씩만 감소하도록 보장하여 멀티플레이어 세션에서도 정확한 시간 측정을 유지합니다.
증가 연산은 반대로 작동합니다. 특정 이벤트 발생 시 정수 변수를 1씩 증가시켜 스톱워치, 점수 추적기 또는 경과 시간 표시기를 만들 수 있습니다.
워크숍 부하량(Intensity) 제한 관리
모든 워크숍 요소는 할당된 부하량 포인트를 소비합니다. 기본 부하량 제한은 18,000에서 시작하며, 장인 포인트(Craftsman Points) 1,000점 달성 시 21,000으로, 10,000점 달성 시 최대 25,000까지 늘어납니다.
기본 타이머 부하량 사용량:
- 정수 변수: 50~100 포인트
- 반복 트리거: 200~300 포인트
- 텍스트 위젯: 150~250 포인트
- 조건부 로직 블록: 개당 50~100 포인트
트리거를 통합하고, 여러 시스템에서 변수를 재사용하며, 게시 전 사용하지 않는 요소를 제거하여 부하량을 최적화하세요. 제한에 걸리지 않도록 부하량 게이지를 수시로 확인해야 합니다.
테스트 및 디버깅
솔로 테스트를 통해 기본 기능을 확인하세요. 카운트다운이 정확한 값에서 시작하는가? 매 초 부드럽게 감소하는가? 0이 되었을 때 올바른 이벤트가 발생하는가? 일관성을 확인하기 위해 전체 카운트다운 사이클을 여러 번 실행해 보세요.
멀티플레이어 동기화는 실제 플레이어들과 함께 테스트해야 합니다. 카운트다운 타이머는 모든 플레이어에게 동시에 동일한 값을 표시해야 합니다.
흔한 타이머 오류:
- 카운트다운 숫자 건너뛰기: 반복 트리거 간격이 잘못됨. 1.0초 타이밍인지 확인하세요.
- 디스플레이에 'undefined' 표시: 변수와 텍스트 위젯 사이에 '문자열로 변환' 블록이 누락됨.
- 타이머가 시작되지 않음: 트리거 활성화 조건 미충족. 감지 범위 설정을 확인하세요.
- 여러 카운트다운이 동시에 실행됨: 이전 타이머가 제대로 리셋되지 않음. 정리 로직을 추가하세요.
에기 코드 튜토리얼에서 공식 가이드를 제공합니다. 튜토리얼 02는 값 블록과 공통 데이터 유형, 03은 제어 및 조건 블록, 04는 변수, 05는 트리거에 대해 자세히 설명합니다.
멀티플레이어 성능 최적화
멀티플레이어 환경에서는 네트워크 효율성이 매우 중요합니다. 매 프레임이 아닌 값이 변경될 때만 디스플레이를 업데이트하여 네트워크 트래픽을 최소화하세요.
중첩된 조건문은 3단계 이하로 유지하여 스크립트 복잡도를 줄이세요. 중첩 단계가 늘어날수록 처리 부하가 증가합니다. 조기 반환(Early returns)이나 별도의 트리거 그룹을 사용하여 로직 구조를 단순화하세요.
메모리 관리:
- 사용하지 않는 변수 삭제
- 비활성화된 트리거 완전히 제거
- 중복된 로직을 재사용 가능한 트리거 그룹으로 통합
최대 플레이어 수로 부하 테스트를 진행하면 솔로 테스트에서는 보이지 않던 성능 병목 현상을 발견할 수 있습니다. 새해 워크숍 제작 기간은 1월 1일 00:00부터 1월 31일 23:59(UTC+8)까지입니다.
실제 구현 패턴
성공적인 새해 카운트다운 맵은 검증된 디자인 패턴을 사용합니다. '중앙 광장' 방식은 거대한 카운트다운 디스플레이를 맵의 중심점에 배치하여 모든 플레이어가 마지막 순간에 모이도록 유도합니다.
'분산형 타이머' 시스템은 맵 곳곳에 작은 카운트다운 디스플레이를 배치하여 플레이어의 위치와 상관없이 시간을 확인할 수 있게 합니다. 이는 플레이어가 여러 구역으로 흩어지는 대형 맵에 적합합니다.
'인터랙티브 카운트다운' 요소는 플레이어가 특정 간격마다 특수 효과를 트리거하게 합니다(예: 10초에 불꽃놀이, 5초에 꽃가루, 0초에 축하 애니메이션). 이러한 단계별 효과는 기대감을 고조시킵니다.
인기 크리에이터들은 카운트다운 타이머를 점진적 난이도 시스템과 결합하기도 합니다. 특정 시간 임계점에서 장애물이 나타나거나 사라지게 하여, 수동적인 시간 측정을 능동적인 게임플레이 메커니즘으로 전환합니다.
카운트다운 타이머 맵 게시하기
게시 전 체크리스트:
- 모든 변수가 올바른 기본값으로 초기화되는지 확인
- 여러 번의 테스트 실행을 통해 트리거가 안정적으로 활성화되는지 확인
- 모든 기기 화면 크기에서 텍스트 디스플레이가 읽기 쉬운지 확인
- 카운트다운 0초 이벤트가 제대로 실행되는지 검증
워크숍 맵 제출 시에는 제작물이 부하량 제한 내에 있어야 하며 커뮤니티 가이드를 준수해야 합니다. 최대 부하량 25,000을 초과하는 맵은 검증을 통과할 수 없습니다.
게임 내 공유, 커뮤니티 포럼, 소셜 채널을 통해 제작물을 홍보하세요. **'새해 카운트다운 파티 광장'**이나 **'2025 축하 타이머 챌린지'**와 같이 설명적인 제목을 사용하면 맵의 목적을 즉시 전달할 수 있습니다.
테스트 세션 중 플레이어의 행동을 관찰하고, 게시된 맵의 댓글을 읽으며, 어떤 기능이 긍정적인 반응을 얻는지 확인하여 피드백을 수집하세요. 피드백을 바탕으로 카운트다운 구현을 지속적으로 개선해 나가세요.
자주 묻는 질문(FAQ)
에기 파티 워크숍에서 카운트다운 타이머는 어떻게 만드나요? 기본값이 30인 timeRemaining이라는 정수 변수를 만들고, 매 초마다 1씩 감소시키는 반복 트리거를 설정한 후, '문자열로 변환' 블록을 사용하여 텍스트 위젯에 값을 표시합니다. 에기 코드는 '더 보기' 메뉴 > '에기 코드 편집'을 통해 접속할 수 있습니다.
새해 카운트다운에 필요한 로직 구성 요소는 무엇인가요? 시간을 저장할 정수 변수, 1초 간격으로 설정된 반복 이벤트 트리거, 표시용 텍스트 위젯, 값 변환을 위한 '문자열로 변환' 블록, 그리고 카운트다운이 0이 되었을 때 축하 효과를 실행할 조건부 로직이 필요합니다.
에기 파티 워크숍에서 카운트다운 숫자를 어떻게 표시하나요? 텍스트 위젯에 '텍스트 내용 설정' 블록을 추가한 다음, 정수 변수를 '문자열로 변환' 블록을 통해 연결하세요. 텍스트 위젯은 정수 값을 직접 표시할 수 없으므로 문자열 변환이 필수입니다.
카운트다운 타이머 스크립트에는 어떤 변수가 필요한가요? 기본적인 카운트다운에는 정수 변수 하나면 충분합니다. 기본값을 원하는 시작 시간(보통 30초 또는 60초)으로 설정하고, 맵 전체에서 접근할 수 있도록 전역 변수로 구성한 뒤 변수 카테고리에서 참조하세요.
워크숍 모드에서 타이머 오류를 어떻게 해결하나요? 반복 트리거가 정확히 1.0초 간격인지 확인하고, '문자열로 변환' 블록이 변수와 텍스트 위젯을 연결하고 있는지 확인하세요. 또한 감지 범위가 플레이어 엔티티 유형으로 설정되어 있는지, 트리거 위치가 지면에서 1에기 단위 위라는 표준을 따르고 있는지 확인하세요.
에기 파티에서 여러 플레이어 간에 카운트다운 타이머를 동기화할 수 있나요? 네, 전역 변수는 맵에 있는 모든 플레이어에게 자동으로 동기화됩니다. timeRemaining에 전역 범위를 사용하면 연결된 모든 클라이언트가 동일한 카운트다운 값을 보게 되어 동기화된 새해 축하 행사를 진행할 수 있습니다.
멋진 워크숍 맵을 만들 준비가 되셨나요? 게임 충전의 신뢰할 수 있는 파트너, BitTopup의 독점 아이템으로 에기 파티 경험을 업그레이드해 보세요. 지금 BitTopup을 방문하여 특별한 혜택을 확인하세요
