ScreenEffects

数据包

· 作者 Trplnr

一个小型灵活库,用于向用户展示动态屏幕叠加层。

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

最新 v2.0.1 · 1.21.8 · 数据包

一键开服(送7天)

ScreenEffects by Trplnr

一个小型灵活的库,用于向用户展示动画屏幕覆盖层。

演示

用法

使用构建器 Deno 文件制作屏幕特效:

重要提示: 使用此方法需要在您的系统中安装以下内容:Deno、ffmpeg。安装完成后,请重启计算机。

屏幕特效由多个字体帧组成,数据包利用这些帧来显示动画。

资源包内的 screen_effects 文件夹中提供了一个实用的 Deno JS 文件,以简化此过程。

1. 制作动画

注意:

  • 您可以使用任何图像编辑软件,只要它能**将动画导出为精灵图(spritesheet)**即可。Aseprite 具备此功能。
  • 建议制作 256x256 的 .png 文件以获得最佳效果。
  • 首先创建动画。

  • 将动画导出为位于 screen_effects 文件夹内的垂直排列的精灵图。


  • 如果您希望拥有更多的屏幕特效,可以在 screen_effects 文件夹中添加更多的精灵图。

2. 构建动画

  • 为了准备构建动画,请进入 buildScreenEffects.js 文件夹并调整以下配置。
// -------------CONFIGS---------------
// 替换为您使用的命名空间!
const NAMESPACE = "trplnr";

// 如果您希望字体 JSON 文件格式化输出,请将此布尔值设为 true。
const prettyPrintFontFiles = false;

// 如果您希望查看 ffmpeg 日志,请将此布尔值设为 true。
const showFFMPEGLogs = false;
// -----------------------------------
  • 为了让您的精彩动画能被数据包使用,您可以在终端中运行命令,将精灵图转换为帧!
  • 打开您喜欢的终端,并确保您位于 screen_effects 文件夹内。
  • 之后,运行此命令:
deno run --allow-all .\buildScreenEffects.js
  • 运行后,如果一切顺利,结果应如下所示:
  • 恭喜!您已成功将精彩的动画转换为帧! :tada:

  • 如果您只想编译单个精灵图,只需运行:

deno run --allow-all .\buildScreenEffects.js filename.png

注册屏幕特效

数据包需要数据来了解什么是屏幕特效,因此您必须对其进行注册。

以下是如何注册一个特效的示例。

ScreenEffect 模式见本节下方。

# 要将您自己的屏幕特效添加到全局注册表,
# 只需复制此处显示的内容。
 
data modify storage example:scrfx_data screen_effects set value { \
   "examples:toast": { \
        tps: 1, \
        frame_count: 31, \
        path: "example:scrfx/exampletoast" \
    }, \
   "examples:transition": { \
        tps: 1, \
        frame_count: 69, \
        path: "example:scrfx/exampletransition", \
        callbacks: { \
            "26": "say This frame covers the whole screen" \
        } \
    }, \
}

function scrfx:add_screen_effects {storage: "example:scrfx_data", path: "screen_effects"}

ScreenEffect 模式

这是 ScreenEffect 的定义。

{
    /**
     * 屏幕特效的名称,
     * 最好带有命名空间。
     */
    "ns:identifier": {
        /**
         * 每帧显示的频率,
         * 以刻(ticks)为单位测量。
         * 
         * 类似于 fps,但是以刻为单位。
         * 
         * 必须大于零。
         */
        tps: <int>,

        /**
         * 动画中包含的帧数。
         */
        frame_count: <int>,

        /**
         * 动画的字体资源位置,
         * 需去掉末尾的数字部分。
         */
        path: <resource_location>,
        /**
         * 定义在特定帧中运行的命令。
         * 
         * 可选。
         */
        callback?: {
            "<frame_number>": "<command>",
            ...
        }
    }
}

运行屏幕特效

  • 在 scrfx:in id 存储中声明要播放的动画。
  • 然后作为玩家执行并运行 scrfx:play!

示例:

data modify storage scrfx:in id set value "ns:identifier"
execute as Trplnr run function scrfx:play
  • 您已成功播放了一个屏幕特效! ?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源