探索无限的
Minecraft 世界

考神的试炼

基本信息概览

核心缔造者：主创·李清洲 联合协作者：副创·胖橘子、副创·小柴胡颗粒 匠心打磨周期：历经两个多月的爆肝制作与精心雕琢 预计沉浸时长：主线流程约需 4 小时；若追求全内容（含主线与详尽支线）体验，预计耗时 6 至 8 小时 适配游戏版本：JAVA版 1.21.1 核心特色阐述：本作拥有深度的剧情架构，并通过小说式的叙述方式展开丰富的支线内容。在玩法上，彻底摒弃陈旧模式，引入独特的解密机制与创新的互动体验。

剧情背景概要

期末考试的阴影步步逼近，一向对学业嗤之以鼻的主角，却遭遇了情感与自尊的双重危机。在浏览“抖阳”短视频时，主角意外发现自己倾慕已久的那个女孩，竟然频繁为一个专注于分享学习干货的“学霸”点赞互动。

这对于主角而言，无疑是一记重击！为了挽回心动女生的关注，更为了重塑自己在她心中积极正面的形象，主角痛下决心：必须依靠这次期末考试的成绩来一雪前耻，实现华丽逆袭。

然而，传统的努力似乎远水解不了近渴，而传说中的“量子波动速读”不仅操作门槛高，效果也令人存疑。究竟还有没有一种方法，能让人以最快的速度掌握知识，在期末考中斩获高分？

在走投无路之际，一个荒诞却充满诱惑的念头浮现——召唤“考神”。为了那张光鲜亮丽的成绩单，这一次，即使是死马也要当活马医了。怀着忐忑与希冀，主角踏上了这场未知的试炼……试一试，或许奇迹真的会发生？

开发者寄语与设计理念

开发者在本作品中，不仅延续了前作的精良品质，更大胆引入了诸多玩家未曾体验过的“船新版本”机制。

首先，玩法层面进行了深度革新。本作致敬经典，巧妙融入了类似《泰坦陨落 2》与《羞辱 2》中的“时空切换”机制，让玩家在不同维度的场景中穿梭解谜。同时，结合近期热门的“寻找异常”类游戏元素，极大丰富了观察与互动的乐趣。

其次，在解密设计上，作者团队彻底摒弃了枯燥乏味的单纯“寻找按钮”模式。取而代之的，是与剧情紧密咬合的逻辑谜题。

最后，剧情文本经过精心润色，大量的阅读文本支撑起宏大的支线网络，等待着注重叙事体验的玩家去细细品味。

特别提示：为了营造特定的叙事氛围，地图中的部分支线剧情可能包含微恐元素；某些试炼场景可能会呈现出阴暗或阴森的视觉风格。但请各位玩家放心，开发者承诺绝对没有突脸式惊吓（Jump Scare），所有恐怖氛围仅为烘托剧情服务，请安心游玩。

探险家游玩指南

一、 关于联机与沉浸感 本地图在技术上完全支持多人联机游玩。然而，为了获得最极致的代入感与剧情体验，孤独的单人冒险往往更具沉浸力。由于游戏整体流程较长，若选择多人组队，请务必协调好各位伙伴的时间，以免中途离场影响体验。

二、 游戏设置准则 为了确保游玩过程的顺畅与机制的正常运行，请务必严格按照游戏大厅内展示的规则进行设置。尊重游戏规则，是获得完美体验的前提。

三、 阅读的重要性 本作极为重视剧情引导与线索铺设，所有的关键规则与解密提示均已详细记录在大厅及流程中的各类书籍中。请各位玩家务必平心静气，仔细阅读每一本书籍的内容，切勿遗漏。

四、 难度预期与思考 本作的解密环节设计具有一定挑战性，并非快餐式体验。保守估计通关时间在 4 小时以上，这需要玩家保持耐心，遇到难题时请仔细思考逻辑联系，享受解开谜题的成就感。

五、 心理准备 再次重申，游戏内部分支线涉及恐怖氛围的营造，虽然保证无“贴脸杀”，但仍建议胆小的玩家在进行支线任务时酌情考虑，量力而行。

沉浸式国产日式恐怖巨制：八岐物语

一、 隐匿于迷雾中的古老村落

这座名为八岐的村落隐匿于崇山峻岭的深处，四周被古木参天的森林重重包围。终年不散的浓雾如幽灵般缠绕，赋予了此地一种彻底与世隔绝的孤寂感。村落依循着险峻的山势而建，仿佛是从山崖上生长出来的一般，错落有致却又透着一股令人不安的压抑。

二、 盘踞千年的神话梦魇

“八岐”二字，直指那古老神话中的凶神——八岐大蛇。相传此地曾是那远古巨兽的栖息之所，村庄也因此得名。虽然大蛇的肉身已灭，但村民们笃信其灵魂依然盘踞在这片土地之上，默默守护着这里。村落的精神图腾是一座专门供奉八岐大蛇的神社，也是整个区域的核心建筑。

神社内部不仅珍藏着众多与大蛇相关的古老文物，墙壁上还绘有揭示神秘过往的斑驳壁画。每逢年度祭典，这里总会吸引无数好奇的拜访者，因为流言蜚语中暗示：只要获得八岐大蛇的赐福，凡人便能触及永生的禁忌领域。

三、 地图制作概况

