语音消息

语音消息

为 Minecraft 添加语音消息功能的模组与插件。

需要安装 Simple Voice Chat。

须知事项

此模组必须在服务器和客户端同时安装才能生效。如果玩家未安装此模组，将无法看到语音消息。

此模组使用 Simple Voice Chat 中配置的麦克风及其所有设置。因此，请确保 Simple Voice Chat 设置中的 Voice Amplification（语音放大）未设置为 -100%。

此外，如果语音聊天声音已禁用，你将无法听到语音消息。

私密语音消息

你可以使用 /voicemsg <target> 或 /vmsg <target> 命令向玩家或你的队伍发送私密语音消息。

请注意，服务器可能通过权限限制你发送这些消息。

服务器设置

配置文件

服务器配置文件位于 config/voicemessages_server.json

以下是默认值及其说明：

{
  "max_voice_message_duration_ms": 90000,  // 语音消息的最大长度（毫秒），范围 [3_000;300_000]
  "voice_message_spam_punishment": "none", // 发送语音消息的时间间隔小于上一条消息长度时的惩罚措施。可选值："none"、"prevent"、"kick"
  "voice_message_invalid_punishment": "prevent", // 发送无效语音消息（超过最大长度）或未获权限发送语音消息时的惩罚措施。可选值："none"、"prevent"、"kick"
  "mod_required": false,                         // 若为 true，未安装此模组的玩家将被踢出服务器
  "mod_not_installed_text": "VoiceMessages is not installed or is of an old version" // 针对未安装此模组玩家的踢出提示消息
}

权限

• voicemessages.send - 发送语音消息的权限。默认值：true
• voicemessages.send.all - 向全局聊天发送语音消息的权限。默认值：true
• voicemessages.send.team - 向玩家所在队伍发送私密语音消息的权限。默认值：true
• voicemessages.send.players - 向其他玩家发送私密语音消息的权限。默认值：true

API

此模组自带 API。

在 build.gradle 中进行配置：

repositories {
    // 其他仓库
    
    maven {
        name "dimaskama"
        url "https://maven.dimaskama.net/releases"
    }
}

dependencies {
    // 其他依赖

    // 语音消息 API
    compileOnly "ru.dimaskama.voicemessages:voicemessages-api:${voicemessages_api_version}"
}