原创 付费 【NeoForge 26.1.2】汐语服务端- Java/基岩互通 Mod 服务端兼容方案 | 自动资源包 | 表单菜单 | JEI/Jade | AE2/背包/传送石碑 26.1.2

汐语服务端 是一套为 NeoForge 26.1.2 服务端打造的 Java/基岩互通 Mod 兼容方案。

它不是单纯的整合包，而是围绕 Geyser + Floodgate 做了一套服务端桥接、资源包生成、模型映射、表单交互和 Mod 功能适配，让基岩版玩家也能进入 Java Mod 服务端，并尽可能获得接近 Java 端的游玩体验。

本方案适合想运营 Java/基岩互通 Mod 服务器的服主使用，尤其适合希望让手机、Win10/Win11 基岩版玩家加入 Java Mod 服务器的场景。

### 核心功能

- 支持 NeoForge 26.1.2 服务端环境。
- 支持 Geyser + Floodgate 基岩互通。
- 自动扫描已安装 Java Mod 资源并生成基岩版资源包。
- 适配 Mod 物品名称、图标、方块贴图、方块模型和基础实体显示。
- 修复多类基岩端显示问题，例如物品只显示 ID、方块渲染错误、传送门方向错误、水浸状态错乱、发光方块异常等。
- 内置基岩版表单菜单，用于功能菜单、TPA、指南、查询和部分 Mod 交互。
- 提供仿 JEI 的指南/查询入口，方便基岩玩家查看物品和配方信息。
- 提供仿 Jade 的方块与实体信息显示。
- 支持可编辑侧边栏、Tab 与菜单配置。
- 支持服务端启动授权验证，便于付费版授权和服务器 IP 绑定管理。

### 已适配内容

#### 物品与方块

- Mod 物品中文名称适配。
- Mod 方块贴图、基础模型和自定义方块注册。
- 3D 物品、手持效果、装备属性与装备外显适配。
- 小型方块、压力板、植物、不规则方块、透明方块、发光方块、传送门等渲染优化。
- 修复部分原版/Mod 方块映射错误，例如荧石、石英、传送门、下界相关方块等显示异常。

#### GUI 与交互

- 基岩版表单菜单。
- TPA 功能。
- 可编辑侧边栏。
- 可编辑 Tab。
- 仿 JEI 指南功能。
- 仿 Jade 实时信息显示。
- Sophisticated Backpacks 背包页面、翻页与格子保护。
- Waystones 传送石碑交互入口。
- AE2 终端与相关交互入口。
- AnvilCraft 指南与部分机器交互适配。

#### 实体与生物

- 自定义 Bedrock 实体注册。
- Mod 生物、投射物、载具、方块实体类显示适配。
- 针对 Aether II、TofuCraft、AnvilCraft、BetterEnd、Ecologics 等 Mod 增加实体映射。
- 支持基础实体模型、动画和 Bedrock 可见回退。

#### 资源包生成

- 自动生成基岩版资源包。
- 自动生成 item_texture、terrain_texture、blocks.json、模型文件、实体文件和语言文件。
- 支持资源包版本递增，减少客户端缓存旧包导致的显示异常。
- 资源包由服务端生成并交给 Geyser 分发。

### 当前主要包含/适配 Mod

- Aether II
- Applied Energistics 2
- AnvilCraft
- Sophisticated Backpacks
- Waystones
- Jade
- JEI
- BetterEnd
- TofuCraft
- YUNG's 系列结构
- Ecologics
- Incendium
- GeckoLib
- Balm
- TerraBlender
- Floodgate
- Geyser NeoForge
- 以及其他结构、辅助与兼容类 Mod

### 版本要求

- Minecraft Java：26.1.2
- NeoForge：26.1.2.76 或兼容版本（服务端使用定制版本）
- Geyser：NeoForge 端
- Floodgate：NeoForge 端
- 基岩版：26.30

### 适合谁使用

- 想开 Java/基岩互通 Mod 服的服主。
- 想让手机基岩玩家进入 Java Mod 服的运营者。
- 想要现成服务端、互通配置、资源包生成和基础适配方案的用户。
- 需要付费授权、IP 绑定和后端管理能力的商业服或工作室。

### 授权与购买说明

本资源提供 NeoForge 付费授权版。服务端启动时会连接授权后端验证服务器 IP，验证通过后才会继续启动。

授权版支持：

- 服务器 IP 绑定。
- 每次开服自动验证。
- 后台用户管理。
- 激活码/邀请码。
- 用户封禁。
- 更新日志。
- Mod 上传与版本管理。

Fabric 版可作为免费版发布或体验版使用；NeoForge 版为登录后解锁/授权使用版本。

购买、授权、定制适配请联系：

QQ：3550945507

版权归深圳市南山区汐语互联网销售商行所有。

### 安装方式

1. 准备 NeoForge 26.1.2.76 服务端。
2. 安装 Geyser NeoForge 与 Floodgate NeoForge。
3. 将 Xiyu Geyser Mod Bridge 放入服务端 mods 目录。
4. 将配套 Geyser 扩展放入 Geyser-NeoForge/extensions 目录。
5. 按说明配置授权 IP、Geyser 端口、Floodgate 和服务端端口。
6. 启动服务端，等待资源包自动生成。
7. 基岩版玩家加入服务器并下载资源包。

### 常见问题

Q：基岩版可以完整运行 Java Mod 吗？

A：基岩版不能原生加载 Java Mod。本项目通过服务端逻辑、Geyser 扩展、资源包转换、表单菜单和模型映射尽量还原体验。复杂客户端 GUI、动态模型和纯客户端渲染仍可能需要专项适配。

Q：新加 Mod 后怎么办？

A：重启服务端，让资源转换器重新扫描已安装 Mod 并生成资源包。新增 Mod 如果使用复杂客户端渲染，可能还需要定制适配。

Q：为什么基岩端有时还是显示旧模型？

A：通常是客户端缓存旧资源包。可清理基岩版缓存后重新进入服务器下载资源包。

Q：是否支持商业服？

A：支持授权版用于商业服，但请遵守第三方 Mod 的许可证，不要将第三方 Mod 声称为自研内容。

### 合规说明

本资源的自研部分为 Xiyu Geyser Mod Bridge、Geyser 适配扩展、资源转换与服务端兼容逻辑。服务端中包含的第三方 Mod 版权归各自作者所有。发布或出售整合包前，请确认相关 Mod 的许可证允许打包分发或商业使用；如许可证不允许，建议只出售自研桥接程序、部署服务、适配服务和授权服务，并为第三方 Mod 提供官方下载来源。

### 更新日志

#### 1.0.0

- 初版发布。
- 支持 NeoForge 26.1.2。
- 支持 Geyser + Floodgate 基岩互通。
- 增加 Mod 资源自动转换。
- 增加物品、方块、实体、GUI、表单菜单、JEI/Jade 风格功能适配。
- 修复多类基岩端模型、贴图、传送门、含水状态和方块映射问题。