GTOEX

基本信息

• 模组名称: GTOEX
• 版本号: 1.3.2-1.20.1
• 适用游戏版本: Minecraft 1.20.1
• 适用 Forge 版本: 47.4.13+
• 开发者: LIN
• 许可证: MIT
• 模组ID: gtoex
• 依赖模组: Applied Energistics 2 (AE2) 15.4.9+

功能描述

GTOEX 是一个为 Applied Energistics 2 (AE2) 模组扩展的存储单元模组，主要提供了两种特殊的存储单元，以及世界数据管理功能，用于减少无意义的重复劳动环节：

1. 吞噬万籁之寂静磁盘

   • 核心功能: 能够无限存储物品或流体，但不具备无限取出功能
   • 存储特点: 显示真实存储数值，容量上限为30位小数的"bigger level"存储
   • 使用场景: 适合需要大量存储但不需要频繁取出的场景，如资源备份、长期存储
   • 操作特性: 存储物品或流体时显示真实数量，取出时按实际数量扣除

2. 好东西磁盘

   • 核心功能: 支持四种工作模式，能够智能地将物品或流体标记为无限
   • 工作模式:
     • 1: 真无限模式 - 所有物品和流体都视为无限资源
     • 2: 输入无限模式 - 物品/流体一旦被输入立即变为无限
     • 3: 阈值无限模式 - 物品/流体达到预设阈值时自动变为无限
     • 4: 好东西无限模式 - 仅内置定义的"好东西"物品/流体视为无限(未完成)
   • 智能特性: 具有智能的无限状态判断机制，支持实时状态切换
   • 删除模式: 支持通过Shift+右键点击切换删除模式，删除模式下禁用存入功能

3. 世界数据管理系统

   • 核心功能: 提供世界数据验证、修复和强制保存功能
   • 命令系统: 新增 /gtoex worldfix 系列命令，用于管理世界数据
   • 备份功能: 优化的备份系统，支持后台执行和资源调度
   • 数据安全性: 多层次的保存机制，确保世界数据安全

安装说明

1. 确保已安装 Minecraft 1.20.1 版本
2. 安装 Forge 47.4.13+ 版本
3. 安装 Applied Energistics 2 (AE2) 15.4.9+ 版本
4. 将 GTOEX-1.3.2-1.20.1.jar 文件放入游戏目录下的 mods 文件夹
5. 启动游戏，配置文件将自动生成在 config 文件夹下

配置文件说明

配置文件位于游戏目录下的 config/gtoexconfig.toml，主要配置项包括：

1. 好东西盘运行模式

   • 参数名称: goodStuff.mode
   • 数据类型: 整数
   • 取值范围: 1-4
   • 默认值: 3（阈值无限模式）
   • 功能描述: 设置好东西磁盘的运行模式
   • 模式说明:
     • 1: 真无限模式 - 所有物品和流体都视为无限资源
     • 2: 输入无限模式 - 物品/流体一旦被输入立即变为无限
     • 3: 阈值无限模式 - 物品/流体达到预设阈值时变为无限
     • 4: 好东西无限模式 - 仅内置定义的"好东西"物品/流体视为无限

2. 物品阈值

   • 参数名称: goodStuff.itemThreshold
   • 数据类型: 长整数
   • 取值范围: 1-9223372036854775807
   • 默认值: 100000
   • 功能描述: 设置物品达到无限状态的阈值
   • 说明: 流体阈值自动设置为物品阈值的1000倍
   • 适用模式: 仅在阈值无限模式下生效

3. 流体阈值（已弃用）

   • 参数名称: goodStuff.fluidThreshold
   • 数据类型: 长整数
   • 取值范围: 1-9223372036854775807
   • 默认值: 100000
   • 功能描述: 流体阈值（已弃用）
   • 说明: 此设置已弃用，流体阈值自动为物品阈值的1000倍
   • 适用模式: 仅在阈值无限模式下生效

