한눈에 보기
- 무엇: 생성형 AI(ChatGPT·Claude·전용 GPT)에게 마인크래프트 코드를 요청하고, 결과를 실행해 보며 오류를 찾아 고치는 활동
- 누구: 코드작성기(MakeCode)를 조금 써 본 학생·교사. 스크립트 API·웹소켓 부분은 심화
- 흐름: AI 리터러시 영상(각 2분 안팎)으로 도입 → 범용 AI의 한계 확인 → 프롬프트·오류 대처 → 전용 GPT(MiEE 코드메이커) → 심화(스크립트 API GPT, 게임 속 AI)
- 결과물: AI가 쓴 JavaScript·Python 코드로 지은 집·장치, 그리고 “AI 답을 그대로 믿지 않고 실행해서 확인하는” 습관
AI 리터러시 영상 4편으로 시작하기
| 영상 | 제목 | 핵심 |
| 영상 1 | 인공지능은 어떻게 작동할까요? | 훈련 데이터 → 패턴 → 예측 / “고래는 호수에 산다”처럼 AI도 잘못 일반화 |
| 영상 2 | 우리 곁의 인공지능과 밝은 미래 | 생활 속 AI 사례 소개 / 링크만 안내(노트 참고) |
| 영상 3 | AI와 함께 최고의 트릭샷 만들기 | 맞는 AI 고르기(길 안내 AI는 창작에 안 맞음) / 자세한 프롬프트 → 결과 검토 |
| 영상 4 | 진짜 같은 가짜? 튼튼한 나무집 짓기 | AI 생성 이미지 알아보기 / 교차 검증, 영감으로만 활용 |

교사용 메모 · AI 리터러시 영상 안내 메모
- Minecraft Education 공식 AI 리터러시 영상 4편(치킨·에이전트 캐릭터, 각 2분 내외)에 한글 자막을 붙인 것입니다. 생성형 AI로 코드를 짜기 전에 개념 도입용으로 보여 줍니다.
- 영상 2(우리 곁의 인공지능: 로봇청소기·얼굴 인식·맞춤형 챗봇·자율주행 택시·바다 연구·돌고래 언어 연구)는 마크 활동이 없어 링크만 둡니다. 다만 ‘누구나 자기만의 맞춤형 챗봇을 만든다’는 장면(00:36)은 뒤에 나오는 전용 GPT(MiEE 코드메이커, 스크립트 API GPT)를 소개할 때 연결하기 좋습니다.
- 영상 3의 ‘맞는 AI 고르기 → 자세한 프롬프트 → 결과 검토’는 다음 슬라이드들(원본 노트 ‘S163
S165’, v07에서는 S212S214)의 프롬프트 요령·오류 대처와 그대로 이어집니다. - 영상 설명란에 “한글 자막본은 문제 시 삭제될 수 있다”고 되어 있으니, 수업 전에 영상이 열리는지 확인합니다. 원본(영어) 영상 링크는 ‘자료 링크’에 있습니다.
- 네 영상을 AI 리터러시 수업 전체로 쓰는 방법은 ‘AI 리터러시 월드’ 페이지를 봅니다.
영상 속 AI 사용 원칙을 코딩으로 가져오기
- ① 목적에 맞는 AI 고르기: GPS의 AI는 길 안내용이라 트릭샷 아이디어에 안 맞음 → 코드에는 코드를 잘 아는 AI·전용 GPT
- ② 자세히 지시하기: “골을 넣어 줘”만 말하면 바닥에 한 번 튕기는 시시한 답 → 에디션·편집기·언어·크기를 밝혀 요청
- ③ 사람이 확인하고 바로잡기: AI는 “고래가 호수에 산다”처럼 틀릴 수 있고, AI 그림 속 문은 어디로도 이어지지 않음 → 코드는 반드시 실행해 확인




