欢迎使用迷上城建（Mishang Urban Construction）模组。本模组为您提供了一系列方块和工具，打造出精美的城市。目前本模组还在开发中，各功能还不稳定，未来还会加入更加内容。

模组还不稳定，请勿将本模组内容用于实际开发中，以免因模组出现不兼容的更新而导致旧的内容消失。
本模组依赖 ARRP，安装本模组时确保已安装 ARRP 模组！
本模组是按照 GPLv3 协议发布的，传播本模组时需遵守本协议。根据该协议，由本模组衍生的任何软件都应按 GPLv3 协议发布。传播源代码时，应当保留许可证文件。传播编译后的模组文件时，应当保留源码或提供源码地址。违反 GPLv3 将会丧失本许可证提供的权利，直到模组作者或者 GPLv3 许可证规定的恢复权利。具体请参考许可证原文。

0.1.7版本更名了道路方块，更新后原有的道路方块将被移除。请提前备份存档。

如何安装

本模组使用 Fabric Loader，并依赖 Fabric API 和 ARRP（高级运行时资源包）模组。请在安装本模组时，确保安装了 Fabric API 和 ARRP，否则可能造成游戏无法启动或者内容缺失。

模组内容

本模组加入了一系列方块和物品。这些模组内容暂不支持合成。

道路方块

本模组添加了一系列道路方块，用来构建你的城市中的道路。目前道路均为柏油路，支持白色与黄色标线。道路和标线均位于同一方块，且分为完整方块和台阶。大多数带有朝向的方块在潜行时可以切换方向。
本模组还添加了可自动标线的道路，放下后若侧面有方块更新，则会根据周围道路的标线来自动确定自身的标线形状和方向（点击方块顶部也可以手动触发更新），注意一旦确定好标线就无法再次自动更改。

灯方块

本模组添加了一系列灯方块，包括完整灯块和装饰物方块。这些方块可含水，且不需要红石触发即可发光。
条形灯和条形灯管方块可放置在墙上、地上或天花板上。放置在墙上时默认是水平的，潜行时放置可放置垂直方向的方块。
灯装饰物方块是吸附在方块面上并且可以在各个方向自动连接的方块。
目前，灯有三种颜色：白色、黄色和青色。

告示牌方块

本模组添加了各种纹理的告示牌方块，包括悬挂着的告示牌和墙上的告示牌。其中，悬挂告示牌方向的两侧都可以写文字，且当告示牌上方连接有方块或告示牌杆方块时，会显示告示牌杆。悬挂的告示牌的文字与方向对应，暂不支持直接旋转，如放置带有 NBT 的方块，应确保放置的方向与获取时的方向一致，以免文字不显示。

本模组有个隐形告示牌方块和（自 0.1.6）隐形的发光告示牌，自身不可见，但告示牌上的文字可见。

所有告示牌均可放在水中。此外，墙上的告示牌可以放在地上和天花板上，这与原版不同。

点击告示牌即可编辑文本。支持多行文本。你可以为每行文本设置以下属性：

• 加粗、倾斜、下划线、删除线、随机文本等。

• 文本大小。默认值取决于方块。悬挂告示牌上的文字默认大小为 5，墙上告示牌上的文字默认大小为 6，完整告示牌（含两种隐形告示牌）上的文字默认大小为 8。

• 文字在 X、Y、Z 三个坐标轴方向上的偏移。注意谨慎调整 Z 轴偏移，该偏移将使文本脱离告示牌平面，可能显示在告示牌后面（导致不可见），也有可能显示在告示牌前面（文本悬空）。

• X、Y 两个方向上的缩放。其效果与文本大小互相叠加。注意：如果将缩放调为 0，会导致文本不显示。没有 Z 轴方向上的缩放，因为文本本就在一个平面上，在 Z 轴方向缩放没有意义。

• 围绕 X、Y、Z 三个坐标轴的旋转。

• 文本颜色。可通过按钮调节文本颜色（仅限内置的 16 种颜色），也可以在旁边的文本框输入自定义颜色（数值、#aaRRGGBB 格式的十六进制或者游戏内置的颜色名称）。如果文本框中输入的颜色不是 16 种内置颜色，则按钮会被禁用。

• （自 0.1.6，且限 Minecraft 1.17 以上的版本）文本描边颜色。可通过按钮设置为：不显示边框、根据文本颜色自动决定描边颜色（和原版的发光告示牌一样）、选择内置颜色、选择内置颜色对应的发光告示牌描边颜色。暂不支持自定义。

• 阴影。不建议开启，当不同方向的文本都开启了“阴影”功能时，文本的显示次序可能存在异常。

• 绝对模式。若某一行开启绝对模式，则在“重新排列”文本时，这一行会被忽略。

• 水平对齐和垂直对齐。注意：如果你有连起来放置的多个告示牌，你应该会注意到对齐的是以单个告示牌为基准，而非多个。

添加多行文本时，文本不会自动排版，你可能会发现多层文本叠在一起。你可以通过点击“全部重排”来从上到下依次排列非绝对模式的文本行，该功能会根据文本大小依次排列各行，不同垂直对齐方向的文本互不干扰。每行文本都会在其上下方留下 1/8 行大小的行距。当然你也可以手动调节 Y 轴偏移来进行排版。

（自 0.1.6）如果你的告示牌还没有创建文本，你可以选择应用双行文字模板（一行大的一行小的，通常用在地铁站中，一行中文加一行英文）。对于悬挂告示牌，如果背面有文字，可以从背面复制。从背面复制文本时，所有的 X 轴偏移和水平对齐方式都会反向，文中的箭头文字（如“→”）也会反向。这在制作两面都有文字的导向牌时非常方便。（自 0.1.7）你也可以在选中单行文本时，点击“翻转”按钮，这一行的文本将会反向，或者按住 Ctrl 点击“翻转”按钮以将所有行的文本反向。