4. 无限状态最大值

   • 参数名称: goodStuff.infiniteValue
   • 数据类型: 字符串（表示大整数）
   • 取值范围: 有效的 BigInteger 字符串
   • 默认值: "100000000000000000000000000000"（10^30）
   • 功能描述: 设置无限状态下显示的最大值
   • 使用注意事项:
     • 必须是有效的 BigInteger 字符串，只能包含数字
     • 过大的值可能导致显示问题
     • 无效值会自动使用默认值

5. 命令系统总开关

   • 参数名称: commands.enabled
   • 数据类型: 布尔值
   • 取值范围: true/false
   • 默认值: true
   • 功能描述: 控制是否启用所有 GTOEX 命令

6. /gtoex setup 命令配置

   • 参数名称: commands.setup.enabled
   • 数据类型: 布尔值
   • 取值范围: true/false
   • 默认值: true
   • 功能描述: 控制是否启用 /gtoex setup 命令

7. /gtoex setup 命令权限等级

   • 参数名称: commands.setup.permissionLevel
   • 数据类型: 整数
   • 取值范围: 0-2
   • 默认值: 1
   • 功能描述: 使用 /gtoex setup 命令所需的权限等级
   • 权限说明:
     • 0: 所有玩家都可以使用
     • 1: 游戏管理员可以使用
     • 2: 服务器管理员可以使用

8. /gtoex setup 命令冷却时间

   • 参数名称: commands.setup.cooldown
   • 数据类型: 整数
   • 取值范围: 0-3600
   • 默认值: 30
   • 功能描述: /gtoex setup 命令的冷却时间（秒）

9. /gtoex setup 命令最大距离

   • 参数名称: commands.setup.maxDistance
   • 数据类型: 整数
   • 取值范围: 1-100
   • 默认值: 5
   • 功能描述: /gtoex setup 命令允许的最大使用距离（方块）

10. /gtoex setup 命令支持生存模式

    • 参数名称: commands.setup.allowSurvival
    • 数据类型: 布尔值
    • 取值范围: true/false
    • 默认值: true
    • 功能描述: 是否允许在生存模式下使用 /gtoex setup 命令

11. 吞噬盘配置

    • 参数名称: voraciousDisk.dropChance
    • 数据类型: 浮点数
    • 取值范围: 0.0-100.0
    • 默认值: 1.0
    • 功能描述: 调整村民掉落吞噬盘的概率（%）

使用指南

1. 吞噬万籁之寂静磁盘

   • 获取方式: 通过击杀村民随机掉落（默认掉落概率1.0%）
   • 使用方法: 放入AE2存储系统中使用
   • 功能特性:
     • 能够无限存储物品或流体
     • 显示真实存储数值
     • 取出时按实际数量扣除，不支持无限取出
     • 容量上限为30位小数的"bigger level"存储
   • 适用场景: 适合需要大量存储但不需要频繁取出的场景，如资源备份、长期存储

2. 好东西磁盘

   • 获取方式: 通过合成或管理员指令获得
   • 使用方法: 放入AE2存储系统中使用
   • 模式切换: 通过修改配置文件中的 goodStuff.mode 参数调整运行模式
   • 阈值无限模式:
     • 物品达到100000时自动变为无限
     • 流体达到100000000时自动变为无限（物品阈值的1000倍）
     • 达到阈值后显示无限符号，允许无限取出
     • 未达到阈值时显示真实数值，取出时按实际数量扣除
   • 删除模式:
     • 通过Shift+右键点击切换删除模式
     • 删除模式下禁用存入功能
     • 适合清理不需要的物品
   • 好东西无限模式:
     • 仅内置定义的"好东西"物品/流体视为无限
     • 其他物品/流体按实际数量存储和取出

