Lib99j

模组

· 作者 Daniel99j

另一个对服务端开发有用的库模组。

0 本站下载 0 关注 更新于 1 周前

需要前置:Polymer

最新 1.4.4-patch10 · 26.3 · Fabric

一键开服(送7天)

关于

这是作为我所有模组基础库使用的模组。如果您愿意,可以自由使用它。

库功能

  • 包括锁定摄像机、覆盖层等在内的视觉效果 (VFX)
  • 服务器端 GUI 纹理
  • 服务器端粒子效果
  • 隐藏 Boss 血条
  • 自定义效果
  • Ponder(思考/演示系统)
  • 轻松创建配置
  • 以及更多……

用法

在模组初始化时,请运行 Lib99j.ensureLoaded()。这将强制库在你的模组之前加载,从而确保所有功能正常工作。

build.gradle(版本号来自 Modrinth)

repositories {
	maven { url = 'https://dj.ucc.asn.au/maven/' }
}

dependencies {
  implementation include("com.daniel99j:djutil:1.1")
  implementation include("com.daniel99j:lib99j:VERSION")
}

Ponder(服务器端)

这是对 Create 模组的 ponder 系统的重新实现,现已支持服务器端。请参阅 获取示例。

功能:

  • 无需客户端模组
  • 支持跳过、倒带和暂停
  • 如果与 Polydex 或 Booklet 一起安装,点击一次即可打开 ponder
  • 快速
  • 不会改变玩家状态——服务器或客户端都不知道你正在 ponder,所有内容均在网络层面处理
  • 完全自包含
  • 无现实世界更改
  • 兼容 Polymer 和服务器端模组(也包括客户端模组!)

控制键(游戏内 HUD 会显示这些按键):

  • F:识别 - 飞行并查看你正对着的内容
  • 空格:暂停/播放
  • Q:退出
  • L:打开菜单
  • S:重新开始场景
  • D:下一场景(如果可能)
  • A:上一场景(如果可能)
  • 滚轮:选择要跳过的步骤
  • W:跳转到选中的步骤

命令:

/ponder all <id>
/ponder item <item>
/ponder item <item> scene <id>
/ponder item hand
/ponder item hand <id>
/ponder scene pause
/ponder scene unpause
/ponder scene exit

开发者命令:

/ponder dev ui_creator -> 打开 UI 编辑器。
/ponder dev ui_creator_from <ponder command> -> 运行指定的 ponder 命令后打开 UI 编辑器
/ponder dev toggle_free_movement -> 在 ponder 场景中切换自由移动模式
/ponder dev get_edits -> 列出在自由移动模式下对世界进行的所有交互

UI 编辑器:

  • 染色玻璃显示安全区域
  • 打开菜单 [L] 开始编辑
  • 如果在客户端,在菜单中按住 Shift 可查看光标所在的 ponder UI 坐标,按 CTRL-C 复制

演示视频:

游戏属性

  • enableHideableBossbar() 使黄色 Boss 血条变为白色,并使用 BossBarVisibility 可以使任何 Boss 血条不可见
  • enableCustomEffectBadLuck() 使“厄运”效果显示为“自定义效果 (/polymer effects)”并具有自定义精灵图
  • enablePonder() 启用 ponder(见上文)
  • enableAddingAssetTranslationsToServer() 使 assets 文件夹中的所有 lang 文件被视为 Nucleoid Server Translations API 中的服务器翻译

配置

  • Lib99j 还提供易于使用的配置 API
  • 支持按世界、通用、仅客户端和仅服务器的配置选项
  • 可选的客户端同步
  • 屏幕界面使用 cloth config
  • 游戏内服务器端对话框重新创建 cloth config 界面 (/lib99j config {modid})
  • 支持 Mod Menu
  • 通过 GSON 进行 JSON 序列化
  • 在所有配置屏幕和配置文件中自动支持基本类型、标识符、vec2、vec3 和颜色
  • 使用 ConfigManager.addConfig(modid, modconfig) 添加配置。每个 ModConfig 包含每个上下文的可选 ConfigHolder。只需提供一个配置类即可完成
  • 使用 ServerConfigCopy.getConfigOption(modid, serializedName, optionClass, fallback) 从服务器获取同步选项(选项必须使用 sync = true 注解)

示例配置类:

public class ExampleConfig {
    @ConfigEntry
    public boolean testBool = true;

    @ConfigEntry(sync = true)
    @SerializedName("wavy_ui")
    public boolean wavyUi = false;

    //对象基本类型也有效!
    @ConfigEntry(min = 0, max = 10000)
    public Integer explosionDamage = 10;

