🤖에이전트 실습

• 무엇: 코드로만 움직이는 나만의 로봇 ‘에이전트’를 불러와 이동·회전, 블록 놓기·부수기, 인벤토리·슬롯, 블록 탐지까지 기본 명령을 익히기
• 누구: 메이크코드를 처음 배우는 초등 중학년~중학생
• 몇 분: 기본 명령 1~2차시, 난이도별 실습(계단·타워·밭·추적)은 차시마다 하나씩
• 결과물: 채팅 명령어로 움직이는 에이전트, 줄·계단·타워·꽃길·밭
• 에이전트로 건축·농사·채굴하는 프로젝트는 ‘에이전트 건축·농사·채굴’, 길 찾기·그림·게임은 ‘에이전트 알고리즘·게임’ 페이지에 있습니다

• 에이전트는 코드로만 움직이는 나만의 로봇. 블록 놓기·부수기·수집·공격을 대신함

• 지금 방식: 월드에서 C키로 코드작성기를 열면 에이전트가 나타남(코드작성기 열기 페이지). 플레이어 한 명에 에이전트 하나
• 방향은 에이전트 기준: ‘앞’은 에이전트가 바라보는 쪽. 생각대로 안 움직이면 방향부터 확인
• 죽지 않음: 물·불·폭발·용암에도 피해를 입지 않음
• 떨어지지 않음: 중력의 영향을 받지 않아 공중에 떠 있고, 허공에도 블록을 놓을 수 있음
• 인벤토리: 에이전트를 마우스 오른쪽 클릭하면 열림. 주인(플레이어)만 열 수 있음
• 앞이 블록으로 막혀 있으면 더 가지 못하고 그 명령이 끝남. 회전은 왼쪽·오른쪽만 있음(뒤로 돌기는 두 번 회전)

• 불러오기: 채팅 명령어 블록 안에 ‘에이전트가 플레이어에게 텔레포트’. 에이전트 코드의 시작에 거의 늘 씀
• 불러온 뒤 ‘채팅창에 말하기: 에이전트 텔레포트 완료’를 붙이면 실행됐는지 알기 쉬움(채팅 명령어 안녕)
• 이동: 방향 6가지(앞으로·뒤로·왼쪽·오른쪽·위·아래) × 거리(칸 수). 3차원 세계라서 6방향
• 회전: 왼쪽·오른쪽. 같은 블록은 마우스 오른쪽 클릭으로 복사해 방향만 바꿈

다음 채팅명령어를 입력하면: "이동"
  에이전트가 이동 방향 앞으로 거리 5
  에이전트가 회전 왼쪽
  에이전트가 이동 방향 앞으로 거리 5
  에이전트가 회전 왼쪽
  에이전트가 이동 방향 앞으로 거리 5

• 10칸 가기: 거리를 10으로 바꾸거나, 1칸 이동을 ‘반복 10회’에 넣기. 앞으로 2칸·왼쪽 회전을 ‘반복 4회’에 넣으면 사각형(채팅 명령어 square)

• 블록 놓기는 에이전트가 블록을 가지고 있어야 함. 처음엔 아무 일도 안 일어남 → 에이전트를 오른쪽 클릭해 인벤토리 1번 슬롯에 블록을 넣어 줌
• 방향은 에이전트 기준 6방향. 앞·뒤·왼쪽·오른쪽에 모두 놓으면 에이전트가 스스로를 가둠
• 블록 파괴도 6방향. 앞에 블록을 놓으면 그 블록 때문에 못 가므로, 줄을 만들 때는 ‘앞으로 1칸 → 뒤에 놓기’

다음 채팅명령어를 입력하면: "블록놓기"
  에이전트가 블록놓기 뒤로 / 앞으로 / 왼쪽 / 오른쪽
다음 채팅명령어를 입력하면: "블록파괴"
  에이전트가 블록 파괴 앞으로 / 왼쪽 / 오른쪽

• 블록이 여러 종류 있어도 에이전트는 기본으로 1번 슬롯만 씀
• ‘에이전트가 (번호) 슬롯을 활성화’ 블록을 놓기 블록 앞에 넣으면 그 슬롯의 블록을 씀
• 인벤토리: 1번 석재 벽돌, 2번 벽돌 → 아래 코드로 두 블록이 번갈아 놓임

다음 채팅명령어를 입력하면: "block"
  반복 4회
    에이전트가 1 슬롯을 활성화
    에이전트가 이동 방향 앞으로 거리 1
    에이전트가 블록놓기 뒤로
    에이전트가 2 슬롯을 활성화
    에이전트가 이동 방향 앞으로 거리 1
    에이전트가 블록놓기 뒤로

• 응용: 슬롯을 3개로 늘려 세 가지 색 울타리 만들기(‘에이전트 건축·농사·채굴’ 페이지)

