ВЕРСИИ (1)

# Codexs Text Mod ## 中文介绍 Codexs Text Mod 是一款面向 Minecraft 1.21.1 NeoForge 的沉浸式功能模组。它围绕原版唱片机、本地音乐、空间声学、越肩视角和创作者工具展开，目标是在尽量保留原版交互逻辑的前提下，让 Minecraft 变成一个更适合沉浸游玩、建筑展示、视频创作和单人调试的环境。 ### 核心功能 - 改造原版唱片机，支持 32 格播放列表。 - 支持将唱片命名为本地音频文件路径，在游戏内播放本地音乐。 - 支持从模组本地音乐文件夹导入音频，并自动生成已命名唱片。 - 支持 MP3 以及 Java Sound 可读取的其他音频格式。 - 支持播放、停止、上一首、下一首、顺序播放、单曲循环、全部循环和随机播放。 - 内置 8 段 EQ，可以在唱片机 UI 中调整不同频段的增益。 - 支持 EQ 预设，普通玩家也能快速获得不同听感。 - 加入轻量声学模拟：距离衰减、左右声道、方块遮挡、材质吸音、反射、回声和混响。 - 支持声学调试射线可视化，方便观察声音路径和反射效果。 - 支持 Minecraft 原生声音系统和 Java 音频线程两种渲染方式。 - 新增“蓝牙”头盔附魔，绑定唱片机后可在等级范围内减少空间影响。 - 新增便携媒体播放器，可随身使用播放列表播放本地音乐。 - 替换原版 F4 第三人称切换体验，提供越肩第三人称视角。 - 提供实体管理器工具，适合地图作者、视频作者和调试用途。 - 提供权限控制、极简模式和声学性能限制配置。 ### 本地音乐 你可以把音频文件放入： ```text 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: ```text 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