    @ConfigEntry(displayType = ConfigDisplayType.SLIDER, max = 50, min = 0)
    public int explosionSize = 10;

    @ConfigEntry(displayType = ConfigDisplayType.COLOUR_PICKER)
    public int worldTint = 0xff00ff;

    @ConfigEntry(displayType = ConfigDisplayType.COLOUR_PICKER_ALPHA)
    public int overlayColour = 0xff0000ff;

    @ConfigEntry
    public Identifier packId = Identifier.withDefaultNamespace("test");

    @ConfigEntry
    public Vec2 spawnRotation = Vec2.ZERO;

    @ConfigEntry
    public Vec3 spawnPos = Vec3.ZERO;

    //ChatFormatting 是一个枚举
    @ConfigEntry
    public ChatFormatting formatType = ChatFormatting.RED;
}

模组安装状态

  • 使用 ModInstallManager.syncInstalledStatus(modid) 标记你的模组以同步其安装状态,然后使用 ModInstallManager.isInstalled(modid, player) 检查该模组是否在客户端上已安装

GUI 工具

  • 默认情况下,Lib99j 生成范围为 -256 到 256 的字体空格范围(注意,当使用例如 space=270 时,它会组合使用 256 和 14!)。使用 GuiUtils.getSpace() 及相关函数
  • GuiUtils.nextPage()、GuiUtils.previousPage() 和 GuiUtils.head() 为玩家头像,可用于 GUI
  • GuiUtils.doesPlayerHaveMods() 允许你查看安装了哪些模组,阅读文档以获取更多信息
  • GuiUtils.toast() 显示带有自定义物品和文本的进度弹出窗口
  • 核心部分来了!
  • GuiUtils.generateTexture() 和 GuiUtils.generateColourableTexture() 创建一个 GuiElementBuilder,它具有自动生成物品模型和定义。纹理格式:"examplemod", "ui/test/image"。注意接受其他基本路径,但建议使用 /ui/,因为其他函数专门使用此路径
  • GuiUtils.generateBarTexture() 创建一个从底部到顶部填充的垂直条形图,包含基底、填充和覆盖层。
  • BackgroundTextures 是一种基于库存的基本字体背景生成器,例如:new BackgroundTexture(Identifier.fromNamespaceAndPath(MagmaNetworkMod.MOD_ID, "test/test_ui"), 176)。使用 /ui/ 进行纹理引用。

视觉效果

  • VfxUtils.shake() 会产生类似基岩版的摄像机抖动效果。

  • VfxUtils.addGenericScreenEffect() 添加多种其他客户端效果,例如:

  • RED_TINT - 红色世界边界色调

  • SNOW - 细雪覆盖层

  • FIRE - 顾名思义(火焰效果)

  • NAUSEA - 你懂的(恶心效果)。

  • BLACK_HEARTS - 凋灵之心

  • GREEN_HEARTS - 中毒之心

  • GREEN_HUNGER - 饥饿之肋条呈绿色

  • BLINDNESS - 失明效果

  • NIGHT_VISION - 夜视效果

  • CONDUIT_POWER - 潮涌核心力量效果

  • DARKNESS - 监守者黑暗效果

  • LOCK_CAMERA_AND_POS - 较为复杂,下文将详细解释。

  • 摄像机锁定

  • 要锁定玩家的摄像机和移动,请添加 LOCK_CAMERA_AND_POS 效果。

  • setCameraInterpolation、setCameraPos、setCameraPitch 和 setCameraYaw 控制被锁定摄像机的各个方面。

  • 由于技术原因,玩家无法看到快捷栏,游戏看起来处于旁观者模式。

  • registerCameraLockHandler 为源 ID 注册一个摄像机锁定处理器,该处理器提供摄像机旋转和玩家数据。

  • 杂项

  • VfxUtils.clientSideExplode() 会在客户端产生爆炸并破坏方块(仅在客户端生效)。仅用于电影制作,因为“幽灵方块”存在 Bug。

  • VfxUtils.fireworkExplode() 创建烟花爆炸效果,仿佛烟花实际生成一样。

  • VfxUtils.sendFakeEntity() 发送一个客户端实体。请注意它永远不会正常移除,因此建议仅将其与闪电或其他会自动移除的实体一起使用。

粒子效果

正在开发中的功能,可能会导致严重的服务器卡顿。 待我有空时将进行重构。

杂项

  • PlayPacketUtils 包含所有 PLAY 阶段数据包的列表。
  • ConfigUtils 包含一些基本的配置函数。
  • GameProperties 包含一些开关以及关于游戏的信息。

本项目与 Create Mod、Ponder 或任何类似的模组均无关联。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源