CityWorld ReForged

CityWorld——为 NeoForge 重新打造

踏入一座仿佛由匠心打造、绵延无尽的城市——程序生成、种子确定性生成，处处细节满满：有名有姓的街道、配备家具的建筑、环岛、工厂、农场、矿井、下水道，以及其间的野生自然景观。这是经典 Bukkit/Spigot 插件CityWorld的完整NeoForge 移植版（Minecraft 1.20.1 另有Forge版本），从头为现代 Minecraft 重制——生成器的核心不变，GPL-3 许可证不变，现在还可在创建世界界面中选择这种世界类型。

经受实战考验：已在455 个世界中生成 760 万个区块——程序生成的城市面积超过1,900 平方公里，比整个大伦敦地区还大，相当于两个半纽约市。

6.12.0 新增：更轻量的服务端。针对所有可能卡住服务端线程的环节进行了优化。此前，一个整合包中的任务模组一次向 CityWorld 查询数百个区块，导致游戏卡顿 55 秒，这促使我们开展了这轮优化：询问“这里计划生成什么”不再触发整片地铁区域的规划；模组现在可通过非阻塞方式查询（lotAtIfPlanned、lotAtAsync）；所有后台规划任务共用一个小型低优先级线程池；地图悬停查询设有上限；规划缓存占用的内存减少至原来的十分之一；不会再有两个线程重复拼装同一座建筑；/locate和探险家地图也能直接获取高度信息，无须生成整列方块。若有模组仍在服务端线程中进行规划，日志只会提示一次，方便追查卡顿源头。

6.11.0 新增：生物群系模组也能在城市中发挥作用。Biomes O’ Plenty、Oh The Biomes We’ve Gone、Nyctophobia，以及 VanillaBackport 的苍白花园——所有 TerraBlender 模组的生物群系现在都能出现在 CityWorld 自有陆地中，1.21.1 和 1.20.1 版本也同样支持（此前这两个版本发布后，这项功能一直存在一个未被发现的问题）。数据包形式的生物群系模组——Terralith、与 Grand Terrain 搭配使用的 Dreamwoods——也能出现在两类陆地中，而 Regions Unexplored 则能出现在原版陆地中。模组生物群系现在会以完整区域生成，而非狭长碎片；穿过雪地模组生物群系的河流会结冰。新增开关“结构：仅生成于野外”，也可通过标签#cityworld:wilderness_only逐项设置，避免模组结构出现在街道上（Arboria 的湖泊已添加标签：此前每个湖泊都会把城市一分为二）。

6.10.0 新增：更符合世界设定的战利品，以及自动取款机。现代风格办公室的抽屉现在会放有纸张、书籍和时钟；废墟抽屉里则有废料、线和变质食物；大约每十三个容器中，就有一个会装着值得一拿的东西（可通过“抽屉中的发现”设置调整）。安装 Modernlife 后，市政厅、商店和购物中心里会出现它的 ATM；在 1.20.1 版本中，银行还会在出生点拥有一座铺好路面的城镇广场，不再生成在商店上。Wiki 新增的战利品表页面介绍了如何向其中任意容器添加自定义物品。

近期其他更新

