防羊毛处理

一个Minecraft Fabric模组,当羊毛放置在声源和玩家之间时阻挡声音。非常适合创建隔音房间或减少建筑中的噪音污染!

游戏机制

Woolproofed

Fabric API Minecraft Fabric Loader Java License

一个 Minecraft Fabric 模组,当羊毛被放置在声源与玩家之间时会阻挡声音。非常适合用于创建隔音房间或减少建筑中的噪音污染!

视频预览

观看视频

功能

  • 声音阻挡:当羊毛方块位于声源与玩家之间的视线中时,自动阻挡声音
  • 所有羊毛颜色:适用于全部 16 种羊毛颜色(白色、橙色、品红色、淡蓝色、黄色、黄绿色、粉红色、灰色、淡灰色、青色、紫色、蓝色、棕色、绿色、红色、黑色)
  • 可配置:通过按键绑定开启/关闭声音阻挡
  • 智能检测:仅阻挡距离玩家足够远的声音,以防止阻挡附近的声音
  • 性能优化:高效的射线投射算法,检查间隔可配置

安装

前置要求

  • Minecraft 1.20.1
  • Fabric Loader 0.17.2 或更高版本
  • Fabric API
  • Java 17 或更高版本

步骤

  1. 从发布页面下载最新版本
  2. 将 JAR 文件放入你的 mods 文件夹
  3. 确保已安装 Fabric API
  4. 使用 Fabric Loader 启动 Minecraft

使用方法

基本声音阻挡

只需将羊毛方块放置在你与任何声源之间。模组将自动检测并阻挡穿过羊毛的声音。

按键绑定

  • B 键(默认):开启/关闭声音阻挡
  • 你可以在控制菜单中的“Woolproofed”分类下更改此按键绑定

配置

该模组包含多个可配置选项:

  • 启用:开启/关闭整个声音阻挡系统
  • 最小距离:比此距离更近的声音将不会被阻挡(默认:1.0 格)
  • 检查间隔:沿声音路径检查羊毛方块的频率(默认:0.5 格)
  • 阻挡界面声音:是否阻挡界面声音(默认:false)

工作原理

该模组使用射线投射算法来检查声源与玩家之间的直线上是否存在羊毛方块:

  1. 当声音即将播放时,模组计算从声源到玩家的方向
  2. 它以固定间隔检查此路径上的每个方块
  3. 如果发现任何羊毛方块,则阻挡该声音
  4. 如果未发现羊毛方块,则正常播放声音

从源码构建

前置要求

  • Java 17 或更高版本
  • Gradle

步骤

  1. 克隆仓库:

    git clone https://github.com/SSnowly/woolproofed.git
    cd woolproofed
    
  2. 构建模组:

    ./gradlew build
    
  3. 构建好的 JAR 文件将位于 build/libs/

开发

贡献

  1. Fork 本仓库
  2. 创建一个功能分支
  3. 进行修改
  4. 充分测试
  5. 提交拉取请求

许可证

本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。

支持

致谢


注意:此模组仅客户端生效,不会影响多人服务器上的其他玩家。每位玩家都需要安装该模组才能享受声音阻挡功能。