音频导航
这是一个 Minecraft 模组,旨在添加音频导航功能,主要是为了让视障玩家更方便地玩游戏。它旨在补充而非替代 Minecraft Access 模组。本模组中的一些功能灵感来源于 Microsoft Soundscape。
它同时支持 Fabric 和 NeoForge(在服务器端和客户端均可运行),并且其服务器端组件也兼容 Paper 和 Purpur。
依赖项
本模组基于 Fabric、NeoForge 或 Paper/Purpur 之一运行,并依赖以下模组:
- Fabric API(仅限 Fabric)
- Fabric Language Kotlin(仅限 Fabric)
- Kotlin for Forge(仅限 NeoForge)
- Architectury API(仅限 Fabric 和 NeoForge)
- Fzzy Config(仅限 Fabric 和 NeoForge)
- Eclipse(仅限 Paper 和 Purpur)
此外,它还使用了一个用于语音合成的 原生库,该库会在首次启动时自动下载。该库已为 Windows、MacOS 和 Linux 编译,支持 x86_64 和 aarch64 架构。如果您使用的是不受支持的操作系统或架构,请提交 Issue,我会尝试添加支持。模组会验证下载文件的哈希值以确保下载正确。专用服务器上不会下载或使用此原生库。
您也可以从 发布页面 自行下载该库。根据您的操作系统和架构下载正确的文件,将其放入您的 .minecraft 文件夹中,并将 espeak-ng-data.zip 中的 espeak-ng-data 文件夹解压后复制到您的 .minecraft 文件夹中。
注意事项
本模组必须同时在客户端和服务器端安装,因此如果您在服务器上游玩,您也必须在那边以及您的客户端上安装它。此外,除非您在本模组已安装的情况下生成世界,否则不会为树木和其他特性创建兴趣点(Points of Interest, POI)。如果您进入未生成的区块,系统会将兴趣点保存至那里,但一旦区块被生成,就来不及再生成这些 POI 了。兴趣点存储在您 .minecraft 文件夹内的 poi.db 文件中,或者如果您在专用服务器上游玩,则存储在 Minecraft 服务器根目录中。删除此文件将删除所有 POI。
当前功能
- 当您经过配置半径、垂直距离限制和最大广播次数所设定的范围时,系统会播报经过的兴趣点。您将听到来自兴趣点方向的播报,并且在播报之前会根据 POI 的类型播放一种声音提示。
- 当播报某个兴趣点时,其名称始终会被读出,并且可以选择性地读出它与您之间的距离和方向。方向也可以包含垂直分量,水平分量可以使用钟表指针、方向和角度、仅方向、仅角度或罗盘方向来表示。垂直分量可以表示为方向和角度、仅方向或仅角度,可以是相对于您面向的方向,也可以是绝对方向。
- 当世界生成时,或者当您进入未生成的区块或通过其他方式触发区块生成时,系统会为树木、冰刺、末地岛、矿脉等特性创建兴趣点。村庄等结构即将推出。
- 您可以按 F7 键播报附近所有的兴趣点。与默认的自动播报相比,这具有更大的半径、垂直限制和最大 POI 数量。
- 您可以随时按 F9 键停止语音播报。
- 您可以通过按 F6 键打开菜单并按“Add landmark”按钮来创建地标。它们作为兴趣点保存,并在您经过时进行播报。您可以选择新地标是否对其他玩家可见。
- 要删除地标,请按 F6 打开菜单,按“Landmarks”,找到您要删除的地标,然后按“Delete”按钮。
- 您可以通过打开地标列表,找到您想要的地标并按“Start beacon”来在地标上启动音频信标。这将开始一个来自地标方向的连续声音,您可以跟随该声音找到它。根据您是面向它、背对它还是面向相反方向,声音会有所不同。
- 默认情况下,每 30 秒会播报到信标的距离和方向。您可以在设置中更改时间间隔、禁用距离或方向播报,或完全禁用此功能。
- 要停止音频信标,请按 F6 打开菜单并按“Stop beacon”。
- 要播报当前信标的距离和/或方向,请按 F8。
- 地标列表按半径过滤。要增加显示地标的半径,请在当前半径上按回车键。
- 本模组高度可配置。要打开设置,请按 F6 打开菜单,然后选择“Settings”。从那里开始,配置界面应该相当直观易用。
- 本模组可以使用多种语音合成器。eSpeak NG 始终包含在内。在 Windows 上,还支持 SAPI 5;在 MacOS 上,模组可以使用 AVSpeechSynthesizer 来使用所有 Apple TTS 语音以及向系统 TTS 暴露的第三方语音。
- 由于如果包含所有语音,语音列表会非常长,因此它按合成器和语言进行过滤。当您在语音设置中打开合成器或语言列表时,您可以选择一个或多个选项,这将改变语音列表的过滤方式。默认情况下,所有语音合成器都被选中,但只有当前的 Minecraft 语言被选中。
- 本模组中的信标声音取自 Soundscape,因此如果您熟悉 Soundscape 的信标名称,它们是相同的聲音。如果不熟悉,您可以在信标运行时启动一个信标并更改声音,当您更改设置时,声音也会随之改变。
服务器配置
在专用服务器上,你可以设置一个最大半径,在此半径内的兴趣点(POI)才会被发送给客户端。你还可以阻止某些特性(例如矿脉)被发送给客户端,无论玩家是否在客户端设置中启用了它们。在 Fabric 和 NeoForge 服务器上,这些设置可以在 config/audio_navigation/server_config.toml 中修改。对于 Paper 和 Purpur 服务器,请在 plugins/AudioNavigation/config.yml 中进行更改。你也可以通过加入世界、按下 F6、点击“Settings”(设置),然后点击“Server Settings”(服务器设置)来使用设置界面修改 Fabric 和 NeoForge 服务器上的服务器设置。
Audio Navigation
This is a Minecraft mod to add audio navigation features, mostly to make it easier for blind players to play the game. It is intended to complement, not replace, the Minecraft Access mod. Some features in this mod are inspired by Microsoft Soundscape.
It runs on both Fabric and NeoForge (on both servers and clients), and the server-side component runs on Paper and Purpur as well.
Dependencies
This mod runs on either Fabric, NeoForge, or Paper/Purpur, and depends on the following mods:
- Fabric API (Fabric only)
- Fabric Language Kotlin (Fabric only)
- Kotlin for Forge (NeoForge only)
- Architectury API (Fabric and NeoForge only)
- Fzzy Config (Fabric and NeoForge only)
- Eclipse (Paper and Purpur only)
Also, it uses a native library for speech synthesis, which is downloaded automatically on first launch. The library is compiled for Windows, MacOS, and Linux, for both x86_64 and aarch64. Create an issue if you use an unsupported operating system or architecture and I will try to add it. The mod verifies the hash of the downloaded file to make sure it downloads correctly. The native library is not downloaded or used on dedicated servers.
You can also download the library yourself from the release page. Download the correct file for your operating system and architecture, place it in your .minecraft folder, and extract the espeak-ng-data folder from espeak-ng-data.zip and copy it into your .minecraft folder.
Things to Know
This mod must be installed on both the client and server side, so if you are playing on a server, you must install it there as well as on your client. Also, points of interest for trees and other features will not be created unless you generate the world with this mod installed. If you travel into ungenerated chunks, it will save points of interest there, but once a chunk is generated it is too late to generate these POIs. Points of interest are stored in poi.db inside your .minecraft folder, or in the Minecraft server root if you are playing on a dedicated server. Deleting this file will delete all POIs.
Current Features
- Points of interest will be announced as you pass, according to the configured radius, vertical distance limit, and maximum number of announcements. You will hear the announcement from the direction of the point of interest, and a sound will be played before speaking the announcement based on the type of the POI.
- When a point of interest is announced, its name is always spoken, and optionally its distance from you and its direction. The direction can also include the vertical component, and the horizontal component can be spoken using clock hands, direction and angle, just direction, just angle, or compass direction. The vertical component can be spoken as direction and angle, just direction, or just angle, either relative to the direction you are facing or the absolute direction.
- When a world is generated, or when you travel into ungenerated chunks or trigger chunk generation in some other way, points of interest are created for features such as trees, ice spikes, end islands, ore vanes, etc. Structures like villages are coming soon.
- You can announce all nearby points of interest by pressing F7. This has a larger radius, vertical limit, and maximum number of POIs than automatic announcements by default.
- You can stop speech at any time by pressing F9.
- You can create landmarks by pressing F6 to open the menu and pressing the "Add landmark" button. They are saved as points of interest and announced as you pass. You can choose whether the new landmark is visible to other players or not.
- To delete a landmark, open the menu with F6, press "Landmarks", find the landmark you want to delete, and press the "Delete" button.
- You can start an audio beacon on a landmark by opening the list of landmarks, finding the landmark you want, and pressing "Start beacon". This will start a continuous sound coming from the direction of the landmark that you can follow to find it. The sound will change depending on if you're facing it, facing away from it, or facing in the opposite direction.
- By default, the distance and direction to a beacon will be announced every 30 seconds. You can change the amount of time, disable either distance or direction, or disable this entirely in settings.
- To stop an audio beacon, open the menu with F6 and press "Stop beacon".
- To announce the distance and/or direction to the current beacon, press F8.
- The landmark list is filtered by radius. To increase the radius in which landmarks are shown, press enter on the current radius.
- This mod is extremely configurable. To open the settings, press F6 to open the menu, and choose "Settings". From there, the configuration screen should be pretty intuitive to use.
- This mod can use multiple speech synthesizers. eSpeak NG is always included. On Windows, SAPI 5 is also supported, and on MacOS the mod can use AVSpeechSynthesizer to use all Apple TTS voices as well as third-party voices exposed to the system TTS.
- Since the list of voices is extremely long if all voices are included, it is filtered by synthesizer and language. When you open the synthesizers or languages list in speech settings, you can select one or multiple options, which will change how the voice list is filtered. By default all speech synthesizers are selected, but the current Minecraft language is the only selected language.
- The beacon sounds in this mod are taken from Soundscape, so if you are familiar with Soundscape's beacon names, they are the same sounds. If not, you can start a beacon and change the sound while the beacon is running, and the sound will change when you change the setting.
Server Configuration
On a dedicated server, you can set a maximum radius at which POIs will be sent to clients. You can also prevent certain features, such as ore veins, from being sent to clients, whether or not players enable them in client settings. On Fabric and NeoForge servers, these can be changed in config/audio_navigation/server_config.toml. On Paper and Purpur, change them in plugins/AudioNavigation/config.yml. You can also use the settings UI to change server settings on Fabric and NeoForge servers, by joining the world, pressing F6, pressing "Settings", then pressing "Server Settings".
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
下载 Audio Navigation
- 已更新至 Minecraft 1.21.10
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