• 무엇: 메이크코드 튜토리얼 제작 도구로 나만의 코드작성기 튜토리얼을 만들어 월드에 넣기
• 누구: 코딩 수업용 월드를 직접 설계하는 교사(고급)
• 몇 분: 교사 연수 60분 안팎 (제안)
• 결과물: 월드를 열거나 NPC·커맨드 블록을 실행하면 코드작성기에 내 튜토리얼이 뜨는 월드
• 덤: education.json으로 학생이 쓸 수 있는 명령어 막기

• 코딩 대결 월드: 구역을 나눠 코드로 건축 결과를 겨루기
• 코드작성기 튜토리얼: 안내를 따라 진행, 언어 선택 가능(번역 안 된 것도 있음)
• 활동 가이드: 언제 쓰면 좋을까?: 본격적인 코딩 과제 전에 개념 익히기용 / 교사 개입 없이 스스로 할 수 있어 개인 과제로 좋음 / 수준·분량이 제각각 → 교사가 먼저 해 보고 골라 주기 / 수업 계획(Guiding Ideas)도 함께 확인
• 템플릿 월드 중에는 C를 누르면 일반 코드작성기 대신 튜토리얼 형태가 뜨는 것이 있음 → 이것을 직접 만들 수 있음

• The Agent Trials(에이전트 튜토리얼 맵): 칠판 안내문을 읽고 단계마다 에이전트를 발판에 올리는 월드
• 원래 쉬운 영어 → 어린 학생도 할 수 있게 선생님이 칠판 글을 직접 한글로 번역·의역한 맵(2017)
• 단계 구성: ① 앞으로 가기 → ② 여러 발판(돌기 조합) → ③ 위아래로 이동 → ④ 이동의 모든 것(흰색판 4개에 서면 타워에 불, 마지막은 황금판)
• 안내문에 쓸 명령 이름을 그대로 적어 줌(예: 'Teleport to the player'), 에이전트 방향에 주의하라는 힌트도 칠판에
• 코드작성기 튜토리얼(아래)과 함께 쓰면: 월드에는 칠판으로 과제, 코드작성기에는 단계별 힌트

1. makecode.com/tutorial-tool 접속(MakeCode Tutorial Editor)
2. 왼쪽 위 '편집기' 목록에서 Minecraft released 선택(기본값은 micro:bit, 목록에 Minecraft nether·Minecraft beta도 있음)
3. 왼쪽에 마크다운으로 쓰고 Run → 오른쪽에 코드작성기에서 보일 모습 미리 보기
4. 공유하기 → https://minecraft.makecode.com/#tutorial:xxxxx-xxxxx-xxxxx-xxxxx 형식 링크가 생김 → 복사해 월드에서 씀

• 다른 문법은 오른쪽 위 Tutorial Docs에서 확인

1. tutorial-tool에서 마크다운으로 작성
2. 공유 버튼 → 튜토리얼 링크 복사
3. NPC · education.json 으로 월드에서 열기

### @explicitHints 1
```template
player.onChat("시작", function () {})

에이전트 탐사 미션

||Player:채팅명령어|| 블록에 설치 적기

~ tutorialhint

player.onChat("설치", function () {})

- 왼쪽 마크다운 → 오른쪽 코드작성기 화면(전구를 누르면 힌트)
- **# · ##**: 튜토리얼 제목 · 단계(페이지) / **template · blocks**: 미리 넣을 코드 · 쓸 블록과 힌트 / **@explicitHints**: 전구 버튼을 누를 때만 힌트 표시


<figure class="tp-fig"><img src="/topics/img/튜토리얼-만들기/v07_S201_1.webp" alt="마크다운 → 코드작성기 튜토리얼 화면" loading="lazy"><figcaption>마크다운 → 코드작성기 튜토리얼 화면</figcaption></figure>

```template
player.onChat("run", function () {
    for (let index = 0; index < 4; index++) {
        blocks.place(GRASS, pos(0, 0, 0))
    }
})

player.say(":)")
player.onTravelled(WALK, function () {})
player.onChat("run", function () {})
agent.teleportToPlayer()
agent.move(FORWARD, 1)
agent.turn(LEFT_TURN)
mobs.spawn()

My Tutorial

Step 1 instructions

추가

추가 설명입니다.

Step 2 instructions

You accomplished your project, good job!

player.onChat("탐사", function () {
    agent.setAssist(DESTROY_OBSTACLES, true)
    agent.move(DOWN, 5)
    agent.move(FORWARD, 5)
    agent.move(DOWN, 2)
    agent.move(BACK, 3)
})

