简介
Image Sign —— 在原版告示牌上渲染图像。
渲染原版告示牌上通过指定格式标明的 URL 下的图片。
支持功能
支持普通的 gif 图像;
支持本地文件(版本 0.3+,服务器其他玩家无法看到图像,只能看到文本内容);
图片的两面都会被渲染以应对特殊要求;
支持图片位置调整;
可配置的内存控制和渲染数量管理,控制图片的加载总量和每帧渲染或上传(内存到显存)总数;
支持网络代理;
支持本地缓存。
使用方法
在告示牌上一共可以填入 4 行文本(“#”后为注释说明):
xxx #标识头部
xxx #链接地址
xxx #渲染参数(可选)
xxx #图片发光亮度,对应原版的方块亮度,范围为 0-15(可选)
本地资源(模组版本 0.3+)
本地的图片可以通过本地文件系统读取,URI 以 file://(/) 开头:
Windows 用户请使用格式“file:///path/to/your/file”, 注意是三个斜杠!
Unix 系统只需要使用格式“file://path/to/your/file”。
示例 1(以 Windows 为例)
假设现在拥有一张本地图像,其文件路径为:C:\Users\11834\Pictures\a.png,那么填入的 URL 为以下任意一种都可以:
file:///C:\Users\11834\Pictures\a.png
file:///C:/Users/11834/Pictures/a.png
file:///c/Users/11834/Pictures/a.png
网络资源
图床或私人存储的资源,现在只支持 http(s) 协议,URL 以 http(s):// 开头:
示例 1
“#”后为注释
[Image] #必填,这样的一份文本代表渲染普通图片(标识头 [Image])
https://xxxxx/2-1.jpg #必填,图片地址:https://xxxxx/2-1.jpg
2,8 #可选(不填时默认为 1,1),图片在游戏中渲染大小:高2,宽8(单位:方块,缩放后图片无法占满你设置的宽高会进行中心对齐)
12 #可选(不填时默认为 0,即不发光),图片发光亮度:12(可填入的范围为 0-15)
示例 2
[ImageT] #标识头 [ImageT] 表示将原图像像素化,如果多幅同源图像会选择像素化缩放比例最低的,所有同源图像会展现同样的分辨率。
https://xxxxxx/2-1.jpg
1,6
15
示例 3
[ImageT]
https://xxxxxx/2-1.jpg
1,6,0,0,0
15
第三行包含 3 种类型的参数:当只有两个数字(可以为浮点数)时,两个数字会被认为为宽高,当有 3 个数时,会被认为为 x,y,z 方向的偏移,当有 5 个数字时会被认为为宽高和偏移。
下图中上方为没有设置偏移时的图像位置,默认贴着告示牌表面;添加偏移参数后贴着依附的方块表面。
其中第一行第二行为必填项,否则无法识别为图像,第三行缺省值为 1,1 第四行缺省值为 0(不发光)。
示例 4
[ImageL] #在以上标识头后加上大写的L可以获得平放的图片。
https://xxxxxx/2-1.jpg
1,1,0,0,0
15
有玩家希望增加水平方向的的图片渲染,遂加。
使用 [ImageL] 或 [ImageTL] 标识头来水平放置图片。
第三行包含 3 种类型的参数:当只有两个数字(可以为浮点数)时,两个数字会被认为为宽高,当有 3 个数时,会被认为为 x,y,z 方向的偏移,当有 5 个数字时会被认为为宽高和偏移。
下图中上方为没有设置偏移时的图像位置,默认贴着告示牌表面;添加偏移参数后贴着依附的方块表面。
可调性能参数
该 Mod 的目标是加载大量图片的同时减小对游戏性能影响,所以有很多可选的调节项,这些选项可以在配置文件中修改。
在这里你可以修改缓存的最大图片数量,允许加载的单张图片的最大解码后的体积,渲染循环的单次加载数量和显示数量(来减少卡顿),本地 HTTP(S) 代理 IP 和端口(加载需要代理才能获得的图片):
#Main settings
[main]
#Local-Proxy port.(本地)代理端口
#Range: 0 ~ 65565
proxy_port = 7890
#Max image count that will be render at one frame.每次渲染循环最大的图片渲染数量,
#这也会影响每帧加载图片数量
#Range: > 1
max_render_count = 50
#ImageCache max size.图片缓存数量上限
#Range: > 10
cache_size = 50
#Image max size (byte).单张图片的最大体积(单位:字节),超过会导致加载失败;
#注意:对于 jpeg 这种高压缩率的图像格式,它解码后的大小会是文件存储大小的几倍甚至几十倍
#Range: 1024 ~ 9223372036854775807
image_size = 10291456 #推荐:对于普通单图 6MB,对于 gif 图像 10MB
#Local-Proxy address.For example: 127.0.0.1 .(本地)代理 IP 地址(只允许 ipv4 或 ipv6)
proxy_address = "127.0.0.1"
#Images max memory limit (byte).图片缓存上限(单位:字节),超过会尝试根据距离观看者的距离排序尝试添加到内存,
#如果失败会无法渲染
#Range: 1024 ~ 9223372036854775807
image_memory_limit = 209715200 #推荐:单图最大体积 x 图片缓存数量上限
#Range: 1~1024x1024x8
min_area = 100 # 最小渲染像素,图片投影到屏幕的最小尺寸,当投影后面积小于该值时放弃渲染。
附加功能
木牌图片手动重新加载(如果因为一些原因图片没有正确加载请尝试);
空手右击木牌本身:尝试重新下载图片并加载;
手持任意物品右击木牌本身:尝试移除之前下载失败的黑名单列表,并重新下载图片并加载;(如果某个 URL 对应的图片多次加载/下载失败会被加入黑名单列表防止不断的尝试占用过多网络和 CPU 资源)
链接拷贝:shift+右键木牌本身:复制链接地址(如果有的话)。
录屏展示
Q&A
Q:如果在服务器中其他玩家能看到吗?
A:只要安装了该 Mod 的玩家都能看到,但是如果你显示的是本地图片的话是无法看到的,对方只能看到你打入的文本。
Q:是否会加入 GUI?
A:为了兼容性不会加入 GUI,保持原版特色。太麻烦了
Q:这个 Mod 会制作其他 MC 版本吗?
A:只会跟进更新新版本。
另:1.12.2 有大量代替品:木牌图片,小画 原谅我写完才知道有这个木牌图片的mod
同版本类似作品:幻灯片
Q:和其他类似的显示图片的 Mod 的区别?
A:区别:该 Mod 为纯客户端 Mod,不需要服务器装载,由于有效的内存管理和渲染约束允许大量图片渲染,如果你的图片量大并且不需要类似幻灯片可控的切换功能可以尝试该 Mod。
Q:如何清理缓存文件?
A:缓存目录在你的游戏 mods 文件夹的同级目录:images_temp
(可能)存在问题汇总