ChatGPT에게 마크 질문해 보기: 정답 있는 질문 vs 방법 질문
| 질문 | ChatGPT 답 | 실제로 해 보니 |
| 스코어보드 명령어, 다이아몬드 칼 받기 | /scoreboard, /give(대상 이름·인챈트 예시까지) | 정답이 분명한 질문은 잘 맞음 |
| 닭을 소환하는 메이크코드 | 블록 코딩 대신 summon chicken 명령어 | 명령어는 실행됨(닭이 나옴), 블록 코딩은 못 함 |
| 좀비 잡기 점수 게임, 타이머 | 스코어보드·커맨드 블록 이야기 | 방법이 구체적이지 않고, 영상에서는 자바 에디션 기준 문법이라고 지적 |
| 원 만들기, 자동문, 무한 회로 | /fill, 레버+감압판+레드스톤 횃불, 리피터 | 원은 네모가 되고, 자동문은 작동하지 않음. 무한 회로는 비교기+레드스톤 횃불이 맞음 |
ChatGPT 답변을 직접 실행해 확인하기
- 화면에 나온 ChatGPT의 답(일부). 그대로 넣어 보고 무엇이 맞고 틀린지 찾게 합니다.
summon chicken # 메이크코드를 물었는데 명령어로 답함
/scoreboard objectives add ZombiesKilled dummy Zombies Killed
/scoreboard players add @a ZombiesKilled 1
scoreboard players set @a Timer -1 # 타이머: “1초마다 1을 뺀다”는 설명
/fill 0 64 0 10 64 10 air 0 replace # “반지름 10칸 원”이라고 했지만 네모가 됨
/give Alex diamond_sword
- 교사 멘트: “AI는 힌트를 주는 친구예요. 답을 그대로 믿지 말고 월드에서 실행해서 확인해 봅시다.”


생성형 AI로 코드 짜기: 되는 것과 안 되는 것
| 언어 | AI 활용 | 방법 |
| MakeCode 블록 | 아이디어 수준 | AI가 블록을 직접 못 만듦 → 알고리즘·순서만 제안받기 |
| JavaScript · Python | 코드 작성 가능 | 부분 활용, 기존 코드를 주고 고치거나 보완 |


범용 AI에게 코드작성기 코드 맡겨 보기
- 요청: “마인크래프트 에듀케이션 메이크코드 블록코딩으로 집만드는 코딩 만들어줘.” (Claude 3.7 Sonnet, ChatGPT 3.5에 같은 문장)
- Claude: 블록 대신 JavaScript로 자세히 작성(채팅 명령 ‘집 만들기’·‘큰 집 만들기’) → 붙여 넣으니 문제 120개 → 오류를 알려 고쳐도 13개 남음
- ChatGPT 3.5: 빨리 답하지만 블록 코딩을 이해하지 못하고, JavaScript로 바꿔도 오류
- 남은 오류(문제 창):
Property 'value' does not exist on type 'typeof positions'./Cannot find name 'DOOR'./Cannot find name 'OAK_SLAB'.


교사용 메모 · 범용 AI가 자주 틀리는 3가지
- 범용 AI(ChatGPT·Claude 등)가 코드작성기 코드에서 자주 틀리는 예 3가지
- ① 블록 이름: 코드작성기에 없는 이름이나 다른 에디션 이름을 씀(예: GLASS처럼 대문자 상수, 석영 블록 이름 오류). 영상에서는
Cannot find name 'DOOR',Cannot find name 'OAK_SLAB'오류가 났습니다. - ② Position 타입: 좌표 자리에 숫자 3개를 그대로 넣음 → world(x, y, z)·pos(x, y, z) 같은 위치 값으로 감싸야 함. 영상에서는
Property 'value' does not exist on type 'typeof positions'오류가 났습니다. - ③ 함수 이름: mc.setBlock처럼 다른 마인크래프트 라이브러리의 함수를 씀 → blocks.place(), blocks.fill() 등 코드작성기 함수로 바꿔야 함
- → 오류 메시지를 그대로 붙여 넣어 다시 요청하거나, 전용 GPT(MiEE 코드메이커)를 쓰면 줄일 수 있습니다. 오류를 알려 고치게 하는 방법은 영상에서 “굉장히 오랜 시간이 걸렸다”고 합니다.
AI에게 코드 요청하기: 구체적으로, 단계별로
- ✗ “파이썬으로 간단한 집을 짓는 코드를 작성해줘”
- 프롬프트 예시 ✓ “마인크래프트 에듀케이션 코드작성기(MakeCode)의 Python으로, 채팅명령어 house를 입력하면 ① 내 위치 앞에 7×7 바닥 ② 높이 4칸 벽 ③ 지붕 순서로 집을 짓는 코드를 만들어 줘.”
- 에디션·편집기·언어를 먼저 밝히기
- 실행 방법(채팅명령어)과 크기를 숫자로
- 한 번에 다 말고 단계별로 요청
- 수업 팁: 블록 코딩 수업에서는 AI에게 ‘순서’를 물어보고, 블록은 학생이 직접 조립하게 합니다.

