Creators-of-Create/Create 딥다이브
— 마인크래프트 안에 "회전 동력 공학"을 통째로 구현한 모드

1프로젝트 한줄 요약

이 레포가 무엇을 하는 물건인가.

Create(mod_id: create)는 simibubi가 시작해 "Creators of Create" 팀이 유지하는 NeoForge 모드다. 핵심은 "건축·장식·미적 자동화(Building, Decoration, and Aesthetic Automation)"로, 플레이어에게 정해진 정답 기계가 아니라 부품을 조합해 자기만의 장치를 설계할 자유를 준다. 코드 관점에서 보면 이건 마인크래프트라는 틱(tick) 기반 게임 루프 위에 올린 거대한 실시간 시뮬레이션 + 렌더링 엔진이다.

이 저장소(Creators-of-Create/Create)는 NeoForge판이고, 별도의 Fabric판(Fabricators-of-Create/Create)이 따로 있다. 기본 브랜치 이름이 mc1.21.1/dev인 데서 보이듯, 마인크래프트 버전별로 브랜치를 나눠 관리한다. 5,400개가 넘는 커밋과 1,100개 이상의 열린 이슈는 이 프로젝트가 살아 있는 대형 OSS임을 말해 준다.

2왜 주목받는가

트렌딩 이유 · 다른 기술 모드 대비 장점.

Create는 출시 이후 마인크래프트 기술 모드(tech mod) 장르에서 손꼽히는 인기작이 됐고, 거대 모드팩의 단골 핵심 모드다. 2026년 들어 MC 1.21.1 + NeoForge로의 이식과 6.x 대형 릴리스(물류/패키지 시스템 확장)가 맞물리며 다시 주목을 받는다. 코드를 공부하는 입장에서 매력 포인트는 넷이다.

3기술 스택 전체 지도

언어/런타임 · 모드 플랫폼 · 핵심 라이브러리 · 빌드 인프라의 4축으로 본다.

Create는 서버/프론트가 나뉜 웹앱이 아니라, 마인크래프트 클라이언트·서버 양쪽에서 도는 단일 Java 모드다. 그래서 "백/프론트" 대신 게임 런타임 + 모드 플랫폼 + 의존 라이브러리 + 빌드 도구 관점으로 스택을 그리는 게 정확하다. 모든 설정은 gradle.properties에 깔끔히 모여 있다.

① 언어 · 런타임

② 모드 플랫폼 — NeoForge

neo_version = 21.1.219. NeoForge는 Forge에서 갈라져 나온 모드 로더로, 레지스트리·이벤트 버스·네트워킹·데이터 생성(datagen) 같은 모딩 인프라를 제공한다. Create의 메인 클래스 Create.java는 @Mod(Create.ID) 애너테이션으로 시작하고, IEventBus에 각종 등록 콜백을 건다.

③ 핵심 의존 라이브러리 — 에코시스템 핵심 라이브러리 4종

주목할 점: Create는 자기 기능 일부를 독립 라이브러리로 떼어내 다른 모드도 쓰게 공개했다. build.gradle의 의존성이 곧 이 모드의 야심을 보여준다.

④ 선택적 연동(compat) · 빌드 인프라

런타임 필수는 아니지만 연동을 위해 localImplementation 또는 compileOnly로 물린 모드가 많다: JEI(레시피 뷰어 — localImplementation으로 로컬 컴파일+런타임 전용), Curios(장신구 슬롯), Sodium(렌더 최적화), CC: Tweaked(인게임 컴퓨터 — 기계를 Lua로 제어), Farmer's Delight(요리). 빌드는 Gradle(build.gradle + NeoForge 플러그인)로 하고, Jenkinsfile로 CI를, crowdin.yml로 다국어 번역을 관리한다.

4아키텍처 심화 분석

동력 네트워크 → 구조물 → 렌더링, 세 기둥을 차례로 해부한다.

4-1. 큰 그림 — 콘텐츠 / 기반 / API의 3층 분리

코드를 열면 com.simibubi.create 아래가 역할별로 깔끔히 갈린다. 이 패키지 분리 자체가 첫 번째 학습 포인트다.

content(기능) ↔ foundation(공통 토대) ↔ api(외부 계약)를 나눠 두면, 기능이 수백 개로 불어나도 토대 코드는 한 곳에 모이고, 외부 모드가 의존할 면(api)이 명확해진다. "바뀌는 것(content)과 안 바뀌어야 하는 것(api)을 분리"하는 대형 코드베이스의 정석이다.

4-2. 기둥 ① 운동 동력 네트워크 (Kinetics)

