chk datapack link

chk datapack link

A Minecraft Fabric bridge mod that connects Chzzk (NAVER live streaming) chat & donation events directly to Minecraft NBT storage and datapacks in real time.

756 downloads 0 followers

๐Ÿง€ ์น˜์ง€์ง ๋ฐ์ดํ„ฐํŒฉ ๋งํฌ (Chzzk Datapack Link)

Minecraft Fabric AI Assisted License English Docs

์น˜์ง€์ง(Chzzk) ๋ผ์ด๋ธŒ ๋ฐฉ์†ก์˜ ์ฑ„ํŒ…๊ณผ ํ›„์› ์ด๋ฒคํŠธ๋ฅผ ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ NBT ์Šคํ† ๋ฆฌ์ง€ ๋ฐ ๋ฐ์ดํ„ฐํŒฉ๊ณผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ์—ฐ๋™ํ•ด์ฃผ๋Š” ํŒจ๋ธŒ๋ฆญ(Fabric) ๋ชจ๋“œ์ž…๋‹ˆ๋‹ค.

๐ŸŒ English Documentation
โš ๏ธ ์•ˆ๋‚ด: ๋ณธ ๋ชจ๋“œ๋Š” ๋„ค์ด๋ฒ„(NAVER)์˜ ๊ณต์‹ ๋ชจ๋“œ๊ฐ€ ์•„๋‹Œ ๋น„๊ณต์‹ ์˜คํ”ˆ์†Œ์Šค ์„œ๋“œํŒŒํ‹ฐ ๋ชจ๋“œ์ด๋ฉฐ, AI ์ฝ”๋”ฉ ์–ด์‹œ์Šคํ„ดํŠธ์˜ ์ง€์›์„ ๋ฐ›์•„ ์ œ์ž‘๋˜์—ˆ์Šต๋‹ˆ๋‹ค.
๐Ÿ’ก ํ•„์ˆ˜: ๋ณธ ๋ชจ๋“œ๋Š” ์น˜์ง€์ง ์ด๋ฒคํŠธ๋ฅผ ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ์Šคํ† ๋ฆฌ์ง€๋กœ ์ „๋‹ฌํ•˜๋Š” ๋ธŒ๋ฆฟ์ง€(Bridge) ๋ชจ๋“œ์ด๋ฏ€๋กœ, ์ด๋ฒคํŠธ๋ฅผ ๋ฐ›์•„ ์‹คํ–‰ํ•  ๋ฐ์ดํ„ฐํŒฉ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.


๐Ÿ“– ๊ฐœ์š”

์น˜์ง€์ง ๋ฐฉ์†ก์˜ ์ฑ„ํŒ…๊ณผ ํ›„์›์„ ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ๋ฐ์ดํ„ฐํŒฉ์œผ๋กœ ๋ฐ›์•„ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ๋ชจ๋“œ์ž…๋‹ˆ๋‹ค.

๋ณ„๋„์˜ ์ž๋ฐ” ์ฝ”๋”ฉ ์—†์ด ๋ฐ์ดํ„ฐํŒฉ ํŽ‘์…˜(.mcfunction)๋งŒ ์ž‘์„ฑํ•˜๋ฉด ์‹œ์ฒญ์ž ์ฐธ์—ฌ ์ฝ˜ํ…์ธ (์ฑ„ํŒ…์œผ๋กœ ๋ธ”๋ก ์†Œํ™˜, ํ›„์› ์‹œ ๋ชน ์†Œํ™˜, ํˆฌํ‘œ ๋“ฑ)๋ฅผ ๋ฐ”๋กœ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


