개발자 문서Developer Docs
Tessera의 통신 프로토콜은 공개되어 있습니다. 누구나 자신만의 클라이언트나 봇 — 자동으로 여행하고, 집을 짓고, 광물을 캐고, 사람처럼 채팅하는 봇 — 을 만들어 라이브 서버에 접속할 수 있습니다.
프로토콜 명세
아래 문서 하나에 모든 것이 담겨 있습니다: WebSocket 핸드셰이크, 모든 JSON 메시지, 바이트 단위 바이너리 프레임 배치, 이동 검증(안티치트) 규칙, 그리고 소스 레지스트리에서 자동 생성되는 블록/아이템/조합법/몹 데이터 테이블. LLM에 이 파일을 그대로 붙여넣어 봇 코드를 생성시킬 수 있도록 자기완결적으로 작성했습니다.
📄 PROTOCOL.MD 열기 🤖 LLMS.TXT빠른 참조
- 게임 서버:
wss://tessera.kimhwan.kr/ws - 계정 API:
POST /api/register·POST /api/login(JWT 발급) - 서버 빌드 확인:
GET /api/version
봇 에티켓
실제 플레이어가 함께하는 공유 월드입니다. 채팅 도배, 남의 건축물 훼손, 과도한 메시지 전송은 일반 플레이어와 동일하게 제재됩니다. 문서의 규칙(블록 채굴 시간, 이동 물리)을 지키는 봇을 만들어 주세요.
Tessera's wire protocol is open. Anyone can build their own client or bot — one that explores, builds houses, mines ore, or chats like a person — and connect it to the live server.
Protocol specification
One document holds everything: the WebSocket handshake, every JSON message, byte-exact binary frame layouts, the movement-validation (anti-cheat) rules, and block/item/recipe/mob data tables generated straight from the game's source registries. It is written to be self-contained enough to paste into an LLM and get working bot code back.
📄 OPEN PROTOCOL.MD 🤖 LLMS.TXTQuick reference
- Game server:
wss://tessera.kimhwan.kr/ws - Account API:
POST /api/register·POST /api/login(returns a JWT) - Server build:
GET /api/version
Bot etiquette
It's a shared world with real players. Chat spam, wrecking other people's builds, and message flooding get moderated exactly like any player would be. Please build bots that respect the documented rules (block break times, movement physics).