54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
# 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 可用，其它外围与兼容性问题会逐步修复与完善。 |