• 6.9.0——相同种子生成相同城市：区块装饰的每个部分都会根据种子使用各自的随机数，因此你分享的种子生成出的城市，朋友也能得到同一座。
• 6.8.0——野外动物：CityWorld 自有陆地生成时会根据生物群系生成原版动物群，也可通过开关让它们进入城市；安装 Forgified Fabric API 并使用添加末地生物群系的模组后，末地也不会再卡死。
• 6.7.0——可将“自定义”设置保存为预设，以便用于下一个世界；“结构”页面新增“全部开启 / 全部关闭”；在“自定义”中更改风格后，生成效果与选择对应世界类型完全一致。
• 6.8.2——兼容 C2ME：安装 C2ME 后末地曾无法生成任何内容（现已修复）；在我们的测试中，C2ME 还能让 CityWorld 的陆地生成速度提升约 2.5 倍。此外，某个家具模组的砧板曾导致所在区块中其余容器变空。
• 6.8.1——毁灭前的城市（/cityworld对应世界）现在会保留自身的灯光、植物蔓生状态和刷怪笼生物，而不会沿用废墟世界的设定；下界和末地也可以用同样的方式设置。
• 6.6.0 — 想找什么都行：CityWorld 可以根据城市规划回答“最近的医院、商场或 Winchester 在哪儿？”（CityWorld Urban Compass 就是基于它打造的），而深层的金库楼层藏着最好的战利品。
• 6.5.0 — 用数据包装配建筑：可以替换方块、在任何原理图建筑里挂上物品展示框，无需替换整栋建筑。
• 6.4.0 — 为任何动物打造动物园：CityWorld 动物园里有哪些动物、每个围栏是什么栖息地，都由数据包决定；此外，创建世界有时会卡在“正在准备出生区域”——现已修复。
• 6.3.0 — 无线电塔新增可进入的小屋（里面有椅子、桌子和备用物资箱）；安装 Lootr 后，医院的药品箱也能保留其中的药水。
• 6.2.0 — 关闭工作灯后，整座城市真的会陷入黑暗；废墟城市的金库有独立电力，深度可达四至八层，越往下越暗、越荒废。
• 6.1.0 — 丛林上方不再落雪：温暖的山地会从稀树草原、森林和丛林一路延伸至石峰，遵循原版的地形布局。
• 6.0.0 — CityWorld 自有土地上新增河流，瀑布后还藏着惊喜；河岸风貌会因城区而异（码头、船坞、港口、海滩、灯塔）；附带All Vanilla Structures示例数据包。
• 5.19.0 — 在原版世界中生成城市：选择 Land — Vanilla，并在 Customize 中选择 cities apart，即可在原版地形中不时遇到一座 CityWorld 城市；河流穿城而过，沿岸设有码头和桥梁；另有 Neutral Palette 附加包（GitHub）。
• 5.18.0 — 加入农夫乐事厨房、宴席和稻田（1.20.1 和 1.21.1）；街边商店出售对应商品，共有十四种交易，而且相邻商店的商品各不相同。
• 5.17.0 — 在游戏中选择结构：Customize 新增 Structures 页面，可启用或停用所有原版和模组结构组（村庄、林地府邸、模组地牢等）；安装 Minecraft Comes Alive 后，CityWorld 的村民会变成其中的居民；同时修复了世界卡在“正在准备出生区域”的问题。
• 5.16.0 — 加入 Ed Churchill 原本计划打造的特色：缺失的道路、车道线、废弃隧道、中庭、停机坪、错层住宅和现代住宅、公园凉亭与池塘、纪念碑，以及陈列化石和展品的博物馆。
• 5.15.0 — 城市地下新增地铁（每个城区都有车站，隧道分两层，设有换乘站，矿车沿线路运行）；城镇边缘新增购物中心；金库越深越危险，战利品也越丰厚。
• 5.14.0 — 新增稀有大型洞穴；支持 Alex’s Caves、Pam’s HarvestCraft、Battle Towers 和 Dungeon Crawl；每个容器都有战利品表；金库新增军械库。
• 5.12.0–5.13.0 — 城市规划会根据每个原版和模组结构的实际占地面积调整，地形也会塑造成适配结构的样子。
• 5.11.0 — 支持 Forge 上的 Minecraft 1.20.1。
• 5.10.0–5.10.1 — Macaw’s 的门、窗、栅栏、屋顶、楼梯和灯具可用于装饰城市；新增筒仓和储气柜；推出 Minecraft 1.21.1 和 26.3 版本。
• 5.7.0–5.8.0 — JourneyMap 会在未探索的地面上绘出城市规划；每条街道都有名称（/cityinfo, /cityfind street）；新增可跨越两个区块的飞艇。

每个版本的完整详情请查看对应文件的更新日志。

你将获得

选择CityWorld作为世界类型，便会降落在一座充满生机的城市中：

