本文翻译自https://github.com/reteo/Sprocket,若阅读过程中认为译文有误, 或不能理解之处, 请评论或查看英文原文。
为了方便, 若未特别指出, 下文中COG意为CustomOre Generation（自定义矿物生成器for MC1.7.10）。
创建于2016/10/16 23：57，当前COG1.2.26for MC1.7.10，阅读汉化后的说明书请注意时效性。
最后编辑于2016/10/17 0:36
Word文档下载地址：链接:http://pan.baidu.com/s/1qXqjOTY 密码:zf89
目录
什么是Sprocket
如何使用Sprocket
Ini文件的格式
模组定义部分
模组名（Name）
模组的前缀（Prefix）
检测信息（Detect）
描述信息（Description）
默认配置部分
方块定义部分
分布预设
COG内建预设
Substitution（替换）
Vanilla（原版）
Cloud（云状）
Motherlode and Veins（主矿脉与子矿脉） 自定义分布
选项类型
分布元信息选项
共享的选项
方块列表
位置选项
替换分布选项
标准分布选项
云分布选项
矿脉分布选项
调试选项
什么是Sprocket
Sprocket是一款基于Python2.7的脚本软件, 其目的是为了快速的生成一份适用于COG的配置文件。它通过读取ini文件来生成指定格式的xml文件。
如何使用Sprocket
Sprocket是一款命令行程序, 它需要Python2.7（请不要使用别的版本，因为Python的设计者意图优化整个软件而放弃了向下兼容）作为运行环境。
想要运行程序, 你可以通过以下两种方式进行:
将写好的ini文件与sprocket.py放置在同一文件夹内，在Python中输入
- sprocket.py name-of-file.ini
- python sprocket.py name-of-file.ini
如果程序正常运行, 你将看到长串的以矿石名开头的过程信息, 或者一条英文的错误信息, 这条错误信息将指导你如何修正你的ini文件。（正在尝试汉化）
每一次程序运行都会创建xml文件位于当前目录下, 文件名基于ini文件中的mod name。
Ini文件的格式
Ini文件包含至少3部分, 模组定义部分, 默认配置部分, 以及至少一个方块定义部分。
文件格式如下(这一段代码加框总是出问题..):
[Section]
Option Name: Option1, Option2, …Final Option
在书写过程中请务必留意标点符号的全角与半角切换, 这有可能导致ini文件失效。
模组定义部分
| [Mod]部分提供了模组的关键信息, 包括模组的名字, xml前缀, 模组的ID, 以及一段针对这个模组或当前配置文件的描述信息。 模组名（Name） 将被展示在COG设置页面, 以及矿石名的前面和模组标签上。请不要使用除空格外的特殊字符。例如:Name:潘马斯的丰收 模组的前缀（Prefix） 被用于整个xml文件。这确保了所有的变量拥有不同的变量名。例如:铜矿（“copper”）在大多数模组中都会出现, 所以任意一份配置文件中对“copper”的设置都将影响其他模组“copper”实例的生成, 除非配置文件中的变量名包含能够彼此区分的特殊部分。建议使用不包含空格的全名, 但缩写过长的变量名也是允许的。例如:Prefix:pms 检测信息（Detect） 被用于写入xml文件, 并在模组加载过程中检测是否存在特定的模组；另外, 如果你移除了一个模组缺没有将它的配置信息删除, 那么COG将有可能在游戏启动时崩溃。例如:Detect:harvestcraft 描述信息（Description） 用于添加自定义的信息至xml文件, 它提供了一块你可以描述整个模组, 你的名字, 或者作为配置信息作者的联系方式等信息的区域。 因此, 一份合适的模组定义部分将具备如下格式:
|
默认配置部分
| 重复书写相同的配置降低了整个工程的效率。因此你可以把这些通用的信息写到默认配置[Default]部分, 在这一部分添加的信息, 例如:是否开启线框, 使用某种分布预设等, 将被自动的配置到方块定义区, 你不用再在那边写第二遍了。 请务必留心, 这一部分只设置默认信息, 这些默认的信息能够轻易的被方块定义区追加的信息覆盖, 例如:在默认配置中将分布预设设为层状（Layered veins）, 而在配置某个矿物时却使用了稀疏（Sparse veins）或管状（Pipe veins）替代了层状。 因此, 一份合适的默认配置部分将具备如下格式:
|
方块定义部分
| 方块定义部分总是以 分布（distribution）的名字开始（实际上以某种矿物的名字开始）, 例如[盐]。这将被展示在COG设置页面, 例如“潘马斯的丰收 盐”。 下列名称为一个分布可使用的各种选项, 这些选项将被将会在接下来的部分更详细的介绍。 一份合适的方块定义部分具有如下格式:
|
分布预设
| 在进入选项部分之前, 最好了解下如何覆盖由SprocketAdvanced提供的不同的分布选项。COG内建了多种分布预设, 现在Sprocket带来了更多更加复杂的预设。 COG内建预设 Substitution（替换） 最简单的分布选项。替换分布简单的将一种方块替换为另外一种, 你可以设置新的约束条件来限制其在特定高度上产生影响。 Vanilla（原版） 实际上这种分布名为“StandardGen”, 即标准生成。但Sprocket使用“Vanilla”来澄清这个分布的功能。从本质上来讲, 这种分布会像原版矿物生成器一样, 在矿物指定的高度范围内生成少量散落的小型矿脉。 Cloud（云状） 云状分布包含一大片球型区域。默认情况下, 这个球体内包含的矿物是稀疏的, 这意味着其中的矿石彼此分离, 使得挖空整片矿脉的进程变的麻烦而费时。球型的形状是可以配置的, 因为它的垂直尺寸和水平尺寸是独立改变的, 并且整个分布能够被倾斜。云状分布也会生成一些散落的矿脉（Hint veins）在它附近。 Strata（地幔） 由一个巨大的扁平的矿石或石头构成的碟子一样的分布, 最好用来提供各类模组带来的各种独特的石头类矿石。这种预设在1.2.25版的COG中不可用。 Motherlode and Veins（主矿脉与子矿脉） 注意, 与之前的选项不同的是, 这不是一个预设。这种矿脉分布是这一组中最复杂的一种。这种矿脉分布中的第一部分是Motherlode（主矿脉）, 一个用来作为分布中心的球状结构, 全部由矿石构成。第二部分则是Veins（子矿脉）, 从主矿脉出发, 发散向各个方向的连成一条线的矿脉, 它们会在其路径上产生平滑的扭曲与转向, 有时则分裂成多条分支。子矿脉中的关键分布是Branches（分支）, 即起源于其根部（可能是主矿脉, 也有可能是某一条分支上的一个节点）的整条子矿脉, 以及Segment（片段）, 就是那些弧形的小矿脉。 Layered Veins（层状） 基础的主矿脉与子矿脉分布。 Vertical Veins（竖直） 这种预设其始于某个点, 然后不间断的延伸（默认向下）。 Small Deposits（小型） 只有主矿脉的一种分布, 默认情况下尺寸很小…大概原版矿脉那种尺寸。 Huge Veins（大型） 这种分布也像层状一样包括主矿脉与子矿脉两部分。相比较而言其主矿脉十分巨大, 子矿脉则略显稀薄, 但出奇的长…它本意是作为一种具有战略性的选项, 玩家需要四处搜寻矿石, 一旦他们探索到了子矿脉, 他们就可以顺藤摸瓜般的找到主矿脉, 此时他们便能得到用上足够久的矿产资源。 Sparse Veins（稀疏） 一段由矿石构成的分支。出奇的宽与长但其内部十分稀疏。挖空一片稀疏的矿物极具挑战性, 因为玩家们不得不花费很多时间来找到下一个矿石, 而不是单纯的挖了这个挖下一个。 Pipe Veins（管状） 这是一个由两条子矿脉构成的分布, 它不包含主矿脉。外层的矿脉有点稀疏, 而内层的矿脉则是密集的, 常见的情况是一些珍贵的矿石配上某些危险的东西, 像是岩浆或者怪物蛋什么的。 Hint Veins（散落） 这种预设通常不单独使用, 而是作为一种提醒玩家附近有战略性矿产资源的分布。它在地图上以单个矿石的形式出现。 Compound Veins（复合） 与层状分布大致相同, 但他还包含一个与管状矿脉相似的子分布。 Geode（晶洞） 与小型分布大致相同, 但其内部包含一个空洞, 它用来模拟真实的洞窟。 Custom Distributions（自定义分布） 当你确切的知道自己在做什么, 并且有些独特的想法的时候能排的上用场的分布。这些分布没有预设值。 Custom Veins（自定义矿脉） 这将产生一个非预设的矿脉分布, 你可以将矿脉相关的选项添加进来。 Custom Cloud（自定义云） 这将产生一个非预设的云状分布, 你可以将云状相关的选项添加进来。 |
选项类型
| List（列）:由逗号分隔的包含项目（Items）的列, 也可以用正则表达式。 Boolean（布尔值）:“Yes”或者“No” StatisticalVariation（统计型变量）:这个选项包含四个值。 Statisticalaverage 统计平均值。 Statisticaldeviation统计偏差值。 Preference偏向, 下列中的一个: Normal一般, 偏向于靠近平均值。 Inverse反向, 偏向于靠近偏差值。 Uniform平均, 没有偏向, 完全随机。 Scalingoption 放缩选项, 默认”base”, 详情见COG自己的文档。 注意, 由于统计型变量的存在, 你可以参考预设的默认值, 将其设为“_default_”值, 确保default的前后都有下划线。 如果你想使用负数的默认值, 只需要在前面加上负号,即“-_default_”。这种值在某些情况下很有用, 比如将管状分布的方向翻过来（Vein Branch Inclination: -_default_, -_default_, normal, base）, 将其设为从下向上延伸, 而不是原来的从上向下延伸。 一个合适的选项将具备以下格式:
|
分布元信息选项
| 这些选项不可忽略，它们用于向xml文件添加有用的逻辑结构，被应用于特定的条件下。他们也包括一些通用的值，如果没有被某种分布覆盖掉的话。 DistributionPreset（List）这种分布所有可用的分布预设，在游戏过程中可用的分布预设。例如： Default:Vanilla Seed(Value)种子码用于序列化不同分布的随机数生成器，通常在将一种分布作为另一种分布的子分布的过程中使用。 Default:MISSING Active(Boolean)是否可用，如果设为“No”，则默认分布将被设为“none”，否则默认分布为分布预设列中的第一项。 Default:yes UseCleanup(Boolean) 是否使用清除工具。如果设为“yes”，则在游戏的过程中会先进行清理过程，再生成新的分布。这是一项很消耗计算量的步骤，严重时可能会导致区块加载时崩溃；如果设为“no”，那么清理过程就会被跳过，然而如果这个模组没有禁用其自身的矿物生成器（oregen），你将会得到两份矿产，一份来自模组自身，另一份来自COG。这个选项对于“minecraft”模组不可用。 Default:yes MainBlock Cleanup（Boolean）是否使用主要的方块清理工具。如果设为“yes”，则首先运行一次清理，将“Blocks”列中所有的方块替换为“Replace”列中的一个方块。这个过程会将其他模组产生的矿石移除以便接下来使用特定的分布重新生成矿石。如果模组自身能够将其矿物生成关闭则推荐设为“no”，这样可以提升区块加载效率。 Default:yes AlternateBlock Cleanup（Boolean）是否使用交替方块清理工具，如果设为“yes”，则首先运行一次清理，将“Alternate Blocks”列中所有的方块替换为“Replace”列中的一个方块。这个过程会将其他模组产生的矿石移除以便接下来使用特定的分布重新生成矿石。如果模组自身能够将其矿物生成关闭则推荐设为“no”，这样可以提升区块加载效率。 Default:no |
共享的选项
| 这些选项被应用于那些没有指定相关配置的分布。 Size (Statistical Variation) 尺寸范围 Default: _default_, _default_, normal, base Frequency(Statistical Variation) 频率范围 Default: _default_, _default_, normal, baseHeight(Statistical Variation) 高度范围 Default: _default_, _default_, normal, baseDensity(Statistical Variation) 密度系数，0意味着没有这一类方块，1意味着全部都是这一类方块， Default: _default_, _default_, normal, baseHeight ClampRange (List) 高度夹紧范围，两个数字，限制分布最高与最低能够影响到的高度 Default: MISSINGParent RangeLimit (Statistical Variation) 父分布疏远极限，定义了一个子分布究竟能离其父分布多远 Default: _default_, _default_, normal, base |
方块列表
| Blocks（List）由方块ID构成的列，影响到替换后的方块。必填选项。 Default: MISSING Alternate Blocks(List) 交替方块列。这些方块将被放置到特定的位置。这个选项仅对复杂分布有效，例如管状分布的内部就会被这个列中的方块填满；复合型矿脉与晶洞，他们都会披上一层由这个列中的方块构成的外壳。 Default: minecraft:stone Replaces (List) 将被替换掉的方块的ID构成的列。替换后的方块来自Blocks。 Default: minecraft:stone Block Weights(List)方块权重系数，调节各个方块在Blocks列中的权重。数目必须与Blocks列的数目一致，总数不大于1。 Default: MISSING Alternate BlockWeights (List)交替方块权重系数，调节各个方块在Alternate Blocks列中的权重。数目必须与Alternate Blocks列的数目一致，总数不大于1。 Default: MISSING ReplacementWeights (List)被替换方块的权重系数。调节各个方块在Replaces列中的权重。数目必须与Alternate Blocks列的数目一致。不像前两项，这一项的数值没有总数限制。但“1”意味着总是替换这个方块，“-1”则意味着永远都不替换这个方块。 Default: MISSING |
位置选项
| Dimensions (List) 维度，当前分布能够影响到的维度。相比之前，这个列被大规模的扩展了，添加了许多由模组提供的维度。目前可用的选项： Overworld Nether End Twilight Forest Aether Aether Dungeons Outer Lands Bedrock Dimension (or just "Bedrock") Mining World (or just "Mining") GalactiCraft Space (or just "Space") GalactiCraft Orbit (or just "Orbit") GalactiCraft Moon (or just "Moon") GalactiCraft Mars (or just "Mars") GalactiCraft Asteroids (or just "Asteroids") RFTools Mystcraft Default: Overworld Need Biomes(List) 生物群落限制，这种分布只能在这些生物群落中生成。默认所有。 Default: .* Need Biome Types(List) 生物群落类型限制。 Default: MISSING Avoid Biomes(List) 生物群落限制，这种分布不会在这些生物群落中生成。 Default: MISSING Avoid BiomeTypes (List) 生物群落类型限制。 Default: MISSING Prefer Biomes(List) 生物群落限制，在这些生物群落中，这个分布会伴随额外的子分布。 Default: MISSING Prefer BiomeTypes (List) 生物群落类型限制。由Forge生物群落字典提供的类型。在这些类型的生物群落中，这个分布会伴随额外的子分布。 Default: MISSING Biome RainfallRange (List) 生物群落降雨量范围限制。由最小值与最大值调节分布。 Default: MISSING BiomeTemperature Range (List) 生物群落温度范围限制。由最小值与最大值调节分布。 Default: MISSING Place Below(List) 处于这些方块下方，这一列将影响到替换后的方块只能出现在这些方块的下方第一格。@ RailwayCraft的某抖M矿。 Default:MISSING Place Beside(List) 处于这些方块的旁边。这一列将影响到替换后的方块只能出现在这些方块的前后左右四面。 Default: MISSING Place Above(List) 处于这些方块上方，这一列将影响到替换后的方块只能出现在这些方块的下方第一格。 Default: MISSING |
替换分布选项
Substitution Height Clamp Range (List) 替换高度夹紧范围，由最小值与最大值限制分布替换方块的范围。
Default: MISSING
标准分布选项
Standard Size(Statistical Variation) 标准尺寸，矿脉的尺寸。 Default: MISSING StandardFrequency (Statistical Variation) 标准频率，每个区块包含矿脉的数量。 Default: MISSING Standard Height(Statistical Variation) 标准高度。 Default:MISSINGStandard ParentRange Limit (Statistical Variation) 标准父分布疏远范围极限，限制究竟子分布能离父分布多远。 Default: MISSING Standard HeightClamp Range (List) 标准高度夹紧范围，由最小值与最大值限制分布替换方块的范围。 Default: MISSING |
| Cloud Frequency (Statistical Variation) 云频率，云状矿脉每区块出现的次数 Default: MISSING Cloud ParentRange Limit (Statistical Variation) 云父分布疏远范围极限。限制究竟子分布能离父分布多远。 Default:MISSINGCloud Radius(Statistical Variation) 云半径，水平方向上云心到其边界的距离。 Default: MISSING Cloud Thickness(Statistical Variation) 云厚度，竖直方向云心到其边界的距离。 Default: MISSING Cloud Noise(Statistical Variation) 云噪声，影响方块在云内部的随机生成。0意味着云的内部是稀疏均匀的，方块以规则的间距出现生成。 Default: _default_, _default_, normal,base Cloud Height(Statistical Variation) 云高度。 Default: MISSING CloudInclination (Statistical Variation) 倾斜角度，竖直方向与云主要平面的夹角，用于生成倾斜的云状矿脉。 Default:_default_, _default_, normal, base Cloud Density(Statistical Variation) 密度系数，0意味着没有替换后的方块，1意味着全部都被替换。 Default: MISSING Cloud NoiseCutoff (Statistical Variation) 正在决定中的选项。 Default: _default_, _default_,normal, baseCloud RadiusMultiplier (Statistical Variation) 正在决定中的选项。 Default: _default_, _default_, normal, base Cloud HeightClamp Range (List) 高度夹紧范围，由最小值与最大值限制分布替换方块的范围。 Default: MISSING |
| Vein Motherlode Frequency (Statistical Variation) 主矿脉频率，出现次数每区块。 Default: MISSING Vein MotherlodeRange Limit (Statistical Variation) 主矿脉范围极限，限制子分布与其的疏远距离极限。 Default: MISSING Vein MotherlodeSize (Statistical Variation) 主矿脉直径 Default: MISSINGVein MotherlodeHeight (Statistical Variation) 主矿脉高度 Default: MISSINGVein Branch Type(List) 分支类型，用于描述分支的扭曲类型；“Ellipsoid”：扭曲更加迂回、规则；“Bezier”： 扭曲更加圆滑，复杂。Default: Bezier Vein BranchFrequency (Statistical Variation) 分支频率，每个主矿脉拥有的分支数。 Default:_default_, _default_, normal, base Vein BranchInclination (Statistical Variation) 倾斜角，调节分支与竖直方向的夹角。 Default: _default_, _default_, normal, baseVein BranchLength (Statistical Variation) 分支总长度（包括其中所有的片段）。 Default: _default_, _default_, normal, baseVein BranchHeight Limit (Statistical Variation) 分支高度限制，分支远离主矿脉的最大高度偏差。 Default: _default_, _default_, normal, baseVein SegmentFork Frequency (Statistical Variation) 片段分叉频率，决定一个片段分为两条分支的频率。 Default: _default_, _default_, normal, baseVein SegmentFork Length Multiplier (Statistical Variation)片段分叉长度系数，用于削减分叉的长度，0到1之间。 Default: _default_, _default_,normal, baseVein SegmentLength (Statistical Variation) 片段长度，分支的每一个片段的长度。 Default: _default_, _default_, normal, baseVein SegmentAngle (Statistical Variation) 水平方向上片段与分支的夹角。 Default: _default_, _default_,normal, baseVein SegmentPitch (Statistical Variation) 竖直方向上片段与分支的夹角。 Default: _default_, _default_,normal, baseVein SegmentRadius (Statistical Variation) 片段半径，决定片段最厚实的点有多宽，本质上是分支的宽度。 Default:_default_, _default_, normal, base Vein Ore Density(Statistical Variation) 密度系数，0意味着没有替换后的方块，1意味着全部都被替换。 Default: MISSINGVein Ore RadiusMultiplier (Statistical Variation) 矿脉半径系数，待定。 Default: _default_, _default_,normal, baseVein HeightClamp Range (List) 高度夹紧范围，由最小值与最大值限制分布替换方块的范围。 Default: MISSING |
调试选项
| Wireframe (Boolean) 在调试模式下，线框是否可见。 Default: yes Bounding Box(Boolean) 在调试模式下，碰撞箱是否可见 Default: noWireframe Color(Value) 线框颜色。Web颜色代码格式。SprocketAdvanced能够处理“#”标记，但xml不能。 Default: MISSINGBounding BoxColor (Value) 碰撞箱颜色。同上。 Default: MISSING |
[groupid=128]HAYO Studio[/groupid]
-
-
2016-10-17 00:26 上传
点击文件名下载附件
29.26 KB, 下载次数: 60
docx文档