这到底是什么东西
mindshaft 是一款以无障碍访问(Accessibility)为核心的小型地图模组,它将来自 Minecraft 三维空间的准密度地图转换为二维视图。从抽象的角度来看,它类似于医生和牙医通过 X 光片所看到的图像类型,尽管这里的具体规则大相径庭。
凭借对这种图形“编码”的熟悉,mindshaft 使用户能够感知原本实心地形中的发光空洞,甚至能判断这些空洞在 Y 轴上的延伸方向。
mindshaft 不是一款通用型小型地图模组。
没有路径点(Waypoints)。没有实体标记。也没有用于查看之前见过的远处地形的滚动功能。
mindshaft 为你提供局部导航数据,并尽力避免使其显得过于“作弊”(但在这方面是有局限性的)。
它存在一些已知的性能问题。可以通过配置文件进行缓解。
配置
配置文件位于 config/mindshaft-client.toml。这是一个仅客户端模组,因此没有服务器端配置。
如果你遇到微卡顿,请增加 map refresh delay(地图刷新延迟)或降低 segment processing rate(分段处理速率)。我最近在使用 Liminal Industries 版本的 Backrooms(后室)时使用的是 3 和 15。非常有趣,非常惊悚。
请注意,这会导致小地图更新变慢。
小地图可以配置在屏幕上的几乎任何位置,虽然操作略显笨拙,并且你可以在一定程度上控制全屏地图的大小。
如果你想要更多的缩放层级,只需调整 zoom level list(缩放层级列表),但请注意它不允许半径超过 7。
如果你想在游戏中运行时编辑配置,你需要安装 mrcrayfish 的 Configured 模组(遗憾的是仅在 CurseForge 上有,我在 Modrinth 上找不到对应的列表),或者任何其他尝试为标准 Forge 配置提供 GUI 的模组。
我下次发布时可能会更新默认设置以匹配这些更改,但我倾向于不发布一个 仅仅 更新默认值的版本。
你可能需要更改按键绑定,因为 WAILA/Jade/OneProbe 等模组往往会占用小键盘按键。
这东西是怎么运作的
我听说这对一些人来说很复杂,而另一些人似乎立刻就能理解。
我喜欢将其想象为关于空白空间的红色偏移和蓝色偏移注释,随着它们在 Y 轴上“远离”玩家。
关于如何理解的详细说明
mindshaft 的核心是在玩家周围的一定距离内、跨越若干高于和低于玩家的 Y 层级,标记出明亮空腔的存在。
实心方块显示为绿色,并且在扫描一列的过程中,这种绿色会叠加。这告诉你哪里是实心地形,而没有绿色(或者说实际上更深的绿色)则表明地形中存在空洞。
但这只是故事的一部分;我们还想知道隧道弯曲的方向。因此,玩家_上方_的空洞会根据其距离玩家层级的远近略带蓝色色调。而玩家_下方_的空洞也会根据垂直距离略带红色色调。
实际上,这意味着红色斑块表示向下趋势,蓝色斑块表示向上趋势,而紫红色则表示空洞既向上也向下延伸,例如垂直竖井。
但仍有一个曲折之处:我本意并非将其制作成一款作弊模组,所以我尝试提供一个简单的限制:如果方块未照亮,我们假装它是实心的。因此,除非那些空间被照亮,否则 mindshaft 不会告诉你地面下的未照亮空洞,也不会告诉你隧道是否在你上方或下方与你的位置相交。
这在实践中是什么样子的呢?嗯,这是主世界表面的视图:

这是在 Liminal Industries 的后室设定中的样子。(也在上面的视频中演示过)

