chzzk-subscriptions

By
Code0987

Bind CHZZK subscription events to automated in-game actions through the chzzkapi suite

## 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

Install the required mods.
Start the server once to generate the config.
Edit config/codemcchzzkapi/chzzkapi-subscriptions.toml or use the admin panel.
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 (선택, 웹 관리 패널용)

## 사용 방법

필요한 모드를 설치합니다.
서버를 한 번 실행해 설정 파일을 생성합니다.
config/codemcchzzkapi/chzzkapi-subscriptions.toml을 수정하거나 관리 패널을 사용합니다.
예: "신규 구독 발생 시 celebration 프리셋 실행".

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