/MelodyMine

Minecraft Server Voice Plugin

Primary LanguageKotlinApache License 2.0Apache-2.0

MelodyMine Logo

MelodyMine (Minecraft Voice Plugin)

License TypeScript Kotlin

🚀 Welcome to the MelodyMine GitHub Project! Explore the world of MelodyMine and enhance your Minecraft server experience. 🌍✨

Introduction 🌐

MelodyMine is a revolutionary system for Minecraft servers where players can simultaneously enter a web interface, communicate, voice chat, and make their in-game interactions richer. Elevate your gameplay with MelodyMine! 🎮🌐

Key Features 🌟

  • 🗣️ Admin Mode: Admins can communicate with players across the entire server and listen to their conversations, even from a distance. Maintain control and ensure a safe environment. 🔊🔒

  • 📼 Toggle Logger: Users can easily record player interactions and voice conversations. Starting and stopping voice recordings is a breeze, providing valuable insights into your server's activities. 📜📼

  • 🔇 Player Mute/Unmute: Users can mute or unmute players directly from the web interface, ensuring that no one's voice goes unnoticed. Manage the voice communication effectively. 🧏‍♂️📢

  • 🌐 Proxy-Less Plugin: MelodyMine can change players' game modes on the website without the need for a proxy like Velocity or BungeeCord. It also captures the voices of players in the same game mode and those nearby, creating a seamless experience. 🏹🖥️

  • 🔒 AuthMe Support: Seamlessly integrate with AuthMe, allowing players to enter the server using their username and password. Enhance security and accessibility. 🔒🔑

  • 🌐 Automatic Login: Users can obtain an automatic login link by using the /melodymine start link command, simplifying website login and reducing hassle. 🌐🚪

  • 🌐 QRCode Automatic Login: Players can obtain a QR code by using the command /melodymine start qrcode, and by scanning it, they can enter the website. 🌍✨

  • 🛠️ Comprehensive API: Developers have access to a comprehensive API, including events like PlayerJoinWebEvent and PlayerLeaveWebEvent, enabling the creation of custom plugins and expanding the possibilities of your server. 📚👩‍💻

  • 📝 Simple Plugin config.yml: Customize plugin settings and messages easily with the user-friendly config.yml.

# ----- Database configs -----
database:
  host: "localhost"
  port: "3306"
  user: 'root'
  password: ''
  database_name: 'melody'

# ----- Basic configs -----

# game mode name.
server: "Lobby" # must be unique!

# website url
website: "http://localhost:3000"

# websocket url
websocket-url: "ws://localhost:4000"

# websocket auth security key !!! (important) change that after install plugin !!!
websocket-auth-key: "" # must be the same in web server auth key

# users must be online in website and active voice chat.
force-voice: false

# shortcut for toggle self mute in website (Shift + F)
mute-toggle-shortcut: true

# call configs
call-pending-time: 600 # must be Long (10L = 0.5s, 20L = 1s,...)

# ------ sound configs ------

3D-sound: true # player voice 3D mode.
hear-lazy: true # default player volume (when 3DSound is "false" you can use this feature).
max-distance: 30 # distance that players can hear each other.
ref-distance: 5  # distance that players can hear each other max volume.
inner-angle: 120 # angle that players can hear each other max volume.
outer-angle: 180 # angle that players can hear each other.
outer-volume: 0.3 # outer angle volume.

# update player distance time (as Long)
update-distance-time: 10 # must be Long (10L = 0.5s, 20L = 1s,...)
  • 📞 Call System: You have the ability to make a call using the command /melodymine call start <player> to call other players.

  • 🎧 3D Voice Capability: Player sounds are played in 3D, and you can determine the player's position through sound.

  • 🐞 Robust System: MelodyMine is a highly reliable and secure system with minimal bugs. Any discovered bugs are promptly addressed and fixed, ensuring a smooth and hassle-free experience for all users. Be part of a community that values your experience and offers continuous improvement. Find announcements and updates on our GitHub repository. 🛠️🐛

Links 🔗

  • 📖 Wiki: To access detailed documentation, visit the MelodyMine Wiki.

  • 💾 Plugin Installation: Get started with the installation by following the Plugin Installation Guide.

  • 📜 Command List: Explore the list of available commands in the Command List.

  • 🚦 Permissions List: Check out the permissions you need in the Permissions List.

  • 📄 Placeholder Information: Discover placeholder details in the Placeholder Information.

  • 📚 API Documentation: Dive into the API for advanced customization in the API Documentation.

  • 🧩 Spigot: Discover MelodyMine on Spigot

  • 💼 Modrinth: Find MelodyMine on Modrinth

  • 🌐 Polymart: Check out MelodyMine on Polymart

  • 💬 Hangar: Discover MelodyMine on Hangar

Get Started 🚀

Ready to harmonize your Minecraft server experience? Join the MelodyMine community and embark on a journey to enhance your Minecraft server. Explore the endless possibilities, and remember, your experience matters to us! Connect, engage, and play with MelodyMine today! 🌟🎮

🌐 Visit our GitHub repository for updates, bug reports, and contributions. 🛠️🐞