# 配置文件优化指南

本文介绍了如何优化Python配置文件的内存使用。

# 1. 使用结构优化建筑生成

在建筑生成和放置方面，我们推荐使用结构文件而不是Python配置。

# 使用feature_rules控制建筑生成

参考教程：自定义特征

优点：

无需代码处理，无卡顿效果
采用微软原生机制，性能优异

缺点：

feature_rules文件中的molang表达式不宜过于复杂
复杂的表达式可能导致内存占用增加，影响游戏加载速度

# 通过API放置structure

参考API：PlaceStructure

优点：

提供灵活的代码控制能力
可实现复杂的生成规则

缺点：

放置时可能出现短暂卡顿

# 2. 使用方块调色板节约内存

方块调色板可用于保存建筑数据。使用GetBlockPaletteBetweenPos等接口获取方块调色板后，使用SerializeBlockPalette将调色板转化成字典后，手动存入配置文件中。

优点：

方块调色板是高度压缩的字典结构，可最大程度节约内存
对应的放置接口SetBlockByBlockPalette是原生c++批量放置，性能较好
可实现复杂的生成规则

缺点：

放置时可能出现短暂卡顿

# 3. 使用引用避免重复定义

在配置文件中，应避免重复定义相同的配置项，而是采用引用方式：

错误的写法

复制 python

# 存在大量重复的方块数据定义
building = {
    'build_A': {
        'size': [0, 1, 2],
        'blocks': [
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
            {'aux': 0, 'name': 'minecraft:air'}, 
        ],
    },
}

正确的写法

复制 python

# 定义基础方块数据
AirBlock = {'aux': 0, 'name': 'minecraft:air'}
GrassBlock = {'aux': 0, 'name': 'minecraft:grass'}
StoneBlock = {'aux': 0, 'name': 'minecraft:stone'}

# 通过引用复用方块数据
building = {
    'build_A': {
        'size': (0, 1, 2),
        'blocks': [
            AirBlock, AirBlock, StoneBlock, AirBlock, AirBlock, 
            GrassBlock, AirBlock, GrassBlock, AirBlock, AirBlock, StoneBlock,
        ],
    },
}

# 4. 使用元组替代字典

对于只读的配置数据，建议使用元组代替字典，以提高内存使用效率：

错误的写法

复制 python

# 定义基础方块数据
AirBlock = {'aux': 0, 'name': 'minecraft:air'}
GrassBlock = {'aux': 0, 'name': 'minecraft:grass'}
StoneBlock = {'aux': 0, 'name': 'minecraft:stone'}

正确的写法

复制 python

# 使用元组存储只读数据，提高内存效率
AirBlock = ('minecraft:air', 0)
GrassBlock = ('minecraft:grass', 0)
StoneBlock = ('minecraft:stone', 0)

# 5. 分割配置文件并动态加载

如果你的配置文件已经有几十M的大小，建议将配置文件按功能模块分割，采用动态加载方式：

错误的写法

复制 python

# 一次性导入所有配置
from build import build1, build2, build3

正确的写法

复制 python

def load_build_config(data):
    building = data['build']
    
    if build == '1':
        # 按需导入配置
        import build1
        place_build(data, build1)
    elif build == '2':
        # 按需导入配置
        import build2
        place_build(data, build)