first commit

This commit is contained in:
2025-11-04 13:49:10 +08:00
commit 8c468ec780
24 changed files with 1706 additions and 0 deletions

38
README.md Normal file
View File

@@ -0,0 +1,38 @@
# MCEF Android (ARM) Compatibility Patch
> **注意:这是一个修改版分支**
>
> 此仓库是原始 [CinemaMod/MCEF](https://github.com/CinemaMod/mcef) 项目的一个分支,专门为**安卓端(ARM架构)** 的 Minecraft Java 版提供基础兼容性支持。
## 项目概述
此分支对原始 MCEF 库进行了最小化修改,主要目标是让 MCEF 及相关模组(如 WebDisplays能够在安卓平台的 Minecraft Java 版中正常加载和运行,避免因架构不兼容而导致的崩溃问题。
### ⚠️ 重要限制
- **❌ 无浏览器功能**:由于 Chromium 无法在安卓环境运行,所有与浏览器相关的功能均被禁用
- **✅ 基础兼容性**:模组可以正常加载,不会因 MCEF 初始化失败而导致游戏崩溃
- **🎯 最小化修改**:仅修改必要的部分,保持与原始代码的最大兼容性
## 技术实现
### 修改内容
1. **架构检测绕过**:禁用了对安卓(ARM)架构的严格检测
2. **初始化流程优化**:在检测到安卓平台时跳过 Chromium 相关初始化
3. **异常处理增强**:提供更友好的错误处理和降级方案
### 兼容性状态
| 平台 | 状态 | 说明 |
|------|------|------|
| **Android (ARM)** | ✅ 可加载 | 模组正常加载,基础功能可用 |
| **Windows/Linux/macOS** | ⚠️ 可能受影响 | 需要进一步测试,建议使用官方版本 |
## 快速开始
### 环境要求
- Minecraft: 1.21.1
- NeoForge: 对应 1.21.1 的最新版本
- 安卓设备:支持 ARM 架构的安卓设备