⚖️ 네임스페이스 GameRules 게임 규칙 완전 레퍼런스

Agrarian Reform의 모든 설정값은 DasikLibrary의 DynamicGameRuleManager를 통해 관리되는 Agrarian Reform(agrarian_reform:*) 네임스페이스 하위의 공식 마인크래프트 게임 규칙으로 등록됩니다. 각 월드의 level.dat에 영구 보존되며 인게임 메뉴나 콘솔 명령어로 변경할 수 있습니다.

📊 정적 GameRules 전체 대조표

게임 규칙 키	데이터 형식	기본값	유효 범위	실행 측면	설명
`agrarian_reform:hydration_source_range`	정수형	`8`	`0` ~ `32`	서버 및 클라이언트	체비쇼프 동심원을 통해 물 근원 블록이 경작지를 적시는 유효 반경(블록 단위).
`agrarian_reform:hydration_flowing_range`	정수형	`4`	`0` ~ `32`	서버 및 클라이언트	흐르는 물이 경작지에 수분을 공급하는 유효 반경(블록 단위).
`agrarian_reform:pure_water_hydration_only`	논리형	`false`	`true` / `false`	서버 및 클라이언트	활성화 시 물에 잠긴 블록과 가마솥을 무시하고 오직 순수한 물 블록만 경작지를 적십니다.
`agrarian_reform:rain_growth_acceleration`	정수형	`1`	`0` ~ `10`	서버	비가 올 때 하늘에 노출된 작물에 무작위 틱당 추가로 주어지는 성장 단계 보너스.
`agrarian_reform:growth_biodiversity_bonus`	논리형	`true`	`true` / `false`	서버	인접한 자리에 다른 종류의 작물을 함께 심었을 때 +10% 성장 확률 보너스를 부여합니다.
`agrarian_reform:total_trample_immunity`	논리형	`false`	`true` / `false`	서버	개체가 떨어지거나 점프할 때 경작지가 짓밟혀 파괴되는 현상을 100% 방지합니다.
`agrarian_reform:trample_immunity_players_only`	논리형	`false`	`true` / `false`	서버	완전 면제와 함께 사용 시 플레이어와 길들인 동물만 보호하며 야생 몬스터는 땅을 훼손합니다.
`agrarian_reform:always_wet_farmland`	논리형	`false`	`true` / `false`	서버 및 클라이언트	물 근원이 없어도 모든 경작지의 수분 단계를 영구히 최대치인 7로 유지합니다.
`agrarian_reform:seeds_grow_grass`	논리형	`true`	`true` / `false`	서버 및 클라이언트	농작물 씨앗을 들고 흙 블록을 우클릭하면 씨앗 1개를 소모하여 잔디 블록으로 변환합니다.
`agrarian_reform:right_click_harvest`	논리형	`true`	`true` / `false`	서버 및 클라이언트	다 자란 작물을 우클릭하면 수확물을 얻고 자동으로 0단계로 다시 심습니다.
`agrarian_reform:universal_bonemeal`	논리형	`true`	`true` / `false`	서버 및 클라이언트	본래 뼛가루를 사용할 수 없는 식물(선인장, 사탕수수, 네더 와트, 덩굴)의 성장을 촉진합니다.
`agrarian_reform:global_growth_multiplier`	정수형	`100`	`0` ~ `2147483647`	서버	작물의 무작위 틱 및 Continuum 오프라인 성장에 적용되는 전체 속도 배율(100 = 바닐라 1배속).
`agrarian_reform:ambient_crop_rustle`	논리형	`true`	`true` / `false`	클라이언트	작물 사이를 지나가거나 작물 단계가 올라갈 때 바스락거리는 환경 음향을 재생합니다.
`agrarian_reform:ambient_vitality_particles`	논리형	`true`	`true` / `false`	클라이언트	작물이 다음 성장 단계로 진행될 때 은은한 녹색 주민 행복 입자 효과를 생성합니다.
`agrarian_reform:debug_mode`	논리형	`false`	`true` / `false`	서버	서버 콘솔에 작물 틱 상세 진단 로그를 출력합니다. 임시 설정: 서버 재시작 시 `false`로 초기화.

🌾 작물별 동적 성장 배율 GameRules

새로운 작물(모드 또는 바닐라)이 월드에서 발견되거나 데이터 팩으로 등록되면, Agrarian Reform은 전용 게임 규칙을 동적으로 생성합니다:

$$\text{GameRule Key} = \text{agrarian_reform:growth_}\langle \text{namespace} \rangle\text{_}\langle \text{path} \rangle$$

Resolution Hierarchy:

개별 작물 배율 지정 ($> 0$): 양의 정수(예: 200)를 설정하면 전역 설정을 무시하고 해당 속도(200% = 2배속)로 성장합니다.
성장 동결 / 비활성화 ($-1$): -1로 설정하면 작물 성장이 완전히 동결(0% 속도)되며 오프라인 따라잡기도 중지됩니다.
전역 배율 상속 ($0$): 0(기본값)으로 설정하면 agrarian_reform:global_growth_multiplier를 자동으로 상속합니다.

bash

# 밀의 성장 속도를 3배로 설정
/gamerule agrarian_reform:growth_minecraft_wheat 300

# 사탕수수 성장을 완전히 동결
/gamerule agrarian_reform:growth_minecraft_sugar_cane -1

# 당근을 전역 배율 상속으로 재설정
/gamerule agrarian_reform:growth_minecraft_carrots 0

⚡ 게임 실행 중 동적 등록 (재부팅 불필요)

즉시 생성: 새로운 지역을 탐험하거나 모드 작물을 심는 순간 AgrarianCropRules가 감지하여 게임 규칙을 즉시 만듭니다.
명령어 자동 완성 지원: 생성된 게임 규칙은 재부팅 없이 즉시 /gamerule 명령어에서 Tab 자동 완성이 지원됩니다.
데이터 팩 리로드 지원: /reload 실행 시 레지스트리를 다시 스캔하여 새로운 작물 태그를 자동 등록합니다.

🛡️ 모드 제거 시 안전성 및 휴면 라이프사이클

완전한 결합 분리: 동적 게임 규칙은 표준 문자열과 바닐라 Identifier 키로 식별되어 모드 클래스 의존성이 전혀 없습니다.
휴면 상태 전환: 모드를 제거하더라도 관련 규칙은 휴면 상태로 남아 CPU 부하가 없고 충돌을 일으키지 않습니다.
재설치 시 복원: 모드를 나중에 다시 설치하면 level.dat와 설정 파일에 저장된 배율이 즉시 복구됩니다.

🛠️ 게임 내 관리 명령어 예시

bash

# 현재 물 근원 블록의 관개 반경 조회
/gamerule agrarian_reform:hydration_source_range

# 물 근원 블록의 관개 범위를 12블록으로 설정
/gamerule agrarian_reform:hydration_source_range 12

# 플레이어 전용 짓밟기 면제 활성화
/gamerule agrarian_reform:total_trample_immunity true
/gamerule agrarian_reform:trample_immunity_players_only true

# 진단용 디버그 로그 일시 활성화
/gamerule agrarian_reform:debug_mode true

⚖️ 네임스페이스 GameRules 게임 규칙 완전 레퍼런스 ​

📊 정적 GameRules 전체 대조표 ​

🌾 작물별 동적 성장 배율 GameRules ​

Resolution Hierarchy: ​

⚡ 게임 실행 중 동적 등록 (재부팅 불필요) ​

🛡️ 모드 제거 시 안전성 및 휴면 라이프사이클 ​