Mekupgradetuner

Mekanism Upgrade Tuner

Mekanism Upgrade Tuner is a small Forge addon for Minecraft 1.20.1 that gives you control over Mekanism's upgrade system. You can change how many upgrades a machine can hold, how much Speed Upgrades increase energy use, how much Energy Upgrades reduce it, and the minimum power a machine is allowed to draw. All settings can be edited in the config file or changed live with in-game commands.

REQUIREMENTS

• Minecraft 1.20.1
• Forge 47.4.10 or newer (47.x)
• Mekanism 10.4.x
• Java 17

FEATURES

• Configurable install caps for all seven Mekanism upgrade types: Speed, Energy, Gas, Muffling, Filter, Anchor, and Stone Generator.
• Three independent energy controls:
  • Speed Upgrades can be made completely free of energy cost (the 1.0.0 behavior; off by default).
  • The energy increase from Speed Upgrades can be capped (default: at most 10x).
  • The energy reduction from Energy Upgrades can be capped (default: at most 90% reduction, 0.1x).
• A final minimum consumption floor: machines cannot use less than a configurable percentage of their base energy (default 50%). Values above 100% can force a higher minimum.
• In-game commands for every setting, with tab completion and a help command.
• Changes apply to loaded machines immediately and are saved to the config file.
• Works in single-player and on LAN. On a dedicated server, commands require OP; client screens may show stale cap numbers, but installation and energy use are server-authoritative.

COMMANDS /mekupgradetuner help [key] /mekupgradetuner get /mekupgradetuner set <key> <value> /mekupgradetuner toggle <key>

Examples: /mekupgradetuner set speedMax 16 /mekupgradetuner set speedEnergyMultiplierCap 5.0 /mekupgradetuner set minimumConsumptionPercent 50.0 /mekupgradetuner toggle removeSpeedEnergyCost

CONFIGURATION The config file is generated at config/mekupgradetuner-common.toml. Upgrade caps: speedMax, energyMax, gasMax, mufflingMax, filterMax, anchorMax, stoneGeneratorMax. Energy: removeSpeedEnergyCost, limitSpeedEnergyIncrease, speedEnergyMultiplierCap, limitEnergyReduction, energyConsumptionFloor, limitMinimumConsumption, minimumConsumptionPercent.

INSTALLATION

1. Install Minecraft Forge 1.20.1 (47.4.10 or newer).
2. Install Mekanism 10.4.x.
3. Put the Mekanism Upgrade Tuner jar into the mods folder.
4. Launch the game. The config file is created on first launch.
5. Upgrading from 1.0.0: delete the old config so the new defaults apply. Upgrading from 1.1.0-1.3.0 usually keeps your settings; if the new keys are missing, delete the config to regenerate it.

IMPORTANT

• Lowering an install cap below the number of upgrades already installed, or removing this mod, can trim extra upgrades on the next world load. They are not refunded. Back up your world and remove extra upgrades first.
• High Speed caps on the six machines that perform multiple operations per tick (Chemical Infuser, Chemical Washer, Electrolytic Separator, Isotopic Centrifuge, Pigment Mixer, Rotary Condensentrator) can cause severe lag. Speed 12 is safer; 16 is risky.
• Do not use with MekanismTweaks, Mekanism Upgrade Caps, Upgrades: Reborn, or Mekanism Empowered/Unleashed. They mix into the same methods.
• This mod is not affiliated with the Mekanism team.

LICENSE AGPL-3.0-only. Source and issues: https://github.com/Lin1848624/Mekupgradetuner

====================================================================

通用机械：升级调校

这是一个 Minecraft 1.20.1 的 Forge 小模组，用来调整通用机械（Mekanism）的升级系统。你可以改：

• 每种升级最多能装几个；
• 加速升级会增加多少耗电；
• 能量升级能减少多少耗电；
• 机器最终耗电最低不能低于基础耗电的百分之几。 所有设置都能在配置文件里改，也能在游戏里用指令实时改。

适用版本

• Minecraft 1.20.1
• Forge 47.4.10 或更新的 47.x
• 通用机械 10.4.x
• Java 17

功能

• 7 种升级的安装上限都能改：加速、能量、气体、消音、过滤、区块加载、造石。
• 三个独立的耗电开关：
  • 加速升级可以完全不加耗电（1.0.0 的行为，默认关）；
  • 加速升级带来的耗电上涨可以封顶（默认最多 10 倍）；
  • 能量升级的省电效果可以封顶（默认最多省 90%，即 0.1 倍）。
• 最终最低耗电：机器最终耗电不能低于基础耗电的百分比（默认 50%）。填 100 以上可以把最低值抬到基础耗电之上。
• 所有设置都有游戏内指令，支持 Tab 补全和 help 帮助。
• 改完立即对已加载的机器生效，并写回配置文件。
• 单人和 LAN 可用。专用服务器需要 OP；客户端界面可能显示旧上限，但实际安装和耗电以服务器为准。

指令 /mekupgradetuner help [参数] /mekupgradetuner get /mekupgradetuner set <参数> <值> /mekupgradetuner toggle <开关>

例子： /mekupgradetuner set speedMax 16 /mekupgradetuner set speedEnergyMultiplierCap 5.0 /mekupgradetuner set minimumConsumptionPercent 50.0 /mekupgradetuner toggle removeSpeedEnergyCost

配置 配置文件在 config/mekupgradetuner-common.toml。 安装上限：speedMax、energyMax、gasMax、mufflingMax、filterMax、anchorMax、stoneGeneratorMax。 耗电：removeSpeedEnergyCost、limitSpeedEnergyIncrease、speedEnergyMultiplierCap、limitEnergyReduction、energyConsumptionFloor、limitMinimumConsumption、minimumConsumptionPercent。

安装

1. 安装 Minecraft Forge 1.20.1（47.4.10 或更新）。
2. 安装通用机械 10.4.x。
3. 把模组 jar 放进 mods 文件夹。
4. 启动游戏，第一次启动会生成配置文件。
5. 从 1.0.0 升级：删掉旧配置，让新默认值生效。从 1.1.0-1.3.0 升级一般不用删；如果看不到新配置项，就删掉配置让它重新生成。

注意

• 把上限调低到已经装了的数量以下，或卸载模组，重进世界会裁掉多出来的升级，且不退还。先备份存档，并把多余升级取出来。
• 加速上限装太高时，化学灌注机、化学洗涤机、电解分离机、同位素离心机、颜料混合机、旋转冷凝机可能严重卡顿。加速 12 比较安全，16 风险高。
• 不要和 MekanismTweaks、Mekanism Upgrade Caps、Upgrades: Reborn、Mekanism Empowered/Unleashed 同时装，它们改的是同一批方法。
• 本模组与通用机械官方团队无关。

许可证 AGPL-3.0-only。源码和问题反馈：https://github.com/Lin1848624/Mekupgradetuner