Lingua Peripherals

Lingua Peripherals

A CC: Tweaked addon mod for Minecraft 1.21.1 (NeoForge) and 1.20.1 (Forge), adding language-related peripherals controllable via Computers. From text-to-speech to data display, from file storage to audio playback — Lingua Peripherals enriches the CC:Tweaked ecosystem with speech, text, and audio capabilities.

Features

🗣 Speech Synthesis

• Narrator — A TTS block using Minecraft’s built-in Narrator system. Exposed as a CC peripheral with playVoice(text, rad) for distance-based speech broadcast.
• Creative Narrator — An indestructible variant with globalVoice(text) for cross-dimension, server-wide announcements.
• Chinese text support — Input non-ASCII characters via \uXXXX Unicode escape sequences.
• Online converter — Unicode escape converter, paste Chinese → instant CC-compatible output.
• voice_finished event — Enables sequential multi-segment speech playback.
• Configurable — Max range (default 128 blocks) and speech frequency interval adjustable via config file.

📀 Cassette Drive & Audio Playback

• Cassette Drive — A single-slot drive block that accepts cassette tapes. Functions as a CC peripheral with data I/O and DFPWM audio playback.
• Cassette Tape — A dyeable item in 16 colors, crafted with dyes in a crafting table. Stores up to 1 MB of data (configurable).
• Data I/O API — open(mode) returns a Lua io-compatible file handle supporting read/write/writeLine/seek/close.
• Audio playback API — playTape() / pauseTape() / stopTape() / seekTape(seconds) control DFPWM audio playback. Position and volume can be queried and adjusted in real time.
• saveAudio API — Encode a PCM sample table directly from CC code to DFPWM format and write it to tape.
• Redstone control — A redstone pulse triggers playback from the beginning; comparator outputs strength 15 while playing.
• Playback events — tape_play_start / tape_play_end events for CC computers to listen on.
• Audio sources — Supports both CC cc.audio.dfpwm library output and raw ffmpeg DFPWM files.
• Volume system — Audible range = max(volume, 1.0) × 16 meters, with spherical distance attenuation. Upper limit configurable (default 3.0).

📺 Display Peripherals (zero new blocks)

Place a Computer adjacent to these existing blocks to use them as peripherals:

• Sign Display (sign_display) — Read/write 4 lines of text on vanilla wood/iron signs.
• Lectern Display (lectern_display) — Page-based read/write of Book & Quill on lecterns, with add/delete page support.
• Flap Display (flap_display) — Control Create mod’s Flap Displays. Only enabled when Create is detected at runtime.

All display peripherals support \uXXXX Unicode escape sequences for Chinese text input.

🔧 General

• Wrench support — Right-click to rotate blocks; Shift + right-click to dismantle and return to inventory.
• JEI integration — 16 cassette tape subtypes by dye color, visible in recipe book.
• Multi-language — 中文, English, 日本語, 한국어.
• Crafting recipes — Narrator (CC Speaker + Skull); Cassette Drive and Cassette Tape are craftable.
• License — CC BY-NC-SA 4.0.

Links

• GitHub: github.com/Dr-Asm/Lingua-Peripherals
• Unicode escape converter: unicode-converter.soe-hentai.win
• MCMod (MCMOD.cn): https://www.mcmod.cn/class/28025.html