简介
Painting-the-World 是一款创新的工具,专为《我的世界》(Minecraft) 玩家及创作者设计,旨在将数字图片转变为游戏内的像素艺术。通过利用 RCON (Remote Console) 协议,本项目可以直接与《我的世界》服务器对话,根据输入的图像数据,在虚拟世界里精确布置方块,重现图像的每一处细节。无论你是想进行个人艺术创作、地图装饰,还是设计游戏内的广告牌,Painting-the-World 都能极大地扩展你的创意边界。
特性
- 多种颜色匹配算法:支持RGB、LAB、HSV、YIQ、YCbCr等多种颜色空间,确保图像色彩在游戏中的准确还原。
- 广泛兼容性:适用于多数《我的世界》服务器,仅需服务器启用RCON功能。
- 一键自动化构建:配置完成后,系统将自动在你指定的位置生成图片,无需手动介入。
快速开始
安装与配置
- 确保RCON已启用:在服务器配置中激活RCON,并记下其IP地址、端口号及密码。
- 下载安装 :直接从 GitHub仓库 获取最新的Painting-the-World版本。
- 配置工具:运行内置的配置向导,输入你的服务器连接详情。
命令行参数详解
通过丰富的命令行参数,你可以灵活地控制图片转换的具体行为。运行 python command.py -h
来查看所有可用选项的详细说明:
-f FILE_PATH, --file_path FILE_PATH
:指定图片文件路径。-x BASE_X, --base-x BASE_X
:设置图片在X轴的起始点。-y BASE_Y, --base-y BASE_Y
:设置图片在Y轴的起始点。-z BASE_Z, --base-z BASE_Z
:设置图片在Z轴的起始点。-c {rgb,lab,hsv,yiq,ycbcr}, --color-space {rgb,lab,hsv,yiq,ycbcr}
:选择颜色空间算法。--no-save
:仅测试,不保存至游戏世界。-d, --delete-generated
:移除已生成的像素画。-g, --generate
:执行生成操作。-rm RESIZE_MULTIPLE, --resize-multiple RESIZE_MULTIPLE
:调整图片缩放比例。
示例用法
转换本地的 test.jpg
图片,从坐标(100, 64, 100)
开始,使用HSV颜色空间,执行命令:
bash
python command.py -f ./test.jpg -x 100 -y 64 -z 100 -c hsv -g
效果预览
为了直观展示转换效果,参考以下两个文件:
- test.jpg:原始图片文件。
- result_test.png:由Painting-the-World生成的像素艺术游戏截图。
通过对比,你可以亲见图片如何被巧妙地转译成《我的世界》的方块布局。
技术细节
- 开发语言:项目采用Python,高效且稳定。
- 依赖库:借助Minecraft-RCON库实现与服务器的通信,以及PIL(Python Imaging Library)等图像处理库处理图像。
贡献与支持
我们诚邀开发者及社区成员参与贡献代码、提交问题报告或提出宝贵建议。访问 GitHub仓库,加入我们,共同为项目添砖加瓦。