• 道路与基础设施 — 有真实路牌的命名街道（街道名称也会显示在/cityinfo、F3 和地图上）、人行道、环岛（带雕像）、桥梁、穿山隧道，以及藏在四岔路口下方的隐秘电梯井。
• 建筑，配有家具 — 从住宅到高层建筑，室内一应俱全：厨房、客厅、卧室、带雕纹书架的图书馆、办公室、商店；商店配有符合其行业的工作站方块（制图台、制箭台、织布机、烟熏炉等），门前还挂着吊牌。
• 城区 — 市政服务中心、工业工厂和仓库（下方设有地堡，配备一排排筒仓，偶尔还能见到煤气柜）、有动物和作物的农场，以及设有动物园和玻璃穹顶生态馆的公园。
• 地铁 — 每个城区都有一座车站，楼梯通往站台；车站之间由近及远铺设双轨隧道，分为上下两层并设有换乘站；矿车会沿线路运行。
• 购物中心 — 稀有的大型建筑，坐落在城镇边缘：设有带阳台的中庭、自动扶梯和电梯，数十家有名有姓的商店各自陈列商品并藏有战利品，外侧还有通往道路的停车场。
• 地下 — 配有铜器时代设施的矿道网络，矿脉越深越丰富，洞穴蜘蛛巢穴、悬挂的灯笼和垂直电梯井；潮湿的下水道；藏有战利品和生物刷怪笼的地堡与地下室。
• 自然与洞穴 — 山脉、带海滩的海洋，以及（在 MODERN/APOCALYPSE 中）类似原版的蜿蜒分支洞穴，还有由玄武岩围绕、取代平坦岩浆海的熔岩池。在地下，你会发现零星分布的真实洞穴生物群系——繁茂洞穴（苔藓、发光浆果藤、垂滴叶、栖息着美西螈/青蛙/热带鱼的水池，以及地表的杜鹃花）、溶洞、深暗之域，还有 Minecraft 26.2 及之后版本中的硫磺洞穴——每种洞穴都采用原版的方式进行装饰。
• 原版结构，各归其位 — 要塞（末影之眼可正常使用，玩家也能抵达末地）、试炼密室，以及深暗之域中的远古城市。村庄和废弃矿井默认关闭——CityWorld 会自行建造；但在自定义界面的结构页面中，可以启用当前安装包含的任意结构，无论是原版还是模组结构（数据包标签或世界设置也可为服务器实现同样效果）。
• 居民 — 有名字的村民在自己的商店里从事相应交易，田野里有动物，海里有鱼，矿井、下水道和黑暗处潜伏着敌对生物。
• 特色场景 — 城堡、无线电塔、石油钻井平台、飞碟、热气球、配有机组人员驾驶控制车的双区块飞艇、露营地——这些稀有地标散布各处，可通过 /cityfind 找到。
• 自定义原理图 — 附带经典建筑目录，也可以把自己的作品（.schematic/.schem/.litematic/.nbt）放进配置文件夹，让它们出现在城市中。

搭配 JourneyMap，地图也能读懂这座城市

5.7.0 新增。 安装 JourneyMap，地图就能显示只有 CityWorld 才知道的信息。地图模组会绘制你已经探索过的区域；CityWorld 则在任何人抵达之前，就已规划好每条道路和每个城区的位置——因此，即使地面尚未有人探索，地图也能显示规划图：

• 区域按功能着色——高层建筑、市政、工业、公园、农场——其上覆盖着街道网格，道路延伸穿过乡村。你旅行时，地图会持续绘制在你身后。
• 指向任意区块，它就会告诉你那里规划了什么——区域、地块类型、蓝图名称、商店，以及建筑内部的内容：“高层建筑 · 办公楼 · 办公隔间”、“农场 · 土豆田”。无人访问过的地方也包含在内。
• 放大后，地图上会标注街道名称（5.8.0 新增），包括你从未访问过的城市，指向道路即可显示其名称。
• 稀有地标在生成时会成为路径点，并且/cityfind、/cityfind lot和/cwlocate会在它们发现的任何东西上放置标记——分为两个独立的组，因此世界自身的发现和你的搜索可以分别显示或隐藏。
• 控制项在你预期的地方：JourneyMap 选项中的城市平面图开关、其全屏地图上的按钮，以及面向服务器的/citymap。/citymap keep <n>设置你的客户端持有多少规划数据，因为这部分开销由你承担，而非服务器。

这是真正意义上的软依赖：没有 JourneyMap，就没有任何区别——除非安装了它，CityWorld 不会触碰它的任何一个类。

主世界之外——废墟下界与末地

5.9.0 新增。CityWorld 世界类型现在自带下界和末地（可在“自定义 → 领域”下将任一维度切回原版）：

• 废墟城市下界就是主世界自己的城市——相同种子、相同街道、相同建筑——被烧毁和坍塌，位于下界生物群系中（若安装了超多生物群系，也包括其生物群系），建在地狱岩和黑石上，伴有熔岩海。传送门 1:1 连接，因此你抵达的废墟就矗立在其主世界建筑所在的位置。全高度，无基岩顶；堡垒和堡垒遗迹仍会生成，每个堡垒遗迹位于自己的洞穴中，有一条从街道向下通往它的废墟竖井。
• 末地全程保持原版——中央岛屿、末影龙战斗、虚空环、外岛及其紫颂森林和末地城——CityWorld 的城市位于外岛的平坦顶部：成片的城市和成片的荒野末地，街道由末地烛照明，建筑与紫珀块和末地石砖融合，从不废墟化（末影龙把所有人都挡在了外面）。生物群系模组的末地生物群系会在荒野地带生成。没有任何东西会挖穿岛屿；地下室只挖到岩石允许的深度。
• /cityworld在陷落之前访问城市——主世界自己的规划，完好无损。
• 整合包可以锁定其中任何一项：lockedWorldPreset、ruinedNether和cityworldEnd位于config/cityworld-startup.toml中，而lockCustomize = true会移除锁定预设的“自定义”按钮，因此每个新世界都会完全按照整合包发布时的预设设置生成。

