Changed AI Boss

# Changed: MC AI Boss Dialogue

An experimental AI-powered dialogue mod for **Changed: MC** (by LtxProgrammer,
inspired by DragonSnow's Changed) on Forge 1.20.1.

This mod connects Changed: MC's signature entities — **Experiment 009**,
**Experiment 010**, and **Void Fox** — to a Large Language Model, letting
them speak dynamic, context-aware lines in battle. It also enables
"inner-persona" dialogue when the player themselves has transfurred into
one of these forms.

> ⚠️ Early Beta — EXPECT BUGS. This is a solo passion project.

---

## What it does

- **Event-driven combat dialogue**: bosses speak on battle start, phase
  change, ranged attack, fire damage, being petted, transfur, death, and
  more.
- **30-second improvisation loop**: bosses keep talking throughout the
  fight, not just on scripted events.
- **Inner-persona dialogue**: when the player transfurs into Exp9 / Exp10 /
  Void Fox, the captive consciousness inside the player's own body will
  respond to chat — a completely separate persona from the external boss.
- **Context-aware prompts**: the AI sees the player's health, equipped
  item, nearby entities, surrounding blocks, time of day, and dimension —
  then decides how the boss speaks.
- **Anti-spam system**: in-flight request lock, global 3-second minimum
  interval between any two lines, separate 9-15s cooldown for event
  triggers and 30s for improvisation.
- **Minecraft § color/style codes enforced**: Exp9 → bold + aqua,
  Exp10 → bold + dark red, Void Fox → italic + dark gray.
- **Persona design**: bosses are written as brutal, oppressive predators —
  not tsundere. The word "小家伙" (and similar endearing terms) is banned at
  both the prompt level and the client-side filter level.

## LLM Providers

The mod uses an **OpenAI-compatible** API protocol. Any provider that
exposes an OpenAI-style `/chat/completions` endpoint works out of the box,
including but not limited to:

- Zhipu AI (智谱 GLM) — default
- DeepSeek
- Alibaba Qwen (通义千问)
- Moonshot (Kimi)
- ByteDance Doubao (豆包)
- Tencent Hunyuan (腾讯混元)
- Baidu Qianfan (百度千帆)
- OpenAI (GPT)
- xAI Grok
- Groq
- Anthropic Claude * (planned native protocol)
- Google Gemini * (planned native protocol)

Configure your provider, API key, endpoint, and model in the in-game config
screen (open with the **B** key).

## In-Game Configuration

Press **B** to open the config screen:

- **Provider**: switch among 12+ preset providers; endpoint & model auto-fill
- **API Key / Endpoint / Model**: manual override
- **Language**: en / zh-CN / zh-TW / fr / ru / ar / es — controls both the
  config UI language AND the language the AI speaks in battle
- **Profanity level**: none / mild / moderate / strong — truly enforced in
  the system prompt

All settings are saved to `config/changedai.json`.

## Requirements

- Minecraft 1.20.1
- Forge 47.4.x
- Changed: MC (by LtxProgrammer)
- An API key from any supported LLM provider

This mod is **client-side only** — no server installation needed.

> 💡 Note: You must bring your own API key. The mod makes live HTTP calls to
> your chosen provider; no local LLM is bundled.

---

## Known Issues

- Dialogue timing may still feel inconsistent.
- Multi-player battle edge cases are not fully tested (client-side mod).
- AI response quality depends entirely on your chosen model and network
  latency.
- Only Forge 1.20.1 is supported right now. A Fabric port is possible after
  the Forge version stabilizes.

## Planned for future versions

- Native Claude & Gemini protocol adapters (currently routed via
  OpenAI-compat workaround)
- Per-boss configuration: dialogue style, profanity, language overrides
- Local LLM support via Ollama / LM Studio endpoints
- Richer environmental awareness (weather, structure names, etc.)
- Possibly: a server-side companion for synchronized multi-player dialogue

---

## Credits

- **LtxProgrammer** — creator of *Changed: MC* (the required base mod)
- **Foxyas** — core contributor to the Changed: MC source tree, and the
  brilliant mind behind *Changed Addon Plus* and *Changed additions*,
  which brought **Experiment 009, Experiment 010, and Void Fox** to life.
  This mod literally could not exist without the entities Foxyas created.
- **DragonSnow** — for the original *Changed* universe that started it all
- **Tencent Yuanbao (元宝)** — the AI coding partner that turned a
  Java-zero-background hobbyist's game design ideas into a working Forge mod
- All LLM providers offering OpenAI-compatible APIs

## A note from the author — LiCrZr

Honest disclosure: **I have zero background in Java.** Every line of code
in this mod was written with **Tencent Yuanbao (元宝) AI**, based entirely
on my own game-design logic and feature ideas. I designed the BattleDirector
system, the event triggers, the anti-spam rules, the inner-persona mechanic,
and the brutal-predator personas. Yuanbao translated my thoughts into working
Forge code.

So:
- The *game design and logic* are mine.
- The *implementation* is a collaboration between me and Yuanbao.
- The *bugs* are ours too. Please be patient. :)

Huge thanks to **Foxyas** — without your Experiment 009, Experiment 010, and
Void Fox, this mod would have no one to talk. You built the souls; I just
gave them a voice.

If you're a Java dev who wants to help, PRs are very welcome. If you're a
player who just wants Changed: MC bosses to feel alive — welcome aboard.

—— LiCrZr 奉上

My E-mail Address: [email protected]
Wechat: IAA_EE

---

中文：

# Changed: MC AI Boss Dialogue

一个为 Changed: MC（LtxProgrammer 作品，灵感源自 DragonSnow 的 Changed）
在 Forge 1.20.1 上打造的 **AI 驱动对话模组**。