• 游戏版本：Java版 1.20.1
• 制作团队：由开发者“凯文爱喝水”携手“逐火之蛾”团队成员共同倾力打造。
• 作品定位：这不仅是一部致敬经典的恐怖题材作品，更是一次拥有超长流程的剧情向沉浸体验。开发者致力于还原日式恐怖的细腻与压抑，打造一个完全免费的解谜世界。

四、 游玩指南与详细规格

为了确保您能获得最佳的“八岐”体验，请仔细阅读以下参数与要求：

• 核心特色：浓郁的日式怪谈风格，结合深度剧情解谜，向经典恐怖游戏致敬。
• 建议年龄：由于包含强烈的恐怖与惊悚元素，建议18岁及以上心智成熟的玩家体验。
• 人数限制：严格限制为1至2人。人多的喧闹会冲淡恐惧感，孤身一人或双人成行才是最佳的体验方式。
• 游玩时长：没有固定的通关时间，一切取决于玩家的解谜步调与探索深度，请准备好充足的时间沉浸其中。
• 终极目标：逃离这段剧情发生的诡异之地，活着返回“平田站”。
• 难度评级：★（本作更侧重于剧情演绎与氛围营造，而非硬核操作）。

五、 关键设置与素材说明

• 模式设置：请务必在非和平模式下进行游戏。和平模式将导致大量剧情触发失败，严重影响游戏体验。
• 视听体验：
  • 为了获得极致的恐怖氛围，强烈建议搭配推荐的光影包进行游玩。
  • 关于材质包的使用，请将下载后的ZIP压缩文件解压，并正确放入游戏的材质包文件夹中。
• 版权提示：本作品内的材质包含大量作者手工绘制的独家素材，凝聚了制作团队的心血。请尊重创作者的劳动成果，切勿擅自修改、提取或拷贝用于其他用途。

Minecraft 沉浸式博弈体验：梦乐园 1930 —— 赌上灵魂的最终局

来自摩根大通的催收信函仿佛一条冰冷的毒蛇，死死缠绕着那根与之纠缠不清的金质怀表链。你颤栗的指尖无力地滑过那张泛黄的破产清算单，视线却无法从那枚猩红色的火漆印记上移开——那里封印着足以将人焚烧殆尽的数字：一亿美元。

身后的门廊处，铜铃在狂风的肆虐下发出凄厉的嘶鸣，昏黄的煤油灯光摇曳不定，映照出“那个人”忽明忽暗的诡谲面容。“白人的纸钞在这个地方，连废纸都不如。”她漫不经心地抛接着手中的燧发枪弹丸，眼神越过厚重的鹿皮帷幕，落在那张泛着奇异幽绿光芒的赌桌上，语气冰冷而诱惑：“但在这里，每一个灵魂的公允市价，是二十枚金币。”

当抵押契约划过锋利水晶刀刃的那一刹那，记忆如同冰冷的潮水般涌来。你猛然回想起昨日《华尔街日报》讣告栏上那些令人心惊的条目——那些莫名失踪的银行巨鳄们。此刻，他们的名字正幽幽地浮现在那些惨白色的骨制筹码之上，在黑暗中散发着来自另一个世界的微光。

幕后制作团队

核心开发 Ran_nano | 兰那梛

动画制作 / 音乐音效 Asakura_kukii | 曲奇

模型构建 / 场景设计 Remnant_leaf | 残叶

七月回廊：1.21版本类“8号出口”风格微恐观察挑战

时间仿佛停滞，你被囚禁在一个无限循环的回廊深处。周遭的一切看似平静，实则暗藏玄机。想要逃离这无尽的七月，唯有敏锐的观察力能拯救你。

仔细甄别每一个细节，找出那些极其细微的“异常”之处。如果你能成功识破虚假，循环将被打破；如果你视而不见，你将永远在七月徘徊。通往八月的出口，就在你的一念之间。

【游戏核心设置指南】

为了确保您能获得最完美的沉浸体验并顺利通关，请务必在进入游戏前调整以下参数，这关乎你是否能察觉到那些致命的细节：

• 语言环境：请务必将游戏语言切换至 繁体中文，以确保所有线索文字能正确显示。
• 视觉亮度：请将亮度设置调整为 [明亮]，黑暗不是你的掩护，看清一切才是生存之道。
• 听觉反馈：务必开启设置中的 [音乐] 以及 [声音/语音] 选项，有些异常不仅仅是用眼睛看的，更是用来听的。
• 视野范围：推荐将视野广度（FOV）调整至 100，更宽的视野能让你不错过角落里的异样。

【地图基础档案】

• 适配版本：Minecraft Java Edition 1.21
• 游玩人数：严格限制单人游玩（多人联机会导致逻辑判定失效，请独自面对这段旅程）。
• 预计耗时：约 10 分钟以上（具体时长取决于你的观察力与心理素质）。

《耐刺王v1.0》：欢乐无限的多人竞技场

游戏概览

欢迎来到《耐刺王v1.0》，这是一款集生存、追逐与策略于一体的多人互动小游戏。在这里，身份的转换就在一瞬之间，唯有敏捷的身手和精准的判断才能助你登上胜利的宝座。

核心玩法：谁是耐刺王