• 이동한 곳에 블록 놓기 = 참(true): 이동할 때마다 자동으로 블록을 놓음. 반복 없이 ‘앞으로 10칸’만으로 줄이 생김
• 장애물 파괴하기(destroy obstacles) = 참: 길을 막는 블록을 따로 명령하지 않아도 부수며 나아감
• 두 설정은 같은 블록에서 드롭다운으로 고름. 기본값은 거짓(false)
• 에이전트에게 꽃을 주면 꽃길, 갈아 놓은 땅에서 씨앗을 주면 씨앗 뿌리기

• 에이전트는 부순 블록을 스스로 줍지 않음 → 모든 블록 수집하기를 넣어야 인벤토리에 모임
• 예) 장애물 파괴하기 참 → ‘앞으로 1칸 이동 → 모든 블록 수집하기’를 5번 반복 → 인벤토리에 벽돌 5개
• 경작: 농사 지을 땅을 만드는 명령. 경작한 자리에 씨앗을 놓고 이동하기를 반복

다음 채팅명령어를 입력하면: "1"
  반복 5회
    에이전트가 경작 오른쪽
    에이전트가 블록놓기 오른쪽   (인벤토리에 씨앗)
    에이전트가 이동 방향 앞으로 거리 1

• 에이전트가 블록 탐지(방향): 그 방향에 블록이 있으면 참. ‘만약 ~이면’ 조건에 넣음
• 숙제 문제: 앞에 블록이 있으면 부수고, 없으면 그냥 앞으로 가기(채팅 명령어, 이동, 반복, 만약, 블록 탐지, 파괴 사용)
• 정답 코드(채팅 명령어 leavemealone):

반복 5회
  에이전트 앞으로 1칸 이동
  만약 (에이전트 블록 탐지: 앞) 이면
    에이전트 장애물 파괴 설정 = 참

• 화면 속 정답은 ‘블록 파괴 앞’이 아니라 ‘장애물 파괴 = 참’ 설정을 켜는 방식. 탐지 결과로 미로·길 따라가기를 하는 법은 ‘에이전트 알고리즘·게임’ 페이지
• 에이전트를 부르는 채팅 명령어 이름은 영상마다 다름(hi, tp, 0, 1, 안녕). 반 전체가 하나로 정해 두면 편함

• 월드 목록의 에이전트 튜토리얼 월드(화면 이름 ‘The Agent Trials’)에서 단계별 과제를 풂. 영상은 한글로 번역한 맵 사용
• 1단계 앞으로 가기: 시작점에서 에이전트를 불러오고, 방향을 돌린 뒤 발판까지 앞으로 보내기
• 2단계: 여러 발판을 차례로. 한꺼번에 짜지 말고 구간을 나눠 조금씩 실행
• 3단계 위아래로 이동 / 4단계 ‘이동의 모든 것’: 금색 발판 4개에 올리면 타워에 불이 켜짐. 유리는 부수고 지나가고, 용암은 에이전트가 그냥 통과
• 엉뚱하게 움직이면 거의 다 방향 문제 → 회전으로 고쳐 다시 실행
• 이어지는 광물 캐기·농사·집 짓기 단계는 ‘에이전트 건축·농사·채굴’ 페이지

• 에이전트는 원래 에듀케이션 에디션에만 있음. 베드락 에디션에서는 웹소켓을 이용한 프로그램(플럼님 개발)으로 불러올 수 있음
• 받은 파일 압축을 풀고 스타트 파일 실행(관리자 권한 권장) → 마인크래프트 채팅창에 /connect localhost:3000 입력
• 연결에 실패하면 setup.bat 실행
• 열린 웹페이지(localhost:3001)의 버튼: 에이전트 생성, 앞으로·뒤로·위로·아래로 이동, 왼쪽·오른쪽 회전, 파괴하기, 공격하기, 모든아이템 버리기, 플레이어에게 TP, 슬롯 고르기, 슬롯 아이템 설치하기
• 버튼으로 이동·회전·설치를 익힌 뒤 코딩 수업으로 넘어가는 도입 활동에 알맞음

• 블록을 놓기 전에 에이전트 인벤토리부터 확인(블록이 없으면 아무 일도 안 일어남). 블록·씨앗은 넉넉히
• 에이전트가 안 보이면 불러오기 명령부터. 반 전체가 같은 이름(예: 0)을 쓰면 서로 도와주기 쉬움
• 플레이어가 뒤로 돌아도 에이전트는 따라 돌지 않음 → 실행 전에 바라보는 방향 확인
• 같은 결과를 ‘블록 여러 개’와 ‘반복’으로 두 번 만들어 보면 반복의 쓸모가 잘 보임
• 도입: 밭 만드는 순서를 먼저 글로 적게 하고(절차적 사고), 그다음 코드로 옮김