โœจ ์ฃผ์š” ๊ธฐ๋Šฅ

  • ๋ฐ์ดํ„ฐํŒฉ ์—ฐ๋™: ์ฑ„ํŒ…์ด๋‚˜ ํ›„์›์ด ์˜ค๋ฉด ์Šคํ† ๋ฆฌ์ง€์— ๋ฐ์ดํ„ฐ๋ฅผ ๋ณ‘ํ•ฉํ•˜๊ณ  #chklink:chat, #chklink:donation ํƒœ๊ทธ์— ๋“ฑ๋ก๋œ ํŽ‘์…˜๋“ค์„ ๋งคํฌ๋กœ์™€ ํ•จ๊ป˜ ์ž๋™ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ช…๋ น์–ด ๋ฐ ์ธ์ž ์ž๋™ ๋ถ„๋ฆฌ:
    • !์†Œํ™˜ ์ข€๋น„ 3 โž” cmd: "์†Œํ™˜", chat: "์ข€๋น„ 3"
    • !์†Œํ™˜, ์ข€๋น„, 3 โž” cmd: "์†Œํ™˜", arg0: "์ข€๋น„", arg1: "3", arg_count: 2 ์ž๋™ ์ œ๊ณต
  • ๋ฉ€ํ‹ฐํ”Œ๋ ˆ์ด ์ง€์›: ์„œ๋ฒ„์— ์—ฌ๋Ÿฌ ํ”Œ๋ ˆ์ด์–ด๊ฐ€ ์žˆ์–ด๋„ ๊ฐ์ž ๋ณธ์ธ์˜ ์น˜์ง€์ง ์ฑ„๋„ ID๋กœ ๊ฐœ๋ณ„ ์—ฐ๋™ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ธ๊ฒŒ์ž„ ์„ค์ •์ฐฝ & Mod Menu ์—ฐ๋™: ์ธ๊ฒŒ์ž„์—์„œ F6 ํ‚ค๋ฅผ ๋ˆ„๋ฅด๊ฑฐ๋‚˜ Mod Menu์˜ ๋ชจ๋“œ ๋ชฉ๋ก ์„ค์ • ๋ฒ„ํŠผ์„ ํ†ตํ•ด ์ฑ„๋„ ID๋ฅผ ์ž…๋ ฅํ•˜๊ณ  ์—ฐ๋™์„ ์ผค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ํ…Œ์ŠคํŠธ ๋ช…๋ น์–ด: /chklink testchat, /chklink testdonation ๋ช…๋ น์–ด๋กœ ๋ฐฉ์†ก์„ ์ผœ์ง€ ์•Š๊ณ ๋„ ๋ฐ์ดํ„ฐํŒฉ ๋™์ž‘์„ ๋ฐ”๋กœ ํ…Œ์ŠคํŠธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ“‹ ์š”๊ตฌ ์‚ฌํ•ญ

  • Minecraft: 26.2 - 26.3
  • Mod Loader: Fabric Loader
  • ํ•„์ˆ˜ ๋ชจ๋“œ: Fabric API
  • ํ•„์ˆ˜ ๋ฐ์ดํ„ฐํŒฉ: ์น˜์ง€์ง ์ด๋ฒคํŠธ๋ฅผ ์ฒ˜๋ฆฌํ•  ๋ฐ์ดํ„ฐํŒฉ (example_datapacks ๋‚ด ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐํŒฉ ์ฐธ๊ณ )

๐ŸŽฎ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

1. ๋ฐ์ดํ„ฐํŒฉ ์ ์šฉํ•˜๊ธฐ (ํ•„์ˆ˜)

  • ๋ ˆํฌ์ง€ํ† ๋ฆฌ์˜ example_datapacks/chklink_sample ํด๋”(๋˜๋Š” ๋‚˜๋งŒ์˜ ์ปค์Šคํ…€ ๋ฐ์ดํ„ฐํŒฉ)๋ฅผ ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ์›”๋“œ์˜ datapacks/ ํด๋”์— ๋„ฃ๊ณ  ์›”๋“œ ๋‚ด์—์„œ /reload๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

