處罰紀錄Punishment records

/punishments 彙整封鎖、IP 封鎖、臨時封鎖、踢出、警告、禁言與監禁，並附上統計（總數、受罰人數、目前生效中）。

紀錄永久保留，解封或到期的項目仍會列出，只是狀態改為已解除／已到期，適合做公開的處罰查詢頁。

punishment-log:
  retention-days: 90        # 0 或負數 = 永久保存

資料從哪來

定期與封鎖名單及 CMI 對帳，而不是攔截指令，因此不論處罰是用什麼方式下的都會被記錄。

Minecraft 與 CMI 都不保存踢出歷史，那部分由本插件監聽事件自行記錄，因此只涵蓋插件啟用之後發生的踢出，過去的無法追溯。

警告、禁言、監禁需要安裝 CMI。未安裝時這三類不會出現。

/punishments merges bans, IP bans, tempbans, kicks, warnings, mutes and jails, with statistics (total, players punished, currently active).

Records are kept permanently — lifted or expired entries stay listed with their status changed, which suits a public punishment lookup page.

punishment-log:
  retention-days: 90        # 0 or negative = keep forever

Where the data comes from

Periodic reconciliation against the ban list and CMI rather than intercepting commands, so punishments are recorded no matter what issued them.

Neither Minecraft nor CMI stores kick history, so this plugin listens for the events itself. That means only kicks after it was enabled are covered; earlier ones cannot be recovered.

Warnings, mutes and jails require CMI. Without it those three types simply do not appear.