配备家具与设施——家具模组让它更加完善

每栋建筑都有内部。办公室和公寓塔楼、政府建筑内的学校和法院、博物馆展品、工厂控制室、备货齐全的商店和仓库——有照明、有标签（按 F3 查看），并一直布置到地下室。空置建筑挂着“出售/出租”招牌，保持黑暗。没有任何模组时，房间保持经典的原版外观；以下每个模组都会升级城市中属于自己的部分，而你没有的模组不会带来任何变化。

家具。安装Macaw’s Furniture、MrCrayfish’s Refurbished Furniture或Fantasy’s
Furniture（任意一套：Nordic、Necrolord、Dunmer、Bone，另加 Decorations 附属模组），房间就会摆满家具：配有冰箱和炉灶的真实厨房、占两格的浴缸、沙发、带电脑的书桌、吊扇、双格高的椅子和双人床、摆满物品的架子、堆着书本、瓶子和酒杯的桌子——超过一千件模组家具，每一件都朝向正确。这个版本之后发布的 Fantasy’s Furniture 套装也能在启动时被识别并立即用于布置；APOCALYPSE 则采用阴森的骷髅、蛛网和骨堆套装。

门、窗、屋顶、围栏、楼梯和灯饰。安装以下任意模组：Macaw’s Doors、Windows、Fences and
Walls、Roofs、Stairs、Trapdoors 或 Lights（以及它的 Biomes O’ Plenty 附属模组；该模组会自动加入所有 BoP 木材），城市就会用这些建材搭建：

• 门根据建筑用途选择——住宅使用乡村风格门和现代风格门，商店采用玻璃门面，工业区则使用三到七格高的金属门和车库门，室内门也会相应搭配。
• 窗户和屋顶——带框窗户可连续拼接，设有活板门式天窗；斜屋顶与墙体木材相配，并带有檐口、屋脊、屋谷和山墙端。
• 楼梯——紧凑式和露台式台阶均配有扶手、平台和阳台栏杆，适用于住宅和办公楼梯间。
• 围栏——用尖桩围栏、树篱、装饰性金属围栏和石墙围住花园与公园；用带门的农场围栏圈起牧场；用工业网状围栏和拼板金属围栏围住建筑工地与工厂院区。
• 灯饰——街道上有路灯，公园入口有花园灯，露营地有提基火把；室内则有壁灯、烛台、吊灯和吸顶灯。

模组作者：只需在你的 jar 文件中添加两个数据文件，即可加入自制家具——详见仓库中的PALETTES.md。

世界风格

提供十三种可选风格，每种都有自己的世界类型（cityworld:<style>），也可以在自定义界面中一键切换：

自定义所有设置

CityWorld 提供约 100 项可调设置——包括生成哪些特征、生成/宝藏概率、地形开关、城市半径、腐朽程度，甚至村民名称和生物列表。由于设置按世界单独保存，因此它们以数据包形式提供，而不是全局配置：你可以手动编辑，也可以使用游戏内的自定义界面进行设置，并通过/cityexport导出所需设置。自定义界面还可将设置保存为命名预设（位于config/cityworld/presets/），以便在下一个世界中重复使用。

→ 完整设置参考、示例数据包和指南（村庄及其他原版结构、更温和的末日、稀疏城市、自定义村民名称、更高的摩天大楼等）：sablecraft.co.uk/cityworld-reforged

其他模组的方块也能用来建造城市

CityWorld 的建筑调色板使用的是方块标签，而非固定列表。模组只要按常规方式为方块添加标签——木板放在 #minecraft:planks，石头放在 #c:stones——安装后，这些方块就会立即出现在城市中，无需补丁或兼容包。随着调色板扩展，各方块出现的概率仍保持不变，因此模组装得很多的世界会有更多变化，而不是更多木屋。对于没有给方块添加标签的模组，或是想把某个模组的方块放到它们通常不会出现的位置，只需用一个小型数据包直接扩展任意调色板。

更朴素的城市，不送免费铁：中性调色板附加包

适用于生存整合包，或任何想要更朴素城市的玩家：CityWorld: Neutral Palette附加包 jar 仅使用天然木材、石头、深板岩和陶瓦建造。建筑中不会出现铁、金、钻石、绿宝石、青金石或铜块；彩色羊毛会替换为木板，混凝土会替换为陶瓦，染色玻璃会替换为普通玻璃。所有世界风格都适用，包括末日风格。将它放入 modsCityWorld 旁边（版本需为 5.19.0 或更高）。它本质上是一个普通数据包，因此整合包作者可以修改任意替换规则。
→ 从 GitHub 下载