本模式的核心机制围绕着唯一的头衔——“耐刺王”展开。系统每隔一段时间会随机指定一名玩家成为当前的“耐刺王”。作为这一焦点角色，首要任务是在其他玩家的围追堵截中通过灵活的走位进行躲避；只要在任期内成功存活，就能源源不断地获取积分。反之，对于其他追猎者而言，成功击杀当前的“耐刺王”则是获取大量积分的关键途径。

为了增加博弈的变数，“耐刺王”持有一把特殊的钥匙。这把钥匙是开启地图上随机降落的空投补给（表现为放置在钻石块上的木桶）的唯一凭证，通过开启空投，玩家可以获取足以扭转战局的强力道具。然而，战场的局势瞬息万变，猎人与猎物的身份随时可能发生“两极反转”，请务必时刻保持警惕。

为了保证游戏的公平性与竞技性，当“耐刺王”的身份发生更替时，新上任的玩家将会获得持续2秒的高亮发光效果，同时其ID将清晰地显示在屏幕上方的状态栏中，供所有玩家确认目标。

进阶挑战：附属疯狂模式

如果你渴望更纯粹的速度与激情，那么“疯狂模式”将是你的不二之选。在这一模式下，由于机制的特殊设定，传统的躲藏战术将彻底失效。

为了平衡对抗强度，当前的“耐刺王”将被赋予极高的移动速度，化身为战场上的幽灵；而所有的追杀者则解除了弹药限制，拥有了无限的箭矢供应，可以进行铺天盖地的火力压制。更令人血脉偾张的是，“耐刺王”在此模式下将处于持续发光状态，且脚下伴随着醒目的粒子效果。这意味着没有任何阴影可以提供庇护，唯有不断的奔跑才能生存。

战场地图

为了丰富玩家的视觉体验与战术选择，本游戏精心设计了三张风格迥异的地图：

一望无际的胜利平原，适合直线追逐与正面交锋。 地形复杂的淘金小镇，提供了丰富的掩体与巷战机会。 寒风凛冽的雪地小屋，在冰雪覆盖的环境中考验玩家的操作。

版本与制作信息

适用游戏版本：Java版 Minecraft 1.20.4 制作团队：本作品由作者“小q叫qwq”与“柠夕”联手打造，并汇聚了多位Bilibili UP主的创意与贡献。

游戏大师提示

为了确保游戏脚本的正常运行，避免出现未知的系统错误或逻辑漏洞，强烈建议所有参与者将游戏模式设置为冒险模式。如果在游玩过程中遇到任何非预期的Bug，欢迎随时向作者反馈，您的建议将帮助我们不断完善游戏体验。

解密地图：归家

风格定位：轻松 / 欢愉 / 中型解密

地图背景与剧情概要

那是一个惬意悠闲的清晨，阳光似乎都带着慵懒的味道。常年在外打拼，春节也没能赶回家团聚，这回好不容易从苛刻的老板手中抠出了宝贵的三天假期。行囊已整，身心俱疲的你只想立刻飞奔回温馨的小窝，享受片刻的安宁。

然而，正当你踏出房门的那一刻，生活给你开了一个荒诞的玩笑。一系列匪夷所思的事件接踵而至……等等，邻居老王家的儿子为什么要千方百计阻挠我回家？为了踏上这段归途，堂堂大人的你，竟然不得不被一个小屁孩牵着鼻子走，被迫卷入一场斗智斗勇的闹剧之中。

游玩时长预估： 约 40 分钟 地图制作周期： 历时约 2 个月（于 2025 年 2 月完工）

核心游玩指南与配置要求

为了确保您获得最流畅的解密体验，请务必仔细阅读以下参数设置：

1. 游戏核心版本： 必须使用 Minecraft Java版 1.20.6 至 1.21.1 之间的版本，以防止出现红石机关失效或方块材质错误。
2. 游玩人数设定： 本图专为单人沉浸式体验设计，虽然理论上支持多人联机，但可能会影响剧情代入感。
3. 视距优化设置： 强烈建议将渲染距离和模拟距离均调整为 8 或更低。这不仅能提升帧率，还能防止因区块加载过远而提前看到某些机关，保持解密的神秘感。
4. 难度预警： 本地图的解密难度属于较难级别，极为考验观察力与逻辑思维。作者贴心地建议大家在游戏开始时就领取攻略书，以免在途中卡关到心态崩溃！

作者创作手记：重制与革新

在这个充满快餐文化的时代，看到许多经典的地图焕发新生，我心中也萌生了重制旧作的念头。于是，我投入了大量的心血与时间，终于将这幅名为《归家》的作品重新打磨完毕。

这次重制绝非简单的材质升级，而是对核心玩法的深度重构：

• 剧情逻辑的完善： 修复了原版中许多不合理的剧情漏洞，强化了故事的连贯性，让玩家的行为动机更加合理。
• 玩法的创新尝试： 我试图打破传统解密地图中那种枯燥乏味的“死循环”——即无休止地翻箱倒柜找钥匙、试错开门。在本图中，寻找“钥匙”不再是折磨玩家的手段，关键道具往往放置在更显眼、更符合逻辑的位置。
• 解密与叙事的融合： 我将重心转移到了如何将多样化的玩法机制与解密过程有机结合起来。

