Skoice 是一款 Minecraft 插件，它允许服务器上的玩家根据游戏中的位置进行语音交流。简单来说，只有附近的玩家才能互相交谈。它最大的特点是与 Discord 联动，用户无需下载任何额外软件即可使用此近距离语音聊天功能。

---

🎉 支持的服务器软件

• Spigot (或其衍生版本，如 Paper, Purpur)
• Velocity (使用我们的 Proxy Guide)
• Fabric (使用 Cardboard)
• Forge (使用 Magma 或 Mohist)

如果你的服务器允许来自 Bedrock Edition 的玩家（例如通过 Geyser），他们也可以像 Java Edition 一样使用 Skoice。

---

⚙️ 安装

下载插件后，只需将文件放入 Minecraft 服务器的 "plugins" 文件夹并启动它。使用具有管理员权限（或 "skoice.manage" 权限）的帐户加入服务器，并按照发送给你的说明进行操作。

Skoice 也可以直接从许多免费 Minecraft 主机的面板上获得。因此，你可以在 Alternos 上获得它。

---

✨ 功能特性

Skoice 可以直接从 Discord 进行高度自定义。以下是一些你可以做的事情：

• 自定义近距离语音聊天的范围。
• 包括或排除某些类型的玩家（观察者、死亡玩家）。
• 选择 Skoice 处于活动状态的世界。
• 创建多个无法相互通信的团队。
• 选择你想要向玩家显示哪些来自插件的消息。
• 切换外部插件与 Skoice 的同步（DiscordSRV、EssentialsX）。

---

⌨️ 命令

Minecraft

• /skoice configure: 获取开始配置过程的说明。*
• /skoice token <token>: 将 Discord 机器人链接到你的 Minecraft 服务器。*
• /skoice language <language>: 更改 Skoice 使用的语言。*
• /skoice tooltips: 切换交互式消息，在 Bedrock Edition 上或在 Minecraft 设置中禁用工具提示时非常有用。*
• /skoice link <code>: 将你的 Minecraft 帐户链接到 Discord。
• /skoice unlink: 取消将你的 Minecraft 帐户与 Discord 的链接。

* 需要管理员权限（或 "skoice.manage" 权限）

Discord

• /configure: 根据你的需求自定义 Skoice（需要 "Manage Server" 权限）。
• /link: 获取用于将你的 Discord 帐户链接到 Minecraft 的代码。
• /unlink: 取消将你的 Discord 帐户与 Minecraft 的链接。
• /invite: 获取与 Skoice 相关的外部链接。

注意： "Use Application Commands" 权限会自动授予用户，因为执行这些命令需要此权限。

---

❓ 获取帮助

如果你在使用 Skoice 时遇到任何问题，可以加入我们的 Discord 服务器。

---

💖 捐赠

请记住，Skoice 是一个免费软件。如果你喜欢它，你可以通过捐赠来帮助我们。

如果你喜欢我们的工作，请考虑留下评论！

---

🛠️ 配置示例

#   _____                         _   _            _____
#  / ____|                       | | (_)          / ____|
# | |     ___  _ __   __ _ _ __ | |_ _  ___  ___| (___   ___ _ __   ___  ___
# | |    / _ \| '_ \ / _` | '_ \| __| |/ _ \/ __|\___ \ / _ \ '_ \ / _ \/ __|
# | |___| (_) | | | | (_| | | | | |_| |  __/ (__  ____) |  __/ | | |  __/ (__
#  \_____\___/|_| |_|\__,_|_| |_|\__|_|\___|\___||_____/ \___|_| |_|\___|\___|
#
# Join our Discord server for help: https://skoice.com/discord
#
# Permissions:
#   - skoice.manage: Allows access to the /skoice configure, /skoice token and /skoice language commands
#   - skoice.admin: Allows access to all commands

# General settings for Skoice
settings:
  # The language used by Skoice
  # Available languages: en, cs, da, de, es, fr, it, ja, nb, pl, pt, ru, tr
  language: en
  # Whether to send interactive messages (tooltips)
  tooltips: true
  # The bot token (leave empty to disable Discord support)
  token: ""
  # Whether to link players automatically when they join the server
  auto-link: false
  # Whether to display a message when a player joins or leaves the voice chat
  presence-messages: true
  # Time in seconds before retrying to send messages
  message-retry: 3
  # Whether to display debug messages in the console
  debug: false
  # Whether to check for updates on startup
  update-check: true
  # List of disabled Metrics modules (https://bstats.org/what-is-bstats)
  # Available modules: charts, errors, os, system, timings
  disabled-metrics-modules: []

# Settings related to the proximity voice chat
voice:
  # The range of the voice chat (in blocks)
  range: 20
  # Whether the range is squared or not (performance)
  squared-range: false
  # Whether to include players in spectator mode
  include-spectators: false
  # Whether to include dead players
  include-dead-players: false
  # Worlds where the voice chat is enabled (leave empty to enable in all worlds)
  enabled-worlds: []
  # List of blocked voice channels where players are muted
  blocked-channels: []
  # Settings related to the microphone
  microphone:
    # Whether the microphone is enabled by default
    enabled: true
    # Whether the microphone can be toggled
    toggleable: true

# List of teams
teams:
  # Example team
  example:
    # The name of the team
    name: Example
    # List of roles that are part of the team
    roles: []

# List of messages
messages:
  # The prefix used by Skoice
  prefix: "&8[&3Skoice&8] &7"
  # Message sent when the configuration is completed
  configure-completed: "Configuration completed! You can now use /skoice link to link your account."
  # Message sent when the player is not linked
  not-linked: "You are not linked! Use /skoice link to link your account."
  # Message sent when the player is already linked
  already-linked: "You are already linked!"
  # Message sent when the link code is invalid
  invalid-code: "Invalid code!"
  # Message sent when the player is successfully linked
  link-success: "You are now linked!"
  # Message sent when the player is successfully unlinked
  unlink-success: "You are now unlinked!"
  # Message sent when the language is changed
  language-changed: "Language changed to %language%!"
  # Message sent when tooltips are enabled
  tooltips-enabled: "Tooltips enabled!"
  # Message sent when tooltips are disabled
  tooltips-disabled: "Tooltips disabled!"
  # Message sent when the microphone is enabled
  microphone-enabled: "Microphone enabled!"
  # Message sent when the microphone is disabled
  microphone-disabled: "Microphone disabled!"
  # Message sent when the player joins the voice chat
  join-voice-chat: "&a%player% joined the voice chat!"
  # Message sent when the player leaves the voice chat
  leave-voice-chat: "&c%player% left the voice chat!"
  # Message sent when the player is muted
  muted: "You are muted!"
  # Message sent when the player is unmuted
  unmuted: "You are unmuted!"
  # Message sent when an error occurs
  error: "An error occurred! Please contact an administrator."
  # Message sent when the plugin is disabled
  plugin-disabled: "Skoice has been disabled!"
  # Message sent when the plugin is being reloaded
  plugin-reloading: "Skoice is reloading..."
  # Message sent when the plugin has been reloaded
  plugin-reloaded: "Skoice has been reloaded!"

# Integrations with other plugins
integrations:
  # DiscordSRV (https://www.spigotmc.org/resources/discordsrv.18494/)
  discordsrv:
    # Whether to synchronize DiscordSRV roles with Skoice teams
    sync-roles: false
    # List of Discord roles that are ignored
    ignored-roles: []
  # EssentialsX (https://www.spigotmc.org/resources/essentialsx.9089/)
  essentialsx:
    # Whether to ignore vanished players
    ignore-vanished: true

# These settings are not meant to be modified
internal:
  version: 1