Structure Gel API

구조물 생성(특히 jigsaw 시스템) 개발을 단순화하는 ModdingLegacy의 라이브러리. 구조물 제작자를 위한 Gel 블록과 크리에이티브 전용 Building Tool을 함께 제공합니다.

📖 소개

Structure Gel API는 ModdingLegacy가 만든 구조물 생성용 라이브러리입니다. 목적은 명확합니다 — 생성 구조물을, 특히 jigsaw 시스템을 쓰는 구조물을 만드는 개발자 쪽 작업을 단순화하는 것입니다. 코드는 공개돼 있고 문서도 제공되며, 같은 팀의 Dungeons Plus가 이 API를 실제로 쓰는 오픈소스 예제 역할을 합니다.

라이브러리이긴 하지만 구조물을 직접 만드는 사람이 쓰는 인게임 도구도 함께 들어 있습니다.

Structure Gel Block이 그 이름의 유래입니다. 구조물 내부를 채워 두는 크리에이티브용 블록으로, 구조물이 게임에서 생성될 때 Gel은 공기로 바뀌고, 원래 비어 있던 공기는 배치 자체를 건너뜁니다. 덕분에 '여기는 비워라'와 '여기는 원래 지형을 그대로 둬라'가 구분돼서, 구조물 안에 자연 지형이 삐져 들어오지 않습니다. 구조물 보이드와 비슷하게 통과해서 걸을 수 있지만 눈에는 보입니다.

Gel은 색깔별로 퍼지는 방식이 다르고, 웅크린 채 놓으면 확산 기능이 발동합니다. 빨강은 기본형으로 상하좌우로 퍼지며 공기만 대체하고, 파랑은 빨강과 같지만 하늘이 보이는 곳으로는 안 퍼집니다. 초록은 빨강 + 대각선 확산이라 덩굴 같은 복잡한 구조의 모서리도 통과하지만, 대신 건물 밖으로 새기 쉽습니다. 청록은 초록과 파랑을 합친 것(대각선 확산 + 하늘 회피), 주황은 손에 든 개수만큼 퍼지는 거리가 결정돼 개방된 지형에서 쓰기 좋고, 노랑은 놓을 때 바라보는 평면 방향으로만 퍼져서 벽이나 창문 구멍을 막는 데 적합합니다. Gel을 지울 때는 화약을 쓰면 되고, 연결된 같은 색 Gel이 연쇄적으로 함께 사라집니다.

Building Tool은 크리에이티브 전용 아이템으로, Structure Items 크리에이티브 탭에 들어 있습니다. 공중에 우클릭하면 GUI가 열리고, 방사형 메뉴에서 모드를 고르며, 실행 취소·다시 실행(최대 32개 동작 저장), 위치 선택, 블록 상태 지정을 할 수 있습니다. 모드는 Extend(클릭한 면의 패턴을 감지해 앞으로 이어 붙임), Flood(클릭한 y 층의 공기를 경계까지 채우고 아래로 계속), Fill(두 모서리를 선택해 사이를 채움 — 특정 블록만 대체하거나 테두리·속 빈 상자만 만들기 가능), Line(두 지점 사이에 직선), Clone(선택 영역 복사·붙여넣기, 회전·미러·잘라내기 지원), Move(선택 영역을 때린 방향으로 이동), Clear(선택 영역 제거), Shape(도형 배치)가 있습니다. 모드별 세부 설정으로 Integrity(실제로 배치될 블록 비율), Replace(All/Air/Clicked 중 무엇을 대체할지), Rotation·Mirror(무작위 값 선택 가능) 등이 있습니다.

Forge와 NeoForge를 지원합니다.

🕒 이 모드는 언제 쓰는가

이 API를 요구하는 구조물 모드가 있으면 자동으로 함께 로드됩니다. Building Tool과 Gel 블록은 크리에이티브에서 구조물을 만들 때 씁니다.

📦 어떤 모드팩에서 중요한가

Dungeons Plus처럼 이 API를 의존성으로 요구하는 구조물 모드가 들어간 모드팩. 그리고 직접 구조물을 만들어 배포하려는 사람에게.