3. 命令使用

   /gtoex setup

   • 功能: 自动设置AE2网络组件
   • 权限等级: 1（游戏管理员）
   • 冷却时间: 30秒
   • 最大距离: 5方块
   • 支持生存模式: 是
   • 使用方法: 站在要设置AE2网络的位置，输入 /gtoex setup 命令

   /gtoex add

   • 功能: 将副手物品或流体容器内的流体添加到好东西盘，并标记为无限属性
   • 权限等级: 1（游戏管理员）
   • 使用条件: 主手持好东西盘，副手持物品或流体容器
   • 操作流程:
     • 主手持好东西盘
     • 副手持物品或装有流体的容器
     • 输入 /gtoex add 命令
     • 流体容器会保留，只提取其中的流体
     • 为添加的物品/流体标记"无限"属性
   • 专属添加特性:
     • 指令添加的无限物品在删除模式中实际数量为1
     • 指令添加的无限流体在删除模式中实际数量为1000
     • AE系统表面显示为"无限"

   /gtoex delete

   • 功能: 移除好东西盘中物品或流体的专属添加属性
   • 权限等级: 1（游戏管理员）
   • 使用条件: 主手持好东西盘，副手持物品或流体容器
   • 操作流程:
     • 主手持好东西盘
     • 副手持物品或装有流体的容器
     • 输入 /gtoex delete 命令
     • 流体容器会保留，只操作其中的流体

   /gtoex worldfix

   • 功能: 执行完整的世界修复操作，包括验证、修复和保存
   • 权限等级: 2（服务器管理员）
   • 使用方法: 输入 /gtoex worldfix 命令
   • 执行流程:
     • 验证世界数据完整性
     • 尝试修复损坏的区块
     • 强制保存世界数据

   /gtoex worldfix validate

   • 功能: 仅验证世界数据完整性，不执行修复操作
   • 权限等级: 2（服务器管理员）
   • 使用方法: 输入 /gtoex worldfix validate 命令

   /gtoex worldfix save

   • 功能: 仅执行强制世界保存操作
   • 权限等级: 2（服务器管理员）
   • 使用方法: 输入 /gtoex worldfix save 命令

   /gtoex fix world

   • 功能: 与 /gtoex worldfix 相同，为兼容旧命令路径
   • 权限等级: 2（服务器管理员）

4. 配置管理

   • 配置文件: config/gtoexconfig.toml
   • 配置界面: 在游戏内模组列表中找到GTOEX，点击"配置"按钮
   • 保存配置: 修改配置后点击"保存配置"按钮
   • 加载配置: 点击"加载保持的配置"按钮加载已保存的配置

Basic Information

• Module Name: GTOEX
• Version number: 1.3.2-1.20.1
• Applicable game version: Minecraft 1.20.1
• Applicable Forge version: 47.4.13+
• Developer: LIN

Functional Description

GTOEX is a storage unit module extended for the Applied Energistics 2 (AE2) module, primarily providing two special storage units and world data management functionality to reduce meaningless repetitive tasks:

1. The Silence Devouring Disk

   • Core function: Capable of storing items or fluids indefinitely, but does not have the capability to retrieve them indefinitely
   • Storage characteristics: Displays the actual stored value, with a capacity limit of "bigger level" storage for up to 30 decimal places
   • Usage scenario: Suitable for scenarios requiring large amounts of storage but not frequent retrieval, such as resource backup and long-term storage
   • Operational characteristics: When storing items or fluids, the actual quantity is displayed; when removing them, the quantity is deducted based on the actual quantity

2. Good stuff disk

   • Core function: Supports four working modes and intelligently marks items or fluids as infinite
   • Operating mode:
     • 1: True Infinite Mode - All items and fluids are treated as infinite resources
     • 2: Input Unlimited Mode - Once an item/fluid is inputted, it becomes unlimited immediately
     • 3: Threshold Unlimited Mode - When an item/fluid reaches a preset threshold, it automatically becomes unlimited
     • 4: Good Stuff Unlimited Mode - Only items/fluids defined as "good stuff" are considered unlimited (not yet completed)
   • Smart features: Equipped with an intelligent infinite state judgment mechanism, supporting real-time state switching
   • Deletion mode: Support switching to deletion mode by pressing Shift + right-clicking. The save function is disabled in deletion mode

3. World Data Management System

   • Core functions: Provides world data verification, repair, and mandatory saving functions
   • Command system: Added the /gtoex worldfix series of commands for managing world data
   • Backup function: An optimized backup system that supports background execution and resource scheduling
   • Data security: Multi-layered storage mechanisms ensure the security of global data

Installation Instructions