本模组将 Changed: MC 的标志性实体——**实验体 009**、**实验体 010** 和
**虚空狐**——接入大语言模型，让它们在战斗中说出动态、有上下文的台词。
当玩家自身兽化为这些形态时，还会触发"体内人格"对话——一个完全独立的
人格设定。

> ⚠️ 早期 Beta 版本——可能有 Bug。单人激情项目。

---

## 功能特性

- **事件驱动战斗台词**：战斗开始、阶段变化、远程攻击、火焰伤害、被抚摸、
  转化、死亡等时刻，Boss 都会发声
- **30 秒即兴循环**：Boss 在战斗中持续说话，而不只是响应脚本事件
- **体内人格对话**：玩家兽化为 Exp9 / Exp10 / Void Fox 后，体内被困的
  意识会回应聊天——与外部 Boss 完全不同的人格
- **上下文感知**：AI 能看到玩家血量、手持物品、附近生物、周围方块、
  昼夜、维度，然后决定 Boss 怎么说
- **反刷屏系统**：在途请求锁、全局 3 秒最小间隔、事件触发 9-15 秒冷却、
  即兴 30 秒冷却
- **Minecraft § 颜色代码强制**：Exp9 → 粗体+青色，Exp10 → 粗体+深红，
  Void Fox → 斜体+深灰
- **人设设计**：Boss 被写成残暴、压迫的掠食者——不是傲娇。提示词层面和
  客户端过滤层面双重禁用"小家伙"等亲昵称呼

## 支持的 LLM 供应商

模组使用 **OpenAI 兼容** API 协议，任何暴露 OpenAI 风格 `/chat/completions`
端点的供应商开箱即用，包括但不限于：

- 智谱 GLM（默认）、DeepSeek、通义千问、Kimi、豆包、腾讯混元、
  百度千帆、OpenAI、xAI Grok、Groq
- Anthropic Claude 与 Google Gemini（原生协议规划中）

按 **B 键**打开游戏内配置界面，选择供应商、填入 API Key、端点与模型。

## 游戏内配置

按 **B 键**打开配置界面：

- **供应商**：在 12+ 预设供应商间切换，端点与模型自动填充
- **API Key / 端点 / 模型**：手动覆盖
- **语言**：en / zh-CN / zh-TW / fr / ru / ar / es——同时控制配置界面
  语言与 AI 战斗台词语言
- **脏话强度**：禁用 / 轻度 / 中度 / 强烈——真正写入 system prompt 生效

所有设置保存在 `config/changedai.json`。

## 运行需求

- Minecraft 1.20.1
- Forge 47.4.x
- Changed: MC（by LtxProgrammer）
- 任一受支持 LLM 供应商的 API Key

本模组**纯客户端**，无需在服务端安装。

> 💡 你需要自备 API Key。模组会向所选供应商发起实时 HTTP 请求，
> 不捆绑本地 LLM。

---

## 已知问题

- 台词节奏可能仍不够稳定
- 多人战斗边界情况未充分测试（客户端模组）
- AI 回复质量完全取决于所选模型与网络延迟
- 目前仅支持 Forge 1.20.1。Forge 版本稳定后可能移植 Fabric

## 未来规划

- Claude 与 Gemini 原生协议适配器（目前通过 OpenAI 兼容绕行）
- 每 Boss 独立配置：台词风格、脏话强度、语言覆盖
- 通过 Ollama / LM Studio 端点支持本地 LLM
- 更丰富的环境感知（天气、结构名等）
- 可能：服务端配套模组以实现多人同步对话

---

## 致谢

- **LtxProgrammer** —— *Changed: MC*（必需基础模组）的作者
- **Foxyas** —— Changed: MC 源码树的核心贡献者，也是 *Changed Addon Plus*
  和 *Changed additions* 的缔造者。**实验体 009、实验体 010、虚空狐**
  正是出自他的作品。本模组没有 Foxyas 创造的这些实体，根本不会存在
- **DragonSnow** —— 最初 *Changed* 宇宙的创造者，一切灵感的源头
- **腾讯元宝** —— 将一名 Java 零基础爱好者的游戏设计想法，转化为可运行的
  Forge 模组的 AI 编程伙伴
- 所有提供 OpenAI 兼容 API 的大语言模型供应商

## 作者碎碎念 —— LiCrZr

老实说：**我 Java 零基础**。这个模组里的每一行代码，都是在**腾讯元宝 AI**
的帮助下，基于我自己的游戏设计逻辑和功能想法写出来的。BattleDirector 系统、
事件触发器、反刷屏规则、体内人格机制、凶悍掠食者人设——这些*设计*都是我的；
元宝把我的想法翻译成了可运行的 Forge 代码。

所以：
- *游戏设计与逻辑*是我的
- *实现*是我和元宝协作的结果
- *Bug*也是我们俩的，请多包涵 :)

特别感谢 **Foxyas**——没有你的实验体 009、实验体 010 和虚空狐，这个模组
就无人可语。你创造了灵魂，我只是给了它们声音。

如果你是 Java 开发者想帮忙，PR 非常欢迎。如果你只是个想让 Changed: MC 的
Boss 活过来的玩家——欢迎上车。

—— LiCrZr 奉上

我的邮箱：[email protected]
QQ号：2967561184
微信号：IAA_EE

提示：
1，这里不送山姆烤鸡，也不送晨光橡皮，更不送“亚一狙”Dank1ng。你是Jee也没有用。
2，像素方块的硬核才是王道。
3，我刚刚把可乐洒在了地板上。
4，可口比百事好喝，毋庸置疑。
5，你能看到这里你也挺厉害。
6，我还想写，可惜我已经点了Sav...