ВЕРСИИ (3)

Minecraft version 26.2 Fabric Loader 0.19.3 Fabric API 0.153.0+26.2

# Fabric version 0.19.3

# HTTP Block HTTP Block adds two configurable redstone blocks that allow Minecraft to communicate with external HTTP services. The HTTP Sender can send JSON POST requests when powered by redstone, while the HTTP Receiver continuously polls an HTTP endpoint and emits a redstone pulse whenever it detects a new event. This makes it easy to exchange data between Minecraft and any application capable of sending or receiving HTTP requests, regardless of the programming language or framework used. - **HTTP Sender** — sends an HTTP `POST` request when it receives a redstone rising edge. - **HTTP Receiver** — polls an HTTP endpoint and emits a short redstone pulse whenever a new event is detected. --- ## HTTP Sender Right-click the block to configure it. ### URL The HTTP endpoint that will receive the request. Example: ```text http://localhost:8000/event ``` ### Payload The raw JSON body that will be sent with the request. Example: ```json { "message": "Hello" } ``` ### Behavior - Sends an HTTP `POST` request only when redstone changes from OFF to ON. - Does not repeatedly send requests while continuously powered. - Uses `Content-Type: application/json`. - Requests are performed asynchronously and do not block the game. --- ## HTTP Receiver Right-click the block to configure it. ### URL The endpoint to poll for events. Example: ```text http://localhost:8000/event ``` > **Note:** The endpoint must return JSON matching the **Event Format** described below. The receiver expects that structure to detect new events correctly. ### Last Message Displays the message from the most recently received event. ### Behavior - Polls the configured endpoint periodically. - Compares the returned event's `hash` with the last one it received. - Emits a redstone pulse only when the hash changes. - Duplicate events do not trigger another pulse. - Pulse strength is always 15. - Pulse duration is configurable. --- ## Event Format The receiver expects the endpoint to return JSON in the following format: ```json { "timestamp": 1750412345, "message": "Hello", "hash": "6a8f6c5d..." } ``` | Field | Description | | ----------- | ------------------------------------------------------------- | | `timestamp` | Unix timestamp of the event. | | `message` | Text shown in the receiver GUI. | | `hash` | Unique identifier for the event. A new hash triggers a pulse. | Only the `hash` is used to detect new events. A simple Python Example is shown below. --- ## Example Relay (FastAPI) The HTTP Receiver expects an endpoint that returns events in the format shown above. Below is a minimal FastAPI relay implementation that satisfies the required API. ```python from fastapi import FastAPI from pydantic import BaseModel import hashlib import time import uvicorn app = FastAPI() latest_event = { "timestamp": 0, "message": "", "hash": "", } class EventIn(BaseModel): message: str @app.post("/send_event") async def create_event(data: EventIn): global latest_event message = str(data.message) timestamp = int(time.time()) event_hash = hashlib.sha256(f"{timestamp}:{message}".encode()).hexdigest() latest_event = { "timestamp": timestamp, "message": message, "hash": event_hash, } return {"success": True} @app.get("/get_event") async def get_event(): return latest_event if __name__ == "__main__": uvicorn.run(app, host="0.0.0.0", port=9000) ``` Install the required packages: ```bash pip install fastapi uvicorn ``` Run the relay: ```bash python relay.py ``` Then configure your blocks: - **HTTP Sender URL:** `http://localhost:9000/send_event` - **HTTP Receiver URL:** `http://localhost:9000/get_event` ## Commands ```text /http pollrate <ticks> ``` Sets how often receivers poll their configured URL. ```text /http pulselength <ticks> ``` Sets how long receiver pulses last. ```text /http status ``` Shows the current configuration and registered sender/receiver counts. ```text /http reload ``` Reloads the configuration from disk. ---