← 책 소개English

QUAD-01 실습 파일

피지컬 AI로 배우는 RoboCo 구조와 보행 제어 · Digital Package

QUAD-01WALK피지컬 AI로 배우는 RoboCo

QUAD-01 · Digital Package v3.5.0

코드는 여기서,
실습의 순서와 해석은 책에서

실습 코드 ZIP은 누구나 내려받을 수 있습니다. ZIP의 README만으로 WALK 모델을 걷게 하는 첫 실행까지 해 볼 수 있습니다. 각 실습에서 무엇을 관찰하고, 어떤 값을 바꿔 무엇과 비교하고, 결과를 어떻게 해석하는지는 책에서 다룹니다.

로봇 파일 · 한국어 소스 · 영어 소스를 시리즈 전체와 함께 한곳에서 받으려면자료실 →

실습 해설은 책에 있습니다 — 25개 CHAPTER의 실습 안내 · 부록 A~F · 최종 미션 카드

구매하기

실습 코드 ZIP

Book_Q01_Robot_release_v3.5.0_kr.zip

ZIP 내려받기 · 391 KB

시작 파일 8개와 저자 교육용 라이브러리 Q01_Lib(Python 파일 55개), README.md · COMPATIBILITY.md · RELEASE_NOTES.md · RIGHTS_AND_USAGE.md · RELEASE_MANIFEST.json. 주석과 문서는 한국어입니다.

SHA-256 f8f09122a7b9df516400ce6bec4601ce7e232bf6e7e3a65eb6f270dc64322b24

로봇 모델 파일과 RoboCo 게임은 ZIP에 들어 있지 않습니다. 콘솔 LOG는 두 판 모두 영어입니다. 영어 주석판은 영어 페이지에서 받을 수 있습니다.

압축을 풀면

Book_Q01_Robot/
├─ q01_*_start.py        시작 파일 8개 (모델의 Microcontroller에 LOAD)
├─ Q01_Lib/              저자 교육용 라이브러리 (RoboCo 공식 API가 아님)
│  ├─ core/  walk/  auto/  action/
│  ├─ leg_common/  leg1_joint/  leg2_ik/  leg3_combined/
│  └─ body_pose/  balance_test/
├─ README.md · COMPATIBILITY.md · RELEASE_NOTES.md
└─ RIGHTS_AND_USAGE.md · RELEASE_MANIFEST.json · cover_quad-01.jpg

설치와 첫 실행

  1. RoboCo에서 Microcontroller 설정의 OPEN SCRIPT FOLDER를 눌러 Scripts 폴더를 엽니다.
  2. ZIP을 풀어 Book_Q01_Robot 폴더를 통째로 Scripts 바로 아래에 둡니다. 폴더 이름을 바꾸거나 Q01_Lib를 밖으로 옮기지 않습니다.
  3. Steam Workshop에서 구독한 Book-QUAD-01-WALK 모델을 불러옵니다.
  4. 로봇 Microcontroller에서 LOAD를 누르고 q01_walk_start.py를 고른 뒤 Live Mode로 실행합니다.
  5. 콘솔에 QUAD-01 WALK (Book-QUAD-01-WALK) 상자와 [STATE] ready가 나오면 게임 창을 한 번 누르고 W를 누르고 있습니다. 로봇이 걸으면 설치는 정상입니다.
막히면 — ModuleNotFoundError가 보이면 Book_Q01_Robot이 Scripts 바로 아래가 아니라 한 단계 더 안쪽에 있는 경우가 대부분입니다. 콘솔에 <color=#...> 글자가 그대로 보이면 시작 파일의 LOG_COLOR를 False로 바꿉니다. 나머지 키와 실습 순서는 책 PART 1부터 이어집니다.

첫 실행 장면 영상으로 보기 · WALK

Steam Workshop 실습 모델 7종

일곱 모델은 모두 같은 12관절 4족 로봇을 바닥·관찰용 거치대·기울기 시험대에 놓은 구성입니다. 모델과 시작 파일을 짝지어 씁니다. 콘솔 첫 상자의 제목에 모델 이름이 나오므로 불러온 모델과 같은지 확인합니다.

