黑洞 - 新手盒子

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

黑洞模组

一个为你的世界添加具有破坏性和动态效果的黑洞的 Minecraft 模组。

Github: https://github.com/IDoTheHax/Blackhole
Modrinth: https://modrinth.com/mod/blackhole
Discord: https://discord.com/faPd8MQ3Ke
Youtube:

概述

黑洞模组引入了一种新的方块，可以在你的 Minecraft 世界中生成模拟黑洞。这些黑洞具有逼真的引力效果，会吸引附近的实体和方块。它们可以随时间增长、追踪玩家，并在移动路径上造成破坏。

警告：请勿在没有备份的情况下在你的世界中安装此模组！！

特性

真实物理效果：黑洞会根据可配置的质量值，对附近的实体和方块施加引力
成长中的黑洞：黑洞可以随时间扩大，增加其影响范围
玩家追踪：黑洞可以在配置的范围内追踪玩家
视觉效果：提供可自定义的粒子效果，增强沉浸式体验
完全可配置：黑洞行为的各个方面均可通过指令或配置文件进行调整
创造模式集成：黑洞物品可在自定义创造模式标签页和原版红石方块标签页中找到

材质包

该模组使用 Polymer 进行自定义渲染，并需要一个材质包来显示黑洞视觉效果。在游戏内使用 /polymer generatepack 指令来创建一个默认材质包，然后将生成的材质包（位于 polymer 文件夹中名为 resource_pack）拖到你的资源包文件夹中，或使用服务器端资源包。更多详情请参阅 Polymer 文档。

指令

所有指令都需要操作员权限等级 2 或更高，并以 /blackhole 开头：

配置指令

指令	描述
`getmaxscale` / `setmaxscale <value>`	获取/设置黑洞可以成长到的最大尺寸
`getgravity` / `setgravity <value>`	获取/设置引力常数
`getplayermass` / `setplayermass <value>`	获取/设置玩家的质量值
`getblockmass` / `setblockmass <value>`	获取/设置方块的质量值
`getitementitymass` / `setitementitymass <value>`	获取/设置物品实体的质量值
`getanimalmass` / `setanimalmass <value>`	获取/设置动物实体的质量值
`getchunkloadradius` / `setchunkloadradius <value>`	获取/设置黑洞周围强制加载的区块半径
`getmaxblockspertick` / `setmaxblockspertick <value>`	获取/设置每刻处理的最大方块数量
`getmovementspeed` / `setmovementspeed <value>`	获取/设置追踪黑洞的移动速度
`getdefaultfollowrange` / `setdefaultfollowrange <value>`	获取/设置黑洞检测玩家的默认范围
`getplayerdetectioninterval` / `setplayerdetectioninterval <value>`	获取/设置玩家检测检查的间隔刻数
`getgrowthrate` / `setgrowthrate <value>`	获取/设置黑洞的成长速率
`getparticles` / `toggleparticles`	获取/全局切换粒子效果的开关状态

黑洞操控指令

指令	描述
`togglefollow`	切换最近的黑洞是否追踪玩家
`togglegrowth`	切换最近的黑洞是否随时间成长
`setfollowrange <range>`	为最近的黑洞设置追踪范围
`kill`	永久移除最近的黑洞及其视觉效果（需要服务端 1.21.11+ 功能）

配置

该模组会在 config/black_hole.json 创建一个配置文件，默认值如下：

{
  "maxScale": 40.0,
  "gravity": 60.0,
  "playerMass": 700.0,
  "blockMass": 10.0,
  "itemEntityMass": 0.1,
  "animalMass": 50.0,
  "chunkLoadRadius": 2,
  "maxBlocksPerTick": 500,
  "movementSpeed": 1.0,
  "defaultFollowRange": 256.0,
  "playerDetectionInterval": 60,
  "growthRate": 0.04,
  "particlesEnabled": true
}

配置属性

属性	描述	默认值
`maxScale`	黑洞可以成长到的最大尺寸	40.0
`gravity`	影响牵引力的引力常数	60.0
`playerMass`	玩家的质量值（影响他们被牵引的强度）	700.0
`blockMass`	方块的质量值	10.0
`itemEntityMass`	物品实体的质量值	0.1
`animalMass`	动物实体的质量值	50.0
`chunkLoadRadius`	黑洞周围强制加载的区块半径	2
`maxBlocksPerTick`	每刻处理的最大方块数量（性能设置）	500
`movementSpeed`	追踪玩家时的移动速度	1.0
`defaultFollowRange`	黑洞检测玩家的默认范围	256.0
`playerDetectionInterval`	玩家检测检查的间隔刻数	60
`growthRate`	黑洞成长的速率	0.04
`particlesEnabled`	全局是否启用粒子效果	true

行为说明

黑洞会吞噬任何过于靠近其中心的实体
创造模式玩家对黑洞效果免疫
黑洞可以破坏大多数方块，但不能破坏无限硬度的方块（如基岩）
黑洞可以配置为不追踪玩家或停止成长
黑洞会从一些被破坏的方块中生成下落的方块实体以产生视觉效果
每个黑洞都维护自己的追踪和成长设置
可以关闭粒子效果以提高服务器或低配置系统的性能
黑洞物品可以在自定义的“BlackHole”创造模式标签页或原版红石方块标签页中找到

技术信息

使用 Fabric 和 Polymer 构建，兼容原版客户端
使用区块强制加载，确保玩家即使距离较远，黑洞也能正常工作
实现了基于刻逻辑的自定义方块实体
支持服务器端资源包进行纹理分发

已知问题

黑洞渲染问题：当玩家改变视角时，黑洞通常看起来像是圆圈在移动，这是由于物品展示的显示模式设置为广告牌模式，需要我不理解的先进数学知识才能修复。
渲染距离问题：由于实体渲染限制，当移动过远时，即使仍在常规渲染距离内，黑洞也会消失。

任何找到的修复方案都可以通过 Github 上的 Pull request 提交：https://github.com/IDoTheHax/Blackhole 不要犹豫，欢迎提交你的修复！！

兼容性

此模组适用于 Fabric，需要以下依赖：

Fabric API
Polymer

许可证

鸣谢

由 IDoTheHax 创建