모드의 심장. content/kinetics/ 아래에 수차(waterwheel)·풍차·증기기관(steamEngine)·기어박스(gearbox)·압착기(press)·믹서(mixer)·드릴(drill)·벨트(belt) 등 30여 종의 부품이 들어 있고, 모두 KineticBlockEntity를 상속한다.

핵심 아이디어: 서로 연결된 회전 부품들은 하나의 KineticNetwork로 묶인다. 이 네트워크가 두 가지를 계산한다 — 속도(RPM)는 부품 사이를 전파되고(톱니비에 따라 곱/나눗셈), 부하(Stress)는 "공급 용량 vs 소비량"으로 합산된다.

실제 KineticNetwork.java를 보면 sources(용량 공급자)와 members(전체 구성원)를 각각 Map<KineticBlockEntity, Float>로 들고, calculateCapacity()와 calculateStress()를 합산해 비교한다. 속도가 빠를수록 부하도 커지도록 getStressMultiplierForSpeed(speed)를 곱한다.

// content/kinetics/KineticNetwork.java (요약) — 네트워크의 두 장부
public class KineticNetwork {
  public Map<KineticBlockEntity, Float> sources; // 용량 제공자
  public Map<KineticBlockEntity, Float> members; // 전체 구성원

  public float calculateCapacity() { // 공급 용량 합 ... }
  public float calculateStress()   { // 소비 부하 합 ... }

  // 속도가 빠를수록 용량·부하에 곱해지는 배수
  private static float getStressMultiplierForSpeed(float speed) { ... }
}

그렇다면 "누가 누구와 연결됐는지"는 어떻게 알까? 그 역할이 RotationPropagator(이웃으로 회전을 전파하고 속도/방향 충돌을 감지)와 TorquePropagator(틱마다 네트워크를 갱신)다. 블록을 놓거나 부수면 이 전파기가 네트워크를 다시 잇거나 끊는다.

4-3. 기둥 ② 구조물 엔진 (Contraptions)

content/contraptions/. 베어링(bearing)·피스톤(piston)·도르래(pulley)·갠트리(gantry)·엘리베이터(elevator)·광산수레(minecart)가 공통으로 하는 일: 붙어 있는 블록 묶음을 "구조물(Contraption)"로 포착해 움직이는 엔티티로 바꾸고, 멈출 때 다시 월드 블록으로 되돌린다.

이때 "떼어낸 블록들"은 임시 가상 월드(virtualWorld)에 담겨 상호작용(예: 이동하는 작업대 위 톱이 나무를 자르는 것)을 그대로 유지한다. foundation/virtualWorld/가 그 토대다. 정적 블록 ↔ 동적 엔티티를 오가는 이 설계가 Create에서 가장 정교한 부분이다.

4-4. 기둥 ③ 렌더링 — BlockEntity 렌더러 vs Flywheel

회전체를 그리는 길이 두 갈래다. 바닐라 방식인 KineticBlockEntityRenderer(매 프레임 지오메트리 재생성)와, 인스턴싱 방식인 KineticBlockEntityVisual + RotatingInstance(Flywheel). Flywheel이 켜져 있으면 같은 축 모델을 GPU에 한 번 올리고 인스턴스별 회전각만 갱신해 수천 개를 싸게 그린다. Flywheel이 없거나 꺼지면 자동으로 바닐라 렌더러로 폴백한다.

5디렉토리 구조 해부

저장소 전체 → 소스 패키지 → 동력 부품 폴더 순으로 좁혀 본다.

5-1. 저장소 전체

5-2. 소스 본체 main/java/com/simibubi/create/

5-3. 동력 부품 폴더 content/kinetics/ 내부

각 기계가 자기 폴더를 갖는 기능별(feature-folder) 구조다 — 부품 하나를 이해하려면 그 폴더만 보면 된다.

읽는 순서 추천: ① base/KineticBlockEntity.java(모든 기계의 부모) → ② KineticNetwork.java(네트워크 장부) → ③ RotationPropagator.java(연결·충돌 판정) → ④ waterwheel/(용량을 공급하는 쪽) → ⑤ press/(부하를 소비하는 쪽). 이 다섯이면 동력 시스템 전체가 잡힌다.

6학습 포인트 (기술별)

이 레포 하나로 "시뮬레이션 + 렌더링 + 대형 OOP 설계"를 동시에 챙긴다.

① 그래프 기반 실시간 시뮬레이션

가장 값진 배움. 서로 연결된 노드(기계)들을 네트워크로 묶고, 상태(속도·부하)를 전파·합산하며 매 틱 갱신하는 패턴은 회로 시뮬레이터·유체 네트워크·전력망 등 어디서나 쓰인다. 블록을 놓고 부술 때 네트워크를 증분 갱신(전체 재계산 회피)하는 RotationPropagator의 기법이 특히 실전적이다.

② 틱 예산(tick budget) 안에서의 성능 사고

초당 20틱, 즉 한 틱은 50ms 안에 세상 전체 갱신이 끝나야 한다. "매 틱 전부 재계산"하면 큰 공장에서 렉이 걸린다. Create는 네트워크를 캐싱하고 변경분만 갱신하며, 렌더는 Flywheel로 GPU에 떠넘긴다. "비싼 계산을 어떻게 분산·캐시·오프로드하나"를 실물로 배운다.

③ 합성(composition) over 상속(inheritance)

수십 종 기계가 능력을 공유하는데, 거대한 상속 트리 대신 foundation/blockEntity/behaviour/의 탈착식 Behaviour로 조립한다. "상속의 다이아몬드 지옥"을 합성으로 피하는 OOP 설계 원칙을 대규모 코드에서 본다.

④ 정적 데이터 ↔ 동적 엔티티 변환

Contraption은 월드에 박힌 블록을 런타임에 엔티티로 "들어 올렸다" 다시 내려놓는다. 직렬화(블록→데이터)·가상 월드·재배치의 한 사이클을 보면, 게임 외 분야에서도 "상태 스냅샷을 떠서 이동·복원"하는 패턴의 감을 얻는다.

⑤ GPU 인스턴스 렌더링 입문

같은 메시를 대량으로 그릴 때 인스턴싱이 왜·어떻게 빠른지를 RotatingInstance/KineticBlockEntityVisual로 구체적으로 본다. 게임 그래픽스의 핵심 최적화를 실코드로 만나는 드문 기회다(원리는 일반 OpenGL/Vulkan 인스턴싱과 동일).

⑥ 대형 OSS 운영 — datagen · 다국어 · CI

전리품표·모델·태그 수천 개를 손으로 안 쓰고 infrastructure/data/의 데이터 생성기(datagen)로 자동 출력한다(src/generated/). 번역은 Crowdin, 빌드는 Jenkins, 게임 동작 검증은 gametest/로 한다. 실전 OSS 운영 교본.

7하드웨어 / 시스템 요구사항

"플레이"와 "개발(코드 빌드)"의 요구사항이 다르다.

소스에서 빌드/실행

# 1) 저장소 클론 (개발 브랜치)
git clone -b mc1.21.1/dev https://github.com/Creators-of-Create/Create

# 2) 개발용 클라이언트 실행 (gradlew 래퍼가 NeoForge 환경 구성)
./gradlew runClient      # Windows: gradlew.bat runClient

# 3) 배포용 jar 빌드 → build/libs/ 에 생성
./gradlew build

# 4) datagen 재생성 / 인게임 게임테스트
./gradlew runData
./gradlew runGameTestServer

처음 실행은 NeoForge·MC·매핑·의존 모드를 내려받느라 시간이 걸린다. settings.gradle에 Ponder/ 디렉토리가 있으면 Ponder 소스도 함께 빌드되도록 includeBuild가 걸려 있어, 라이브러리까지 한 번에 수정·디버깅할 수 있다.

8직접 해볼 수 있는 실습 과제

읽기만 말고, 난이도순으로 손을 움직여 보자.

9관련 기술 심화 학습 로드맵

4주 코스 — 모딩 기초와 코드 독해를 번갈아 다진다.

10핵심 키워드 사전

이 레포를 읽다 마주치는 용어들.

11참고 링크

원본과 더 깊이 파고들 자료.

프로젝트 원본

· GitHub 저장소(NeoForge): github.com/Creators-of-Create/Create
· Fabric 포트: github.com/Fabricators-of-Create/Create
· CurseForge: curseforge.com/.../create · Modrinth: modrinth.com/mod/create
· 위키 / Discord: 저장소 상단 링크(r.createmod.net) 참고

코드 안에서 먼저 볼 곳

· 진입점: src/main/java/com/simibubi/create/Create.java
· 동력 핵심: content/kinetics/base/KineticBlockEntity.java, content/kinetics/KineticNetwork.java, RotationPropagator.java
· 구조물: content/contraptions/ · 렌더: content/kinetics/base/KineticBlockEntityVisual.java
· 버전 매트릭스: gradle.properties · 의존성: build.gradle

배경 지식

· NeoForge 공식 문서: docs.neoforged.net (블록/아이템/BlockEntity/datagen)
· Parchment 매핑: parchmentmc.org
· Flywheel(렌더): github.com/Engine-Room/Flywheel · GPU 인스턴싱 개념 학습 병행 권장