Excel2Bytes(v0.1.0)

Excel2Bytes仓库

py写的游戏开发用的导表工具。目前支持C#脚本。

原理

该工具的原理是将表格数据转换为二进制数据，并生成对应的bytes文件。同时，它还会生成可供访问的C#脚本，使得在游戏中可以通过C#按照二进制字节的方式读取所需的数据。

这个工具的优势在于它可以提高游戏的加载速度和性能。通过将表格数据转换为二进制格式，可以减少文件大小和加载时间。同时，使用C#脚本读取二进制数据可以更高效地访问和处理数据。

该工具目前正在开发中，预计会提供更多功能和优化。敬请期待！

工具配置

首次运行会在当前目录的Config文件夹下生成一个Config.json配置文件，这个文件里面是导表工具的配置。
这里的配置后续开发将支持QT面板进行修改，不用修改文件。

示例

{
    "IsUpdateAllLNG": true,
    "TablePath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Table",
    "BytesPath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Bytes",
    "ScriptsPath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Scripts",
    "CorePath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Core",
    "LNGBytesPath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Bytes",
    "ResRefFileListPath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\reslist.json",
    "LanguageXlsxPath": "F:\\MyPrograme\\Excel2Bytes\\Excel2Bytes\\Save\\Table\\Languages.xlsx",
    "CNLanguage": "cn",
    "TableLanguageCSName": "Languages",
    "BytesExportPath": "",
    "ScriptsExportPath": "",
    "CoreExportPath": "",
    "TableRootNamespace": "LBRuntime",
    "TableResLoadAssembly": "LBUnity",
    "ResLoadScripts": "ResManager.OpenFile(\"{0}\")",
    "LanguageKey": [
        "tw",
        "en"
    ],
    "SupportExcelFormats": [
        ".xlsx",
        ".csv"
    ],
    "TableSheetInfo": {
        "ScriptsName": "",
        "ImportType": "NoneType",
        "ExtraNamespace": ""
    }
}

表格类型

首次运行会在当前目录的Config文件夹下生成一个TableConfig.json配置文件，这个文件里面是导表工具的配置。

示例

{
    "Global.xlsx": {
        "Global": {
            "ScriptsName": "TableGlobal",
            "ImportType": "CustomTypeField",
            "ExtraNamespace": ""
        }
    },
    "Languages.xlsx": {
        "cn": {
            "ScriptsName": "TableLanguagescn",
            "ImportType": "LNGType",
            "ExtraNamespace": ""
        },
        "tw": {
            "ScriptsName": "TableLanguagestw",
            "ImportType": "LNGType",
            "ExtraNamespace": ""
        },
        "en": {
            "ScriptsName": "TableLanguagesen",
            "ImportType": "LNGType",
            "ExtraNamespace": ""
        }
    },
    "LanguagesUI.xlsx": {
        "UI": {
            "ScriptsName": "TableLanguagesUIUI",
            "ImportType": "NoExportLNGType",
            "ExtraNamespace": ""
        }
    },
    "Level.xlsx": {
        "Level": {
            "ScriptsName": "TableLevel",
            "ImportType": "FindType",
            "ExtraNamespace": ""
        },
        "Chase": {
            "ScriptsName": "TableLevelChase",
            "ImportType": "FindType",
            "ExtraNamespace": ""
        }
    },
    "ResName.xlsx": {
        "ResName": {
            "ScriptsName": "TableResName",
            "ImportType": "FieldType",
            "ExtraNamespace": ""
        },
        "ArrayResName": {
            "ScriptsName": "TableResNameArrayResName",
            "ImportType": "FieldType",
            "ExtraNamespace": ""
        }
    },
    "Text.xlsx": {
        "System": {
            "ScriptsName": "TableTextSystem",
            "ImportType": "FieldType",
            "ExtraNamespace": ""
        },
        "Network": {
            "ScriptsName": "TableTextNetwork",
            "ImportType": "NoneType",
            "ExtraNamespace": ""
        },
        "SystemFind": {
            "ScriptsName": "TableTextSystemFind",
            "ImportType": "NoneType",
            "ExtraNamespace": ""
        },
        "SystemArray": {
            "ScriptsName": "TableTextSystemArray",
            "ImportType": "FieldType",
            "ExtraNamespace": ""
        },
        "Rich": {
            "ScriptsName": "TableTextRich",
            "ImportType": "NoneType",
            "ExtraNamespace": ""
        }
    }
}

