Skip to content

Configuration_CN

Jump to bottom
MIAOKATZE edited this page Jul 12, 2026 · 1 revision

配置文件

1. 配置文件清单

GTSWN 共有 3 个配置文件，位于 config/gtswn/ 目录：

文件名 用途
gtswn.cfg 基础配置（MTE ID 偏移）
gtswn_network.cfg 网络配置（损耗 + HUD）
gtswn_ae.cfg AE2 配置（采样、监控项、走势图）

2. gtswn.cfg

**类目：**无（顶层配置）

键 类型 / 默认值 范围 说明
metaIdOffset int = 0 [-5000, 5000] MTE ID 偏移

**说明：**MTE ID 基准为 14600（MetaTileEntityID.BASE），偏移用于避免与其他模组 ID 冲突。当与其他模组 ID 冲突时，调整此偏移即可。

3. gtswn_network.cfg

类目 1：general

键 类型 / 默认值 范围 说明
DownlinkLossEU float = 0.15 [0.0, 10.0] 下行损耗（电网 → 机器），默认 15%
UplinkLossEU float = 0.0 [0.0, 1.0] 上行损耗（机器 → 电网），默认 0%

类目 2：hud

键 类型 / 默认值 范围 说明
HudXOffset int = 0 [-500, 500] HUD X 偏移
HudYOffset int = 0 [-500, 500] HUD Y 偏移
HudScale float = 1.0 [0.2, 5.0] HUD 缩放

说明

  • **下行损耗：**覆盖板从电网取电时额外扣除的比例（电网多扣）
  • **上行损耗：**覆盖板向电网送电时扣除的比例（电网少得）
  • **损耗不对称设计：**下行有损耗，上行默认无损耗
  • **HUD 偏移：**X 正 = 右，Y 正 = 上（反转屏幕坐标）
  • HUD 位置公式：
    • X = screenWidth / 2 + 91 + hudXOffset
    • Y = screenHeight - 54 - hudYOffset

4. gtswn_ae.cfg

**类目：**ae2

键 类型 / 默认值 范围 说明
aeSampleInterval int = 100 [1, 6000] AE 采样间隔（ticks）
aeMaxMonitoredItems int = 64 [1, 256] AE 实时监控最大项数
aeMaxSamplePoints int = 61 [10, 120] AE 走势图最大采样点数
aeChartEnabled boolean = true — AE 走势图功能开关

说明

  • **aeSampleInterval：**AE 数据采样间隔，默认 100t（5 秒），与 EU 采样同步
  • **aeMaxMonitoredItems：**AE 实时监控列表最大项数，超出无法添加
  • **aeMaxSamplePoints：**AE 走势图每个时间窗口的最大点数，受内部 FIFO 容量 61 限制
  • **aeChartEnabled：**关闭后网络信息屏不显示 AE 标签页

5. 配置文件示例

gtswn.cfg

# GTSWN 基础配置
# MTE ID 基准为 14600（MetaTileEntityID.BASE），偏移用于避免与其他模组 ID 冲突
# 范围: [-5000, 5000]
I:metaIdOffset=0

gtswn_network.cfg

# GTSWN 网络配置

general {
    # 下行损耗（电网 → 机器），电网多扣
    # 范围: [0.0, 10.0]
    F:DownlinkLossEU=0.15

    # 上行损耗（机器 → 电网），电网少得
    # 范围: [0.0, 1.0]
    F:UplinkLossEU=0.0
}

hud {
    # HUD X 偏移（正 = 右）
    # 范围: [-500, 500]
    I:HudXOffset=0

    # HUD Y 偏移（正 = 上，反转屏幕坐标）
    # 范围: [-500, 500]
    I:HudYOffset=0

    # HUD 缩放
    # 范围: [0.2, 5.0]
    F:HudScale=1.0
}

gtswn_ae.cfg

# GTSWN AE2 配置

ae2 {
    # AE 采样间隔（ticks），默认 100t（5 秒），与 EU 采样同步
    # 范围: [1, 6000]
    I:aeSampleInterval=100

    # AE 实时监控列表最大项数
    # 范围: [1, 256]
    I:aeMaxMonitoredItems=64

    # AE 走势图每个时间窗口的最大采样点数（受内部 FIFO 容量 61 限制）
    # 范围: [10, 120]
    I:aeMaxSamplePoints=61

    # AE 走势图功能开关（关闭后网络信息屏不显示 AE 标签页）
    B:aeChartEnabled=true
}

6. 热重载说明

  • 当前未监听配置热重载
  • **读取时机：**配置在 preInit 阶段读取一次
  • **损耗系数（DownlinkLossEU / UplinkLossEU）：**运行时实时读取（每次覆盖板操作）
  • **HUD 参数（偏移 / 缩放）：**HUD 渲染时实时读取
  • **生效方式：**修改配置后需重启游戏生效（除损耗与 HUD 参数外）

**说明：**损耗系数与 HUD 参数在每次使用时直接读取配置文件，因此修改后无需重启即可生效；而 MTE ID 偏移、AE 采样间隔等参数在启动时初始化，必须重启游戏才能生效。

Clone this wiki locally