nft-generator-py

nft-generator-py 是一个简单的脚本，它使用加权层文件以编程方式生成图像。

入门指南

克隆仓库并安装依赖项。

git clone https://github.com/Jon-Becker/nft-generator-py
cd nft-generator-py
python3 -m pip install -r requirements.txt

创建一个配置文件，或使用 build_configuration 命令从特征目录创建配置文件。有关配置文件的更多信息，请参阅配置。

CLI 选项

以下命令可用：

可选参数

配置

{
  "layers": [
    {
      "name": "Background",
      "values": ["Blue", "Orange", "Purple", "Red", "Yellow"],
      "trait_path": "./trait-layers/backgrounds",
      "filename": ["blue", "orange", "purple", "red", "yellow"],
      "weights": [30, 45, 15, 5, 10]
    },
    ...
  ],
  "incompatibilities": [
    {
      "layer": "Background",
      "value": "Blue",
      "incompatible_with": ["Python Logo 2"],
      "default": {
        "value": "Default Incompatibility",
        "filename": "./trait-layers/foreground/logo"
      }
    }
  ],
  "baseURI": ".",
  "name": "NFT #",
  "description": "This is a description for this NFT series."
}

config 对象是一个包含配置指令的字典，可以更改这些指令以在运行程序时产生不同的输出。在元数据文件中，使用配置的 name 参数命名代币，并使用 description 参数描述。

• 按升序，tokenId会附加到 name 后面，生成如 NFT #0001 的NFT元数据名称。
• tokenId会根据生成的最大数量进行填充。例如，使用上述配置生成999个对象将得到 NFT #001，生成1000个对象将得到 NFT #0001。
• 自 v1.0.2 版本起，已移除文件名填充功能。

layers 列表包含 layer 对象，定义了程序在生成唯一代币时使用的层。每个 layer 都有一个名称（将显示为属性）、值、trait_path、filename 和 weights。

• trait_path 指的是可以找到 filename 中图像文件的路径。请注意，文件名省略了 .png，程序会自动添加。
• weight 对应于程序运行时选择特定值的百分比几率。权重必须加起来等于100，否则程序将失败。

incompatibilities 列表包含一个对象，告诉程序哪些层与哪些不兼容。在上述配置中，蓝色背景 layer 将永远不会与 Python Logo 2 一起生成。

• layer 指的是目标层。
• value 是与 incompatible_with 列表中的属性不兼容的层的值。
• incompatible_with 是当 layer 具有属性 value 时永远不会被选择的不兼容层列表。
• 每个不兼容项可以提供一个可选的 default 对象。如果存在且选择了不兼容的层，此对象将100%被选中。default 对象具有 value 和 filename 属性。
  • value 是将在元数据中显示的默认选择的名称。
  • filename 是将用作默认选择的图像文件的路径。

故障排除

• 所有图像都应为 .png 格式。
• 所有图像的像素大小应相同，例如：1000x1000。
• 每个属性的权重值加起来应等于100。

贡献

在贡献之前，请创建一个新分支，格式如下：

user/{用户名}/{描述}

您的名称应该能描述您正在进行的更改。例如，如果您正在添加一个新命令，您的分支名称可能是 user/jon-becker/some-new-command。

您的代码将被审核，并至少需要一个批准才能合并到 main 分支。

在编写提交消息时，请遵循本指南。消息应该具有描述性且简洁明了。