Jshader 문서 원본 보기

'''jshader'''는 [[마인크래프트]] 서버에서 커스텀 셰이더 효과를 적용할 수 있게 해주는 플러그인이다. 클라이언트 측 모드 없이도 서버에서 다양한 시각적 효과를 제공할 수 있다.

== 주요 기능 ==
=== 셰이더 효과 ===
서버 측에서 제어 가능한 다양한 셰이더 효과:
* '''화면 효과''': 블러, 왜곡, 색상 필터
* '''환경 효과''': 안개, 빛 번짐, 그림자
* '''상태 효과''': 현기증, 환각, 충격 효과
* '''날씨 효과''': 비, 눈, 폭풍 강화

=== 리소스팩 연동 ===
커스텀 리소스팩과 함께 사용하여 더욱 풍부한 시각 효과를 구현할 수 있다. 서버 리소스팩 자동 다운로드 기능을 지원한다.

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /shader apply <플레이어> <셰이더> || 셰이더 적용 || jshader.apply
|-
| /shader remove <플레이어> || 셰이더 제거 || jshader.remove
|-
| /shader list || 사용 가능한 셰이더 목록 || jshader.list
|-
| /shader reload || 셰이더 리로드 || jshader.reload
|-
| /shader create <이름> || 셰이더 생성 || jshader.create
|-
| /shader test <셰이더> || 자신에게 테스트 || jshader.test
|}

== 설정 ==
<pre>
# config.yml 주요 설정
shaders:
  blur:
    type: GAUSSIAN_BLUR
    intensity: 0.5
    duration: -1  # -1은 무한
    
  nightvision:
    type: COLOR_FILTER
    color: "#00FF00"
    brightness: 1.2
    
  underwater:
    type: DISTORTION
    wave-speed: 0.05
    wave-amplitude: 0.02
    color-overlay: "#000080"
    
resource-pack:
  enabled: true
  url: "https://example.com/shaders.zip"
  hash: "SHA-1 해시값"
  force: false
</pre>

== 셰이더 종류 ==
=== 기본 셰이더 ===
<pre>
# 사용 가능한 기본 셰이더
- BLUR: 흐림 효과
- GRAYSCALE: 흑백 효과
- SEPIA: 세피아 톤
- NEGATIVE: 색상 반전
- RAINBOW: 무지개 효과
- GLITCH: 글리치 효과
- PIXELATE: 픽셀화
- VIGNETTE: 비네팅 효과
</pre>

=== 커스텀 셰이더 생성 ===
<pre>
# shaders/custom.yml
custom_shader:
  name: "커스텀 효과"
  description: "특별한 시각 효과"
  layers:
    - type: COLOR_FILTER
      color: "#FF0000"
      opacity: 0.3
    - type: DISTORTION
      strength: 0.1
    - type: VIGNETTE
      intensity: 0.5
      
  animation:
    enabled: true
    duration: 2000  # 밀리초
    loop: true
</pre>

== 이벤트 연동 ==
=== 자동 적용 ===
<pre>
# 특정 상황에서 자동으로 셰이더 적용
triggers:
  on-damage:
    shader: "damage_effect"
    duration: 500
    
  on-potion-effect:
    CONFUSION:
      shader: "dizzy"
    BLINDNESS:
      shader: "darkness"
      
  in-biome:
    DESERT:
      shader: "heat_wave"
    SNOWY:
      shader: "frost"
</pre>

== API 사용법 ==
<pre>
// 플러그인에서 jshader API 사용
ShaderAPI api = jshader.getAPI();

// 셰이더 적용
api.applyShader(player, "blur", 5000); // 5초간

// 커스텀 셰이더 생성
Shader custom = api.createShader("custom")
    .addLayer(ShaderType.BLUR, 0.5f)
    .addLayer(ShaderType.COLOR_FILTER, Color.RED)
    .build();
    
api.applyShader(player, custom);
</pre>

== 성능 최적화 ==
<pre>
performance:
  max-active-shaders: 50  # 동시 활성 셰이더 수
  update-interval: 1  # 업데이트 주기 (틱)
  client-side-caching: true  # 클라이언트 캐싱
  
  quality-settings:
    low: 
      skip-frames: 2
      reduce-quality: true
    medium:
      skip-frames: 1
      reduce-quality: false
    high:
      skip-frames: 0
      reduce-quality: false
</pre>

== 활용 예시 ==
* '''공포 맵''': 어두운 화면 효과와 갑작스런 화면 왜곡
* '''약물 효과''': 포션 효과에 따른 시각적 변화
* '''환경 연출''': 지역별 특수 효과 (사막의 열기, 눈보라 등)
* '''컷신''': 영화적 효과를 위한 화면 전환
* '''상태 이상''': 피격, 중독, 질병 등의 시각화

== 호환성 및 제한사항 ==
* 클라이언트가 OptiFine 또는 Iris Shaders를 사용 중일 경우 충돌 가능
* 일부 효과는 특정 그래픽 설정에서만 작동
* 리소스팩 필수 요구 효과가 있을 수 있음

== 문제 해결 ==
* '''셰이더가 적용되지 않음''': 클라이언트 그래픽 설정 확인
* '''성능 저하''': 동시 활성 셰이더 수 제한
* '''깜빡임 현상''': 업데이트 주기 조정

[[분류:마인크래프트]]