Workshop 모델시작 파일책에서구독 주소
Book-QUAD-01-WALKq01_walk_start.pyCH01 · 03 · 04 · 16 · 19~25주소 등록 예정
Book-QUAD-01-ACTIONq01_action_start.pyCH02 · 05 · 18주소 등록 예정
Book-QUAD-01-LEG1q01_leg1_joint_start.pyCH06~09주소 등록 예정
Book-QUAD-01-LEG2q01_leg2_ik_start.pyCH10~13주소 등록 예정
Book-QUAD-01-LEG3q01_leg3_combined_start.pyCH07 · 09 · 13 · 14 · 19 · 21주소 등록 예정
Book-QUAD-01-ROLL_PITCH_YAWq01_body_pose_start.pyCH15~18주소 등록 예정
Book-QUAD-01-BALANCEq01_balance_test_start.py
q01_balance_test_platform_start.py
CH17 · 20 · 24 (선택 실습)주소 등록 예정

Workshop 구독 주소는 모델이 공개되는 대로 이 표에 차례로 게시합니다. RoboCo에서 구독한 로봇은 Save/Load 메뉴에 나타납니다.

BALANCE에는 Microcontroller가 두 개 있습니다. 로봇 쪽에 q01_balance_test_start.py, 시험대 쪽에 q01_balance_test_platform_start.py를 각각 LOAD하고, 균형 제어를 켜기 전에 책 CHAPTER 17의 방향 확인을 먼저 합니다. RoboCo Controls 매핑과 스크립트가 같은 서보를 함께 움직이지 않게 합니다.

검증 상태

패키지 버전v3.5.0 (2026-11-08)
Python 코드 기준v3.4.9 — 동작 코드는 같고 주석·설명 문자열 5곳만 고침
RoboCo Python API0.3.1 문서 기준으로 작성. 사용하는 게임 버전에서 다시 확인
Python 문법 · ZIP 구조 · 파일 해시정적 검사 완료
RoboCo Game Build확인 후 기록
Live Mode 실행 · 보행 · IMU · 시험대실행 검증 결과를 이곳에 기록
정오표현재 등록된 정오표가 없습니다. 확인된 수정 사항은 날짜와 함께 이곳에 게시합니다.

게임이 업데이트되어 동작이 달라지면 확인한 Game Build와 고친 파일을 이곳에 공개합니다. 같은 RoboCo 빌드에서 실행을 확인하기 전에는 호환성이나 성공률을 보증하지 않습니다. 문의할 때는 RoboCo 버전, 모델 이름, 시작 파일 이름, ZIP 버전, 첫 [WARN]·[ERROR] 줄을 함께 적어 주세요.

확인값

파일크기SHA-256
Book_Q01_Robot_release_v3.5.0_kr.zip400,046 Bf8f09122a7b9df516400ce6bec4601ce7e232bf6e7e3a65eb6f270dc64322b24
Book_Q01_Robot_release_v3.5.0_en.zip118,752 B06954534149eb9df1d4578b5a9b3fe6aa14015192f501b5d6e9bd77e593e5e9f

manifest.json · SHA256SUMS.txt

사용 안내

  • Q01_Lib와 시작 파일은 저자가 작성한 교육용 코드이며 RoboCo 게임의 공식 Python API가 아닙니다.
  • RoboCo 이름·게임·로고·게임 안 자산의 권리는 각 권리자에게 있습니다. 이 패키지는 RoboCo 라이선스를 포함하지 않으며 개발사의 승인이나 제휴를 뜻하지 않습니다.
  • 코드와 문서의 재배포·수정 배포·상업적 이용·교육기관 이용 조건은 이 페이지에서 안내합니다. 이 안내만으로 오픈소스 라이선스가 부여되지 않습니다.

코드로 첫걸음을 걸었다면, 다음 24개 CHAPTER는 책에서

구매하기