（自 0.1.7）编辑文本时，如果需要自定义 JSON 文本内容，可以在文本框中输入 -json 一段JSON，例如 -json {text:一段文本,color:red,bold:true}。本模组识别的 JSON 为宽容（lenient）模式，因此键和值均可以省略引号。

在告示牌编辑界面，各个按钮都进行了增强：点击按钮可调整数值，鼠标右键点击按钮或者按住 Shift 点击按钮可反方向调整，鼠标滚轮点击按钮或者按住 Alt+Shift 点击按钮可恢复默认值。滚动鼠标滚轮亦可用于调节数值。此外，按住 Ctrl 可 8 倍速调整，按住 Alt 可 1/8 倍速调整。

栏杆

自模组版本 0.1.7 开始，模组新增了栏杆方块。栏杆方块可含水。

栏杆目前有 5 种形式：

• 普通。栏杆位于整个方块的靠近边缘的位置。放置时，其水平走向与水平视线方向垂直，也就是说，你放置栏杆方块时，栏杆是“横着”的。具体位于方块的哪一个边缘，取决于你准星对准的位置。

• 中间。栏杆位于方块正中央的位置。这种情况下，方块具有自动连接功能，类似于栅栏或者玻璃板。不过，与栅栏或者玻璃板不同，无论周围方块如何，栏杆总是至少连接了两个方向。如果放置时周围没有方块，则栏杆放置后，显示为水平视线方向的垂直的水平方向。如果周围方块有更改，该栏杆方块也将相应更改。

• 角落。两个相互垂直的普通栏杆方块叠加起来形成的。在一个普通栏杆方块相同的方块空间内放置一个与其方向垂直的方块，将会自动产生角落的栏杆方块。同样地，破坏该方块的一部分后，会留下另一部分的栏杆方块。

• 角落外部。类似于角落，不过是用于栏杆方块之外位置的直角的。这种情况下，旁边两个方块必须先放置，然后再在角落的适当位置放置栏杆方块，方块会自动转为角落外部的形状。注意这种情况下，方块放置后，其形状不会自动改变。

• 楼梯。放置在楼梯边缘或者楼梯上方（倒立的楼梯除外），方块会自动与楼梯的形状相匹配。

工具

本模组添加了一系列用来辅助建造的工具。大多数工具在按下 Shift 时可以处理流体（水或者熔岩）。

• 道路连接状态调试工具：点击道路方块即可查看该道路在系统内部的各方向上的连接方向等情况。道路连接状态主要用于自动标线的道路方块识别。

• ID检查工具：点击方块或实体时可以用来查看方块或实体的 ID（包括原始 ID、文字 ID），如果对着空气点击则可以用于获取生物群系的 ID。

• 快速建造工具：可以用来快速地放置或者移除多个方块。受影响的方块取决于该物品的“匹配规则”和“范围”，例如，拿着匹配规则为“相同材料”、范围为 16 的快速建造工具点击橡木木板时，该平面上 16 格以内与该橡木木板方块相连的所有木质方块都会受到影响。放置方块时，会直接复制被点击的平面上的方块，但如果副手拿着方块，则使用副手上的方块。（自 0.1.6）按住 Shift 时可放置或破坏流体。按住 Shift 或者 Alt 并滚动鼠标滚轮可调整匹配模式。

• 旋转工具：点击方块即可旋转。按住 Shift 可反方向旋转。即使是生存模式也可使用。

• 镜像工具：点击方块时可沿着被点击的方向翻折方块。例如，朝东的楼梯方块，点击该方块的东侧或者西侧可变成朝西的，点击南侧或者北侧不受影响（因为该方块本来就南北对称）。即使是生存模式也可使用。

• 台阶工具：可用来只破坏双台阶方块的一半。从 Minecraft 1.17 开始，支持直接将具有台阶的完整方块（仅限原版方块以及本模组的方块，不含其他模组的方块）转化为台阶，例如对着橡木木板方块破坏即可将其转化为橡木台阶。该功能在 Minecraft 1.16.5 不受支持。

• 强制放置工具：可用于强制放置或破坏方块而不造成方块更新，如果被放置方块的地方已有方块，该方块将会被替换。可用此工具来形成本来不可能做到的方块悬空效果。副手拿着方块时，放置该方块，否则放置被点击的方块。

• 方块状态工具：点击方块即可获取方块状态属性。

• 数据标签工具：点击方块或者实体即可获取其所有 NBT 数据标签。本工具获取的是服务器的数据。

• 文本复制工具：可以跨方块复制和粘贴文本。对方块按“攻击”键（默认为鼠标左键）可复制所有行的文本（对于悬挂告示牌，一次只复制一侧的所有文本）。对方块按“使用”键（默认为鼠标右键）则会将该物品已复制的所有文本粘贴上去，若已有文本，则已有的文本会被覆盖。对原版告示牌和模组中的告示牌均有效，但有一些限制：

• 原版告示牌仅支持 4 行文本，因此如果粘贴的文本超过 4 行，则只粘贴前 4 行。

• 从原版告示牌复制到模组中的告示牌时，每一行的“颜色”属性对应原版告示牌的自身颜色。

• 由于原版告示牌仅支持一种颜色，且该颜色只能是游戏内置的 16 中颜色之一，因此将模组中的告示牌文本粘贴在原版告示牌时，可能会损失部分颜色。但是，JSON 文本中定义的颜色不会被忽略。

• 从原版告示牌复制文本到模组中的告示牌时，原版告示牌的自身颜色会应用至每一行，且原版告示牌的空行会被忽略。

还有更多内容将在新版本添加，敬请期待。