============================================================
Hxwi1Structures - 사용 가이드
============================================================

이 모드는 JSON 설정과 NBT 파일을 통해 구조물을 생성합니다.
내장된 구조물은 없습니다.

============================================================
파일 위치
============================================================

  설정:   .minecraft/config/hxwi1structures/structure_rules.json
  옵션:   .minecraft/config/hxwi1structures/mod_settings.json
  NBT:     .minecraft/config/hxwi1structures/structures/
  가이드: .minecraft/config/hxwi1structures/readme.txt

최초 실행 시 자동 생성:
  - mod_settings.json
  - structure_rules.json (예제 규칙 3개)
  - structures/example.nbt (석조 벽돌집)
  - structures/dock_example.nbt (나무 부두)
  - structures/forest_cabin.nbt (통나무 오두막)
  - readme.txt (이 파일)

가이드 언어는 게임 언어 설정을 따릅니다
(options.txt에서 감지).

============================================================
규칙 필드
============================================================

biomes (필수)
  바이옴 ID 배열. 바닐라 및 모드 바이옴 지원.
  예: "minecraft:plains", "terralith:highlands"

dimensions (선택, 기본값: 전체)
  생성할 차원 ID 배열.
  바닐라: "minecraft:overworld", "minecraft:the_nether",
           "minecraft:the_end"

nbt_file (필수)
  config/hxwi1structures/ 기준 .nbt 파일의 상대 경로.

chance (필수)
  소수 0.0~1.0. 청크당 생성 확률.

min_y / max_y (필수)
  생성 높이 범위 (Y 좌표).
  snap_to_surface가 false일 때만 사용.

snap_to_surface (선택, 기본값: false)
  지형 표면에 구조물 배치.

allowed_rotations (선택, 기본값: [0,90,180,270])
  허용 회전 각도. 0,90,180,270만 유효.
  잘못된 값은 0°로 처리.

max_conflict_ratio (선택, 기본값: 0.2)
  배치 충돌 허용치.
  0.0 = 충돌 불허, 1.0 = 강제 배치.

place_on_water (선택, 기본값: false)
  수면 위 생성 허용.

dock_mode (선택, 기본값: false)
  육지-물 경계를 자동 감지하여 방향 결정.
  부두에 적합.

y_offset (선택, 기본값: 0)
  수직 오프셋. 음수 = 아래로.

underwater_mode (선택, 기본값: false)
  물속에서만 생성.

clear_trees (선택, 기본값: false)
  배치 전 구조물 범위 내 원목과 잎 제거.

loot_table (선택, 기본값: 빈칸)
  상자 등 컨테이너에 전리품 테이블 주입.
  예: "minecraft:chests/simple_dungeon"

============================================================
팁
============================================================

- 숲속 건물 (자동 벌목):
    "clear_trees": true
- 부두 (자동 물 방향):
    "dock_mode": true, "place_on_water": true
- 배 (일부 물에 잠김):
    "place_on_water": true, "y_offset": -1
- 수중 유적:
    "underwater_mode": true
- 지하 던전:
    "snap_to_surface": false, "max_conflict_ratio": 1.0

============================================================
디버그
============================================================

mod_settings.json에서 "debug_logging": true로 설정하고
게임 로그의 [hxwi1structures] 출력을 확인하세요.

============================================================
NBT 파일 생성
============================================================

크리에이티브 모드에서 구조물 블록 사용:
  1. 구조물 블록 배치
  2. 경계 내에 구조물 건설
  3. "SAVE" 클릭
  4. .minecraft/saves/<월드>/generated/<namespace>/structures/
     에서 .nbt 파일을 config/hxwi1structures/structures/로 복사

하위 디렉터리 사용 가능:
  structures/overworld/houses/cottage.nbt

============================================================
생성 흐름
============================================================

1. 청크 로드 시 grid_interval 확인
2. 대상 청크 즉시 큐에 추가 (월드 생성 차단 없음)
3. 큐의 청크는 후속 tick에서 처리 (최대 2개/tick)
4. 각 청크는 한 번만 처리 (SavedData로 영구 저장)
5. 규칙을 순서대로 확인, 첫 성공 시 중지
6. 규칙별: 차원→XZ→바이옴→확률→Y→회전
   →벌목→충돌→청크경계→배치→전리품

============================================================
mod_settings.json
============================================================

{
  "grid_interval": 2,
  "debug_logging": false
}

grid_interval (기본값: 2)
  청크 샘플링 밀도: 1=100%, 2=~25%, 3=~11%, 4=~6%

debug_logging (기본값: false)
  DEBUG 로그 켜기/끄기