- **template**: 튜토리얼을 시작할 때 작업 영역에 미리 놓일 블록
- **맨 앞 blocks**: 도구 상자에 보일 블록 목록. `mobs.spawn()` 한 줄을 넣으면 '몹' 카테고리가 생김
- **#·##·###**: 제목 · 스텝 · 스텝 안 소제목과 설명(한국어 가능)
- **스텝 아래 blocks**: 그 스텝에서 전구를 누르면 나오는 힌트 코드(어느 스텝에나 넣을 수 있음)


<figure class="tp-fig"><img src="/topics/img/튜토리얼-만들기/yt_Jh4qSCy8kMg_00-03-44.webp" alt="예시 문서(왼쪽)와 미리보기(오른쪽) (03:44)" loading="lazy"><figcaption>예시 문서(왼쪽)와 미리보기(오른쪽) (03:44)</figcaption></figure>

1. 튜토리얼이 뜨던 템플릿 월드의 폴더에서 education.json을 메모장 등으로 열기(가장 위 폴더가 가장 최근에 플레이한 월드)
2. "codebuilder"의 "defaulturi" 값을 지우고 내 튜토리얼 링크 넣기
3. "commands"의 "hiddenFromPlayer" : ["*"]에서 * 지우기(있으면 명령어가 하나도 안 먹음) → 저장
4. 고친 education.json을 내 월드 폴더에 복사 → 월드를 열고 C

• 튜토리얼에서 완료를 누르면 보통 코드작성기로 돌아가고, 다시 열어도 안 뜸 → 월드를 나갔다 들어오면 다시 뜸(게임 중에는 아래 NPC·커맨드 블록으로)

{
    "codebuilder" : {
        "canResize": true,
        "defaulturi" : "https://minecraft.makecode.com/#tutorial:70606-52922-64928-99576"
    },
    "commands" : {
        "hiddenFromPlayer" : ["*"]
    }
}

• NPC: 월드 빌더 권한을 얻고 NPC 대화 편집 → 고급 설정 → 명령 추가 → 버튼 모드, 버튼 이름 '튜토리얼 시작'
• NPC 명령: execute as @initiator run codebuilder navigate @s false <튜토리얼 링크>
• 끝 값: true = 코드작성기가 바로 열림 / false = C를 눌러야 열림
• 커맨드 블록: NPC가 아니므로 대상을 @p로 바꿔 레드스톤 블록으로 실행
• 버튼·커맨드 블록마다 다른 링크를 넣으면 튜토리얼 여러 개를 바꿔 가며 불러올 수 있음
• 예전 버전(영상 2022): execute @initiator ~~~ codebuilder navigate @s false <링크>

{
  "commands": {
    "hiddenFromPlayer": ["*", "!give"],
    "hiddenFromAutomation": ["!setblock"]
  },
  "codebuilder": {
    "defaulturi": "<튜토리얼 링크>",
    "capabilities": { "agent": {
      "permissions": {
        "canModifyBlocks": true } } }
  }
}

설정	하는 일
codebuilder.defaulturi	코드작성기를 열면 이 튜토리얼이 바로 뜸
commands.hiddenFromPlayer	학생이 못 쓰게 막을 명령(* 전부, ! 해제)
hiddenFromAutomation	커맨드 블록·함수(.mcfunction)에서 막을 명령
agent.permissions.canModifyBlocks	모험 모드에서 에이전트가 블록 변경

- **GitHub로 배포하면**: 주소 형식 `…makecode.com/#tutorial:github:사용자/저장소/파일명`

• 증상: 치트·명령 허용이 켜져 있는데 명령어가 하나도 안 되고 월드 빌더도 안 됨(클래스룸 모드 연결과 코드작성기만 됨)
• 원인: 월드 폴더 education.json의 "hiddenFromPlayer" : ["*"] — *는 모든 명령
• 고치기: 메모장으로 열어 ["give","gamemode"]로 바꾸고 저장 → 월드를 나갔다 다시 들어와야 적용
• 결과: /tp·월드 빌더는 되고 /give·/gamemode는 '알 수 없는 명령어'
• 다른 월드에: education.json을 복사해 넣으면 같은 설정이 적용. "codebuilder" 부분은 지워야 코드작성기를 그대로 씀
• 교육용 에디션에서만 작동(베드락 에디션은 해당 없음)

{
    "commands" : {
        "hiddenFromPlayer" : ["give","gamemode"]
    }
}

• 학생 월드에 넣기 전에 월드 폴더를 백업하고, 교사가 먼저 튜토리얼을 끝까지 해 보기
• 차시마다 다른 튜토리얼 링크를 NPC 버튼에 연결 → NPC와 대화하며 단계별 코딩 미션 (제안)
• 활동 규칙을 깨는 명령(/give, /gamemode)만 막고 필요한 명령은 열어 두기
• 심화반: 학생이 직접 튜토리얼을 만들어 친구에게 링크로 공유 (제안)
• 어린 학생에게는 칠판 안내문을 한글로 옮겨 주기