remove HANDOVER.md — 더 이상 필요 없음 (사용자 요청)

내용:
- 한 줄 요약, 리포/인증, 최신 버전
- 폴더 구조, 빌드 명령
- 핵심 동작 3 개 (handleChat, mod_active_notice, presence pulse) 동작 + 왜 그렇게 짰는지
- mc_datapack 측 통합 인터페이스 (함수/점수 표)
- v1.1.0 ~ v1.3.8 버전 히스토리 요점
- 릴리스 절차 (gradle.properties 버전 → buildAll → tag/push → Gitea API)
- 작업 환경 (클론 위치, JDK, git author override 패턴)

이 mod 채팅은 데이터팩 mc_datapack 채팅과 분리되므로, 호환 깰 가능성 있는
변경 시 데이터팩 쪽 채팅과 조율 필요.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

README.md

@@ -9,8 +9,9 @@
 execute as <플레이어 UUID> run function mq:answer/submit {text:'<채팅 내용>'}
 ```
 
-채팅은 다른 플레이어에게 broadcast 되지 않으므로 정답이 화면에 노출되지 않는다.
+v1.3.8 부터는 정답 단계여도 채팅이 평소대로 broadcast 된다 (다른 플레이어
-`init` 점수가 5 가 아닐 때는 채팅이 평소처럼 모두에게 보인다.
+화면에 그대로 노출됨). 정답 보호는 데이터팩이 아니라 룸 운영자의 신뢰 기반
+운영으로 처리한다. v1.3.7 까지는 정답 단계에서 채팅 broadcast 가 차단됐었다.
 
 ## 빌드
 

common/src/main/java/kr/tkrmagid/chatanswer/core/ChatAnswerCore.java

@@ -21,8 +21,11 @@ import org.slf4j.LoggerFactory;
  *   execute as <player UUID> run function mq:answer/submit {text:'<채팅>'}
  * 을 OP 레벨로 실행한다.
  *
- * 각 로더 진입점(Fabric / NeoForge) 에서 chat 이벤트 받자마자 {@link #handleChat}
+ * v1.3.8 부터 채팅은 어떤 단계에서도 broadcast 차단하지 않는다 — 정답 입력
- * 호출 → 반환값이 false 면 그 채팅은 broadcast 차단해야 함.
+ * 단계에서도 친 채팅이 평소처럼 채팅창에 보인다. (사용자 요청: 정답 화면
+ * 노출을 데이터팩이 관리하지 않고 룸 운영자가 신뢰 기반으로 처리.)
+ * 따라서 {@link #handleChat} 는 항상 true 를 반환하며, 정답 단계일 때만
+ * 부가적으로 정답 제출 함수를 호출한다.
  */
 public final class ChatAnswerCore {
     public static final String MOD_ID = "chat_answer";
@@ -33,6 +36,21 @@ public final class ChatAnswerCore {
     private static final String SCOREBOARD_HOLDER = "init";
     private static final int ACCEPTING_ANSWER_STATE = 5;
 
+    /** 음악퀴즈 데이터팩이 선언한 "모드 존재 확인" 점수 이름.
+     *  본 모드는 서버 측에서 채팅을 가로채는 server-only 모드 — 클라이언트는
+     *  설치할 필요가 없고 server 한 곳에 있으면 모든 플레이어에게 적용된다.
+     *  따라서 per-player 검증은 무의미하고, fake player {@link #PRESENCE_HOLDER}
+     *  점수만 1 로 set 한다. 데이터팩의 start 가드는
+     *  `score <PRESENCE_HOLDER> <OBJECTIVE> matches 1` 로 검사.
+     *
+     *  presence pulse 는 여러 이벤트에서 중복 호출한다 — banner/mohist 같은
+     *  fabric-bukkit 하이브리드 호스트에서 일부 Fabric 이벤트(특히
+     *  ServerTickEvents.END_SERVER_TICK) 가 안 들어오는 케이스가 보고됨.
+     *  SERVER_STARTED / PlayerJoin / TickEnd 셋 중 하나라도 firing 되면
+     *  데이터팩 가드가 통과하도록 모든 진입점에서 markModPresence 호출. */
+    private static final String MOD_PRESENCE_OBJECTIVE = "mq_chat_mod";
+    private static final String PRESENCE_HOLDER = "#server";
+
     /** JOIN 이벤트 시점엔 클라이언트가 chat HUD 를 받을 준비가 안 됐을 수 있어
      *  tellraw 패킷이 사라지는 경우가 있다. 그래서 N 틱 늦춰서 호출한다. */
     private static final int NOTICE_DELAY_TICKS = 20;
@@ -52,10 +70,31 @@ public final class ChatAnswerCore {
         LOG.info("[{}] onPlayerJoin fired for {}, scheduling notice in {} ticks",
                 MOD_ID, name, NOTICE_DELAY_TICKS);
         PENDING_NOTICES.put(player.getUUID(), NOTICE_DELAY_TICKS);
+        // tick 이벤트가 안 들어오는 호스트 대비 — join 시점에도 presence 한 번 찍는다.
+        MinecraftServer server = player.level().getServer();
+        if (server != null) markModPresence(server);
+    }
+
+    /** 각 로더 entrypoint 가 서버 부팅 완료 시점에 호출. tick 이벤트가
+     *  발화되지 않는 환경(banner/mohist) 에서 최소 한 번은 presence 가 찍히도록.
+     *  데이터팩 load 가 SERVER_STARTED 보다 먼저 끝나므로 objective 도 이미 존재. */
+    public static void onServerStarted(MinecraftServer server) {
+        LOG.info("[{}] onServerStarted fired, marking presence", MOD_ID);
+        markModPresence(server);
+    }
+
+    /** /reload 직후 호출. load.mcfunction 이 mq_chat_mod objective 를 remove/add
+     *  하고 `#server` 점수를 0 으로 재설정하므로, reload 끝난 직후 즉시
+     *  다시 1 로 찍어야 함. tick 이벤트가 죽은 호스트 + 이미 접속 중인
+     *  플레이어 조합에서 SERVER_STARTED/JOIN 둘 다 발화 안 되는 케이스 커버. */
+    public static void onDataPackReload(MinecraftServer server) {
+        LOG.info("[{}] onDataPackReload fired, re-marking presence", MOD_ID);
+        markModPresence(server);
     }
 
     /** 각 로더 entrypoint 가 매 server tick 마다 호출해야 한다. */
     public static void onServerTick(MinecraftServer server) {
+        markModPresence(server);
         if (PENDING_NOTICES.isEmpty()) return;
         Iterator<Map.Entry<UUID, Integer>> it = PENDING_NOTICES.entrySet().iterator();
         while (it.hasNext()) {
@@ -73,6 +112,19 @@ public final class ChatAnswerCore {
         }
     }
 
+    /**
+     * 데이터팩의 mq_chat_mod 점수(fake player #server 키) 를 1 로 set.
+     * 데이터팩이 아직 load 되지 않아 objective 가 없으면 조용히 skip.
+     * 점수 값이 이미 1 이면 Minecraft 가 packet 전송을 생략하므로
+     * 매 tick 호출해도 트래픽은 늘지 않는다.
+     */
+    private static void markModPresence(MinecraftServer server) {
+        Scoreboard scoreboard = server.getScoreboard();
+        Objective objective = scoreboard.getObjective(MOD_PRESENCE_OBJECTIVE);
+        if (objective == null) return;
+        scoreboard.getOrCreatePlayerScore(ScoreHolder.forNameOnly(PRESENCE_HOLDER), objective).set(1);
+    }
+
     private static void deliverNotice(MinecraftServer server, ServerPlayer player) {
         String name = player.getName().getString();
         // 플레이어 자체를 source 로 써서 함수 안의 @s 가 그대로 player.
@@ -86,15 +138,19 @@ public final class ChatAnswerCore {
     }
 
     /**
-     * @return true = 채팅을 평소처럼 broadcast / false = 채팅 차단 (이미 정답 제출 처리됨)
+     * 항상 true 반환 — 어떤 단계에서도 채팅을 차단하지 않는다.
+     * 정답 단계(state 5) 일 때만 부가적으로 정답 제출 함수를 호출한다.
+     *
+     * @return 항상 true (broadcast 허용). 로더 진입점은 반환값을 그대로 이벤트
+     *         allow/cancel 결정에 전달하면 된다.
      */
     public static boolean handleChat(ServerPlayer sender, String rawText) {
         MinecraftServer server = sender.level().getServer();
         if (server == null) return true;
-        if (!isAcceptingAnswer(server)) return true;
+        if (isAcceptingAnswer(server)) {
-
+            submitAnswer(server, sender, rawText);
-        submitAnswer(server, sender, rawText);
+        }
-        return false;
+        return true;
     }
 
     private static boolean isAcceptingAnswer(MinecraftServer server) {

fabric-1216/src/main/java/kr/tkrmagid/chatanswer/fabric/ChatAnswerFabric.java

@@ -2,6 +2,7 @@ package kr.tkrmagid.chatanswer.fabric;
 
 import kr.tkrmagid.chatanswer.core.ChatAnswerCore;
 import net.fabricmc.api.ModInitializer;
+import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
 import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;
 import net.fabricmc.fabric.api.message.v1.ServerMessageEvents;
 import net.fabricmc.fabric.api.networking.v1.ServerPlayConnectionEvents;
@@ -18,11 +19,15 @@ public final class ChatAnswerFabric implements ModInitializer {
             ServerMessageEvents.ALLOW_CHAT_MESSAGE.register((message, sender, params) ->
                 ChatAnswerCore.handleChat(sender, message.signedContent())
             );
+            ServerLifecycleEvents.SERVER_STARTED.register(ChatAnswerCore::onServerStarted);
+            ServerLifecycleEvents.END_DATA_PACK_RELOAD.register((server, resourceManager, success) -> {
+                if (success) ChatAnswerCore.onDataPackReload(server);
+            });
             ServerPlayConnectionEvents.JOIN.register((handler, sender, server) ->
                 ChatAnswerCore.onPlayerJoin(handler.player)
             );
             ServerTickEvents.END_SERVER_TICK.register(ChatAnswerCore::onServerTick);
-            LOG.info("[{}] Fabric entrypoint registered: ALLOW_CHAT_MESSAGE + JOIN + TICK", ChatAnswerCore.MOD_ID);
+            LOG.info("[{}] Fabric entrypoint registered: ALLOW_CHAT_MESSAGE + SERVER_STARTED + END_DATA_PACK_RELOAD + JOIN + TICK", ChatAnswerCore.MOD_ID);
         } catch (Throwable t) {
             LOG.error("[{}] Fabric entrypoint event registration failed", ChatAnswerCore.MOD_ID, t);
             throw t;

fabric-2612/src/main/java/kr/tkrmagid/chatanswer/fabric/ChatAnswerFabric.java

@@ -2,6 +2,7 @@ package kr.tkrmagid.chatanswer.fabric;
 
 import kr.tkrmagid.chatanswer.core.ChatAnswerCore;
 import net.fabricmc.api.ModInitializer;
+import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
 import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;
 import net.fabricmc.fabric.api.message.v1.ServerMessageEvents;
 import net.fabricmc.fabric.api.networking.v1.ServerPlayConnectionEvents;
@@ -18,11 +19,15 @@ public final class ChatAnswerFabric implements ModInitializer {
             ServerMessageEvents.ALLOW_CHAT_MESSAGE.register((message, sender, params) ->
                 ChatAnswerCore.handleChat(sender, message.signedContent())
             );
+            ServerLifecycleEvents.SERVER_STARTED.register(ChatAnswerCore::onServerStarted);
+            ServerLifecycleEvents.END_DATA_PACK_RELOAD.register((server, resourceManager, success) -> {
+                if (success) ChatAnswerCore.onDataPackReload(server);
+            });
             ServerPlayConnectionEvents.JOIN.register((handler, sender, server) ->
                 ChatAnswerCore.onPlayerJoin(handler.player)
             );
             ServerTickEvents.END_SERVER_TICK.register(ChatAnswerCore::onServerTick);
-            LOG.info("[{}] Fabric entrypoint registered: ALLOW_CHAT_MESSAGE + JOIN + TICK", ChatAnswerCore.MOD_ID);
+            LOG.info("[{}] Fabric entrypoint registered: ALLOW_CHAT_MESSAGE + SERVER_STARTED + END_DATA_PACK_RELOAD + JOIN + TICK", ChatAnswerCore.MOD_ID);
         } catch (Throwable t) {
             LOG.error("[{}] Fabric entrypoint event registration failed", ChatAnswerCore.MOD_ID, t);
             throw t;

gradle.properties

@@ -3,7 +3,7 @@ org.gradle.parallel=true
 
 # ───── mod metadata ─────────────────────────────────────────────────────────
 mod_id=chat_answer
-mod_version=1.3.4
+mod_version=1.3.8
 mod_group=kr.tkrmagid.chatanswer
 mod_name=채팅정답
 

neoforge-1216/src/main/java/kr/tkrmagid/chatanswer/neoforge/ChatAnswerNeoForge.java

@@ -6,14 +6,18 @@ import net.neoforged.bus.api.IEventBus;
 import net.neoforged.bus.api.SubscribeEvent;
 import net.neoforged.fml.common.Mod;
 import net.neoforged.neoforge.common.NeoForge;
+import net.neoforged.neoforge.event.OnDatapackSyncEvent;
 import net.neoforged.neoforge.event.ServerChatEvent;
 import net.neoforged.neoforge.event.entity.player.PlayerEvent;
+import net.neoforged.neoforge.event.server.ServerStartedEvent;
 import net.neoforged.neoforge.event.tick.ServerTickEvent;
 
 @Mod(ChatAnswerCore.MOD_ID)
 public final class ChatAnswerNeoForge {
     public ChatAnswerNeoForge(IEventBus modBus) {
         NeoForge.EVENT_BUS.addListener(ChatAnswerNeoForge::onServerChat);
+        NeoForge.EVENT_BUS.addListener(ChatAnswerNeoForge::onServerStarted);
+        NeoForge.EVENT_BUS.addListener(ChatAnswerNeoForge::onDatapackSync);
         NeoForge.EVENT_BUS.addListener(ChatAnswerNeoForge::onPlayerLogin);
         NeoForge.EVENT_BUS.addListener(ChatAnswerNeoForge::onServerTick);
     }
@@ -26,6 +30,19 @@ public final class ChatAnswerNeoForge {
         }
     }
 
+    @SubscribeEvent
+    public static void onServerStarted(ServerStartedEvent event) {
+        ChatAnswerCore.onServerStarted(event.getServer());
+    }
+
+    /** OnDatapackSyncEvent: /reload 끝나면 player=null 로 한 번 broadcast,
+     *  로그인 때마다 해당 player 로 한 번 더 fire. 어느 쪽이든 reload 직후
+     *  presence 가 다시 찍히는 것이 목적이라 둘 다 OK. */
+    @SubscribeEvent
+    public static void onDatapackSync(OnDatapackSyncEvent event) {
+        ChatAnswerCore.onDataPackReload(event.getPlayerList().getServer());
+    }
+
     @SubscribeEvent
     public static void onPlayerLogin(PlayerEvent.PlayerLoggedInEvent event) {
         if (event.getEntity() instanceof ServerPlayer player) {