# WebDisplays（NeoForge 1.21.1 适配版）

本仓库来源于原始项目并在本地克隆后进行适配与修复：
- 上游仓库：`https://github.com/CinemaMod/webdisplays.git`
- 本分支目标：适配 Minecraft 1.21.1（NeoForge）并在可用范围内修复关键问题
- 大量代码改动由多位 AI 大模型辅助完成（自动化迁移、代码生成、问题定位与修复）

## 当前状态
- 完成基础功能适配（屏幕方块、模型加载、基础网络消息、MinePad 使用流程等）
- 修复 MinePad 初次使用时 URL 为空导致的崩溃（自定义负载编码 NPE）
- 调整屏幕模型贴图加载逻辑（通过 `assets/webdisplays/atlases/blocks.json` 注册 `screen0..screen15` 贴图）
- 默认主页为 `https://git.lnkos.cn`（`CommonConfig.Browser.homepage`）
- 已验证可构建并产出 JAR（Windows，JDK 21，NeoGradle）

## 已知问题（进行中）
- 外置键盘（左/右部件）在某些朝向或交互下存在异常
- 屏幕边框/部分贴图在某些资源包或拼图场景下异常（已加入图集声明，但仍需进一步兼容性验证）
- 代码中存在一定数量的弃用/迁移警告（不影响构建，后续逐步清理）

## 构建环境与依赖
- JDK：`21`
- 构建：`Gradle Wrapper`（已内置）
- Mod 平台：`NeoForge 1.21.1`
- 建议依赖：`MCEF (com.cinemamod:mcef-neoforge)` 对应 1.21.1 版本

## 本地构建
在仓库根目录执行：
- Windows：`./gradlew.bat build -x test`
- 其他平台：`./gradlew build -x test`
构建成功后，JAR 位于 `build/libs/`。

## 安装与试用
- 将生成的 `webdisplays-*.jar` 放入 `mods/`
- 确保安装对应版本的 `NeoForge` 与 `MCEF`
- 启动 1.21.1 客户端，创建世界，放置屏幕方块进行验证

## 主要改动摘要
- 屏幕自定义模型：`ScreenModelLoader`/`ScreenBaker`
  - 通过 `atlases/blocks.json` 将 `screen0..screen15` 注册至方块图集
  - 自定义烘焙模型以实现屏幕边框/连接效果
- 网络与数据修复：
  - MinePad URL 为空值编码导致崩溃修复（`C2SMessageMinepadUrl` 编码前对 `null` 处理）
  - GUI 初始化对 `null` URL 防御式赋值，避免界面 NPE

## 贡献与致谢
- 原始项目与创意来源归上游仓库及其作者所有
- 本地适配工作由多位 AI 大模型参与完成，辅助完成迁移、修复与文档编写
- 欢迎提交 Issue/PR，共同完善 1.21.1 的适配与修复

## 许可证
- 许可证遵循上游仓库约定（详见本仓库 `LICENSE`）

---
说明：本项目仍在持续迭代阶段，优先确保基础功能在 1.21.1 可用，其它外围与兼容性问题会逐步修复与完善。