文本样式

文字样式

“用动态动画和特效让你的文字生动起来！”

一个为 Minecraft 设计的先进、模块化、高度可自定义的文字效果系统。

📖 描述

文字样式 是对原始文字效果概念的一次强力重构与扩展。它引入了一个基于注册表的稳健系统，允许你使用简单的标签实现高度个性化的文字动画。无论你是在书里、告示牌上还是聊天中，现在都可以为文字添加移动、色彩循环和独特的显示动画。

与其他简单的效果模组不同，文字样式 的设计注重兼容性和可扩展性，允许其他模组轻松注册自定义样式和参数。

🌟 特性

• 基于注册表：每种样式都是一个注册对象，使其易于扩展和维护。
• 高度个性化：效果的几乎每个方面（速度、距离、频率等）都可以通过标签参数调整。
• 短别名：支持短标签名和参数别名（例如，使用 <;wb d=5> 代替 <;wobble distance=5>），非常适合书籍和告示牌等空间有限的场景。
• 原生集成：样式使用 Codec 进行序列化，确保与 Minecraft 的文字系统、NBT 和 JSON 完美兼容。
• 丰富动画库：内置超过 15 种样式，包括波浪、彩虹、故障、打字机等。
• 逐字渲染：高级渲染技术，支持平滑渐变和逐字符动画。

⚙️ 兼容性

• Minecraft 版本：
  • 完全兼容 26+。
• 模组平台：
  • Fabric：✅ 完全支持！
  • NeoForge：即将支持！
• 模组兼容性：
  • 适用于任何使用标准 Minecraft 组件的模组。

📦 安装

1. 下载模组：从 GitHub 或你喜欢的模组托管站点获取最新版本。
2. 安装 Fabric 或 NeoForge：确保已为你的 Minecraft 版本安装 Fabric Loader 或 Neoforge Loader。
3. 添加模组：将 .jar 文件放入 Minecraft 实例的 mods 文件夹。
4. 启动游戏：启动 Minecraft，开始体验各种样式！

💡 使用方法

只需将文字包裹在类似 <;style_name params>你的文字</;style_name> 的标签中即可。你可以使用全名或短别名。

🛠️ 可用样式与参数

样式	别名	参数（全称/简称）	描述
Wobble	wb	distance/d，speed/s	上下摆动。
Shake	sh	x，y，frequency/f	随机抖动。
Wave	wv	amplitude/a，frequency/f，speed/s，vertical/v	流体般的波动。
Rainbow	rb	speed/s，frequency/f，saturation/sat，brightness/bri	HSB 色彩循环。
Bounce	bn	amplitude/a，speed/s，delay/dl	跳跃/弹跳效果。
Pulse	pl	intensity/i，speed/s，delay/dl，color/c	缩放和色彩脉冲。
Fade	fd	min_alpha/m，max_alpha/x，speed/s，delay/dl	淡入淡出。
Swing	sw	amplitude/a，speed/s，delay/dl	钟摆式旋转。
Glitch	gl	intensity/i，frequency/f	随机偏移和色彩闪烁。
Turbulence	tb	intensity/i，speed/s	不规则但平滑的移动。
Gradient	gr	color1/c1，color2/c2，speed/s，frequency/f	两种颜色间的平滑过渡。
Typewriter	tw	delay/dl，land/l，snap/sn	逐个字符显示。
Marquee	mq	min/m，max/x，vertical/v	滚动跑马灯效果。
Shadow	sd	color/c，x，y	自定义偏移阴影。
Show After	sa	delay/dl	在一段时间内隐藏文字。

🔍 展示命令

你可以在游戏中运行 /textstyles showcase 来查看所有这些效果的实际演示。

🛠️ 贡献与反馈

欢迎贡献、提出想法和报告 Bug！

• 发现了 Bug？请在 GitHub 上报告。
• 想贡献代码？欢迎 Fork 本仓库并提交 Pull Request。

📄 许可

本模组使用 MIT 许可证 授权。

❤️ 致谢

文字样式 由 [RazorPlay01] 创作，旨在为 Minecraft 的文字带来更多表现力。感谢你使用本模组！如果你喜欢它，请在仓库中留下一个 Star！