텍스트 어드벤처 명령어 도움말: 예시 속 물건을 실제 장면의 물건으로 오해하지 않게 쓰는 법
도움말을 입력 형식, 별도의 연습 예시, 현재 장면의 명령어로 나누고 각 예시에 등장하는 대상의 출처와 실행 전제 조건을 밝힌다. 의자 하나만 있는 가상의 방을 바탕으로 재사용 가능한 예시 구분표를 만들어, 설명용 열쇠를 실제 장면의 소품으로 오해하지 않도록 한다.

들어가며
플레이어가 ‘열쇠 집기’를 현재 장면의 단서로 받아들이지 않게 하려면 도움말에 세 가지를 함께 밝혀야 한다. 이 문장이 어느 상황에서 성립하는지, 열쇠는 어디에서 나온 설정인지, 현재 장면에서 사용할 수 있는지다. 일반적인 입력 형식과 현재 장면의 명령어는 따로 제시해야 한다. 복사할 수 있는 예시라면 복사한 뒤 어디에 사용하는지, 사용 전에 어떤 조건을 충족해야 하는지도 설명해야 한다.
아래에서는 가상의 교육용 사례로 도움말 전체를 고쳐 쓴다. 플레이어는 의자 하나만 놓인 거의 빈 방에 있으며, 열쇠는 별도로 설정한 연습 상황에만 등장한다. 장면, 문안, 처리 절차는 모두 이 설명을 위해 직접 설계한 것이다. 실제 사용자 사례나 실측 결과, DramaFork의 제품 기능이 아니다.
먼저 이 도움말이 무엇을 약속하는지 정한다
원래 문안은 두 문장뿐이다. ‘동작과 물건 이름을 입력하세요. 예: 열쇠 집기.’ 문장 구성법을 가르치려는 의도지만, 플레이어가 방금 읽은 방 설명 옆에 구체적인 물건을 등장시킨다. 플레이어는 이를 근거로 열쇠를 찾을 수 있고, 찾지 못하면 자신이 충분히 탐색하지 않았다고 생각할 수도 있다.
고쳐 쓰기 전에 먼저 장면의 근거를 ‘방에는 의자 하나만 있다’로 고정한다. 여기에 작가가 이 사례를 위해 정한 규칙을 덧붙인다. 캐릭터는 의자를 살펴볼 수 있지만, 옮길 수 있는지는 아직 정하지 않았다. 따라서 현재 장면의 예시로는 ‘의자 살펴보기’를 쓰고 ‘의자 집기’는 쓰지 않는다. 대상이 이미 등장했다는 사실은 출처가 있다는 근거일 뿐, 그 대상에 어떤 행동이든 할 수 있다는 근거는 아니다.
이 페이지의 교육 목적은 두 가지다. ‘동작+대상’이라는 두 요소로 이루어진 기본 표현을 이해시키고, 현재 장면에 근거한 첫 행동을 제시하는 것이다. 숨겨진 물건을 암시하거나 모든 행동 규칙을 설명하는 역할은 맡지 않는다. 먼저 목적을 좁혀야 어떤 예시를 남길지 판단할 수 있다.
다섯 열로 된 구분표로 각 예시의 위치를 정한다
예시부터 잔뜩 모은 다음 면책 문구를 붙이지 말자. 먼저 아래의 작가용 표를 채운다. 각 행에서 같은 다섯 가지 질문에 답한 뒤, 해당 내용을 플레이어가 읽는 도움말에 반영한다.
| 교육 목적 | 예시의 맥락 | 대상의 출처 | 실행 가능 조건 | 현재 장면으로 돌아갈 때의 안내 |
|---|---|---|---|---|
| 문장 구성 익히기 | 추상적인 형식: 동작+대상의 두 요소 | 특정 물건을 지정하지 않음 | 형식일 뿐이므로 그대로 제출할 수 없음 | 현재 장면에서 대상을 선택해야 함 |
| 구체적인 표현 이해하기 | 별도의 연습 예시: 열쇠 집기 | 설명을 위해 가정한 연습용 탁자 위 | 이 문안에서는 예시만 보여 주며 연습 실행 기능은 제공하지 않음 | 연습용 열쇠는 현재 방에 속하지 않음 |
| 현재 장면에서 행동해 보기 | 현재 방: 의자 살펴보기 | 이미 제시한 방 설명 | 의자가 여전히 있고 캐릭터가 살펴볼 수 있을 때 제출 가능 | 제출 후 실제로 수행한 행동에 따라 진행 |
두 번째 행은 의도적으로 읽기만 하는 연습 예시를 택했다. 이해하기 쉬운 구체적인 예문을 남기면서도 연습 진입 경로, 연습용 소지품, 초기화 동작까지 추가로 약속하지 않아도 된다. 대신 플레이어는 도움말 안에서 직접 시도할 수 없고 글로만 이해해야 한다.
작품에 실제로 조작 가능한 별도의 연습 공간이 있다면 이 행을 다시 써야 한다. 어디에서 들어가는지, 무엇에 영향을 주는지, 어떻게 나오는지 설명하고 구현과 일치하는지 확인한다. 제목만 ‘연습 모드’로 바꿨다고 해서 그 안의 행동이 본편과 분리되어 있다고 가정해서는 안 된다.
이 표는 인물, 장소, 자원이 등장하는 예시에도 재사용할 수 있다. 명사가 나올 때마다 현재 장면에 속하는지, 연습을 위한 가정인지, 입력 형식을 설명하는 자리표시용 표현인지 답할 수 있어야 한다. 답할 수 없는 예시는 일단 빼 둔다.
구분표를 바로 전달할 수 있는 도움말 문안으로 바꾼다
아래 인용문은 이 사례의 플레이어용 문안 전체다. 자신의 작품에 복사해 사용할 때는 장면 설명을 바꾸고, 문안에 적힌 행동을 실제로 지원하는지 확인해야 한다.
행동 입력 방법
기본 형식은 ‘동작+대상’이라는 두 요소로 구성됩니다. ‘동작’과 ‘대상’은 형식을 설명하는 말이므로 두 단어를 그대로 입력할 필요는 없습니다. 현재 장면에 이미 등장한 대상을 고른 뒤, 그 대상에 무엇을 하고 싶은지 입력하세요.
별도의 연습 예시: 문장 구성만 설명합니다
연습용 탁자 위에 열쇠 하나가 있다고 가정해 보겠습니다. ‘열쇠 집기’는 동작과 그 대상을 표현합니다. 여기의 탁자와 열쇠는 설명용 설정이며, 지금 탐색 중인 방에 속하지 않습니다. 이 부분에는 연습용 입력창이 없습니다. 이 문장을 현재 장면에서 권장하는 명령어로 받아들이지 마세요.
현재 방: 시도할 수 있는 명령어
방에는 의자 하나만 있습니다. 이 장면의 규칙에 따라 지금은 ‘의자 살펴보기’를 입력할 수 있습니다. 이 명령어가 가리키는 것은 장면에 이미 등장한 의자입니다. 도움말 페이지 자체가 대신 살펴보기 행동을 실행하지는 않습니다.
현재 장면으로 돌아가기
도움말을 닫고 방 설명으로 돌아가 행동을 이어 가세요. 이 페이지를 읽기만 했다고 해서 물건을 집거나 살펴보기를 완료한 것은 아닙니다. 연습 예시의 열쇠가 방이나 소지품에 추가되지도 않습니다. 다음 입력은 현재 장면의 설명을 바탕으로 해 주세요.
이 문안에서는 ‘한번 해 보세요’라는 표현으로 연습과 현재 장면을 동시에 가리키지 않았다. 두 예문을 하나의 ‘추천 행동’ 제목 아래 나란히 놓지도 않았다. 플레이어가 소제목만 훑어봐도 두 맥락의 차이를 알 수 있다.
돌아가기 안내에서도 새로운 추측을 유도하지 않아야 한다. ‘연습용 열쇠는 여기에 속하지 않는다’는 말은 현재의 경계만 분명히 한다. 이야기 전체에 열쇠가 전혀 없다는 뜻이 아니다. ‘나중에 찾게 될 것’이라는 말을 덧붙여 계획하지 않은 전개를 예고해서도 안 된다.
복사할 수 있다고 어디서나 실행할 수 있는 것은 아니다
도움말에 복사 기능을 제공한다면, 복사되는 것이 완성된 명령어인지 수정이 필요한 형식인지, 어느 입력창에 붙여 넣어야 하는지를 바로 옆에 설명해야 한다. 이 사례의 현재 장면 명령어에는 이렇게 쓸 수 있다. ‘“의자 살펴보기”를 복사해 현재 방의 행동 입력창에 붙여 넣으세요. 제출해야 행동이 실행됩니다.’ 이 문장은 작품에 해당 조작이 실제로 있을 때만 사용할 수 있다.
연습 예시와 현재 장면의 명령어에 설명 없는 ‘지금 시도하기’ 진입 경로를 공통으로 제공하는 것은 피하는 편이 좋다. 교육 목적으로 연습 예시도 복사할 수 있게 한다면 예문 가까이에 ‘문장 구성을 배우기 위한 예시입니다. 현재 방에는 적용되지 않습니다’라고 명시해야 한다. 중요한 전제 조건을 페이지 끝에 숨겨, 복사한 뒤에야 제한을 알게 해서는 안 된다.
도움말이 열린 동안 장면이 바뀔 수 있는지도 고려해야 한다. 이후 이야기 전개로 의자가 방에서 다른 곳으로 옮겨졌다고 가정하면, 기존 예시는 더 이상 실행 전제 조건을 충족하지 않는다. 현재 상태를 확인할 수 있다면 근거가 있는 명령어를 다시 골라야 한다. 확인할 수 없다면 항목 이름을 ‘현재 장면의 명령어 작성법’으로 바꾸고, 돌아간 뒤 대상이 여전히 있는지 확인하도록 안내한다. 지금 실행할 수 있다고 단정해서는 안 된다.
구체적인 예문은 이해하기 쉽지만 사실로 받아들여지기도 쉽다. 추상적인 형식은 경계가 분명하지만 초보자는 무엇을 입력해야 할지 모를 수 있다. 이 문안은 두 가지를 모두 남기고 별도의 맥락으로 연결한다. 현재 장면을 다루는 부분은 ‘지금 무엇부터 시작할까’에 답하는 역할을 맡는다.
세 가지 오독 경로를 따라 문안을 검토한다
첫째, 연습 부분만 읽고 ‘이것을 근거로 방에 열쇠가 있다고 단정할 수 있는가?’라고 묻는다. 답은 ‘아니요’여야 한다. 끝까지 읽어야만 그런 해석을 배제할 수 있다면, 맥락 설명을 예문 앞으로 옮긴다.
둘째, ‘열쇠 집기’를 플레이어가 현재 장면에서 직접 제출한 입력으로 취급한다. 작가는 장면 규칙에 맞는 응답을 미리 작성해야 한다. 예를 들면 ‘현재 방에는 집을 수 있는 열쇠가 없습니다. 도움말의 열쇠는 문장 구성을 설명하는 데만 사용됩니다’라고 쓸 수 있다. 이는 구현 담당자에게 문구만 보고 예시를 판별하라는 뜻이 아니다. 예시를 잘못 복사했을 때 물건이 갑자기 생기거나, 행동 비용이 차감되거나, 물건을 획득했다고 알리는 일이 발생하는지 확인하려는 것이다.
셋째, 도움말을 읽고 곧바로 닫는다. 방과 소지품이 그대로인지 확인한 다음 ‘의자 살펴보기’를 입력해, 실제로 제출한 행동만 처리되는지 확인한다. 이상의 내용은 앞으로 수행할 점검 절차이며, 이미 완료한 테스트 기록이 아니다.
이 자료는 이야기 밖에서 제공하는 입력 형식 도움말과 명령어 설명에 적합하다. 플레이어가 직접 물건을 만들어 낼 수 있는 작품이라면 생성 규칙을 별도로 설명해야 한다. 연습 자체가 이야기 속 과제라면 어떤 실제 영향이 남는지 밝혀야 한다. 전달할 때는 다섯 열로 된 구분표, 플레이어용 문안, 오독 점검 기록을 함께 보관한다. 장면의 대상이 바뀌었을 때 같이 수정해야 할 예시를 찾을 수 있도록 하기 위해서다.