以及你的生物群系模组

安装Biomes O’ Plenty——或任何基于TerraBlender构建的模组（Oh The Biomes We’ve Gone、Nyctophobia、VanillaBackport……）——其生物群系就会在所有版本的 CityWorld 世界中生成。可不只是寥寥几个：安装 BoP 后，其全部 59 种主世界生物群系都会出现，覆盖大约三分之一的地表，其余区域仍由 CityWorld 命名。洞穴生物群系会出现在地下应有的位置；而外观取决于其地面的生物群系——如砂砾海滩、火山平原、盐碱荒地——会使用对应的真实方块，而非以草方块代替。

会改写原版世界预设的数据包生物群系模组——Terralith、带有 Grand Terrain 的Dreamwoods——也会以同样方式作用于 CityWorld 的陆地，并为原版陆地提供地形（world.packPreset）。Regions Unexplored和其他 Lithostitched 模组则会作用于原版陆地。模组生物群系会以合适的片区生成（world.moddedBiomeGrain），而模组结构也可以限制在荒野中：在 Customize 中选择“Structures: only in the wild”，或按组设置数据包的#cityworld:wilderness_only标签

。默认开启，因为安装生物群系模组本身就代表了需求。world.moddedBiomeShare用于设置模组最多可占据多少地表，world.useModdedBiomes则可彻底关闭此功能；如果没有安装这类模组，两项设置都不会产生任何影响。

农场也能种植模组作物

作物和花卉也通过标签识别，因此Farmer’s Delight的卷心菜、洋葱和番茄，以及生物群系模组的野花，都会在 CityWorld 的田地中生长；它的水稻也会拥有专属的灌水稻田。双格高作物也能正常生长——Biomes O’ Plenty 的大麦就会长到完整高度；若某种植物无法在播种处存活，系统会悄悄将其替换为适合生长的植物，因此田地不会出现空缺。

命令

/cityinfo会告诉你脚下是什么，包括街道名称；/cityfind//cityfind lot//cityfind street//cwlocate可查找指定的建筑、地标、街道或生物群系；/cityschem可手动粘贴目录中的建筑；/cityexport可打包世界设置，方便交给服务器使用。

每条命令都是一个 权限节点（cityworld.info、.teleport、.find、.schematic、.export），因此可以通过 LuckPerms 或任何 NeoForge 权限管理器授予玩家查找和跳转世界的权限，而不必授予粘贴建筑蓝图的权限。如果没有安装权限管理器，则一切保持不变：默认权限仍是这些命令一直使用的管理员等级。

→ 每条命令均附带用法示例：sablecraft.co.uk/cityworld-reforged

运行要求

CityWorld 支持六个 Minecraft 版本，涵盖两种加载器。下载适用于你的版本的文件即可——文件名中标明了 Minecraft 版本，不必猜哪个文件对应哪个版本。

使用相同的种子，六个版本都会生成相同的城市。城市布局——地形、道路、区域划分以及每栋建筑的位置——在所有版本中都完全一致；只有材料略有变化，因为较新的 Minecraft 版本会为建筑素材库带来新方块。每个版本都会在发布前自动验证：生成真实世界，并检查城市、标牌和生物群系是否正确生成。

兼容模组

已针对以下模组测试 CityWorld。它们全都是可选的：CityWorld 不依赖其中任何模组，全部不安装也不会有任何变化。

内置支持——安装这些模组后，CityWorld 会使用它们：

协同兼容：

按设计可用，但未经逐一测试：任何模组的结构都可以在「结构」页面中启用；任何TerraBlender生物群系模组的生物群系都会加入世界；任何按标准方式为方块、作物和花朵添加标签的模组，其内容都会被生成和种植。如果你使用的内容在 CityWorld 世界中运行异常，请在评论区告知。

鸣谢与许可

CityWorld 采用GPL-3.0-only许可。

• 原版CityWorld Bukkit 插件由DaddyChurchill开发——原作者知晓此移植版本，并已表示认可。
• 此 NeoForge 移植版及 1.20.1 Forge 版本由Sablednah开发，作为衍生作品继续遵循 GPL-3 许可。
• 地形噪声代码取自 Bukkit（GPL-3），而 Bukkit 中的代码改编自 Stefan Gustavson 的公有领域 simplex 算法。

完整文档、截图和指南：sablecraft.co.uk/cityworld-reforged
源代码、问题追踪器和完整移植历史：请参阅 GitHub 仓库。