这不仅是一次地图的更新，更是我对解密玩法新方向的一次大胆探索。如果您厌倦了传统的找钥匙游戏，不妨来试试这张充满诚意的作品。如果它能博得您的一笑或赞赏，那便是对我最大的支持。

告别枯燥PVE！Minecraft全新神作《隙不可逾》带来剧情与玩法的双重震撼

探索未知的深渊

你是否已经对千篇一律的传统PVE模式感到乏味？那么，这款将剧情张力与硬核玩法完美融合的殿堂级地图——《隙不可逾》，绝对能重新点燃你的冒险之魂。

故事始于一场令人绝望的意外。你们的星际飞船不幸失控，最终坠毁在一颗触目惊心、看似早已被岁月遗忘的极寒星球之上。刺骨的暴风雪中究竟隐藏着什么？这座荒芜星辰的深处又埋葬着怎样的过往？作为幸存者的你们，能否在这个危机四伏的严酷环境中顽强求生，并一步步揭开尘封在这个异星世界背后的所有谜团？

然而，这绝不仅仅是一次轻松的星际观光。《隙不可逾》本质上是一款极度考验团队默契的神级高难度挑战地图。面对接踵而至的险境与残酷的机关，单打独斗往往只会让人陷入死局。唯有与同伴紧密协作，将团队配合发挥到极致，大家才能在这无情的冰天雪地中觅得一线生机，从而逾越那看似不可跨越的绝境之隙。

幕后缔造者与汉化团队

如此精彩恢弘的冒险世界，离不开创作者们的精心雕琢。 地图原作者：Ash 携手 Chaoticlmme 共同倾力打造，为我们构建了这个迷人的科幻世界。 与此同时，为了让中文社区的生存者们获得最纯粹的沉浸式体验，特别感谢汉化团队的辛勤付出。翻译名录如下：Kuang_Dao、Idoniate ID、好耶老淦、Rain_G 以及 渔泽。正是他们夜以继日的努力，彻底扫清了剧本探索中的语言障碍。

游玩前置指南与硬核须知

为了保证这段星际之旅能够完美运行，请各位探险家严格遵守以下游玩配置要求：

核心运行版本：必须且只能使用 1.20.4 客户端进行加载！这一点极其关键，使用任何其他版本都将不可避免地导致底层命令崩溃或地图机制完全失效。

性能优化建议：来自汉化团队的 Kuang_Dao 强烈建议大家在启动前额外安装 Optifine 模组。在顺利进入地图后，请务必前往客户端的视频设置界面，手动将“天气/下雪”的渲染效果彻底关闭。这一个看似微小的操作，将会极其显著地提升你在复杂场景下的游戏帧率，从而带来丝滑顺畅的战斗体验。

推荐联机人数：本星际任务支持 1 至 6 名玩家共同挑战。尽管你可以选择成为孤胆英雄，但我们依然强烈建议你召集好友组建满编小队。因为在这片荒芜之地上，参与探索的玩家数量越多，整个异星求生与解谜的互动乐趣就会越发完整，游戏体验也必将达到最佳状态。

高能警示

本探险旅程含有极高强度的惊悚体验，包括但不限于突如其来的惊吓（Jump scare）、令人窒息的追逐战、战栗恐怖的音效设计以及其他各种心理压迫元素。心理承受能力较弱者，请在进入前做好充分的心理建设，或谨慎尝试。

档案记录：往日 The Past

独立创作者：悟灵爱恰饭

探险家技术指南

为了确保您获得最完美、无错误的沉浸式体验，请严格遵守以下环境配置要求：

运行环境

• 游戏版本：仅限 Java版 1.16.4 至 1.16.5。

视觉增强特别说明

• 严禁使用 Optifine：本图不支持 Optifine，强行使用极大概率导致贴图错误或机制失效。
• 正确光影方案：如果您希望开启光影效果，请务必安装 Iris 模组 进行加载。

人数限制与协作守则

• 队伍规模：支持 单人独行 或 双人协作 [1 ~ 2人]。
• 三格定律：若选择双人游玩，请务必与你的同伴保持极近的距离。全程请严守3格以内的间距，切勿擅自离队或落单，否则后果难料。

声响校准（至关重要）

• 本图的音效叙事极为重要，请严格按以下参数设置音频：
  • 音乐（Music）：关闭 / OFF
  • 主音量（Master Volume）：70% ~ 80%
  • 音符盒（Jukebox/Note Blocks）：必须设置为 100%
  • 注：音符盒承担了游戏内绝大部分的关键音效与环境氛围，请务必拉满。

反馈通道

• 如在探索过程中遭遇任何时空异象（Bug）或对地图机制存有疑问，可联系反馈专线：979961074。

档案包内容

请解压下载后的文件包，您将获取以下关键物资：

1. 往日 The Past 地图文件
2. 专属宣传海报
3. 探险家必读手册

剧情梗概

一切始于一份看似寻常的夜班差事。

穿过那条幽暗深邃的森林小径，你终于找到了那家隐蔽的店面。然而，随着工作的深入，这片森林掩盖下的一起陈年事故逐渐浮出水面。不知不觉间，你已被卷入了这场名为“往日”的漩涡之中。

混乱的记忆碎片开始侵袭你的感官。这段并不属于你的“往日”，究竟是属于谁的悲剧？而在层层迷雾与恐惧的纠缠下，你是否具备足够的勇气与智慧，摆脱这些梦魇般的困扰，重获自由？

