GalaxiHD 系列项目共享的库模组,提供通用的工具、API 和系统(包括基于数据包的配置、世界生成辅助功能、事件钩子等),供多个模组复用。将随各项目的发展持续更新。
此模组本身非常枯燥,不妨前往 Extractrooms 体验它的精彩之处!
开发过程中使用了 AI 进行调试及自动化处理重复性任务。
由 GalaxiHD 制作!
A shared library mod for GalaxiHD's projects, providing common utilities, APIs, and systems (datapack-driven config, worldgen helpers, event hooks, and more) reused across mods. Will be updated as projects evolve.
This mod is really boring on it's own, check out Extractrooms to see it shine!
AI was used during development for debugging and automating repetitive tasks.
By GalaxiHD!
下载 MilkyWayLib
下载 MilkyWayLib
下载 MilkyWayLib
下载 MilkyWayLib
下载 MilkyWayLib
1.1.0 — 2026-10-23
可挖掘实体,重做(破坏性更新)
现在挖掘实体的行为与挖掘方块完全一致:相同的速度计算、工具与等级规则、裂纹效果、音效、粒子、掉落物、工具损耗以及 Jade 提示。旧的 API 已被移除,且没有提供替代的兼容层。
- 通过实现
MineableEntity(或继承AbstractMineableEntity)并返回一个MineableProperties(硬度、harvestAs对应的方块状态、战利品表、可选的音效/粒子覆盖、工具损耗)来启用此功能。没有任何内容被附加到、注入到或检查在其他实体上。详见docs/mineable-entities.md - 挖掘由服务器权威判定,并具有每个玩家的独立进度。客户端仅发送 START/ABORT/STOP;服务器针对实体的碰撞箱验证可达性和视线,应用生成保护和平行模式规则,并运行原版方块的破坏流程。创造模式下瞬间破坏且不产生掉落物
- 掉落物按方块掉落物进行掷骰(
LootContextParamSets.BLOCK,harvestAs作为方块状态),因此锋利、精准采集和match_tool生效。附魔“抢夺”不再适用 - 新的高亮显示:实时勾勒实体动画旋转模型部分的轮廓,也用于准星拾取,仅基于原版缓冲区构建(由于构造方式,对 Sodium/Embeddium/Iris 安全)
- 新增可取消的
MineableEntityBreakEvent和自定义统计milkywaylib:entities_mined(stat.milkywaylib.entities_mined) - 方块破坏爆炸会像对待方块一样破坏可挖掘实体:当该距离下的爆炸威力超过其
harvestAs方块的爆炸抗性时,它们会破碎并掉落方块风格的爆炸掉落物(传入EXPLOSION_RADIUS,因此survives_explosion逻辑生效)。保留方块的爆炸不会触碰它们 - 可挖掘实体免疫所有伤害,除了
#minecraft:bypasses_invulnerability(如/kill命令、虚空伤害) - 对于原本即可挖掘的类型,可通过数据包的
data/<ns>/mineable_entities/<entity_path>.json进行覆盖(hardness、harvest_as、loot、sounds、particles、tool_damage);无法挖掘类型的错误信息将输出到DatapackDiagnostics。覆盖项在服务器上读取;专用服务器上的客户端使用代码值进行预测并同步至服务器的裂纹阶段 - Jade 显示方块风格的提示(标题、所需工具的检查或交叉标记、方块边缘的破坏进度),并隐藏生命值和护甲值
- 已移除:
MineableEntityAPI、MineableEntityData、MineableEntityManager、MineableMobEntity、MineablePartEntity、MineableEntityProvider、mineable_entity附件、MixinIEntityExtension、EntityPersistentDataAccessor、MineableEntityDamageHandler、ModelPartHitboxExtractor、旧的挖掘和进度数据包及处理器,以及旧的高亮和渲染处理器 - 网络协议版本现已为
1.1.0:客户端和服务器都必须运行 MilkyWayLib 1.1.0
修复
- 修复了与 Create: Aeronautics(气球爆破)及其他包含复杂实体的模组一起运行时可能崩溃的问题。之前,可挖掘实体的查找会在实体生成、追踪、攻击或渲染时为每个实体执行完整的保存操作,包括其他模组未构建完成的实体,并且在客户端和服务器线程之间共享了一个不同步的缓存。现在可挖掘实体通过接口启用,因此其他模组的实体永远不会被读取或接触
- 加入服务器时不再两次重新加载玩家文件。之前的维度生成钩子会在每次加入时从磁盘重新读取存档并将其重新应用到玩家身上,导致监听玩家加载的其他模组运行三次。现在它复用游戏自身的加载逻辑
- 修复了启动时因其他任何修改附魔等级名称的模组而导致的崩溃问题。Milky Way Lib 对 X 以上等级的罗马数字修复是硬重定向,当两个模组同时执行此操作时会崩溃;现在它会与其他模组链式协作
- 修复了进入带有自定义流体溅射效果的世界时可能发生的崩溃:客户端和服务器可能同时构建流体列表并读取未构建完成的数据
- 如果其他模组返回只读的提示文本列表,创意模式标签页分区的提示文本不再崩溃
1.0.3
API 变更
- 新增
net.galaxihd.milkywaylib.util.DatapackDiagnostics:为数据包加载器提供一个集中报告文件问题(未知字段、未知 ID、错误值)的位置。每个问题都会被记录并保留,以便在游戏中通过命令列出。每个加载器在重新加载时会清除其自身的来源 MobVariantManager、ItemTimerExtenderManager、DatapackKeywordManager、DatapackLootPoolManager和RoomTemplateManager现在通过它进行报告,而不是静默跳过或回退。文件按排序后的 ID 顺序合并,因此replace/最后写入者获胜的结果是确定性的。计时器扩展器中的未知物品 ID 现在会被跳过,而不是注册空气- 新增
RoomTemplateManager(String folderName, Set<String> extraKnownKeys),允许消费者声明自己的额外模板字段而不会被标记为未知,以及DatapackLootPoolManager.knownConditions(...) - 新增
ProceduralChunkGenerator.reloadStamp()和DormantWakeEngine.scanDue(tickCount, entityId, interval) ItemTimerExtenderManager已弃用:推荐使用 NeoForge 物品数据映射。它仍然可以正常工作
性能优化
ProceduralChunkGenerator的边缘缓存现在是受限表(每个世界种子 64K 个槽位),而不是全局锁后面的无界映射,后者在长时间会话中会无限增长。生成的世界保持一致ContagionSpreadLogic和DormantWakeEngine在扫描时不再加载区块;休眠唤醒扫描按实体错开执行(相同的 20 刻频率)
修复
- 修复了安装 Create 模组后退出世界时永远卡在保存屏幕的问题。
MultiblockCrackSync在未检查区块是否已加载的情况下读取方块状态;Create 的钻头或锯子在关闭期间清除裂缝,旁边是一个未加载的区块,导致服务器线程等待一个永远不会到来的区块加载(由 Kwerz 报告)。现在它会跳过未加载的区块
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