1. Ensure that the Minecraft version 1.20.1 has been installed
2. Install Forge version 47.4.13+
3. Install Applied Energistics 2 (AE2) version 15.4.10+
4. Place the GTOEX-1.3.2-1.20.1.jar file into the mods folder located in the game directory
5. Launch the game, and the configuration file will be automatically generated in the config folder

Configuration file description

The configuration file is located in config/gtoexconfig.toml under the game directory. The main configuration items include:

1. Good thing disk operation mode

   • Parameter Name: goodStuff.mode
   • Data type: Integer
   • Range of values: 1-4
   • Default value: 3 (threshold unlimited mode)
   • Function description: Set the operation mode of the good stuff disk
   • Mode description:
     • 1: True Infinite Mode - All items and fluids are treated as infinite resources
     • 2: Input Unlimited Mode - Once an item/fluid is inputted, it becomes unlimited immediately
     • 3: Threshold Unlimited Mode - When an item/fluid reaches a preset threshold, it becomes unlimited
     • 4: Good Stuff Unlimited Mode - Only items/fluids defined as "good stuff" are considered infinite

2. Item threshold

   • Parameter name: goodStuff.itemThreshold
   • Data type: Long integer
   • Value range: 1-9223372036854775807
   • Default value: 100000
   • Function description: Set the threshold for items to reach an infinite state
   • Description: The fluid threshold is automatically set to be 1000 times the item threshold
   • Applicable mode: Only valid in threshold-unlimited mode

3. Fluid threshold (Deprecated)

   • Parameter name: goodStuff.fluidThreshold
   • Data type: Long integer
   • Range of values: 1-9223372036854775807
   • Default value: 100000
   • Function description: Fluid threshold (Deprecated)
   • Description: This setting has been deprecated, and the fluid threshold is automatically set to 1000 times the item threshold
   • Applicable mode: Only valid in threshold-unlimited mode

4. Maximum value in infinite state

   • Parameter name: goodStuff.infiniteValue
   • Data type: String (representing large integers)
   • Value range: Valid BigInteger string
   • Default value: "100000000000000000000000000000" (10^30)
   • Function description: Set the maximum value displayed in the infinite state
   • Precautions for use:
     • It must be a valid BigInteger string, containing only numbers
     • An excessively large value may cause display issues
     • Invalid values will automatically be replaced with default values

5. Master switch of command system

   • Parameter name: commands.enabled
   • Data type: Boolean
   • Value range: true/false
   • Default value: true
   • Function description: Controls whether all GTOEX commands are enabled

6. Configure with the /gtoex setup command

   • Parameter Name: commands.setup.enabled
   • Data type: Boolean
   • Value range: true/false
   • Default value: true
   • Function description: Controls whether the /gtoex setup command is enabled

7. /gtoex setup command permission level

   • Parameter Name: commands.setup.permissionLevel
   • Data type: Integer
   • Value range: 0-2
   • Default value: 1
   • Function description: The permission level required to use the /gtoex setup command
   • Permission description:
     • 0: Available to all players
     • 1: Can be used by game administrators
     • 2: Can be used by server administrators

8. Cooldown time for the /gtoex setup command

   • Parameter Name: commands.setup.cooldown
   • Data type: Integer
   • Range of values: 0-3600
   • Default value: 30
   • Function description: Cooldown time (in seconds) for the /gtoex setup command

9. Maximum distance for the /gtoex setup command

   • Parameter name: commands.setup.maxDistance
   • Data type: Integer
   • Value range: 1-100
   • Default value: 5
   • Function description: Maximum usage distance (in blocks) allowed for the /gtoex setup command

10. The /gtoex setup command supports survival mode

    • Parameter name: commands.setup.allowSurvival
    • Data type: Boolean
    • Value range: true/false
    • Default value: true
    • Function description: Whether to allow the use of the /gtoex setup command in survival mode

11. Devour Disc Configuration

    • Parameter Name: voraciousDisk.dropChance
    • Data type: Floating point number
    • Value range: 0.0-100.0
    • Default value: 1.0
    • Function description: Adjust the probability (%) of villagers dropping the Devouring Disc

User Guide