Architectury API：构建多平台模组的桥梁

这是一个旨在简化多平台模组开发流程的中间层 API。

这是一个旨在简化多平台模组开发流程的中间层 API。

Architectury API 究竟是什么

Architectury API 的核心本质是一个用于抽象化 Fabric API 和 Forge API 调用的接口库。众所周知，这两个主流加载器虽然在实现相似功能时往往殊途同归，但其底层的代码实现却大相径庭，而本 API 便是为了消除这种差异、统一调用接口而生。

Architectury API 保持着极高频率的更新节奏，源源不断地引入新的钩子（Hooks）和特性以适应版本变化。截至目前，该库已囊括了超过 90 个事件钩子，并提供了针对网络发包、加载器调用以及游戏注册表的抽象层。除此之外，它还提供了一个极易上手且功能强大的 @ExpectPlatform 注解（需要注意的是，该功能目前仅适用于静态方法），这进一步简化了跨平台逻辑的编写难度。

我真的非要使用这个 API 不可吗？

这取决于您的具体需求。需要明确的是，Architectury API 仅仅是宏大的 Architectury 生态系统中的一环，真正赋予多平台构建能力、在幕后运筹帷幄的是 Architectury Plugin（Gradle 插件）。

对于构建在 Architectury 架构上的项目而言，本 API 实际上是可选的。这意味着，您完全拥有选择的自由，可以仅凭 Architectury Plugin 来创建您的 Architectury 项目，而不强制依赖此 API 库。

选择 Architectury 的优势

• 完全开源：透明的代码库，允许开发者深入研究与贡献。
• 代码精简：它能显著减少多平台模组开发中那些冗长且重复的“样板代码”，让您的代码结构更加清爽、高效。

开启您的多平台模组开发之旅

若您已准备好踏上多平台模组开发的征途，以下核心组件与资源将是您的得力助手：

Architectury Loom 这是 Fabric Loom 的一个分支版本，经过特别改造与增强，专门增加了强大的多平台开发能力。

Gradle Plugin 这一组件包含了 Architectury Injectables，它是实现 @ExpectPlatform 注解功能的关键所在，也是整个构建流程的核心插件。

Example Mod（示例模组） 这是一个曾经使用 Architectury 构建的示例模组仓库。请务必注意，该示例目前已停止维护，为了获得最佳的开发体验，建议优先使用下方的模组模板。

Mod Templates（模组模板） 这是一套现成的、结构完整的模板集合，旨在帮助开发者以最快的速度启动项目，并熟练使用 Architectury 工具链。

