Warudo 블루프린트 시스템
Warudo의 **블루프린트(Blueprint)**는 코드를 작성하지 않고도 복잡한 로직을 만들 수 있는 비주얼 프로그래밍 시스템입니다.
블루프린트란?
블루프린트는 **노드(Node)**를 연결해서 동작을 정의하는 방식입니다. 각 노드는 하나의 기능을 수행하며, 노드끼리 선으로 연결하면 데이터와 실행 흐름이 전달됩니다.
예를 들어, "채팅에서 특정 단어가 오면 캐릭터가 손을 흔든다"는 동작을 만들려면:
- 이벤트 노드 — 채팅 메시지 수신을 감지
- 조건 노드 — 특정 단어가 포함되었는지 판별
- 애니메이션 노드 — 손 흔드는 동작 재생
이 세 노드를 연결하면 완성됩니다.
노드의 구조
모든 노드는 **포트(Port)**를 통해 다른 노드와 연결됩니다. 포트는 두 종류로 나뉩니다:
데이터 포트 (Data Port)
값을 전달합니다. 숫자, 문자열, Boolean, 벡터 등 다양한 타입의 데이터가 흐릅니다.
- Data Input — 노드가 받는 값 (왼쪽에 표시)
- Data Output — 노드가 내보내는 값 (오른쪽에 표시)
플로우 포트 (Flow Port)
실행 순서를 제어합니다. "이 노드 다음에 어떤 노드를 실행할 것인가"를 결정합니다.
- Flow Input — 이 노드의 실행을 시작하는 진입점 (왼쪽, 삼각형)
- Flow Output — 실행이 끝난 후 다음으로 넘어가는 출구 (오른쪽, 삼각형)
데이터 포트는 "무엇을"에 해당하고, 플로우 포트는 "언제"에 해당합니다. 데이터 포트만 있는 노드(예: 수학 연산)는 연결된 다른 노드가 값을 요청할 때 자동으로 계산됩니다. 플로우 포트가 있는 노드는 명시적으로 실행 순서가 지정되어야 합니다.
노드 페이지 읽는 법
각 노드 문서는 같은 형식으로 되어 있습니다. 예시(For Loop 노드):
- 인용문(맨 위) — 노드가 무엇을 하는지 한 줄 요약입니다.
- 노드 정보 박스 — 어느 카테고리인지, 그리고 노드의 종류를 알려줍니다.
- 실행 노드 — 실행 흐름(▶)을 받아 동작하고 다음으로 넘깁니다.
- 값 노드 — 입력으로 계산한 결과를 출력합니다 (흐름 없음).
- 이벤트 노드 — 특정 사건이 일어나면 스스로 흐름을 시작합니다 (그래프의 시작점).
- 노드 미리보기 — 에디터에서 보이는 노드 모양입니다. 왼쪽=입력, 오른쪽=출력. 데이터 입력의 필드·슬라이더·드롭다운은 에디터에서 값을 정하는 위젯이며, 표시된 숫자는 기본값입니다.
- 입력 / 출력 표 — 각 포트의 종류·타입·기본값·설명을 정리합니다.
- 함께 보면 좋은 노드 — 같은 카테고리의 관련 노드입니다.
포트 색상
Warudo 에디터와 동일하게 표시합니다.
- ▶ 초록 삼각형 — 실행(플로우) 포트
- 흰색 점 — 데이터 포트
포트의 값 타입은 각 노드 페이지의 입력·출력 표에서 확인할 수 있습니다.
카테고리
Warudo에 기본 내장된 노드를 기능별 카테고리로 분류해 왼쪽 사이드바에서 탐색할 수 있습니다.
이 사이트는 Warudo 디컴파일 소스에서 추출한 메타데이터를 학습 목적으로 정리한 비공식 커뮤니티 문서입니다. 실제 동작은 Warudo 버전에 따라 다를 수 있습니다.