🎮 플레이 체감 변화

일반 플레이 중에는 존재를 알아차릴 일이 없습니다. 크리에이티브에서 대규모 건축을 하면 Building Tool의 Fill·Clone·Undo가 눈에 띄게 시간을 줄여 줍니다.

🚀 시작 가이드 — 첫 30분 동안 해야 할 것

플레이어로서는 할 일이 없습니다. 모드팩에 포함돼 있다면 그대로 두면 됩니다.

구조물을 직접 만들 생각이라면 크리에이티브에서 Structure Items 탭을 열어 Building Tool과 Gel 블록을 꺼내는 것부터 시작하세요. Building Tool은 공중 우클릭으로 GUI가 열리고, GUI 안의 항목에 마우스를 올리면 오른쪽에 설명이 뜹니다.

작업 흐름은 대략 이렇습니다. Fill·Clone·Shape로 구조물 뼈대를 잡고, 완성된 내부를 Gel로 채운 다음, 구조물로 저장합니다. 생성 시 Gel은 공기로 치환되고 바깥의 공기는 무시되므로, 구조물 안에 지형이 끼어들지 않습니다.

💡 플레이 팁

  • 임의로 빼지 마세요. 이 API를 요구하는 구조물 모드(예: Dungeons Plus)는 로딩 단계에서 실패합니다.
  • Building Tool은 크리에이티브 전용입니다. Structure Items 크리에이티브 탭에 있고, 공중에 우클릭하면 GUI가 열립니다. 실행 취소는 최대 32개 동작까지 저장됩니다.
  • Gel 색깔은 확산 방식이 다릅니다. 개방된 지형에서는 손에 든 개수로 거리가 정해지는 주황, 벽·창문 구멍을 막을 때는 평면으로만 퍼지는 노랑, 하늘로 새는 게 걱정이면 파랑을 쓰세요.
  • Gel은 화약으로 지웁니다. 연결된 같은 색 Gel이 한 번에 연쇄 제거됩니다.

⚠️ 자주 헷갈리는 부분

  • Gel 블록은 구조물 제작용이지 게임플레이용이 아닙니다. 일반 서바이벌 진행에는 아무 영향이 없습니다.
  • 모든 구조물 모드가 이걸 요구하는 건 아닙니다. 이름이 비슷한 다른 라이브러리(YUNG's API 등)를 쓰는 모드도 많으니, 특정 모드의 의존성은 그 모드 쪽에서 확인해야 합니다.

❓ 자주 묻는 질문

어떤 모드가 이걸 요구하나요?

같은 팀의 Dungeons Plus가 이 API를 의존성으로 요구하고, 문서에서도 API 사용 예제로 안내됩니다. 다른 구조물 모드도 쓸 수 있지만, 특정 모드가 요구하는지는 그 모드의 의존성 목록에서 확인하는 게 정확합니다.

Gel 블록이 정확히 뭘 하나요?

구조물 내부를 채워 두는 제작용 블록입니다. 구조물이 생성될 때 Gel은 공기로 치환되고, 원래의 공기는 배치를 건너뜁니다. 그래서 '비워야 할 공간'과 '건드리지 말아야 할 기존 지형'이 구분되고, 구조물 안에 자연 지형이 들어오지 않습니다.

Gel 색깔이 여러 개인 이유는?

확산 방식이 다르기 때문입니다. 빨강(기본·상하좌우), 파랑(하늘 보이는 곳 회피), 초록(대각선 포함), 청록(대각선 + 하늘 회피), 주황(손에 든 개수만큼 거리 결정), 노랑(바라보는 평면으로만). 웅크린 채 놓으면 확산이 발동합니다.

Building Tool은 서바이벌에서도 쓸 수 있나요?

아니요. 크리에이티브 모드 전용 아이템입니다. Structure Items 크리에이티브 탭에 있고, 공중에 우클릭해 GUI를 엽니다.

📦 이 모드가 포함된 모드팩

🔗 관련 모드