@libmsmp/nuxt

Nuxt module for the Minecraft Server Management Protocol (MSMP). Owns one MSMP client in Nitro (secret server-side), streams live server state to the browser over SSE, and exposes a typed useMinecraftServer() composable.

Part of libmsmp.

npm install @libmsmp/nuxt

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ["@libmsmp/nuxt"],
  msmp: {
    host: "127.0.0.1",
    port: 25585,
    secret: process.env.MSMP_SECRET,
    tls: true,
    tlsOptions: { rejectUnauthorized: false },
    // denyMethods: ["minecraft:server/stop"], // blocked from the command route by default
  },
});

<script setup lang="ts">
const mc = useMinecraftServer();
async function kick(name: string) {
  await mc.players.kick([{ name }]);
}
</script>

<template>
  <p>
    {{ mc.connected ? "Live" : "Connecting…" }} —
    {{ mc.state.players.length }} online
  </p>
  <ul>
    <li v-for="p in mc.state.players" :key="p.id ?? p.name">
      {{ p.name }} <button @click="kick(p.name!)">Kick</button>
    </li>
  </ul>
</template>

mc.state is reactive (SSE-fed); actions POST to a guarded command route. minecraft:server/stop is denied by default — opt in via denyMethods: [].

See the full documentation.

License

MIT © Simeon L