为什么会有这个东西
是的,这确实令人费解。
制作原因
小型地图模组通常可用于几种不同的用途:绘制地表地形、放置标记以便日后寻找物品、发现附近的生物,有时甚至尝试在洞穴中导航。
mindshaft 的存在不是为了做前几件事,除了最后一件事。
我在处理空间推理方面有一些非常奇特的认知障碍。最极端的例子是我曾有一份工作,持续了几年,我经常(至少每月几次,有时一周内两次)会在上班路上迷路。
从我的车道到公司停车场之间只有_两个转弯_。是的,情况就是这么糟糕。
问题在于,这两个转弯都位于林区,那里没有任何具体的地标参考。街道网格?它们大部分对我来说还算合理,所以我有时能记住它们。但在茂密森林中的某条分支?不行。我需要某种自上而下的实时视图,能够在二维空间中投影路径并提供导航标记,才能可靠地在那种环境下导航,而消费级 GPS 还要再过十年才会出现。
所以这就回到了 mindshaft:我无法确定自己在洞穴中的确切位置。大多数试图提供洞穴功能的小型地图模组都是通过切片来实现的,当你上下移动 Y 层级时,它们会在这些切片之间切换。
对我来说,在地图上切换 Y 层级就像瞬移到另一个维度一样。由于生硬的过渡,我无法将这两个空间联系起来。幸运的是,有一款小型地图模组做到了我所需要的:
rei 的小地图。为什么它对我有效?它生成了一个虚假的密度图,能够提示从玩家所在位置向上和向下延伸的地形结构;在上下楼梯和斜坡时,变化是渐进的,我可以据此构建出一些关于地形连接方式的心理模型。这帮了大忙。
后来原作者销声匿迹,没有人站出来制作替代品。
好吧,作为一个有辅助功能需求且具备一定编程能力的人,我不得不自己动手为自己修复它。
以防你好奇:是的,我讨厌 Java,它确实糟糕透顶,但我得到了我需要的东西。
支持
进一步的性能提升将需要我设置性能分析工具,以精确测量性能瓶颈所在。我一直不愿费这个劲,因为目前它在配置 spoiler 块(见上文)中的设置下已经能满足我的需求。
如果有人有兴趣协助这项工作,我很乐意听取意见。不过我不指望会有人同时兼具“真正想使用此模组”和“能帮助诊断问题”这两个条件。
错误报告和特性请求请提交至 GitHub。请不要询问关于航点、实体追踪或其他“常规”小地图功能。如果你想知道现在还有哪些特性请求空间……我也一样。只要你提出令人惊喜的想法,说不定就能实现。
我只关注 1.18.2 和 1.20.1 的错误报告,并且有可能被那些对 1.12.2 同样执着的人说服,但你需要从 GitHub 获取该版本(或 1.19.2)。
鉴于我预计在 1.20.1 上仍能访问 Thaumcraft(神秘时代)和 Tinkers' Construct(匠魂),对于比 1.20.1 更新的版本,我在相当长一段时间内都不会在意。距离上次这种情况发生已经过去很久了。
移植请求将被忽略。
权限
本模组基于 MIT 许可证发布,这是一个非常宽松的许可证。尽管如此,针对某些特殊情况(以及万一用户数意外突破个位数的模糊可能性):
你可以将它放入整合包中。任何整合包、任何平台都可以。甚至不需要公开署名感谢我。
想做我不想做的事?fork 它吧,我不仅在法律上、伦理上,也在道德上给予许可。如果你对代码做了实质性修改,最好换个名字,这样比较礼貌。也许可以加个冒号和一些巧妙的后缀,比如:
- mindshaft: the motion picture
- mindshaft: the tote bag
- mindshaft: cheatery edition that just tells you where ores are
或者随便什么名字。我又不是你妈
what even is this thing
mindshaft is an accesssibility-focused minimap mod which transforms a quasi-density map from 3d minecraft space to 2d space. in abstract, it's similar to the kinds of imagery that doctors and dentists get from an x-ray, although the actual rules here are quite different.
with familiarity with the graphical 'encoding', mindshaft enables a user to perceive lit voids in otherwise solid terrain, and even which directions those voids go along the y axis.
what mindshaft is NOT is a general purpose minimap mod.
there are no waypoints. there are no entity markers. there's no scrolling to look at distant terrain you've previously seen.
mindshaft gives you local navigational data, and does its best it can to not be 'cheaty' about it (but there are limits to that).
it has some known performance issues. this can be mitigated through the config file.
configuration
the config file is config/mindshaft-client.toml. this is a client-side only mod, so there is no server config.
if you're getting microstutters, you want to increase map refresh delay or decrease segment processing rate. i've been using 3 and 15 lately, while running around in liminal industries' version of the backrooms. great fun. very spook.
be advised this causes the minimap to update slower.
the minimap can be configured to be basically anywhere on the screen, albeit clunkily, and you can control the size of the full screen map to a degree.
if you want more zoom steps, you just need to adjust the zoom level list, but be advised it won't let you go past a radius of 7.
if you want to edit the config while the game is running, you'll need the configured mod by mrcrayfish (sadly only on curseforge, no modrinth listing that i can find), or any other mod that attempts to provide gui to standard forge configs.
i will probably update the default settings to match that next time i make a release, but i'm reluctant to do a release that only updates defaults.
you probably want to change the keybindings given that waila/jade/oneprobe/etc mods tend to try to grab numpad slots.
how even is this thing.
i'm told this is complicated to some folks, others seem to get it right away.
i like to think of it red-shift and blue-shift annotations on empty space as they 'move away' from the player on the y axis.
details on how it's meant to be understood
the core of mindshaft is marking the presence of lit empty spaces within a distance around the player, across a handful of y levels above and below.
solid blocks get green, and that green adds up over the course of scanning a column. this tells you where solid terrain is, and the lack of green (or practically speaking, darker green) tells you there's voids in the terrain.
but this is is only part of the story; we also want to know which way the tunnel is curving. so voids above the player get a slight blue tint based on how far it is from the player's level. and voids below the player get a slight red tint, also based on vertical distance.
practically, this means red splotches mean downward trending, blue splotches mean upward trending, and magenta means the voids go up AND down, such as a vertical shaft.
but there's still a wrinkle: i did not actually intend for this to be a cheat mod, so i attempted to provide a simple restriction: if a block is unlit, we pretend it's solid. so mindshaft won't tell you about unlit holes in the ground, or whether a tunnel intersects with where you are from above or below, until those spaces are lit.
what does this look like in practice? well, this is a view of the surface of the overworld:

this is what it looks like in the backrooms setting of liminal industries. (also demonstrated in the video up top)

why even is this thing
yeah it's really baffling
why it was made
there's a few different things minimap mods can typically be used for. charting out surface terrain, placing markers so you can find things later, spotting nearby creatures, and sometimes even trying to navigate caves.
mindshaft exists to do none of that, all except for the last one.
i have some very peculiar cognitive issues dealing with spatial reasoning. the simplest example of how bad it is, i once worked a job for a few years, which i frequently (at least a few times a month, sometimes a couple times in a week) would get lost on my way to work.
there were two turns between my driveway and the company parking lot. yes, it was that bad.
the problem there was that the two turns in question were in wooded areas, where i had no concrete landmarks. street grids? they mostly make some sense to me, so i can remember them, sometimes. which branch in a dense forest? nope. i'd need some sort of top-down realtime view that projected the path in 2d space with navigation markers to be able to navigate that reliably, and consumer gps wasn't a thing for another decade.
so that brings us back to mindshaft: i cannot tell where the hell i am in caves. most minimap mods that try to provide cave functionality do it by taking slices, and switching between them as you go up and down in y levels.
to me, flipping between y levels on a map is like teleporting to another dimension. i can't link the two spaces together because of the hard transition. fortunately, there was one minimap mod that did what i needed:
rei's minimap. why did it work for me? it created a false density map that would give hints as to the shape of things going both up and down from from where the player is positioned; changes as you went up and down stairs and slopes were gradual, and i could build some mental model of how things were connected. it helped a lot.
then the author fell off the internet, and nobody else stepped up to make a replacement.
well, as a person with an accessibility need, and some capacity to program, it fell to me to fix it myself for myself.
just in case you're curious: yes i hate java, it sucked, but i got what i needed.
support
further performance improvements will require me to set up instrumentation to measure exactly where the performance issue lays. i've been reluctant to go through those hoops since right now it does what i need (with the settings in the configuration spoiler block up a ways block).
if someone shows up who has the interest to help with this, i'd be happy to hear about it. not holding my breath for the junction between "actually wants to use this" and "can help diagnose it", though.
bug reports and feature requests go on github. please don't ask for waypoints, entity tracking, or other "normal" minimap features. if you're wondering what that still leaves open for feature requests, well so am i. be surprising and you might get it.
i care about bug reports on 1.18.2 and 1.20.1, and can potentially be convinced by someone intrepid enough to care about 1.12.2, but you'll need to get that (or 1.19.2) from github.
anything newer than 1.20.1 isn't going to matter to me for quite some time, given that i expect to have access to thaumcraft and tinkers' construct both on 1.20.1. it's been a long time since that has happened.
port requests will be ignored.
permissions
this is released under the MIT license, which is quite permissive. but still, for the circumstances that warrant it (and the vague possibility i somehow end up with more than a single digit of users):
put it in a modpack. any modpack. any platform. you don't even need to publicly credit me.
wanna do something i don't wanna do? fork it, with my blessing all three of legally, ethically, and morally. it'd be polite if you changed the name tho if you do anything nontrivial to it. maybe give it a colon and some clever thing after it.
- mindshaft: the motion picture
- mindshaft: the tote bag
- mindshaft: cheatery edition that just tells you where ores are
or whatever. i'm not your mom
评论 0
登录后参与评分
还没有评论,来抢沙发吧