오류가 날 때: 오류 메시지와 예시 코드 주기

1 오류 메시지를 그대로 붙여넣기 mc.setBlock, GLASS처럼 코드작성기에 없는 함수를 써서 생긴 오류. 문제 창의 줄 번호와 메시지를 복사해 “이 오류를 고쳐 줘”

2 올바른 예시 코드·문서를 직접 주기 “다음 함수를 사용해야 해” + 코드작성기의 실제 함수 예시. 블록을 Python으로 바꿔 본 코드를 붙여 주면 문법을 맞춰 줌
전용 GPT로 오류 줄이기: MiEE 코드메이커
- 찾는 방법: ① ChatGPT 접속 › ② Explore GPTs › ③ “MiEE” 검색 → ‘MiEE Codemaker’ (Gemini Gems·Edge Copilot에 MakeCode 문서를 주는 방법도 가능)
- 학습: MakeCode 공식 레퍼런스·예제 기반 / 언어: JavaScript·Python 코드를 함께 제공 / 강점: 건축보다 게임 장치·자동화·미니게임
- 요청 예: ✗ “집 만들어 줘” / ✓ “5×5 크기 나무 집을 채팅 명령어로 만들어 줘. 문과 창문 포함”
- 한계와 확인: 블록 이름(석영 등)·계단 방향은 가끔 틀림 / 붙여 넣기 전 블록 이름·좌표·크기 확인

MiEE 코드메이커 시연: 작은 집과 모던하우스
- “작은 집을 지어줘”처럼 짧게 요청해도 JavaScript·Python 두 가지 코드를 줌 → JavaScript 탭에 붙여 넣고 채팅에
집→ “작은 집이 완성되었어요!” (오류 없음) - “모던 스타일 2층 주택” 요청 → 채팅
모던하우스→ 문·유리창은 나왔지만 계단은 정확히 만들어지지 않음 - 블록 이름 오류는 만든 사람이 그때그때 고쳐 업데이트하는 중(설명란: “아직 오류가 있지만 계속 수정 보완 중”)



MiEE가 쓴 코드 읽어 보기
- 코드작성기 문법에 맞는 모양:
player.onChat·player.position()·positions.add(시작, pos(x, y, z))·blocks.fill·blocks.place
player.onChat("모던하우스", function () {
let 시작 = player.position()
// 1층 외벽 … (중략)
// 출입문
blocks.place(IRON_DOOR, positions.add(시작, pos(4, 1, 0)))
})
- 남은 오류는 블록 이름 하나:
QUARTZ_BLOCK에 빨간 밑줄(문제 4개). 영상은 고친 결과만 보여 주므로, 블록 화면에서 석영 블록을 골라 놓은 뒤 JavaScript로 바꿔 보면 올바른 이름을 알 수 있습니다(02:55 화면) - 활동: 빨간 밑줄을 찾아 블록 목록에서 맞는 이름으로 바꿔 보기

