
LibVilNam
跨模组村名生成兼容库。“欢迎来到[此处填入你的村名],村长大人!UwU”
LibVilNam
跨模组村庄名称生成兼容库。
欢迎来到 [此处填入你的村庄名称],村长大人!UwU
我到底在看什么鬼东西?
LibVilNam 是一个村庄名称库(其实这只是它的名字,只不过遵循了 Linux 命名惯例,所以所有东西都被缩短到最多 3 个字符,而且“Library”放在前面而不是后面——就像“C Library”变成“LibC”那样),其他任何模组都可以用它来以跨兼容的方式为村庄附加名称。
这到底是什么意思?
想象一下,你有一个模组会在村庄里放置某种交通标记(也许交通方式是步行,标记是小地图路径点;也许是传送石模组;也许是连接到程序化生成网络的火车站),而另一个模组会在你进入村庄时欢迎你(也许类似 Traveller's Titles,但针对村庄;也许基于告示牌)。那么,如果那个模组说“欢迎来到 (村庄 X)!”,而交通标记也叫“(村庄 X)”,岂不是非常美好?不幸的是,目前这还无法实现。
……除非该模组集成了 LibVilNam! 没错!受够了大模组包里多个模组给出相互冲突的村庄名称?我们来救场了!LVN 提供了一个库,其他模组作者可以接入,使他们模组的村庄名称与所有同样支持 LibVilNam 的其他模组保持一致(见下方列表)。在某些情况下,模组本身甚至不需要直接支持 LVN,因为我们维护了一份目前尚短(但稳步增长)的官方集成列表,针对热门模组,我们在 LibVilNam 内部自行维护支持。
你只有一个村庄命名模组?LibVilName 也同样有用!大多数名称生成模组只是盲目地把一个形容词/名词和一个类城市词汇拼在一起,从中组成一个名字(例如 Sunnyvale、Steamtown、Icetopia 等)。这没问题,但很快就会变得重复无聊。LVN 使用一种不同的技术,叫做马尔可夫链,它有点像一个小型 LLM(好吧,如果它很小,那就不再是大型语言模型了,但你懂我的意思)。它在提供的数据集上训练对给定语言如何连接音节的理解(关于如何提供数据集,见下方“配置 LibVilNam”),然后尝试从中外推。这一切意味着你可以得到听起来更真实、更独特的名字,而且你对生成名称的风格有很大的控制权(只需使用不同的训练数据集),让你可以相当容易地改变例如语言,甚至回到那些旧的重复名称(如果你出于某种原因喜欢它们的话)。[ 注意,马尔可夫链不支持任何花哨的 LLM 优化概念,比如注意力机制(它是每个现代聊天机器人的核心),这理论上使它们在内存效率上不如 LLM(如果有人要用马尔可夫链生成一整段文字,他们需要艾字节的 RAM),但它们需要的额外内存非常少(你的数据集本身就是模型——无需将几十 GB 的模型权重加载到 GPU 中),这在实践中使它们在生成短单词序列(如村庄名称)方面远优于 LLM——得益于此,LVN 完全在你的 CPU 上本地运行,你不需要(实际上也不能)在任何地方放置任何 AI 垃圾 API 令牌。]
下载
- 从 Modrinth 下载
- 在 GitHub 上,请从源码构建或下载发行版。
- 不计划支持 CurseForge。
支持的模组
以下是支持的模组列表。如果某个模组标记为 [AUTO],则无需额外配置,它会自动拾取 LibVilNam(或 LibVilNam(或第三方集成器)拾取它)。
第一方支持
这些是直接使用 LibVilNam 的模组,要么将其作为直接依赖,要么作为一种额外的可选集成:
这里还什么都没有! 构建了一个支持 LibVilNam 的模组?请向此文件提交拉取请求,我们很乐意展示你作为我们的第一位使用者!
第二方支持
LibVilNam 本身通过 Mixin 与这些模组集成:
- Blay 的 Waystones [AUTO]
- Railways Untold [AUTO]
第三方支持
以下模组提供 LibVilNam 与其他某些模组之间的集成:
这里还什么都没有! 构建了一个支持 LibVilNam 的模组?请向此文件提交拉取请求,我们很乐意展示你作为我们的第一位使用者!
使用说明 - 面向普通玩家
LibVilNam 最基本的用法简单得令人发笑。对于大多数模组(上方标记为 [AUTO] 的那些),你只需安装 LVN 和所选的模组,就可以享受模组间共享的村庄名称了。有时,你可能需要安装一个额外的模组(上方第三方支持列表中的那些)来弥合差距,或者更改某些配置值以显式启用 LVN 支持(如果没有 [AUTO] 标记)。那是模组特定的,因此不在此处记录。
不过,对于高级用法,请见下文:
配置 LibVilNam
LibVilNam 的配置文件取决于你的模组平台。在 Forge 上,你可以在 ~/.minecraft/config/lvn-common.toml 找到它;在 Fabric 上,则是 ~/.minecraft/config/lvn.properties(两者均以 Linux 客户端通过官方 Minecraft 启动器为例——请根据你的操作系统、客户端/服务器情况和启动器自行调整)。无论你的文件在哪里,它都会包含以下键:
padding:村庄应向每个方向额外宣称多少区块作为自己的领地?这样做是为了照顾那些在村庄附近(但不在内部)生成结构的模组,比如 Railways Untold 的车站。默认为3(可配置1-5),此外还会向上取整到村庄边界框外最近的区块(核心行为,不可配置)。do_villagelike:“类村庄”结构(即那些通常有一些类人居民、看起来不像古代遗迹的结构,比如林地府邸或堡垒)是否也应该被赋予名称,还是只给真正的村庄分配名称?如果为true,将同时在#minecraft:village和#lvn:villagelike标签中查找结构;如果为false,则仅在#minecraft:village中查找。如果你想更精细地控制哪些结构算作村庄,可以使用数据包编辑上述标签。dataset:LibVilNam 训练其马尔可夫链村庄名称生成器所依据的数据集。单词以空格分隔。默认为一个生成波兰语风格名称的数据集,见下方默认值。lang:上述数据集所使用语言的连字符分隔区域代码。如果使用幻想语言,请选择一个字母表最接近的现实语言。别担心,它不需要是字母的严格子集/超集(即使普通的英语对大多数情况也足够了),只是别做太蠢的事,比如用日语数据集配希腊字母表。默认为pl-PL以匹配上述数据集。
选择数据集
默认情况下,LibVilNam 在此数据集上训练其马尔可夫链。这是一个手工整理的列表,包含超过四千个各种波兰地理地名(村庄、城市、省、乡和县——由于数据获取方式,有些词也可能是街道名称的一部分)。我们决定走这条路,而不是在美国或英国地名上训练,因为:
- 这个模组最初是为 GhostLand 8 开发的,而 GhostLand 是一个波兰社区/模组包/SMP/Discord/我其实不太确定 GhostLand 到底是什么的东西——它有点像现代 Xbox 品牌,什么都是它,同时又是一切——我们想让这一版的名称更熟悉;以此区别于之前有村庄名称的版本(6 和 7),那些版本的所有名称都是通用的美国风格(参见:上面大多数名称生成器的工作方式——巧合的是,这似乎也是美国发明其县名的方式)。我们技术上本可以只在 GhostLand 上使用这个数据集,但我花了太多时间让它可用,想展示一下。
- 我们想利用这个项目的文化优势,为用户提供一种真正独特的体验。有点像《巫师》里那样,你不会遇到在所有重复的 MMO 或抽卡游戏里都能找到的普通哥布林或史莱姆,而是受到我们当地波兰/斯拉夫民间传说启发的怪物,大多数玩家由于某种探索因素而喜欢这种设计。同样,由于作者对波兰语的熟悉(她在这里长大了一辈子),LibVilNam 生成的名称可以听起来独特地波兰化,让你探索这门语言的深度,因此应该更令人愉快。
……理论上如此。实践中,我们理解有些玩家可能不想应付必须念出“Sokołobrychodnorostrów”(*开发期间我们的生成器产出的真实名称)这种情况。因此,我们提供了使用不同数据集来改变生成器工作方式的能力。具体操作说明见上方,而在这里我想转而关注如何获取数据集。一般来说,你有两条路线:要么从当地政府下载数据库并自己整理数据(除非你的政府提供比我们更有用的东西),要么前往 SamCodes Markov,按 Settings,设置 Length Range 3-23 + Order 3 + Prior 0.00 + Backoff 0(这是 LibVilNam 使用的参数),然后开始摆弄预置数据集,直到找到一个生成的名称看起来像你想用的东西。如果你需要一个起点,我们发现他们的“Currencies”数据集会产生一些有趣的结果,看起来很适合作为某种非特定的幻想语言(至少如果你假设“Mark”在那门语言中意味着城市/城镇/村庄等,因为那个后缀似乎相当常见)。
游戏内命令
/lvn-getvillage来查明你现在在哪个村庄,以及是否在村庄里(使用所有 4 种可用的村庄定位策略)/lvn-rename来重命名你当前所在的村庄(由上述命令打印的第一种策略确定)
世界文件
LibVilNam 在重启之间将村庄名称持久化保存在 ~/.minecraft/saves/[世界名称]/lvn/[维度命名空间]/[维度 ID].csv。例如,对于位于“My Forever World”世界的 minecraft:overworld 维度中的村庄,路径将是:~/.minecraft/saves/My Forever World/lvn/minecraft/overworld.csv。
使用说明 - 面向使用者
目前还没有开发者指南或社区。我只能说使用 Modrinth Maven 添加依赖,然后查看我们在 GitHub 上的公共 API 来了解如何与之交互(它真的很简单,我保证)。API 实例可以通过 hub.guzio.lvn.internal.Main.i().getAPI() 获取(这是第一次也是最后一次有人应该接触 internal 包,因为那里其他所有内容都高度依赖平台和版本——与此同时,hub.guzio.lvn.API 中的公共方法(除其构造函数外)和 hub.guzio.lvn.Village 保证遵循 SemVer)。
许可证
- 代码和二进制文件在 MIT 许可下授权。本项目适用两个 MIT 许可证,一个管理大部分代码,另一个适用于本项目硬嵌入其内部的 Felix 的马尔可夫链库(不是通过 Gradle 的软依赖,因为他的生成器需要一些大量修改才能在这里使用(这就是为什么我也将自己列为 2026 年及以后的贡献者,这并不违反 MIT 许可证,因为原作者的版权声明和免责声明都按要求保留了),而且我不担心更新问题,因为它似乎是废弃软件)
- 是的,这意味着你可以在模组包中使用它。是的,甚至可以在 Modrinth 之外的包中使用(没错,甚至 CF——只需使用直接文件包含),不过在那种情况下(为了遵守 MIT 许可证要求),你需要通过“在衍生作品中包含其许可证”来注明此模组。理想情况下,这应该是一个简单的许可证链接,附上作者和模组的名称,直接放在你的包 README 的许可证脚注中(就像这个一样)——而不是深埋在两层 ZIP 中(先是包,然后是模组),即使那样技术上仍然算作包含。
- 不要将此模组原样重新上传(或重新编译+上传,除非作为完整分支的一部分进行了重大更改(和/或此模组被废弃而你想保持其更新))到其他主机,特别是 9Minecraft(包括病毒不算“重大更改”)或 CurseForge。不,CurseForge,我不在乎在 MIT 下它技术上有多合法*。如果你拒绝下架任何冒充者,那就让我把这一小段文字称为“具有法律约束力”吧(因为它在上面技术上写了 License,所以我们真的能确定它不如 GitHub 上的
LICENSE文件或 Modrinth 上链接的许可证有效吗?我是说……当然不是(这只是一个解释性脚注),但是——你知道——你真的能确定吗?你有多勇敢,敢跨越这片法律灰色地带的面纱,CurseForge?)然后看看你会怎样…… - 马尔可夫链的内置训练数据集在
CC BY-NC 4.0下授权。 - 标志是由 NanoBananna 凭感觉画的,因为我完全不知道*我到底想要这个项目的标志长什么样(但我还是想加点什么),更不用说我有能力让它看起来像样了。由于我对垃圾没有任何情感依恋,你可以随意处置它;我在此根据
CC BY 4.0(基本上就是图像版的 MIT)发布它。我没有选择完全CC0 公共领域的唯一原因是,以防万一这个标志最终成为某个关于 AI 的吐槽视频的 B-Roll,我希望我的项目被署名~~(听着,作为 Minecraft 模组,你得不到多少广告机会;必须绝望地采取“所有曝光都是好曝光”的策略~~,特别是考虑到实际模组是由人类制作的!,这样就不会发生“氛围编程”的恶心/劝退感)。 - 你不能直接复用 LibVilNam 名称(至少加个后缀什么的)用于任何分支或(尤其是)无关项目。
鼓励的话
*如果你恰好比我有更多想法,并且也实现了那个想法(或者只是想人性化 NanoBannana 的“想法”目前的实现——因为说实话整体设计还不错(马尔可夫字面链和一种徽章风格的设计),只是可笑地不协调(招牌上 3 个生成的名称示例中有 2 个明显不是这个模组所做的那种名称生成;链条被扭曲成了怪物;书看起来一点也不像 Minecraft)且没有灵魂),那么提交一个带有你标志的拉取请求将极其受欢迎!如果你以 CraftLDAP 风格的标志许可心态发布艺术作品,即根据 CC BY-NC-ND 4.0 授权,并愿意为善意的衍生作品降低要求(其中之一必须是 LibVilNam 本身,否则我法律上就无法使用它)或比这更宽松的许可(我只是倾向于避免不允许衍生作品的东西(尽管任何贡献都受到赞赏,我相信可以达成安排),因为我认为这违背了任何创作作品的精神——我把所有东西都发布在 MIT 下是有原因的)。
就这些!
希望你喜欢这个傻乎乎的小项目 :3
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。