chzzk-subscriptions

## CHZZK Subscriptions for Minecraft

chzzk-subscriptions connects CHZZK (Naver) subscription events to your NeoForge Minecraft server. When a viewer follows, subscribes, or triggers a subscription-related event on your CHZZK channel, this mod runs configured actions inside the game — spawn mobs, give buffs, apply debuffs, execute commands, and more.

This is a module of the chzzkapi suite. It requires chzzkapi_core and chzzkapi_actions to function.

## Features

• Subscription event rules — bind CHZZK subscription events to in-game actions.
• Action presets — reuse presets and named groups from chzzkapi_actions.
• Admin panel — manage rules through the web UI when codemc_admin is installed.
• Server-side config — rules are stored in config/codemcchzzkapi/chzzkapi-subscriptions.toml.
• Safe & local — admin web UI binds to 127.0.0.1 by default.

## Required Dependencies

Make sure these mods are in your mods/ folder:

• chzzkapi_core (required)
• chzzkapi_actions (required)
• codemc_admin (optional, for the web admin panel)

## How to Use

1. Install the required mods.

2. Start the server once to generate the config.

3. Edit config/codemcchzzkapi/chzzkapi-subscriptions.toml or use the admin panel.

4. Set up rules like: "on new subscription → run preset celebration".

   Streamer authentication is handled by chzzkapi_core via the /chzzk login command.

## Links

• Official site: https://chzzkapi.code0987.me/minecraft
• GitHub: https://github.com/code0987/chzzk-subscriptions

## 마인크래프트용 CHZZK 구독 연동

chzzk-subscriptions는 CHZZK(치지직) 구독 이벤트를 NeoForge 마인크래프트 서버와 연결하는 모드입니다. 시청자가 팔로우·구독·구독 관련 이벤트를 발생시키면, 설정한 규칙에 따라 서버 내 몹 소환, 버프/디버프 부여, 명령어 실행 등의 액션이 자동으로 실행됩니다.

chzzkapi 모드 묶음의 일부이며, 동작을 위해서 chzzkapi_core와 chzzkapi_actions가 필요합니다.

## 기능

• 구독 이벤트 규칙 설정
• chzzkapi_actions의 프리셋/그룹 재사용
• codemc_admin 설치 시 웹 관리 패널 제공
• config/codemcchzzkapi/chzzkapi-subscriptions.toml에서 서버 측 설정
• 관리 UI는 기본적으로 127.0.0.1에만 바인딩

## 필요한 모드

mods/ 폴더에 아래 모드가 있어야 합니다:

• chzzkapi_core (필수)
• chzzkapi_actions (필수)
• codemc_admin (선택, 웹 관리 패널용)

## 사용 방법

1. 필요한 모드를 설치합니다.

2. 서버를 한 번 실행해 설정 파일을 생성합니다.

3. config/codemcchzzkapi/chzzkapi-subscriptions.toml을 수정하거나 관리 패널을 사용합니다.

4. 예: "신규 구독 발생 시 celebration 프리셋 실행".

   스트리머 인증은 chzzkapi_core의 /chzzk login 명령어로 처리합니다.

## 링크

• 공식 안내 페이지: https://chzzkapi.code0987.me/minecraft
• GitHub: https://github.com/code0987/chzzk-subscriptions