Repolode
jasonkneen

jasonkneen/tiny-world-builder

작은 월드를 만들고, 다듬고, 비행하며 공유할 수 있는 브라우저 기반 3D 복셀 월드 에디터입니다.

스타
1,606
포크
214
열린 이슈
5
마지막 커밋
2시간 전

어떤 프로젝트인가요?

Tiny World Builder는 브라우저에서 완전히 실행되는 독립형 3D 복셀 에디터입니다. 잔디, 물, 돌, 모래, 용암 같은 지형을 배치하고, 집, 나무, 울타리, 다리, 작물, 동물 같은 오브젝트를 추가할 수 있습니다. 땅을 높이거나 낮추고 칠해 절벽과 강을 만들 수도 있습니다.

에디터는 아이소메트릭, 소프트, 퍼스펙티브 등 여러 카메라 모드를 제공해 월드를 어느 각도에서든 볼 수 있습니다. 월드는 이름을 지정해 로컬 슬롯에 저장하고, 내보내고, 리믹스하고, 공유할 수 있습니다. Mesh Terrain 조각 도구를 사용하면 선택적으로 복셀 단위 재질을 적용해 더 부드러운 지형 형태를 다듬을 수 있습니다.

프로젝트에는 배달 차량이 도로망을 따라 이동하고 배치된 오브젝트를 피해 경로를 다시 찾는 시드 기반 차량 런타임이 포함됩니다. 바닐라 JavaScript와 Three.js로 만든 정적 사이트이며 Vercel이나 Netlify에 배포할 수 있습니다.

핵심 기능

  • 01복셀 그리드에 지형, 오브젝트, 작물, 동물을 배치합니다.
  • 02지형을 높이거나 낮추고 칠해 절벽과 강을 만듭니다.
  • 03아이소메트릭, 소프트, 퍼스펙티브 카메라를 전환합니다.
  • 04이름을 붙인 여러 월드를 로컬에 저장하고 내보내거나 공유합니다.
  • 05복셀별 재질을 지원하는 선택형 Mesh Terrain 조각 도구를 제공합니다.
  • 06도로 경로 안내와 교통 회피 기능을 갖춘 시드 기반 차량 데모를 제공합니다.

활용 사례

  • 브라우저에서 작은 복셀 스타일 게임 레벨이나 디오라마 장면을 프로토타이핑합니다.
  • 도로, 울타리, 집처럼 인접 요소를 인식하는 타일이 자동으로 어떻게 연결되는지 살펴봅니다.
  • 생성된 도로망에서 경로 계획과 교통 동작을 테스트합니다.
  • 독립형 정적 3D 월드 빌더를 자체 사이트에서 호스팅합니다.

빠른 시작

  1. 1

    로컬 개발 서버를 시작합니다

    npm run dev
  2. 2

    localhost:3000/tiny-world-builder에서 빌더를 엽니다

  3. 3

    또는 개발 서버 없이 정적 파일을 직접 엽니다

    open index.html

사용 전 알아둘 점

  • AGPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 수정된 배포본을 사용하는 네트워크 사용자에게 소스 코드를 제공해야 합니다.
  • 실제 배포 환경에서 지갑 로그인을 사용하려면 먼저 Netlify에서 TINYWORLD_WALLET_SESSION_SECRET을 설정해야 합니다.

토픽

자주 묻는 질문

tiny-world-builder은(는) 무엇인가요?
작은 월드를 만들고, 다듬고, 비행하며 공유할 수 있는 브라우저 기반 3D 복셀 월드 에디터입니다. Tiny World Builder는 브라우저에서 완전히 실행되는 독립형 3D 복셀 에디터입니다. 잔디, 물, 돌, 모래, 용암 같은 지형을 배치하고, 집, 나무, 울타리, 다리, 작물, 동물 같은 오브젝트를 추가할 수 있습니다. 땅을 높이거나 낮추고 칠해 절벽과 강을 만들 수도 있습니다.
tiny-world-builder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tiny-world-builder은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
tiny-world-builder은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. tiny-world-builder의 마지막 커밋은 2026년 10월 19일입니다.
tiny-world-builder은(는) 어디에 사용할 수 있나요?
브라우저에서 작은 복셀 스타일 게임 레벨이나 디오라마 장면을 프로토타이핑합니다. 도로, 울타리, 집처럼 인접 요소를 인식하는 타일이 자동으로 어떻게 연결되는지 살펴봅니다. 생성된 도로망에서 경로 계획과 교통 동작을 테스트합니다. 독립형 정적 3D 월드 빌더를 자체 사이트에서 호스팅합니다.
tiny-world-builder는 어떻게 설치하나요?
로컬 개발 서버를 시작합니다: npm run dev localhost:3000/tiny-world-builder에서 빌더를 엽니다 또는 개발 서버 없이 정적 파일을 직접 엽니다: open index.html
tiny-world-builder은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jasonkneen/tiny-world-builder

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트