[CN ONLY]网易云点播台 V2

网易云点歌台 NCM Player v2.13

在 Garry's Mod 里和服务器里的大家一起听网易云音乐。界面对标网易云音乐桌面版，单机、开房间、专用服务器都能用。 玩家自制的非官方作品，与网易云音乐官方无关。

亮点

• 网易云风格界面：推荐、排行榜、搜索（热搜 / 历史 / 歌曲歌手专辑歌单建议）、歌单、播放页（黑胶 + 歌词 / 评论 / 相似推荐）、播放队列，7 套主题可换肤。
• 三种收听方式：大家一起听（全服电台轮流播放）、只给自己听、用音箱放；右键单曲也能临时改这一首的去向。
• 歌词：原文 + 中文翻译 + 日韩罗马音 + 粤语拼音，逐字高亮；屏幕歌词可拖动，配色、字号、单双行、对齐、描边都能调。
• 网易云音箱：实体音箱有方向感和距离衰减，随节拍鼓动、按封面发光、头顶飘歌名与歌词，每个音箱可放自己的播放列表（最多 50 首）。
• 账号登录（可选）：扫码后可看每日推荐、同步红心、查看自己的歌单；黑胶 VIP 可点会员歌。凭证只存本机，不上传服务器。
• 服务器管理：点歌上限、冷却、最长时长、投票切歌、只允许管理员点歌、只能通过音箱收听等规则可在游戏内直接改；兼容 ULX / SAM 等 CAMI 插件。
• 性能优化：预渲染贴图、虚拟列表、封面分批加载、背景缓存，自带「性能自测」。

快速上手

1. 按 F3 或 Alt + L（聊天输入 `!music`）打开点歌台，首次会弹出新手引导。 2. 搜到歌后 双击或点右侧 + 放给大家听；右键可选「只给自己听」「用音箱放」。 3. 底栏左侧「点的歌放给谁听」随时切换收音方式；按住 C 可拖动屏幕歌词。

• 大家一起听（默认）：全服同一首、排队轮流播放，没人点歌时放空闲电台。
• 只给自己听：只有你听到，放完自动回到全服电台，不影响别人。
• 用音箱放：只有音箱附近的人听到；还没有音箱时会先在你准星处放一个。

暂停 / 下一首控制的是你此刻听到的那个声音：自己听只影响自己；自己的音箱会带上附近的人；别人的音箱只能选择不听；全服电台只有你时是真暂停，有别人时只暂停你自己，切歌由点歌人和管理员直接切、其他人投票。

常用命令

聊天：`!点歌 歌名`（`!play`）、`!skip` / `!切歌`、`!np` / `!当前`、`!自己听 歌名`（`!me`）、`!电台` / `!radio`、`!music`、`!hud`。 控制台：`ncm_menu`、`ncm_toggle`、`ncm_login`、`ncm_guide`、`ncm_perf [秒数]`。 服务端：`ncm_sv_play <歌名/ID/链接>`、`ncm_sv_skip`、`ncm_sv_clear`、`ncm_sv_stop`、`ncm_sv_status`。 窗口内快捷键：空格 播放 / 暂停、Ctrl + F 搜索、Esc 逐层关闭、双击点歌、右键更多操作。

服务器设置（管理员在设置页直接改，括号为默认值）

`ncm_admin_only` 只允许管理员点歌（0）；`ncm_speaker_only` 只能通过音箱收听（0）；`ncm_allow_private` 允许只给自己听（1）；`ncm_speaker_play` 用音箱放，0 关闭 / 1 主人与管理员 / 2 只有管理员（1）；`ncm_max_per_player` 每人队列上限（3）；`ncm_max_queue` 队列上限（50）；`ncm_cooldown` 点歌冷却秒数（6）；`ncm_max_duration` 最长歌曲时长秒（600）；`ncm_voteskip_ratio` 投票切歌比例（0.5）；`ncm_repeat_window` 最近 N 首不能重播（8）；`ncm_autoplay` / `ncm_autoplay_playlist` 空闲电台及其歌单（开 / 热歌榜）；`ncm_bitrate` 音质码率（128000）；`ncm_speaker_adminonly` / `ncm_max_speakers` 音箱放置权限与每人数量（0 / 2）。兼容 CAMI，权限名 NCM Admin。

玩家设置（括号为默认值）

`ncm_volume` 音量（60）；`ncm_listen_mode` 电台声音 auto 到处都能听 / speaker 只在音箱附近；`ncm_theme` 主题 immersive / classic / midnight / jade / dusk / sakura / amber；`ncm_menu_key` 打开按键（F3）；`ncm_menu_altl` Alt + L 备用键（开）；`ncm_personal` 点歌去向 0 全服 / 1 自己 / 2 音箱（0）；`ncm_hud` 迷你播放器（开）；`ncm_hear_spk` 听别人的音箱（开）；`ncm_duck_voice` 有人说话时压低音乐（开）；`ncm_underwater` 水下效果（开）；`ncm_follow_music_volume` 跟随游戏音乐音量（开）。 屏幕歌词：`ncm_lyric_size` / `ncm_lyric_color` 字号与配色、`ncm_lyric_lines` 单双行、`ncm_lyric_align` 对齐、`ncm_lyric_edge` / `ncm_lyric_alpha` 边缘与不透明度、`ncm_lyric_karaoke` / `ncm_lyric_bold` 逐字高亮与粗体、`ncm_lyric_roma` 罗马音、`ncm_lyric_offset` 时间微调；位置按住 C 拖动即可。

账号登录（可选）

侧栏或右上角头像 → 用网易云 App 扫码。登录后可看每日推荐、同步红心、查看自己的歌单，黑胶 VIP 可点会员歌。凭证只保存在本机 `garrysmod/data/ncm_player/account.dat`，不会发给服务器；扫码失败可用 Cookie 登录。

部署到服务器

• 放进 `garrysmod/addons/`；推荐上传创意工坊后用 `resource.AddWorkshop` 下发。
• 图标字体和贴图会自动下发；中文字体（Noto Sans SC，约 20MB）没下到时自动改用微软雅黑。
• 服务器要能访问 music.163.com（建议国内服务器）；浏览、搜索、评论由玩家客户端直接请求，不占服务器带宽。

注意

• 没有版权的歌放不了；VIP 歌曲需要点歌人自己登录 VIP。
• 用的是网易云网页版公开接口，接口变动时插件可能需要更新。
• 只在线播放，不下载、不缓存音频；音乐版权归网易云及各版权方所有。
• 界面为中文，主要面向中文游戏环境。

鸣谢：图标 Remix Icon，字体 Noto Sans SC（SIL OFL），许可证见 `lua/ncm/licenses.lua`。

English

Unofficial NetEase Cloud Music (网易云音乐) jukebox for Garry's Mod: full music UI with 7 themes, a server-wide radio queue, private listening, placeable speakers, synced lyrics with translation, on-screen lyrics, optional account login, and server admin rules. Chinese-first interface; the server must be able to reach music.163.com. Only public web APIs are used; no audio is downloaded or cached.