叮咚尼克的传说

叮咚尼克的传说

Ding Dong Nicktale 是一个独立的、客户端侧的 Minecraft 模组及配套桌面应用程序,旨在全面自定义游戏启动音效和加载界面启动画面。它无需任何第三方库依赖。

🚀 主要特性

1. 游戏内启动音效自定义器

  • 启动与重载时即时播放音频: 每当 Minecraft 完成加载画布或资源重载时(例如通过 F3 + T),播放一段清晰的 .ogg 音效。
  • 直接下拉菜单: 玩家无需反复点击循环切换音效,而是可以打开交互式游戏内下拉列表,实时查看、选择并预览任意音效。
  • 内置音效库: .jar 内直接预打包了 10 个高质量音效:
    1. 门铃(叮咚) [默认]
    2. 柔和风铃
    3. 快速叮声
    4. 门铃旋律
    5. 和弦风铃
    6. 欢迎语音
    7. 共鸣铃
    8. 明亮风铃
    9. 欢迎回来语音(女声)
    10. 欢迎陌生人语音(商人风格)
    11. 自定义音效文件(ding.ogg)
  • 自定义用户音效: 放入 .minecraft/config/customding/sounds/ 的任何 .ogg 音频都会被自动发现并列入游戏内下拉菜单。
  • 音量与音调控制: 专用滑块可实时调节音量(0%–100%)和音调(0.50x–2.00x)。
  • 专用 OpenAL 引擎: 通过 STBVorbis 和 OpenAL 直接在内存中解码,确保选择新音效时立即停止之前的音频预览,防止重叠或幻听播放。

2. 交互式标题界面铃铛按钮

  • 原版风格集成按钮: 在 TitleScreen 右上角添加一个金色铃铛图标按钮(16x16 像素画),带有标准 Minecraft 按钮边框和悬停状态。
  • 零绑定依赖: 渲染安全,不会因早期物品组件绑定或缺失字体字形而崩溃。
  • 快速访问: 点击铃铛可直接打开游戏内配置界面,无需进入世界或菜单。

3. 自定义加载界面(启动壁纸)

  • 完整壁纸替换: 将默认的红/黑 Mojang Studios 加载画布替换为自定义背景图片(例如官方 “Nicktale: A Minecraft Adventure” 图形)。
  • 三层保障:
    1. JAR 内嵌资源: 预打包的 mojangstudios.png 确保从第零毫秒起即刻呈现品牌形象。
    2. 自动资源包: 首次启动时(或通过桌面应用),模组会在 .minecraft/resourcepacks/NicktaleLoadingScreen 下配置原生资源包,并在 options.txt 中启用,确保第二次启动及以后 100% 自动显示。
    3. 动态纹理挂钩: Mixin 将自定义壁纸以精确的 UV 映射绑定到 TextureManager 和 LoadingOverlay。

4. 配套桌面应用(管理器 GUI)

  • 内置音频转换器: 用户可上传任意外部音频格式(MP3、WAV、OGG),应用会自动将其转换为兼容的 OGG Vorbis 格式。
  • 音频播放器: 实时预览按钮,可在保存前试听任意音效。
  • 壁纸自定义器: 可选择任意图片(PNG、JPG、WEBP),并带有实时缩放缩略图预览。
  • 一键应用: “保存并将更改应用到 Minecraft” 按钮会复制所有已配置的文件、更新 JSON 配置,并将所需资源包直接安装到活动的 .minecraft 目录中。

5. 自动多语言支持(i18n)

  • Minecraft 语言环境集成: 使用 Component.translatable 键自动匹配 Minecraft 当前的语言设置。
  • 支持的语言:
    • 英语(美国)(en_us.json)
    • 西班牙语(西班牙)(es_es.json)
    • 西班牙语(拉丁美洲)(es_ar、es_cl、es_co、es_ec、es_mx、es_uy、es_ve)
  • 根据 Minecraft 语言 中选择的语言,动态翻译标题、按钮标签、下拉音效名称、滑块和工具提示。