교사용 메모 · MiEE 코드메이커 시연 메모
- MiEE 코드메이커는 MakeCode 공식 레퍼런스와 예제를 넣어 만든 ChatGPT 전용 GPT입니다. 블록 이름·문법을 코드작성기에 맞춰 주기 때문에 범용 AI보다 오류가 적습니다.
- 같은 방식으로 Gemini의 Gems, Edge의 Copilot에 MakeCode 문서를 주고 쓸 수도 있습니다(가이드맵 ‘바이브 코딩’).
- 노션 원문의 AI별 별점 비교표(GPT-3.5·GPT-4 등)는 오래된 정보라 싣지 않았습니다.
- 시연 순서: Explore GPTs에서 MiEE 검색 → 아래 요청 예를 입력 → JavaScript 코드를 복사해 코드작성기 JavaScript 탭에 붙여 넣기 → 블록으로 전환해 확인.
- 영상(2025-04)에서는 건축보다 다른 작업을 “오히려 더 잘한다”고 하며, 오류를 댓글로 알려 달라고 합니다. 지금 동작은 영상과 다를 수 있습니다.
프롬프트를 고쳐 가며 완성하기: 아이템 수리 NPC
- 스크립트 API용 GPT(scriptAPI)에 “아이템 수리 스크립트”를 요청 → 네 번쯤 고쳐 요청해서 완성
- ① 첫 답은 NPC를 새로 정의(
/summon scriptapi:blacksmith) → “기존 NPC를 쓰고 이름이 리페어일 때만 상호작용하게 해” - ② 대화창이 뜨는 문제 → 고쳐 달라고 요청 / ③ 비용이 없음 → “한 번 수리하는데 에메랄드 1개가 소비되도록 해. 그리고 수리하는 아이템은 손에 들고 있는 아이템을 수리하도록 해.”
- 고칠 때마다 코드를 main.js에 붙여 넣고
/reload→ 흙(내구도 없음)·최대 내구도 곡괭이·깎인 곡괭이로 차례로 시험



나만의 코딩 GPT 만들기: 지침에 참고 자료 넣기
- 전용 GPT는 ‘지침’에 무엇을 참고할지 적어 두면 범용 AI보다 정확해짐(MiEE 코드메이커도 같은 원리)
- scriptAPI GPT의 지침(화면): “컨넥터로 연결된 깃허브 레포지토리 https://github.com/ssakspirit/scriptAPI 의 내용을 참고하되 예전 문법이 안될 수도 있으니 최신 공식 문서를 우선적으로 확인해.”
- 함께 넣은 샘플:
https://github.com/microsoft/minecraft-scripting-samples,https://github.com/MicrosoftDocs/minecraft-creator(영상에서는 Minecraft Creator 유튜브 예제도 참고했다고 함) - 주석이 이해되지 않으면 코드에 대해 GPT에게 더 물어볼 수 있음. 기능이 복잡할수록 정확한 프롬프트와 코드를 읽는 힘이 필요

게임 안에서 AI에게 묻기: 웹소켓 + 로컬 AI
- 웹소켓으로 월드와 내 컴퓨터의 프로그램을 연결하면, 채팅에 쓴 질문에 AI가 채팅으로 답함(심화)
- 디스코드에서 받은 AI 프로그램(WebSocket Gemma2.zip) + Ollama(https://ollama.com/download/windows) 추가 설치 → 셋업 → 스타트
- 월드 채팅에
/connect localhost:3000으로 연결 →!ai {메시지}(예:!ai 니가 인공지능이니?) - 답: “네, 저는 구글에서 훈련된 대규모 언어 모델입니다.” — 답이 나오기까지 시간이 걸리고, 긴 답은 여러 줄로 나뉨
- 웹소켓 기본 예제(
npm install ws uuid)·연결이 안 될 때는 ‘웹소켓·스크립트 API’ 페이지

AI로 만든 결과물 예시
- 큰 모양은 잘 나오지만 세부는 어색함 → 결과를 보고 고칠 점을 다시 요청하는 과정이 곧 학습




수업 팁
- 같은 프롬프트, 여러 AI: 같은 문장을 Claude·ChatGPT·MiEE에 넣고 오류 수(문제 창 숫자)를 비교
- 정답 있는 질문 vs 방법 질문: 명령어 하나를 묻는 질문과 장치·게임을 만드는 질문의 정확도 차이를 토론
- 답대로 만들어 보기: ChatGPT가 알려 준 자동문·무한 회로를 그대로 지어 보고, 왜 안 되는지 찾아 고치기
- 고쳐 요청하기 기록: 몇 번 고쳐 요청했는지, 무엇을 바꿔 말했는지 적게 하면 프롬프트 실력이 보임
- 코드 읽기: AI가 준 코드의 조건(내구도 없음·최대 내구도·에메랄드 부족)을 표로 정리하며 코드 읽기 연습