Codexs Text Mod

中文介绍

Codexs Text Mod 是一款面向 Minecraft 1.21.1 NeoForge 的沉浸式功能模组。它围绕原版唱片机、本地音乐、空间声学、越肩视角和创作者工具展开，目标是在尽量保留原版交互逻辑的前提下，让 Minecraft 变成一个更适合沉浸游玩、建筑展示、视频创作和单人调试的环境。

核心功能

• 改造原版唱片机，支持 32 格播放列表。
• 支持将唱片命名为本地音频文件路径，在游戏内播放本地音乐。
• 支持从模组本地音乐文件夹导入音频，并自动生成已命名唱片。
• 支持 MP3 以及 Java Sound 可读取的其他音频格式。
• 支持播放、停止、上一首、下一首、顺序播放、单曲循环、全部循环和随机播放。
• 内置 8 段 EQ，可以在唱片机 UI 中调整不同频段的增益。
• 支持 EQ 预设，普通玩家也能快速获得不同听感。
• 加入轻量声学模拟：距离衰减、左右声道、方块遮挡、材质吸音、反射、回声和混响。
• 支持声学调试射线可视化，方便观察声音路径和反射效果。
• 支持 Minecraft 原生声音系统和 Java 音频线程两种渲染方式。
• 新增“蓝牙”头盔附魔，绑定唱片机后可在等级范围内减少空间影响。
• 新增便携媒体播放器，可随身使用播放列表播放本地音乐。
• 替换原版 F4 第三人称切换体验，提供越肩第三人称视角。
• 提供实体管理器工具，适合地图作者、视频作者和调试用途。
• 提供权限控制、极简模式和声学性能限制配置。

本地音乐

你可以把音频文件放入：

config/codexs_text_mod/local_music

然后在唱片机播放列表界面中导入。模组会自动创建对应的已命名唱片。你也可以保留传统方式，直接把任意唱片重命名为本地音频文件路径。

声学模拟

本模组不会只把音乐“播放出来”，而是尝试让它存在于 Minecraft 的空间里。 当你远离唱片机时，音量会自然衰减；当你站在墙后时，声音会被削弱；当唱片机位于较封闭的空间中时，声音会带有更明显的空间感。你也可以在配置中关闭或调整这些效果，以适配不同电脑性能和个人偏好。

多人游戏说明

本模组不是纯客户端模组。 如果用于多人服务器，客户端和服务器都需要安装本模组。 推荐 Modrinth 环境设置：

Client side: Required
Server side: Required

English Introduction

Codexs Text Mod is an immersive feature mod for Minecraft 1.21.1 NeoForge. It revolves around the vanilla jukebox, local music, spatial acoustics, over-the-shoulder camera, and creator tools, aiming to turn Minecraft into a more immersive environment for gameplay, building showcases, video creation, and single‑player debugging while preserving vanilla interaction logic as much as possible.

Core Features

• Overhauls the vanilla jukebox with a 32‑slot playlist.
• Supports naming a record with a local audio file path to play local music in‑game.
• Supports importing audio from the mod’s local music folder, automatically generating named records.
• Supports MP3 and other audio formats readable by Java Sound.
• Supports play, stop, previous, next, sequential playback, single‑track loop, full‑playlist loop, and shuffle.
• Built‑in 8‑band EQ, adjustable via the jukebox UI for per‑band gain.
• EQ presets allow casual players to quickly enjoy different sound signatures.
• Adds lightweight acoustic simulation: distance attenuation, stereo panning, block occlusion, material absorption, reflections, echo, and reverb.
• Supports acoustic debug ray visualisation to observe sound paths and reflection effects.
• Supports both Minecraft’s native sound system and the Java audio thread for rendering.
• Adds a “Bluetooth” helmet enchantment that reduces spatial effects within its range when bound to a jukebox.
• Adds a portable media player that lets you carry your playlist and play local music on the go.
• Replaces the vanilla F4 third‑person toggle with an over‑the‑shoulder third‑person view.
• Provides an Entity Manager tool, suitable for map makers, video creators, and debugging purposes.
• Offers permission controls, a minimal mode, and acoustic performance limiting options.

Local Music

You can place audio files in:

config/codexs_text_mod/local_music

and import them from the jukebox playlist UI. The mod will automatically create corresponding named records. You can also keep the traditional method: rename any record to a local audio file path.

Acoustic Simulation

This mod doesn’t just “play” music – it tries to make it exist within Minecraft’s space.
When you move away from the jukebox, the volume naturally fades; when you stand behind a wall, the sound is muffled; when the jukebox is in a more enclosed space, the sound gains a stronger sense of room presence. You can also disable or adjust these effects in the configuration to suit different hardware performance and personal preferences.

Multiplayer Notes

This mod is not a client‑only mod.
If used on a multiplayer server, both the client and the server need to have this mod installed. If used on a multiplayer server, both the client and the server need to have this mod installed. Recommended Modrinth environment settings:

Client side: Required
Server side: Required