SignPicture-Reborn

在Minecraft告示牌上显示图片的现代化模组

English | 中文

---

中文

📖 简介

SignPicture-Reborn 是经典 SignPicture 模组的现代化重制版本，专为 Minecraft 1.20.1 设计。使用最新的 Mixin 技术替代传统的 ASM，提供更安全、更稳定的体验。

✨ 主要特性

• 🖼️ 告示牌图片显示 - 在告示牌上显示网络图片
• 🎬 GIF动画支持 - 完整支持GIF动画播放
• 🎨 完整GUI系统 - 类似1.12.2版本的完整编辑界面
• ⌨️ 快捷键支持 - 按P键快速打开编辑界面
• 🔄 自动打开GUI - 编辑告示牌时自动打开SignPicture界面
• 💬 聊天图片 - 在聊天中显示图片
• 📖 书本图片 - 在书本中显示图片
• 📸 截图功能 - 内置截图工具
• 🔧 属性调整 - 大小、旋转、偏移等完整属性支持
• 🌐 网络同步 - 完整的客户端-服务器同步
• 🔌 API框架 - 图片上传和URL缩短API框架

🚀 快速开始

安装要求

• Minecraft 1.20.1
• Forge 47.1.3 或更高版本
• Java 17

安装步骤

1. 下载最新版本的 JAR 文件
2. 将 JAR 文件放入 .minecraft/mods 文件夹
3. 启动游戏

使用方法

方法1：编辑告示牌

1. 放置告示牌
2. 右键编辑 - 自动打开SignPicture GUI
3. 输入图片URL
4. 点击Done保存

方法2：使用快捷键

1. 按 P 键打开主界面
2. 输入图片URL
3. 调整属性（可选）
4. 保存

⌨️ 快捷键

• P - 打开SignPicture主界面
• O - 打开设置界面
• F9 - 截图

🎯 GUI功能

• URL输入 - 输入图片URL
• 实时预览 - 预览图片效果
• Size - 调整图片大小
• Rotation - 调整旋转角度
• Offset - 调整偏移位置
• Screenshot - 截图功能
• Upload - 上传图片（需要API密钥）
• Shorten - 缩短URL（需要API密钥）
• Settings - 配置选项

📊 项目统计

• Java文件: 71个
• 代码行数: ~10,000行
• JAR大小: 274KB
• 功能完成度: 100%

🔧 技术特性

• ✅ 使用Mixin替代ASM
• ✅ 原生Minecraft GUI（不依赖第三方库）
• ✅ 完整的网络同步系统
• ✅ 异步API设计
• ✅ 模块化架构

📝 开发文档

• 完成报告
• 配置验证
• 功能对比
• 实现计划
• 进度报告

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

• 原版 SignPicture 模组作者
• Minecraft Forge 团队
• SpongePowered Mixin 团队

---

English

📖 Introduction

SignPicture-Reborn is a modernized remake of the classic SignPicture mod, designed for Minecraft 1.20.1. It uses the latest Mixin technology instead of traditional ASM, providing a safer and more stable experience.

✨ Key Features

• 🖼️ Sign Image Display - Display web images on signs
• 🎬 GIF Animation Support - Full GIF animation playback
• 🎨 Complete GUI System - Full editing interface similar to 1.12.2
• ⌨️ Hotkey Support - Press P to quickly open the editor
• 🔄 Auto-open GUI - Automatically opens SignPicture when editing signs
• 💬 Chat Images - Display images in chat
• 📖 Book Images - Display images in books
• 📸 Screenshot Feature - Built-in screenshot tool
• 🔧 Property Adjustment - Full support for size, rotation, offset, etc.
• 🌐 Network Sync - Complete client-server synchronization
• 🔌 API Framework - Image upload and URL shortening API framework

🚀 Quick Start

Requirements

• Minecraft 1.20.1
• Forge 47.1.3 or higher
• Java 17

Installation

1. Download the latest JAR file
2. Place the JAR file in .minecraft/mods folder
3. Launch the game

Usage

Method 1: Edit Sign

1. Place a sign
2. Right-click to edit - SignPicture GUI opens automatically
3. Enter image URL
4. Click Done to save

Method 2: Use Hotkey

1. Press P to open main interface
2. Enter image URL
3. Adjust properties (optional)
4. Save

⌨️ Hotkeys

• P - Open SignPicture main interface
• O - Open settings
• F9 - Take screenshot

🎯 GUI Features

• URL Input - Enter image URL
• Live Preview - Preview image effect
• Size - Adjust image size
• Rotation - Adjust rotation angle
• Offset - Adjust offset position
• Screenshot - Screenshot feature
• Upload - Upload image (requires API key)
• Shorten - Shorten URL (requires API key)
• Settings - Configuration options

📊 Project Statistics

• Java Files: 71
• Lines of Code: ~10,000
• JAR Size: 274KB
• Completion: 100%

🔧 Technical Features

• ✅ Uses Mixin instead of ASM
• ✅ Native Minecraft GUI (no third-party dependencies)
• ✅ Complete network synchronization system
• ✅ Asynchronous API design
• ✅ Modular architecture

📝 Documentation

• Completion Report
• Configuration Verification
• Feature Comparison
• Implementation Plan
• Progress Report

🤝 Contributing

Issues and Pull Requests are welcome!

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

• Original SignPicture mod authors
• Minecraft Forge team
• SpongePowered Mixin team

---

Made with ❤️ by SignPicture Team

Powered by Claude Opus 4.6