1. The Silence Devouring Disk

   • Acquisition method: Drops randomly by killing villagers (default drop probability 1.0%)
   • Usage: Place it in the AE2 storage system for use
   • Functional features:
     • Capable of storing items or fluids indefinitely
     • Display the actual stored value
     • Deductions will be made based on the actual quantity withdrawn, and unlimited withdrawals are not supported
     • "Bigger level" storage with a capacity limit of 30 decimal places
   • Applicable scenarios: Suitable for scenarios that require large amounts of storage but do not require frequent retrieval, such as resource backup and long-term storage

2. Good stuff disk

   • Acquisition method: Obtained through synthesis or administrator command
   • Usage: Place it in the AE2 storage system for use
   • Mode switching: Adjust the operation mode by modifying the goodStuff.mode parameter in the configuration file
   • Threshold unlimited mode:
     • When the item reaches 100,000, it automatically becomes unlimited
     • The fluid automatically becomes infinite when it reaches 100,000,000 (1000 times the item threshold)
     • Display an infinity symbol when the threshold is reached, allowing unlimited retrieval
     • Display the actual value when it does not reach the threshold, and deduct it by the actual quantity when it is taken out
   • Delete mode:
     • Switch to delete mode by pressing Shift and right-clicking
     • Disable the deposit function in delete mode
     • Suitable for cleaning up unwanted items
   • Good Stuff Unlimited Mode:
     • Only the "good stuff" items/fluids defined internally are considered infinite
     • Other items/fluids are stored and retrieved based on actual quantity

3. Command usage

   /gtoex setup

   • Function: Automatically configure AE2 network components
   • Permission level: 1 (game administrator)
   • Cooling time: 30 seconds
   • Maximum distance: 5 blocks
   • Support survival mode: Yes
   • Usage: Stand at the location where the AE2 network is to be set up and enter the command /gtoex setup

   /gtoex add

   • Function: Adds fluids from a secondary item or fluid container to the Good Stuff tray and marks them as having an infinite attribute
   • Permission level: 1 (game administrator)
   • Usage conditions: The primary hand holds a good plate, while the secondary hand holds an item or a fluid container
   • Operational process:
     • The main character holds a good thing in their hand
     • Items held by the deputy or containers containing fluids
     • Enter the command /gtoex add
     • The fluid container will be retained, and only the fluid inside will be extracted
     • Mark the added item/fluid with the "infinite" attribute
   • Exclusive added features: The actual quantity of the infinitely added items in the deletion mode is 1
     • The actual quantity of the infinite fluid added by the command is 1000 in delete mode The AE system surface displays "Infinity"

   /gtoex delete

   • Function: Remove the exclusive addition attribute of items or fluids in the "Good Things" tray
   • Permission level: 1 (game administrator)
   • Usage conditions: The primary hand holds a good plate, while the secondary hand holds an item or a fluid container
   • Operation process: "- The main character holds a good thing in their hand"
     • Auxiliary handheld items or containers filled with fluid
     • Enter the command /gtoex delete
     • The fluid container will be retained, and only the fluid inside will be operated on

   /gtoex worldfix

   • Function: Perform a complete world repair operation, including verification, repair, and saving
   • Permission level: 2 (Server administrator)
   • Usage: Enter the command /gtoex worldfix
   • Execution process:
     • Verify the integrity of global data
     • Attempt to repair damaged blocks
     • Forcefully save world data

   /gtoex worldfix validate

   • Function: Only verifies the integrity of world data, without performing repair operations
   • Permission level: 2 (Server Administrator)
   • Usage: Enter the command /gtoex worldfix validate

   /gtoex worldfix save

   • Function: Perform only the forced world save operation
   • Permission level: 2 (Server administrator)
   • Usage: Enter the command /gtoex worldfix save

   /gtoex fix world

   • Function: Same as /gtoex worldfix, for compatibility with old command paths
   • Permission level: 2 (Server administrator)

4. Configuration management

   • Configuration file: config/gtoexconfig.toml Configuration Interface: Find GTOEX in the in-game mod list and click the "Configuration" button
   • Save Configuration: Click the "Save Configuration" button after modifying the configuration
   • Load configuration: Click the "Load saved configuration" button to load the saved configuration