Singularity Iteration

# 更新日志 v0.1.6.1

**发布日期**: 2026-07-27

---

## ✨ 新增内容

### API 系统

- **新增完整的 API 系统**，支持附属模组开发

  - `MioIcifAPI` - 主 API 入口，提供单例访问

  - `IEnergyNetAPI` - 能源网络 API，查询电网状态、节点统计

  - `IEnergyTileAccess` - 能源方块访问接口

  - `IFluidAPI` - 流体系统 API，获取所有模组流体

  - `IRecipeRegistrationAPI` - 配方注册 API，向机器添加自定义配方

  - `IBlockAPI` - 方块系统 API

  - `IGeneratorAPI` - 发电机系统 API

- **新增事件系统**

  - `EnergyGenerationEvent` - 能量生成事件，可修改/取消发电量

  - `EnergyTransferEvent` - 能量传输事件，可修改/取消传输

  - `GeneratorStartEvent` - 发电机启动事件

  - `GeneratorStopEvent` - 发电机停止事件

- **新增 API 文档** (`API_DOCUMENTATION.md`)，详细说明如何使用 API 开发附属模组

### 流体系统

- 为所有流体添加 `fluid_type.xxx` 本地化键

  - 支持中文和英文显示

  - 修复流体名称显示问题

---

## 🔧 修复

### 代码优化

- 整理 `com.singularity_iteration.mio_icif.api` 包下所有代码

  - 修复中文注释乱码问题

  - 添加完整的 JavaDoc 文档

  - 统一代码格式和缩进

  - 优化方法分组和代码结构

### GUI 文件

- 修复多个 GUI 文件中的未使用变量警告

  - `mio_icif_gui_scanner_elc.java`

  - `mio_icif_gui_transformer.java`

  - `mio_icif_gui_sorter_elc.java`

  - `mio_icif_gui_stirling_generator.java`

  - `mio_icif_gui_water_generator.java`

  - `mio_icif_gui_wind_generator.java`

  - `mio_icif_gui_armor_features.java`

### Menu 文件

- 移除未使用的导入和变量

  - `QuantumGeneratorMenu.java`

  - `SteamKineticGeneratorMenu.java`

  - `IndustrialWorkbenchMenu.java`

### 作物系统

- 移除 `PlantStickreed.java` 中未使用的导入

### 服务端兼容性

- **修复重大 Bug**: `JetpackKeyHandler` 在服务端崩溃问题

  - 问题原因: 类中引用了客户端专有类 `KeyMapping`，在服务端加载时导致 `RuntimeException`

  - 触发场景: 玩家穿戴喷气背包胸甲登录时，`inventoryTick` 调用引发类加载失败

  - 解决方案: 将 `JetpackKeyHandler` 拆分为服务端和客户端两部分

    - `JetpackKeyHandler` - 仅包含服务端安全代码，存储按键状态

    - `JetpackKeyHandlerClient` - 客户端专用，处理按键检测和网络发送

  - 现在喷气背包可以在服务端正常运行

---

## ⚖️ 调整

### 代码质量

- 为所有 API 接口方法添加完整的中文 JavaDoc 注释

- 优化 API 实现类的代码结构，添加分节注释

- 提取版本号和模组 ID 为常量

- 统一事件类的代码风格

---

**总结**: 本次更新主要完善了 API 系统，为附属模组开发提供了完整的接口支持。同时修复了大量代码警告和关键的服务端兼容性问题，提升了代码质量和可维护性。

---

# Changelog v0.1.6.1

**Release Date**: 2026-07-27

---

## ✨ New Content

### API System

- **Added complete API system** for addon mod development

  - `MioIcifAPI` - Main API entry point with singleton access

  - `IEnergyNetAPI` - Energy network API for querying grid status and node statistics

  - `IEnergyTileAccess` - Energy tile access interface

  - `IFluidAPI` - Fluid system API to access all mod fluids

  - `IRecipeRegistrationAPI` - Recipe registration API for adding custom recipes to machines

  - `IBlockAPI` - Block system API

  - `IGeneratorAPI` - Generator system API

- **Added Event System**

  - `EnergyGenerationEvent` - Energy generation event, modifiable/cancellable

  - `EnergyTransferEvent` - Energy transfer event, modifiable/cancellable

  - `GeneratorStartEvent` - Generator start event

  - `GeneratorStopEvent` - Generator stop event

- **Added API Documentation** (`API_DOCUMENTATION.md`) with detailed guide for developing addon mods

### Fluid System

- Added `fluid_type.xxx` localization keys for all fluids

  - Support for Chinese and English display

  - Fixed fluid name display issues

---

## 🔧 Fixes

### Code Optimization

- Organized all code in `com.singularity_iteration.mio_icif.api` package

  - Fixed Chinese comment encoding issues

  - Added complete JavaDoc documentation

  - Unified code formatting and indentation

  - Optimized method grouping and code structure

### GUI Files

- Fixed unused variable warnings in multiple GUI files

  - `mio_icif_gui_scanner_elc.java`

  - `mio_icif_gui_transformer.java`

  - `mio_icif_gui_sorter_elc.java`

  - `mio_icif_gui_stirling_generator.java`

  - `mio_icif_gui_water_generator.java`

  - `mio_icif_gui_wind_generator.java`

  - `mio_icif_gui_armor_features.java`

### Menu Files

- Removed unused imports and variables

  - `QuantumGeneratorMenu.java`

  - `SteamKineticGeneratorMenu.java`

  - `IndustrialWorkbenchMenu.java`

### Crop System

- Removed unused imports in `PlantStickreed.java`

### Server Compatibility

- **Fixed Critical Bug**: `JetpackKeyHandler` server crash issue

  - Root cause: Class referenced client-only class `KeyMapping`, causing `RuntimeException` on server

  - Trigger scenario: Player wearing jetpack chestplate logs in, `inventoryTick` triggers class loading failure

  - Solution: Split `JetpackKeyHandler` into server and client parts

    - `JetpackKeyHandler` - Contains only server-safe code, stores key states

    - `JetpackKeyHandlerClient` - Client-only, handles key detection and network sending

  - Jetpack now works correctly on dedicated servers

---

## ⚖️ Tweaks

### Code Quality

- Added complete Chinese JavaDoc comments to all API interface methods

- Optimized API implementation class structure with section comments

- Extracted version number and mod ID as constants

- Unified event class code style

---

**Summary**: This update mainly improves the API system, providing complete interface support for addon mod development. Also fixed numerous code warnings and critical server compatibility issues, improving code quality and maintainability.