DarknessLib

概述

DarknessLib 是一个前置库模组，提供处理光照计算的功能，并内置对最常见动态光照模组的支持。由于它是一个前置库模组，它本身功能很少，但其他模组可以为其添加支持，以减少重复编写同类代码的需要。

特性

该前置库提供以下内容：

• 用于检查相对光照等级的函数（也会将站在灵魂沙上等情况考虑在内）
• 对 Atomic Stryker’s Dynamic Lights、Optifine’s Dynamic Lights 和 Smooth Entity Light 的支持。功能基于玩家与玩家之间生效（如果启用，任何使用上述动态光照模组的玩家，其光照都会计入其总光照中，而不是客户端显示明亮而服务端却认为不亮），并且有一个可配置列表，你可以向其中添加额外的手持光源（如果它们尚未被发现，因为该前置库内置了尝试从所有已注册方块中判定光源的功能）
• 内置的载具列表，依赖该前置库的模组可以在检查光照等级之前先检查该列表（因为当你坐在矿车或船里时，它们都会遮挡光照等级）
• 支持模组通过 IMC 向模组内的相应列表添加手持光源和载具（或者你可以在问题追踪器上提交工单，附上模组 ID 和载具实体类的路径，我会将其加入内部列表）

配置

该模组还附带几个配置选项：

IMC

如果你想将你模组中的载具添加到载具列表，可以使用以下代码：

FMLInterModComms.sendMessage(“darknesslib”, “addVehicle”, “path.to.mod.Entity”); //or any alternative where you get the exact path

其中路径就是指向你的载具实体的路径（请务必事先检查光照计算是否会受其影响）。如果你的载具继承了原版的矿车或船，它们会被系统自动检测到。当然，如果你有很多载具，你只需要为它们注册你的基类即可（假设你有一个基类）。

如果你想将你模组中的手持光源添加到动态光源列表中，可以使用以下代码：

FMLInterModComms.sendMessage(“darknesslib”, “addLightsource”, new ItemStack(INSERT_ITEM_REFERENCE_HERE);

FMLInterModComms.sendMessage(“darknesslib”, “addLightsource”, “modid:name:meta;light_level”);

其中 ItemStack 版本会将光照等级设为 15，而字符串版本在省略 meta 时会默认为 OreDictionary.WILDCARD_VALUE（如果省略光照等级，也会将其设为 15）。

模组支持

本模组内置对以下内容的支持：

• 来自 MrCrayfish’s Vehicle Mod 的载具。

使用此前置库的模组

Grue（自 1.6.0 版本起）

Hungering Darkness（自 1.3.0 版本起）

捐赠

如果你想支持我模组的开发，可以考虑成为赞助者！你可以点击下方的图片访问我的 Patreon 页面。

服务器托管

我由 Aim2Game 赞助，你可以使用以下优惠码在你自己的服务器上享受折扣！
ABYSSAL25 – 新客户终身享受 75 折优惠
ABYSSAL50 – 新客户首月享受 5 折优惠

整合包

本模组可以作为整合包的一部分进行再分发，前提是正确署名作者（也就是我，Shinoow），并附上该模组 Curse/CurseForge 页面的链接。你不得在第三方网站上再分发本模组（通过镜像模组或创建“模组安装器”），对于被发现违反此规定的网站，将采取法律行动。

Discord

我为我的模组建立了一个 Discord 服务器（方便地命名为“AbyssalCraft”）。点击下方的图片加入！