LightAPI (光源控制-API:轻松编辑Minecraft世界的光照级别)
功能介绍:LightAPI是一个专门为Minecraft服务器设计的库,允许开发者在Minecraft世界中编辑光照级别。它支持在CraftBukkit/Spigot平台上的Vanilla和Starlight引擎,覆盖了从1.14.1到1.19的多个版本。
配置:配置项包括调试模式、启用bStats统计、兼容模式、强制启用旧版插件支持等。此外,还可以配置处理器路径、内部任务线程数、队列处理和光照引擎的策略等。
general: debug: false enable-metrics: true enable-compatibility-mode: false force-enable-legacy: false specific-handler-path: none handlers: craftbukkit: factory-path: ru.beykerykt.minecraft.lightapi.bukkit.internal.handler.craftbukkit.HandlerFactory BukkitBackgroundService: corePoolSize: 1 BukkitScheduledChunkObserver: tick-period: 2 BukkitScheduledLightEngine: relight-strategy: DEFERRED tick-period: 1 max-time-ms-in-per-tick: 50 max-iterations-in-per-tick: 256
用法:使用LightAPI,开发者可以简单地调用函数来设置世界中特定位置的光照级别。支持异步处理,并允许通过回调获取操作结果。
LightAPI.get().setLightLevel(String worldName, int blockX, int blockY, int blockZ, int lightLevel); LightAPI.get().setLightLevel(String worldName, int blockX, int blockY, int blockZ, int lightLevel, int lightFlags, ICallback callback);
权限:此插件主要面向开发者,因此主要权限集中在API的调用上,具体权限依据实际使用情况而定,文档中未特别列出。
已知问题:自定义光照级别可能会因为游戏内部机制而消失,比如附近的方块被放置或破坏时;使用Starlight引擎时,卸载区块可能导致自定义光照级别消失,且IMMEDIATE编辑策略可能存在问题;服务器可能在随机时刻因未知原因崩溃。
收录