? VoiceChatMegaphone (VCM)
一个 Paper 插件,为你的服务器添加了一个扩音器物品。激活后,它通过 Simple Voice Chat 将玩家的声音广播给所有在线玩家,并带有逼真的 DSP 效果——高通/低通滤波器、存在感均衡器、软削波失真、噪声以及可选的混响。
要求
| 依赖项 |
版本 |
| Paper |
1.21.10 |
| Simple Voice Chat |
2.6.13+ |
| Java |
21+ |
安装
- 从发布页面下载最新的
VoiceChatMegaphone-*.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 确保已安装 Simple Voice Chat。
- 启动(或重启)服务器 ——
plugins/VoiceChatMegaphone/config.yml 将自动生成。
- 根据需要配置插件并运行
/vcm reload。
命令
| 命令 |
描述 |
权限 |
/vcm |
显示可用命令 |
— |
/vcm give [player] |
给自己或其他玩家发放扩音器 |
vcm.admin |
/vcm reload |
重新加载 config.yml |
vcm.admin |
权限
| 权限 |
描述 |
默认值 |
vcm.use |
允许使用扩音器 |
op |
vcm.admin |
允许管理命令 |
op |
使用方法
- 通过
/vcm give 或其他方式(商店插件、战利品表等)获取扩音器。
- 在主手中持有该物品并右键点击以激活。
- 你的声音将通过扩音器音量类别广播给服务器上的所有人。
- 再次右键点击以停用。当你切换物品、丢弃物品、死亡或离开服务器时,扩音器也会自动关闭。
操作栏会显示当前所有活跃扩音器用户的名称。
配置
首次启动时会生成包含注释的完整 config.yml。关键部分如下:
物品外观
megaphone:
material: CARROT_ON_A_STICK
name: "<gold>Megaphone"
lore:
- "<gray>Amplifies your voice."
custom-model-data: 7641
支持对 name 和 lore 使用 MiniMessage 格式进行格式化。
音频效果
process-voice: true # 所有 DSP 的主开关
effects:
highpass-enabled: true
highpass-freq: 300.0 # 切除 300 Hz 以下的低频轰鸣
lowpass-enabled: true
lowpass-freq: 4500.0 # 切除 4500 Hz 以上的高频嘶声
peak-enabled: true
peak-freq: 2000.0 # 存在感增强中心频率
peak-gain-db: 8.0
peak-q: 1.0
distortion-enabled: true
distortion-drive: 2.2 # 1.0 = 纯净,3.0 = 重度过载
noise-enabled: true
noise-level: 0.008 # 轻微的背景嘶声
reverb-enabled: false
reverb-wet: 0.22
更改效果后,请运行 /vcm reload。已经激活扩音器的玩家必须关闭并重新打开,新设置才会生效。
操作栏
action-bar:
enabled: true
text: "<green>Now in live: {players}"
{players} 将被替换为逗号分隔的活跃用户列表。支持 MiniMessage。
? 自定义扩音器纹理
VCM 使用 Minecraft 的自定义模型数据系统为扩音器物品应用自定义纹理。默认值为 7641,基础物品为 CARROT_ON_A_STICK。
分步指南
1. 准备纹理
创建一个用于扩音器的 32×32(或 64×64)PNG 图像。例如命名为 megaphone.png。
2. 设置资源包结构
my_resourcepack/
├── pack.mcmeta
└── assets/
└── minecraft/
├── models/
│ └── item/
│ ├── carrot_on_a_stick.json ← 覆盖文件
│ └── megaphone.json ← 你的模型
└── textures/
└── item/
└── megaphone.png ← 你的纹理
3. 创建 pack.mcmeta
{
"pack": {
"pack_format": 46,
"description": "VCM Megaphone texture"
}
}
4. 创建 megaphone.json(一个简单的平面物品模型)
{
"parent": "item/handheld",
"textures": {
"layer0": "item/megaphone"
}
}
5. 覆盖 carrot_on_a_stick.json
添加一个 custom_model_data 覆盖,当值与 config.yml 中设置的值(默认 7641)匹配时指向你的模型:
{
"parent": "item/handheld",
"textures": {
"layer0": "item/carrot_on_a_stick"
},
"overrides": [
{
"predicate": { "custom_model_data": 7641 },
"model": "item/megaphone"
}
]
}
6. 压缩并应用
将 my_resourcepack/ 文件夹压缩为 .zip 文件,并将其放置在服务器上(通过 server.properties → resource-pack)或手动分发给玩家。
7. 匹配配置中的值
确保 config.yml 中的 custom-model-data 与你在模型覆盖中使用的谓词值匹配:
megaphone:
custom-model-data: 7641 # 必须与覆盖谓词匹配
提示: 如果你想使用不同的基础物品(例如 STICK),请在 config.yml 中更改 megaphone.material,并为该物品创建覆盖文件。
许可证
MIT © 2026 litkoit1003
? VoiceChatMegaphone (VCM)
A Paper plugin that adds a megaphone item to your server. When activated, it broadcasts the player's voice to all online players through Simple Voice Chat with realistic DSP effects - high-pass/low-pass filters, presence EQ, soft-clip distortion, noise, and optional reverb.
Requirements
| Dependency |
Version |
| Paper |
1.21.10 |
| Simple Voice Chat |
2.6.13+ |
| Java |
21+ |
Installation
- Download the latest
VoiceChatMegaphone-*.jar from the releases page.
- Drop it into your server's
plugins/ folder.
- Make sure Simple Voice Chat is already installed.
- Start (or restart) the server —
plugins/VoiceChatMegaphone/config.yml will be generated automatically.
- Configure the plugin to your liking and run
/vcm reload.
Commands
| Command |
Description |
Permission |
/vcm |
Show available commands |
— |
/vcm give [player] |
Give a megaphone to yourself or another player |
vcm.admin |
/vcm reload |
Reload config.yml |
vcm.admin |
Permissions
| Permission |
Description |
Default |
vcm.use |
Allows using the megaphone |
op |
vcm.admin |
Allows admin commands |
op |
Usage
- Get a megaphone via
/vcm give or by any other means (shop plugin, loot table, etc.).
- Hold the item in your main hand and right-click to activate.
- Your voice will be broadcast to everyone on the server through the Megaphone volume category.
- Right-click again to deactivate. The megaphone also turns off automatically when you switch items, drop it, die, or leave the server.
The action bar shows the names of all currently active megaphone users.
Configuration
The full config.yml with comments is generated on first launch. Key sections:
Item appearance
megaphone:
material: CARROT_ON_A_STICK
name: "<gold>Megaphone"
lore:
- "<gray>Amplifies your voice."
custom-model-data: 7641
Supports MiniMessage formatting for name and lore.
Audio effects
process-voice: true # Master toggle for all DSP
effects:
highpass-enabled: true
highpass-freq: 300.0 # Cut rumble below 300 Hz
lowpass-enabled: true
lowpass-freq: 4500.0 # Cut hiss above 4500 Hz
peak-enabled: true
peak-freq: 2000.0 # Presence boost centre
peak-gain-db: 8.0
peak-q: 1.0
distortion-enabled: true
distortion-drive: 2.2 # 1.0 = clean, 3.0 = heavy crunch
noise-enabled: true
noise-level: 0.008 # Subtle background hiss
reverb-enabled: false
reverb-wet: 0.22
After changing effects, run /vcm reload. Players who already have the megaphone active must toggle it off and on again for the new settings to apply.
Action bar
action-bar:
enabled: true
text: "<green>Now in live: {players}"
{players} is replaced with a comma-separated list of active users. Supports MiniMessage.
? Custom Megaphone Texture
VCM uses Minecraft's Custom Model Data system to apply a custom texture to the megaphone item. The default value is 7641 and the base item is CARROT_ON_A_STICK.
Step-by-step guide
1. Prepare your texture
Create a 32×32 (or 64×64) PNG image for the megaphone. Name it, for example, megaphone.png.
2. Set up a resource pack structure
my_resourcepack/
├── pack.mcmeta
└── assets/
└── minecraft/
├── models/
│ └── item/
│ ├── carrot_on_a_stick.json ← override file
│ └── megaphone.json ← your model
└── textures/
└── item/
└── megaphone.png ← your texture
3. Create pack.mcmeta
{
"pack": {
"pack_format": 46,
"description": "VCM Megaphone texture"
}
}
4. Create megaphone.json (a simple flat item model)
{
"parent": "item/handheld",
"textures": {
"layer0": "item/megaphone"
}
}
5. Override carrot_on_a_stick.json
Add a custom_model_data override that points to your model when the value matches what is set in config.yml (default 7641):
{
"parent": "item/handheld",
"textures": {
"layer0": "item/carrot_on_a_stick"
},
"overrides": [
{
"predicate": { "custom_model_data": 7641 },
"model": "item/megaphone"
}
]
}
6. Zip and apply
Compress the my_resourcepack/ folder into a .zip file and put it on your server (via server.properties → resource-pack) or distribute it to players manually.
7. Match the value in config
Make sure custom-model-data in config.yml matches the predicate value you used in the model override:
megaphone:
custom-model-data: 7641 # Must match the override predicate
Tip: If you want to use a different base item (e.g. STICK), change megaphone.material in config.yml and create the override file for that item instead.
License
MIT © 2026 litkoit1003
评论 0
登录后参与评分
还没有评论,来抢沙发吧