Xaero的小地图 (Xaero's Minimap)

这款模组能够在你的屏幕角落展开一副详尽的战术图表，实时显示周边的地形地貌、玩家动向、生物群落以及各类实体信息。它赋予你创建“路径点”的能力，指引你从容寻回曾经涉足的地点。

警示：切勿将 XaeroPlus 与本模组混用！

请务必注意，XaeroPlus 并非本人开发，且与官方毫无关联。该第三方插件会引发难以追踪的严重错误乃至游戏崩溃。更令人担忧的是，据称它与某些服务器破坏团伙存在瓜葛，这可能会导致你在服务器中的建筑成果面临极大风险。

与市面上众多同类模组不同，Xaero的小地图极其注重保留 原版 Minecraft 的美学风格，旨在成为游戏界面中浑然天成的一部分，而非突兀的附加组件。值得一提的是，它是 Minecraft 历史上首个采用旋转方形设计的地图模组。在极其丰富的自定义选项中，你依然可以选择传统的 圆形地图，或者设定 锁定地图旋转（转而使用方向箭头来指示方位）。

雷达系统能够以 自定义颜色的圆点 或 图标（通常是头像） 的形式，精准显示周围的实体，涵盖 玩家、生物及掉落物。除了提供基础的 指南针方位，你还可以自行部署 路径点，这些标记将在小地图和游戏世界中同步显现。路径点不仅能助你重返旧地或抵达特定坐标，更支持 传送功能。此外，该模组具备透视能力，能够显示地表之上的结构以及地下的深邃环境（即 洞穴模式）。

这仅仅是该模组众多特性中的冰山一角。为了全面了解其潜能，请详细阅读下方的“小地图特性”章节。为了适应多人服务器的规则环境，本模组提供了两个版本：完整版与公平竞争版（Fair-play），后者专为公平 PVP 环境设计。本模组主要在客户端运行。将其安装在服务端并非必须，但能解锁诸如“世界识别”等额外功能。

特性概览

• 完美复刻原版 Minecraft 的视觉风格。
• 提供多种小地图尺寸选项，包括自动调整模式。
• 具备多级缩放功能，视野掌控随心所欲。
• 两种地图形状可供选择：方形或圆形。
• 性能优化卓越，运行流畅度超越市面上绝大多数同类竞品。
• 通过“更改位置”设置，你可以将地图安置在屏幕的任意角落。甚至支持以 1 像素为单位的微调，这在与其他 UI 模组共存时尤为实用。
• 两种方块颜色模式：原版模式（采用原版地图颜色）和 精准模式（直接采用方块纹理和生物群系的颜色）。你还可以在原版模式下单独开启生物群系着色。
• 支持自定义按键（默认为 Z 键）暂时放大地图，以便更清晰地观察周围环境。所有按键绑定均位于原版控制菜单中。 此外，你还可以定制放大时的行为，例如让地图居中显示或自动切换至最大缩放级别。
• 通过“地形深度”和“地形坡度”设置，你可以自定义地图的阴影效果，增强立体感。
• 与 Xaero的世界地图 (Xaero's World Map) 完美兼容。默认情况下，它会直接调用世界地图模组生成的纹理，而非重复加载，从而在使用双模组时显著提升性能。
• 支持服务端配置，并提供游戏内 UI 界面。你可以实时管控服务器上玩家使用模组的权限。支持基于等级/权限系统的管理（xaero.minimap.enforced_server_profile），兼容 FTB Ranks、Odyssey Roles、LuckPerms 以及通用权限 API。
• 支持通过绑定特定物品来限制小地图的使用。例如，在配置文件中添加 minimapItemId:minecraft:compass，即可实现只有当玩家在快捷栏持有或装备指南针时，小地图才会显示。
• 引入药水效果机制，用于控制服务器/地图中玩家的小地图功能权限。目前支持的效果包括：xaerominimap:no_minimap（禁用地图）、xaerominimap:no_entity_radar（禁用雷达）、xaerominimap:no_waypoints（禁用路径点）、xaerominimap:no_cave_maps（禁用洞穴图）。这些效果默认为中性，但你也可以通过在 ID 后添加 _harmful（如 xaerominimap:no_entity_radar_harmful）将其指定为有害类型。
• 已被翻译成多种语言，打破语言壁垒。
• 支持 锁定北方 选项，停止地图旋转，转而用箭头指示角色朝向。
• 得益于 自动洞穴模式，无论是地表还是地下探索均能应对自如。该模式在进入建筑物内部时也应能自动激活。你可以自定义触发洞穴模式所需的“实体屋顶”尺寸。例如，设置 3x3 及以上的屋顶尺寸，可以防止你在砍树站在原木下时误触洞穴模式。
• 路径点系统。支持创建几乎无限数量的路径点。若拥有传送指令权限，可直接传送至路径点。这些标记将在游戏世界内渲染并在小地图上高亮。你可以隐藏全部或特定的路径点。按 B 键创建新路径点，按 U 键列出所有路径点。在列表中，你可以管理单点或多点，进行排序，或查看其他子世界/维度的路径点。
• 局部与全局路径点机制。 为了避免屏幕杂乱，你可以创建受“最大绘制距离”限制的局部路径点。这允许你为大区域设置一个全局路径点，而在区域内部设置多个局部路径点。当你超出绘制距离时，仅全局路径点可见。
• 路径点集管理。 你可以通过将路径点归类到不同的“集”中来组织它们，并通过按键快速切换当前的路径点集。所有按键绑定均在原版控制菜单中。
• 路径点分享功能。 你可以在游戏聊天栏中与服务器上的其他玩家分享你的路径点，此操作在路径点列表（按 U）中进行。
• 死亡标记。每次角色死亡时，系统会自动在死亡地点创建一个 骷髅形状的路径点。旧的死亡点会自动转换为普通路径点，如果不希望保留，可以通过“保留旧死亡点”设置将其禁用。
• 支持显示来自 Open Parties and Claims 模组的区块声明和盟友玩家。
• 可切换的 区块网格。网格线将清晰标示区块的起始与结束位置。
• 可切换的 史莱姆区块 模式。能够生成史莱姆的区块将覆盖绿色显示。
• 自定义光照覆盖层。你可以设置一个光照覆盖层，用自定义颜色标记特定光照范围内的方块（默认为 0 到 7）。此功能本来用于寻找怪物生成的温床，但你也可以将其用于任何用途。
• 多人游戏中的多世界检测。若在服务端同时也安装了本模组，每个服务器世界不仅会有独立的世界地图，还将拥有独立的路径点“子世界”。若未能安装服务端模组，则会采用基于世界出生点的可靠性较低的分离方案。如果服务器只有一个“单一世界”，建议关闭多世界检测。此选项位于 路径点菜单（按 U） -> 选项 界面。
• 生物雷达：在地图上将 生物 显示为 黄色圆点。敌对与友好 生物可配置 不同颜色。亦支持显示为 图标/头像。请查阅 “实体雷达” 设置。
• 玩家雷达：在地图上将 玩家 显示为 白色圆点或玩家头像。亦支持显示为 图标/头像。请查阅 “实体雷达” 设置。
• 物品雷达：在地图上将 掉落物 显示为 红色圆点。请查阅 “实体雷达” 设置。
• 显示所有 其他实体（如箭矢和物品展示框）为 紫色圆点，且支持在设置中禁用特定类型的实体。请查阅 “实体雷达” 设置。
• 在“实体雷达”设置中，提供 在小地图上显示实体名称 的选项。
• 支持放大和缩小按键 （默认为 I 和 O），以便高效调整缩放级别以适应你的使用场景。
• 小地图下方显示 坐标。
• 小地图下方显示 当前生物群系名称。默认禁用，需在设置中开启（按 Y）。
• 小地图下方显示 光照等级。同样默认禁用，需手动开启。
• 小地图下方显示 当前游戏时间。默认禁用，支持 12 小时制和 24 小时制。
• 小地图下方显示 当前视角角度。默认禁用。
• 支持一键隐藏/取消隐藏所有界面中的路径点坐标，这对于直播或视频录制非常有用。
• 支持完全隐藏/取消隐藏下拉菜单中提及的所有服务器地址。默认设置为“部分隐藏”，这在大多数情况下能够提供足够的隐私保护。
• 海量设置选项。功能繁多，不胜枚举。请在游戏中按 Y 键打开设置界面亲自探索。
• 两个模组版本：完整版与公平竞争版。完整版 功能无限制。公平竞争版 不显示任何实体或洞穴地图，更适合与不使用小地图的玩家进行 PVP 对抗。

常见问题解答 (FAQ)

为何路径点传送功能对我失效？

造成此现象的原因可能多种多样。该模组通过发送聊天命令来执行传送操作，默认指令为 /tp @s x y z，因此你必须拥有相应的权限。原版的 /tp 命令通常需要管理员权限（作弊开启），但在非原版服务器上，通过特定插件可能拥有独立的命令权限。如果是指令不匹配，你可以在小地图设置中的“默认传送命令”选项，或在路径点菜单的“传送聊天命令”选项中（针对特定服务器）进行更改。非原版传送指令通常不支持 @s 这样的选择器，因此你可能需要从配置的命令中移除它。此外，世界地图上的右键传送使用的是另一套独立设置，详情请参阅世界地图说明页面的 FAQ。

如果“传送”按钮呈现为灰色禁用状态，这也暗示了多种可能性。最常见的原因是你正在尝试使用并非来自当前“自动（auto）”子世界、但同属一个维度的路径点。如果当前的“自动”子世界并非你应该使用的那个，请手动选中正确的子世界，并在路径点菜单的选项中点击“设为自动子世界（Make Sub-world Auto）”。这将交换两个子世界的数据，使你能够传送到现已归入“自动”子世界的路径点。

若“自动”子世界选择无误但按钮依旧禁用，那很可能是服务器或该世界手动禁用了传送功能。请检查路径点菜单选项中的传送开关。如果确被禁用，你只能通过修改游戏目录下 xaero/minimap（旧版本为 XaeroWaypoints）文件夹中的服务器特定配置文件来启用它。强烈建议在编辑任何配置文件前退出 Minecraft，并养成定期备份的习惯。

为何我的路径点在特定服务器上神秘消失了？

请保持冷静，你的数据几乎肯定没有被删除。如果你同时使用了世界地图模组且地图也发生了重置，请务必先参照世界地图描述页面 FAQ 中的 “为何我的世界地图在特定服务器‘重置’了？” 一节进行恢复。如果已完成该步骤，请继续阅读。

首先，按 U 键打开完整的路径点菜单（若 U 键无效请检查原版控制设置）。浏览右上角下拉菜单中列出的子世界。当前服务器地址的所有路径点子世界都应罗列于此。如果其中没有任何一个包含你当前所在维度的数据，那么很可能是服务器地址发生了变更。请在 左上角 的下拉菜单中找到旧的服务器地址，选中它，然后执行 选项 -> 设为当前世界/服务器（Make World/Server Auto）。此时，你应该能在右上角的菜单中找到正确的子世界了。如果该子世界已被标记为 (auto)，意味着它已被自动选中，那么问题应当已解决。若标记为 (auto) 的是错误的子世界，请继续阅读。

<ins>正在使用世界地图模组？</ins> 导致错误子世界被自动选中的最常见原因之一，是在多人游戏中未能正确使用世界地图模组（自 1.6 版本起）。请务必在确认前为当前世界选择正确的地图，这直接决定了哪些路径点会对你可见。地图选择菜单位于世界地图界面的左下角图标（除非默认已打开）。如果服务器环境允许，建议将地图选择模式更改为自动模式之一。 你当前确认的地图决定了哪个路径点子世界被视为“自动”。这允许每个创建的地图拥有独立的数据。在任何时候，你都可以通过路径点菜单（按 U）右上角的下拉列表查看非自动的子世界。若要将任意子世界绑定到当前地图并设为自动，请选择 选项 -> 设为自动子世界。

<ins>未使用世界地图模组？</ins> 如果错误的子世界被视为 (auto) 并自动选中，这通常是由于服务器插件改变了原版指南针的行为，从而干扰了模组的“多世界”检测功能（如果已开启该功能，默认是关闭的）。在此类情况下，指南针通常指向玩家床的位置而非世界出生点。如果是睡在另一张床上导致路径点消失，只需重新睡回原本的床通常能修复问题。 如果是由于新添加的插件导致（且无法移除该插件），你可以按以下步骤恢复路径点：

1. 在路径点界面的右上角下拉菜单中找到包含你所需数据的正确“子世界”（先从主世界尝试）。
2. 使用 选项 -> 设为自动子世界。
3. 对每个维度重复此操作（操作前需先进入对应维度！）。
4. 如果这是一个简单的单世界服务器（没有大厅世界、小游戏世界、创造地皮世界等），请在同一 选项 菜单中关闭“多世界检测”。日后若有需要，可随时重新开启。

如有疑问，请随时联系我！

如何添加自定义实体图标或覆盖默认图标？

首要前提是：请确保你已在 小地图设置 -> 实体雷达类别 中启用了实体图标/头像显示，无论是设为“总是”还是“玩家列表”。你必须先知道如何显示它们，本节内容才对你有意义。

从模组版本 21.6.0 开始，你可以通过制作资源包（或将其包含在你自己的模组中）来用自定义精灵图/图像覆盖实体的默认图标。此外，你还可以通过编写简单的模组或代码，为实体变体（即同一种实体的不同形态拥有不同图标）添加或改进支持。不过，对于大多数简单的多变体实体类型而言，这通常是不必要的。 默认情况下，小地图模组使用绑定到实体的渲染器/模型来渲染所有图标。这支持所有原版生物以及一些头部模型部件易于识别（如头、耳、鼻等）的简单双足/四足生物。如果模组无法识别，则会退而求其次显示彩色圆点。

用于覆盖图标的相关资源目录位于 /assets/xaerominimap/entity/icon/。你可以在模组的 jar 文件中找到此路径并提取文件作为参考。jar 包内包含一个示例文件 /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json，用于演示如何覆盖模组实体的图标。该文件对应假设存在的实体类型 example_mod:example_entity。请仔细阅读 example_entity.json 中的注释，了解其结构，以便创建你自己的图标定义文件。 此外，/assets/xaerominimap/entity/icon/definition/minecraft/ 目录下包含多个原版实体类型的示例文件，其中可能包含关于默认实体变体支持的额外说明。默认情况下，实体变体支持非常简单，变体 ID 仅仅是实体的主纹理资源位置。 如果你在小地图配置文件中将 debugEntityVariantIds 选项设为 true，那么新遇到的实体（变体）的变体 ID 将会打印在聊天栏和日志/控制台中。

从版本 21.8.0 开始，你还可以配置自定义的基于模型的渲染。请阅读示例文件 /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json 中的注释以获取所需的全部信息。

如果你想查看自定义图标的实际应用案例或直接使用它，请查看 babybluetit 的这个精彩项目：https://www.curseforge.com/minecraft/texture-packs/xaeros-minimap-modded-support

如何在我的服务器上禁止使用洞穴模式和/或实体雷达？

要实现此目的，请在服务端安装本模组（撰写本文时需 NeoForge/Forge/Fabric/Quilt 服务端）。

如果你的小地图版本至少为 25.3.0，请设置并使用“小地图服务器设置”按键绑定来打开服务器设置界面。你可以在那里强制执行几乎任何选项，包括洞穴模式、实体雷达，甚至创建自定义实体雷达类别。

在旧版本模组中，当你启动服务器时，服务器目录（非世界文件夹）的 config 文件夹中通常会生成一个新的“common”配置文件。在该文件中，你可以找到多个选项来禁用玩家的特定模组功能。更改后需要重启服务器。

另外，如果你无法安装该模组，可以在玩家登录时发送包含以下字符串的服务器/系统消息，这些隐藏代码将触发相应功能：

§f§a§i§r§x§a§e§r§o - 强制客户端禁用洞穴模式（包括世界地图）和实体雷达（公平竞争模式）。

§x§a§e§r§o§m§m§n§e§t§h§e§r§i§s§f§a§i§r - 允许小地图洞穴模式在下界工作，即便处于公平竞争模式下。世界地图有一个几乎相同的独立代码。

§n§o§m§i§n§i§m§a§p - 完全禁用小地图。

§r§e§s§e§t§x§a§e§r§o - 重置所有系统消息标记。

这里有一个第三方 Spigot 插件可简化此操作（非本人制作）：XMMForceFairPlay 以及一个具有类似功能的第三方数据包（非本人制作）：Xaero's Map Server Utils 使用任何第三方插件风险自负。

安装了模组的服务器如何允许原版客户端玩家加入？

请在服务器目录（非世界文件夹）下的 config 文件夹中找到“common”配置文件，通常路径为 config/xaero/minimap。其中有一个选项允许你 禁用状态效果的注册，正是这种状态效果注册阻止了原版玩家的加入。更改设置后需要重启服务器。如果使用了世界地图模组，也请执行相同的操作。

开发者指南

若想将你的模组与本模组挂钩，首先请将以下仓库添加到你的构建脚本中：

repositories {
    maven {
        url "https://chocolateminecraft.com/maven"
        name "Xaero's Maven"
    }
}

如果你使用的是 Forge，请确保在你的项目中应用了 Mixin gradle 插件 (org.spongepowered.mixin)，除非你的版本是 1.12.2。

最后，添加以下一个或多个依赖声明，请将 <minecraft version> 和 <mod version> 替换为 https://chocolateminecraft.com/maven/xaero/minimap 页面上显示的实际值。

Forge (使用 1.21.1 之前的官方 Mojang 映射):

implementation "xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>:dev"//特意不进行反混淆！

Forge (使用 1.21.1 及之后的官方 Mojang 映射):

implementation "xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>"

Forge (使用其他映射):

implementation fg.deobf("xaero.lib:xaerolib-forge-<minecraft version>:+")
implementation fg.deobf("xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>")

Fabric:

modImplementation "xaero.minimap:xaerominimap-fabric-<minecraft version>:<mod version>"

NeoForge:

implementation "xaero.minimap:xaerominimap-neoforge-<minecraft version>:<mod version>"

在多加载器设置中的“common”项目里:

compileOnly "xaero.minimap:xaerominimap-common-<minecraft version>:<mod version>"