2. ์น˜์ง€์ง ์ฑ„๋„ ID ํ™•์ธํ•˜๊ธฐ

  • ์น˜์ง€์ง ์ŠคํŠธ๋ฆฌ๋จธ์˜ ๋ฐฉ์†ก๊ตญ URL ์ฃผ์†Œ์—์„œ ์ฑ„๋„ ID(32์ž๋ฆฌ ํ•ด์‹œ๊ฐ’)๋ฅผ ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
    (์˜ˆ: https://chzzk.naver.com/live/0123456789abcdef0123456789abcdef โž” 0123456789abcdef0123456789abcdef)

3. ์ธ๊ฒŒ์ž„์—์„œ ์—ฐ๋™ํ•˜๊ธฐ

  • ๊ฒŒ์ž„ ๋‚ด์—์„œ F6 ํ‚ค(๋˜๋Š” Mod Menu ์„ค์ •)๋ฅผ ๋ˆŒ๋Ÿฌ ์„ค์ •์ฐฝ์„ ์—ฝ๋‹ˆ๋‹ค.
  • ๋ณต์‚ฌํ•œ ์ฑ„๋„ ID๋ฅผ ์ž…๋ ฅํ•˜๊ณ  **[์ฑ„๋„ ID ์ €์žฅ]**์„ ๋ˆ„๋ฅธ ๋’ค **[์—ฐ๋™ ์‹œ์ž‘]**์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ’ป ์ธ๊ฒŒ์ž„ ๋ช…๋ น์–ด ๋ชฉ๋ก

๋ช…๋ น์–ด ์„ค๋ช…
/chklink connect (๋˜๋Š” /chklink start) ์„ค์ •๋œ ์ฑ„๋„ ID๋กœ ์น˜์ง€์ง ์—ฐ๋™์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
/chklink disconnect (๋˜๋Š” /chklink stop) ์น˜์ง€์ง ์—ฐ๋™์„ ํ•ด์ œํ•ฉ๋‹ˆ๋‹ค.
/chklink status ํ˜„์žฌ ์„ค์ •๋œ ์ฑ„๋„ ID์™€ ์—ฐ๋™ ์ƒํƒœ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
/chklink testchat <๋ฉ”์‹œ์ง€> ๊ฐ€์ƒ ์ฑ„ํŒ…์„ ์ƒ์„ฑํ•˜์—ฌ ์Šคํ† ๋ฆฌ์ง€ ๋ฐ ๋ฐ์ดํ„ฐํŒฉ์œผ๋กœ ํ…Œ์ŠคํŠธ ์ „์†กํ•ฉ๋‹ˆ๋‹ค.
/chklink testdonation <๊ธˆ์•ก> <๋ฉ”์‹œ์ง€> ๊ฐ€์ƒ ํ›„์›(์น˜์ฆˆ)์„ ์ƒ์„ฑํ•˜์—ฌ ์Šคํ† ๋ฆฌ์ง€ ๋ฐ ๋ฐ์ดํ„ฐํŒฉ์œผ๋กœ ํ…Œ์ŠคํŠธ ์ „์†กํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ› ๏ธ ๋ฐ์ดํ„ฐํŒฉ ๊ฐ€์ด๋“œ

๋ชจ๋“œ๋Š” ์น˜์ง€์ง ์ด๋ฒคํŠธ๊ฐ€ ๋ฐœ์ƒํ•  ๋•Œ๋งˆ๋‹ค ์Šคํ† ๋ฆฌ์ง€์— ๋ฐ์ดํ„ฐ๋ฅผ ๋ณ‘ํ•ฉํ•œ ํ›„, ํ•ด๋‹นํ•˜๋Š” ํŽ‘์…˜ ํƒœ๊ทธ์— ๋“ฑ๋ก๋œ ํ•จ์ˆ˜๋“ค์„ ๋งคํฌ๋กœ์™€ ํ•จ๊ป˜ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
์ฒ˜์Œ ์ œ์ž‘ํ•˜์‹ ๋‹ค๋ฉด example_datapacks/chklink_sample ๊ตฌ์กฐ๋ฅผ ์ฐธ๊ณ ํ•˜์—ฌ ์ œ์ž‘ํ•ด ๋ณด์„ธ์š”!

๐Ÿ’ก ๋…๋ฆฝ ์‹คํ–‰ ์ง€์›: ๋ฐ”๋‹๋ผ์˜ function #ํƒœ๊ทธ์™€ ๋‹ฌ๋ฆฌ, ํƒœ๊ทธ์— ๋“ฑ๋ก๋œ ํŠน์ • ํŽ‘์…˜์—์„œ ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•˜๋”๋ผ๋„ ๋‹ค์Œ ํŽ‘์…˜์ด ์ค‘๋‹จ๋˜์ง€ ์•Š๊ณ  ์ •์ƒ์ ์œผ๋กœ ๋๊นŒ์ง€ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค.

1. ํŽ‘์…˜ ํƒœ๊ทธ ๋“ฑ๋กํ•˜๊ธฐ

๐Ÿ’ฌ ์ฑ„ํŒ… ํƒœ๊ทธ: data/chklink/tags/function/chat.json

{
  "values": [
    "chklink:example_chat",
    "chklink:example_chat2"
  ]
}

๐Ÿง€ ํ›„์› ํƒœ๊ทธ: data/chklink/tags/function/donation.json

{
  "values": [
    "chklink:example_donation",
    "chklink:example_donation2"
  ]
}

2. ์Šคํ† ๋ฆฌ์ง€ NBT ๊ตฌ์กฐ ๋ช…์„ธ

๐Ÿ’ฌ minecraft:chat ์Šคํ† ๋ฆฌ์ง€

{
  player_name: "ํ”Œ๋ ˆ์ด์–ด๋‹‰๋„ค์ž„", // ๋ฐฉ์†ก ์—ฐ๋™์„ ์ผ  ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ํ”Œ๋ ˆ์ด์–ด ์ด๋ฆ„
  player_uuid: "12345678-...", // ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ํ”Œ๋ ˆ์ด์–ด UUID
  cmd: "์„ค์น˜",                // !๋ช…๋ น์–ด ๋ช…์นญ (์˜ˆ: !์„ค์น˜ sand, 10, 20 -> "์„ค์น˜")
  chat: "sand, 10, 20",       // ๋ช…๋ น์–ด ์ œ์™ธ ์ „์ฒด ๋ณธ๋ฌธ
  
  // ์‰ผํ‘œ(,) ๊ตฌ๋ถ„ ์ธ์ž ํ•„๋“œ
  args: ["sand", "10", "20"], // ์ธ์ž ์ „์ฒด NBT ๋ฌธ์ž์—ด ๋ฆฌ์ŠคํŠธ
  arg0: "sand",               // 0๋ฒˆ์งธ ์ธ์ž
  arg1: "10",                 // 1๋ฒˆ์งธ ์ธ์ž
  arg2: "20",                 // 2๋ฒˆ์งธ ์ธ์ž
  arg3: "",                   // (์—†์œผ๋ฉด ๋นˆ ๋ฌธ์ž์—ด)
  arg4: "",
  arg5: "",
  arg_count: 3,               // ์ด ์ธ์ž ๊ฐœ์ˆ˜
  
  sender_nick: "์‹œ์ฒญ์ž๋‹‰๋„ค์ž„",  // ์น˜์ง€์ง ์‹œ์ฒญ์ž(๋ณด๋‚ธ ์‚ฌ๋žŒ) ๋‹‰๋„ค์ž„
  sender_id: "a1b2c3...",     // ์น˜์ง€์ง ์‹œ์ฒญ์ž ๊ณ ์œ  ID ํ•ด์‹œ๊ฐ’
  raw_msg: "!์„ค์น˜ sand, 10, 20",// ์›๋ณธ ์ „์ฒด ๋ฉ”์‹œ์ง€
  time: 1724123456789L        // ๋ฉ”์‹œ์ง€ ํƒ€์ž„์Šคํƒฌํ”„ (๋ฐ€๋ฆฌ์ดˆ)
}

๐Ÿง€ minecraft:donation ์Šคํ† ๋ฆฌ์ง€

{
  player_name: "ํ”Œ๋ ˆ์ด์–ด๋‹‰๋„ค์ž„", // ๋ฐฉ์†ก ์—ฐ๋™์„ ์ผ  ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ํ”Œ๋ ˆ์ด์–ด ์ด๋ฆ„
  player_uuid: "12345678-...", // ๋งˆ์ธํฌ๋ž˜ํ”„ํŠธ ํ”Œ๋ ˆ์ด์–ด UUID
  cmd: "๋ฏธ์…˜",                // !๋ช…๋ น์–ด ๋ช…์นญ
  chat: "๋‹ค์ด์•„, 10",         // ํ›„์› ๋ฉ”์‹œ์ง€ ๋‚ด์šฉ
  amount: 10000,              // ํ›„์› ๊ธˆ์•ก (์น˜์ฆˆ ๊ฐœ์ˆ˜ / ์›)
  
  // ์‰ผํ‘œ(,) ๊ตฌ๋ถ„ ์ธ์ž ํ•„๋“œ
  args: ["๋‹ค์ด์•„", "10"],
  arg0: "๋‹ค์ด์•„",
  arg1: "10",
  arg2: "",
  arg3: "",
  arg4: "",
  arg5: "",
  arg_count: 2,
  
  sender_nick: "ํ›„์›์ž๋‹‰๋„ค์ž„",  // ํ›„์›์ž ๋‹‰๋„ค์ž„
  sender_id: "a1b2c3...",     // ์น˜์ง€์ง ํ›„์›์ž ๊ณ ์œ  ID ํ•ด์‹œ๊ฐ’
  pay_type: "CHEESE",         // ๊ฒฐ์ œ ํƒ€์ž… (CHEESE ๋“ฑ)
  raw_msg: "!๋ฏธ์…˜ ๋‹ค์ด์•„, 10",
  time: 1724123456789L
}

3. ๋งคํฌ๋กœ ํŽ‘์…˜ ์ž‘์„ฑ ์˜ˆ์‹œ

๐Ÿ’ฌ ์ฑ„ํŒ… ์ถœ๋ ฅ ์˜ˆ์ œ: data/chklink/function/example_chat.mcfunction

$tellraw @a [{"text":"$(sender_nick)","color":"yellow"},{"text":": "},{"text":"$(cmd)","color":"aqua"},{"text":"$(chat)","color":"white"}]

๐Ÿ’ฌ ์ฑ„ํŒ… ์ธ์ž ๊ธฐ๋ฐ˜ ๋ช…๋ น์–ด ์˜ˆ์ œ: data/chklink/function/example_chat2.mcfunction

// ์‰ผํ‘œ(,) ๊ตฌ๋ถ„ ์ธ์ž๋ฅผ ํ™œ์šฉํ•œ ๋ธ”๋ก ์„ค์น˜ (!์„ค์น˜ sand, 10, 20)
$execute if data storage minecraft:chat {cmd:"์„ค์น˜"} as $(player_name) at @s run setblock ~$(arg1) ~ ~$(arg2) $(arg0)

// ํŠน์ • ๋‹จ์ผ ์ฑ„ํŒ… !๋ช…๋ น์–ด ๊ฐ์ง€ (!๋‹ค์ด์•„, !์ ํ”„)
$execute if data storage minecraft:chat {cmd:"๋‹ค์ด์•„"} run give $(player_name) diamond 1
$execute if data storage minecraft:chat {cmd:"์ ํ”„"} run effect give $(player_name) jump_boost 5 2

๐Ÿง€ ํ›„์› ์•Œ๋ฆผ ์˜ˆ์ œ: data/chklink/function/example_donation.mcfunction

$tellraw @a [{"text":"[ํ›„์›!] ","color":"green","bold":true},{"text":"$(player_name)๋‹˜ ๋ฐฉ์†ก์— ","color":"gray"},{"text":"$(sender_nick)","color":"yellow"},{"text":": ", "color":"yellow"},{"text":"$(cmd)","color":"aqua"},{"text":"$(chat)","color":"white"}," ",{"text":"$(amount)","color":"yellow"},{"text":"์›","color":"yellow"}]

๐Ÿง€ ํ›„์› ๋ช…๋ น์–ด ๊ฐ์ง€ ์˜ˆ์ œ: data/chklink/function/example_donation2.mcfunction

// ํ›„์› ๋ช…๋ น์–ด ๊ฐ์ง€ ๋ฐ ๊ธˆ์•ก ์กฐ๊ฑด (!์†Œํ™˜ + 10,000์› ํ›„์› ์‹œ ํฌ๋ฆฌํผ ์†Œํ™˜)
$execute if data storage minecraft:donation {cmd:"์†Œํ™˜", amount:10000} as $(player_name) at @s run summon creeper ~ ~ ~

๐Ÿค– ํฌ๋ ˆ๋”ง (Credits)

  • ๋ณธ ๋ชจ๋“œ๋Š” ๋„ค์ด๋ฒ„(NAVER)์˜ ๊ณต์‹ ์ œํ’ˆ์ด ์•„๋‹ˆ๋ฉฐ, AI ์ฝ”๋”ฉ ์–ด์‹œ์Šคํ„ดํŠธ์˜ ์ง€์›์„ ๋ฐ›์•„ ๊ฐœ๋ฐœ๋œ ์˜คํ”ˆ์†Œ์Šค ๋น„๊ณต์‹ ๋ชจ๋“œ์ž…๋‹ˆ๋‹ค.

๐Ÿ“„ ๋ผ์ด์„ ์Šค (License)

This project is licensed under the CC0 1.0 Universal (CC0-1.0) License.


๐ŸŒ English Documentation

โฌ†๏ธ Back to Top

๐Ÿง€ Overview

Chzzk Datapack Link is a Minecraft Fabric mod that bridges live stream chat and donation events from Chzzk (NAVER live streaming) directly into Minecraft NBT storage and datapacks in real time.

Streamers and map creators can easily implement interactive stream events (such as block spawning via chat, mob summons upon donation, viewer voting, etc.) simply by writing standard Minecraft datapack functions (.mcfunction) without writing any Java code.

โš ๏ธ Notice: This mod is an unofficial third-party open-source project and is not affiliated with NAVER. Developed with AI coding assistance.
๐Ÿ’ก Required: This is a Bridge mod that routes incoming Chzzk events to Minecraft storage (minecraft:chat, minecraft:donation). A datapack is required to receive and process these events!


โœจ Key Features

  • Datapack Integration: Automatically merges chat and donation payloads into storage and triggers #chklink:chat and #chklink:donation function tags with macro parameters.
  • Smart Command & Argument Parsing:
    • !์†Œํ™˜ ์ข€๋น„ 3 โž” cmd: "์†Œํ™˜", chat: "์ข€๋น„ 3"
    • !์†Œํ™˜, ์ข€๋น„, 3 โž” cmd: "์†Œํ™˜", arg0: "์ข€๋น„", arg1: "3", arg_count: 2
  • Fault-Tolerant Isolated Execution: Unlike vanilla function #tag, an error occurring in one registered tag function will not halt subsequent functions.
  • Multiplayer Support: Multiple players on a server can each independently connect to their own Chzzk channel ID.
  • In-Game GUI & Mod Menu: Easily configure and connect your Channel ID via F6 or through Mod Menu.
  • In-Game Testing Commands: Simulate chat and donation events using /chklink testchat and /chklink testdonation without needing an active live stream.

๐Ÿ“‹ Requirements


๐ŸŽฎ How to Use

1. Install a Datapack (Required)

2. Find Your Chzzk Channel ID

  • Copy the 32-character Channel ID from the streamer's Chzzk channel URL.
    (Example: https://chzzk.naver.com/live/0123456789abcdef0123456789abcdef โž” 0123456789abcdef0123456789abcdef)

3. Connect In-Game

  • In-game, press F6 (or open Mod Menu config) to bring up the configuration screen.
  • Paste your Channel ID, click [Save Channel ID], and then click [Start Connection].

๐Ÿ’ป In-Game Commands

Command Description
/chklink connect (or /chklink start) Starts Chzzk connection with the saved Channel ID.
/chklink disconnect (or /chklink stop) Disconnects from Chzzk.
/chklink status Displays the current connection status and saved Channel ID.
/chklink testchat <message> Simulates a chat message and sends it to storage and datapacks.
/chklink testdonation <amount> <message> Simulates a donation (cheese) and sends it to storage and datapacks.

๐Ÿ› ๏ธ Datapack Development Guide

When a Chzzk event occurs, the mod merges data into storage and executes all functions registered in the respective function tag along with macro variables.
Refer to example_datapacks/chklink_sample for an implementation reference.

๐Ÿ’ก Isolated Execution: Even if an error or exception occurs in a function registered in the tag, execution does not abort, allowing remaining functions to execute normally.

1. Register Function Tags

๐Ÿ’ฌ Chat Tag: data/chklink/tags/function/chat.json

{
  "values": [
    "chklink:example_chat",
    "chklink:example_chat2"
  ]
}

๐Ÿง€ Donation Tag: data/chklink/tags/function/donation.json

{
  "values": [
    "chklink:example_donation",
    "chklink:example_donation2"
  ]
}

2. Storage NBT Schema

๐Ÿ’ฌ minecraft:chat Storage

{
  player_name: "PlayerName",   // In-game name of the player who enabled connection
  player_uuid: "12345678-...", // Minecraft player UUID
  cmd: "์„ค์น˜",                // Command name without '!' (e.g. !์„ค์น˜ sand, 10, 20 -> "์„ค์น˜")
  chat: "sand, 10, 20",        // Full message content excluding the command
  
  // Comma-separated argument fields
  args: ["sand", "10", "20"],  // Full arguments string list
  arg0: "sand",                // 0th argument
  arg1: "10",                  // 1st argument
  arg2: "20",                  // 2nd argument
  arg3: "",                    // (empty string if missing)
  arg4: "",
  arg5: "",
  arg_count: 3,                // Total argument count
  
  sender_nick: "ViewerName",   // Chzzk viewer's nickname
  sender_id: "a1b2c3...",      // Chzzk viewer's unique ID hash
  raw_msg: "!์„ค์น˜ sand, 10, 20", // Original raw message
  time: 1724123456789L         // Timestamp (epoch milliseconds)
}

๐Ÿง€ minecraft:donation Storage

{
  player_name: "PlayerName",   // In-game name of the player who enabled connection
  player_uuid: "12345678-...", // Minecraft player UUID
  cmd: "๋ฏธ์…˜",                 // Command name without '!'
  chat: "๋‹ค์ด์•„, 10",          // Donation message content
  amount: 10000,               // Donation amount (Cheese count / KRW)
  
  // Comma-separated argument fields
  args: ["๋‹ค์ด์•„", "10"],
  arg0: "๋‹ค์ด์•„",
  arg1: "10",
  arg2: "",
  arg3: "",
  arg4: "",
  arg5: "",
  arg_count: 2,
  
  sender_nick: "DonorName",    // Donor's nickname
  sender_id: "a1b2c3...",      // Donor's unique ID hash
  pay_type: "CHEESE",          // Payment type (e.g. CHEESE)
  raw_msg: "!๋ฏธ์…˜ ๋‹ค์ด์•„, 10",
  time: 1724123456789L
}

3. Macro Function Examples

๐Ÿ’ฌ Print Chat to Chatbox: data/chklink/function/example_chat.mcfunction

$tellraw @a [{"text":"$(sender_nick)","color":"yellow"},{"text":": "},{"text":"$(cmd)","color":"aqua"},{"text":"$(chat)","color":"white"}]

๐Ÿ’ฌ Argument-Based Block Placement: data/chklink/function/example_chat2.mcfunction

// Place block using comma-separated arguments (!์„ค์น˜ sand, 10, 20)
$execute if data storage minecraft:chat {cmd:"์„ค์น˜"} as $(player_name) at @s run setblock ~$(arg1) ~ ~$(arg2) $(arg0)

// Detect single chat command (!diamond, !jump)
$execute if data storage minecraft:chat {cmd:"diamond"} run give $(player_name) diamond 1
$execute if data storage minecraft:chat {cmd:"jump"} run effect give $(player_name) jump_boost 5 2

๐Ÿง€ Donation Alert Notification: data/chklink/function/example_donation.mcfunction

$tellraw @a [{"text":"[Donation!] ","color":"green","bold":true},{"text":"To $(player_name): ","color":"gray"},{"text":"$(sender_nick)","color":"yellow"},{"text":": ", "color":"yellow"},{"text":"$(cmd)","color":"aqua"},{"text":"$(chat)","color":"white"}," ",{"text":"$(amount)","color":"yellow"},{"text":" Cheese","color":"yellow"}]

๐Ÿง€ Donation Command & Threshold: data/chklink/function/example_donation2.mcfunction

// Detect command & donation amount threshold (!์†Œํ™˜ with 10,000 Cheese summons a creeper)
$execute if data storage minecraft:donation {cmd:"์†Œํ™˜", amount:10000} as $(player_name) at @s run summon creeper ~ ~ ~

๐Ÿค– Credits & License

  • Credits: Unofficial open-source bridge mod developed with AI coding assistance. Not affiliated with NAVER.
  • License: Licensed under the CC0 1.0 Universal (CC0-1.0) License.
Version Minecraft Loader Download

chk datapack link 1.3.0

1.3.0

26.3
fabric
Download

chk datapack link 1.2.0

1.2.0

26.2
fabric
Download

chk datapack link 1.1.0

1.1.0

26.2
fabric
Download