导入类型

每个表格得每个页签都需要选择一个导入类型，没选择导入类型得页签代表不进行导入。导入类型决定了生成得表格数据得bytes文件和对应得脚本文件。

类型总览：

FieldType

字段的导入类型，用于根据字段的关键字来访问对应的值。此类型只允许有两列第一行包含'c'的列（第一行包含'c'代表要导入的数据），一列是代码访问关键字，一列是值。

示例

在这个示例中，我们展示了一个普通表格的结构。每一列都有一个对应的数据类型和字段描述。
在第一行中，我们使用了字符c来表示是否要导入该列的数据。只有含有c的列才会被导入到数据文件中。
在第二行中，我们列出了每一列的字段名字。这些字段名字用于标识每一列所代表的数据。
在第三行中，我们指定了每一列数据的类型。这些类型可以是整数(int)、字符串(string)、长整型(long)等。
在第四行中，我们提供了对每一列所代表的字段的描述。这些描述可以帮助读者更好地理解每一列数据的含义。
接下来的行中，第一列表示的是我们要搜索的关键字，第二列就是关键字对应的数值

FindType

查找的导入类型，用于根据数据的key查找对应的数据，此类型包含'c'的列至少是两列，一列是查找的时候的关键字，后面就是一系列的配置数据了。

示例

在这个示例中，我们展示了一个普通表格的结构。每一列都有一个对应的数据类型和字段描述。
在第一行中，我们使用了字符c来表示是否要导入该列的数据。只有含有c的列才会被导入到数据文件中。
在第二行中，我们列出了每一列的字段名字。这些字段名字用于标识每一列所代表的数据。
在第三行中，我们指定了每一列数据的类型。这些类型可以是整数(int)、字符串(string)、长整型(long)等。
在第四行中，我们提供了对每一列所代表的字段的描述。这些描述可以帮助读者更好地理解每一列数据的含义。
接下来的行中，我们可以输入对应的数据。在这个示例中，我们输入了一条数据，其中ID为1，等级为1，描述为"练气"，经验为100。
以上是对普通表格的描述和示例。你可以根据需要调整表格的结构和内容。

LNGType

这个是语言表类型，是导表工具自动生成的多语言表内的页签用的类型，这个类型的表在生成多语言的时候每页都会生成一个语言的字节文件，游戏可以在加载字节文件里做处理，只需要加载对应语言即可。

示例

这个语言表会自动生成，不需要创建，只需要添加要生成语言的配置即可

NoExportLNGType

这个类型的表也是语言类型表，这个表需要玩家自己收集游戏中不是动态变化的语言，类似Unity的prefab上的语言，导表的时候会把这些语言收集到多语言表中，并且不会生成脚本和字节文件，游戏中开发者只需要通过id访问语言表的字节文件即可。

示例

CustomTypeField

自定义类型的字段导入类型，这个和字段导入类型差不多，但是要求有效列(第一行含'c')的列必须是三列。

示例

在这个示例中，我们展示了一个多类型表格的结构。每一行都有一个对应的数据类型和字段描述。
在第一行中，我们使用了字符c来表示是否要导入该列的数据。只有含有c的列才会被导入到数据文件中。
在第二行中，我们提供了对每一列所代表的字段的描述。这些描述可以帮助读者更好地理解每一列数据的含义。
以上是对多类型表格的描述和示例。你可以根据需要调整表格的结构和内容。

导入命令

后续版本会支持界面按钮调用，目前仅支持命令。(注：需要配置python环境)

支持的数据格式