py-mcws 2.0.1

Minecraft Bedrock WebSocket

py-mcws

MinecraftとPythonを繋げるためのシンプルなライブラリ

---

インストール

pip install py-mcws

使い方

import py_mcws

server = py_mcws.WebsocketServer()


@server.event
async def on_ready(host, port):
    print(f"サーバーを起動しました。\n'/connect {host}:{port}'で接続できます")


@server.event
async def on_connect():
    print("接続しました")
    await server.command("say Hello World!") #　メッセージを送信


@server.event
async def on_PlayerMessage(event):
    print()

server.start(host="0.0.0.0", port=19132)

[!WARNING] 現在、以下のコードは非推奨です。
クロームブックのマインクラフト統合版でプログラミングをしてみるを参考してください。

import py_mcws

class MyWsClient(py_mcws.WsClient):
    def event_ready(self):
        print(f"Ready {self.host}:{self.port}")

        #受け取るイベント
        self.events = ["PlayerMessage", "PlayerDied"]
    
    async def event_connect(self):
        print("Connected!")

        #コマンドを実行
        await self.command("say Hello")
    
    async def event_disconnect(self):
        print("disconnect!")

    async def event_PlayerMessage(self, event):
        print(event)

    async def event_PlayerDied(self, event):
        print(event)

MyWsClient().start(host="0.0.0.0", port=19132)

接続の仕方

[!WARNING] ワールドの設定でチートを有効にする必要があります。

Minecraft内のチャットで以下のコマンドを実行してください。

/connect host:port

イベントを受け取る

[!NOTE] Minecraftで受け取れるイベントは以下から確認してください。
MCPE & W10 Event Names by jocopa3

PlayerMessageイベントを受け取る例

@server.event
async def on_PlayerMessage(event):
    print(event)

コマンドを実行する

Minecraft と接続している状態でコマンドを実行してください。

cmd = await self.command("say hello")
print(cmd)