红石书

红石书

红石书增加了可定制的书界面系统，支持JSON配置、动画、声音和自定义布局。非常适合地图、RPG和故事模组使用。需要资源包来提供纹理和声音。

红石书预览查看大图

📖 Redstone Books

Minecraft-1.20.1 Loader-Forge Version-1.2.0 Status-Stable

一个为 Minecraft Forge 1.20.1 设计的高电影化、JSON驱动的书系统。

Banner

🇬🇧 适用于 Minecraft 的电影化书系统
🇪🇸 适用于 Minecraft 的电影化书系统

✨ 概述

Redstone Books 是一个轻量级的 Forge 模组，允许创作者通过 JSON 配置来构建完全电影化的书籍。

非常适合：

  • 🎬 电影化场景
  • 🧭 RPG 冒险
  • 🗺️ 自定义地图
  • 🌍 多人服务器
  • 📜 故事驱动的模组
  • 🧱 数据包

🚀 特性

  • 📖 逐帧打开动画
  • 🔊 每页语音旁白
  • ✍️ 打字机效果
  • 🎨 完全可配置的布局
  • 🌫️ 淡入淡出过渡
  • 📚 支持多本书
  • 🧠 JSON 驱动的配置
  • 🎮 HUD 和输入控制
  • 🌐 专用服务器支持
  • 👥 多人同步

📦 安装

安装 Forge 1.20.1

客户端：

.minecraft/mods/

服务器：

server/mods/

启动 Minecraft。

🎮 命令

命令 描述
/redstonebook open <book> 为自己打开一本书。
/redstonebook open <book> <player> 为指定玩家打开一本书。
/redstonebook open <book> @a 为所有在线玩家打开一本书。

示例：

/redstonebook open guardian

📁 书籍结构

书籍定义文件存储在 服务器 上：

config/redstonebooks/books/<id>.json

资源（纹理、动画和音频）由客户端资源包提供：

assets/redstonebooks/
├── textures/books/<id>/
└── sounds/books/<id>/

🌐 多人架构

  • 📚 书籍从服务器加载。
  • 📡 服务器同步书籍数据给客户端。
  • 🖼️ 图像、动画和音频从资源包本地加载。
  • ✅ 确保每位玩家始终收到每本书的最新版本。

🧪 JSON 示例

{
  "id": "guardian",
  "meta": {
    "title": "守护者编年史"
  },
  "theme": {
    "folder": "guardian"
  },
  "animation": {
    "enabled": true,
    "folder": "anim",
    "frameCount": 143,
    "frameRate": 1
  },
  "assets": {
    "cover": "book_cover.png",
    "reading": "book_reading.png"
  },
  "options": {
    "hideHud": true,
    "lockInput": true,
    "autoAdvance": true,
    "pageTurnTicks": 8,
    "showPageIndicator": true
  },
  "style": {
    "textScale": 1.0,
    "align": "LEFT",
    "lineSpacing": 1,
    "textColor": "#1E1A16",
    "textShadow": false
  },
  "typewriter": {
    "enabled": true,
    "charsPerTick": 2,
    "startDelay": 10
  },
  "layout": {
    "mode": "book",
    "openBookWidth": 0.74,
    "openBookHeight": 0.74,
    "textStartX": 0.55,
    "textStartY": 0.14,
    "textWidth": 0.30,
    "textHeight": 0.60
  },
  "transition": {
    "useFadeBetweenAnimationAndReading": true,
    "fadeOutTicks": 18,
    "blackHoldTicks": 8,
    "fadeInTicks": 20
  },
  "pages": [
    {
      "durationTicks": 200,
      "text": "示例文本",
      "voiceSound": "redstonebooks:books.guardian.guardian_p1",
      "voiceVolume": 1.0,
      "voicePitch": 1.0
    }
  ]
}

🎵 声音

sounds.json 示例：

{
  "books.guardian.guardian_p1": {
    "sounds": [
      {
        "name": "books/guardian/guardian_p1",
        "stream": true
      }
    ]
  }
}

🧪 测试

/playsound redstonebooks:books.guardian.guardian_p1 master @p

📸 展示

Showcase

📄 许可证

保留所有权利

📜 更新日志

🆕 v1.2.0

  • 🌐 专用服务器支持。
  • 📡 服务器与客户端之间的网络同步。
  • 📚 书籍直接从服务器加载。
  • 👥 支持为特定玩家或所有在线玩家打开书籍。
  • 🛠 修复了因客户端专属类导致的专用服务器崩溃问题。

🆕 v1.1.0

  • 🎞 修复了动画问题（粉色/黑色纹理）。
  • 📖 新的模块化书籍结构。
  • 🔊 功能完善的音频系统。

🚀 v1.0.0

  • 📚 基础电影化书籍系统。
  • ⚙ JSON 配置。
  • 📄 多页支持。
  • ✨ 文本渲染和视觉效果。
  • 🔊 初始音频系统。

⚖️ 许可证

保留所有权利