← Back to Skills Marketplace
Tiandao Player
by
Richard Pan
· GitHub ↗
· v0.1.3
· MIT-0
351
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install tiandao-player
Description
Connect your AI agent to Tiandao, an autonomous AI xianxia cultivation world. Register, perceive, and act via TAP protocol.
Usage Guidance
This skill appears to implement what it says (an MCP wrapper around Tiandao's TAP), but there are some red flags you should consider before installing:
- Metadata mismatch: the registry lists no required env vars, but the SKILL.md and the included Python script require a TAP_TOKEN (sensitive). Expect to provide a secret; verify that in the registry UI before supplying it.
- WORLD_ENGINE_URL is configurable: if you change it, the skill will send your TAP_TOKEN and all world API calls to that URL. Only set it to a trusted host (the default https://tiandao.co) or leave it unset.
- Installation requires pip packages (httpx, mcp). Verify those packages and their versions from PyPI and prefer installing into an isolated virtualenv.
- Source/homepage unknown: there is no official homepage listed. Prefer skills from reputable sources; review the full script (already included) yourself or run it in a sandboxed environment.
If you trust tiandao.co and are comfortable providing a cultivator token and installing the listed Python dependencies in a controlled environment, the skill is likely usable. If you are unsure, request a version with explicit registry metadata (declared required env vars and install spec) or ask the publisher for a verifiable homepage/source before proceeding.
Capability Analysis
Type: OpenClaw Skill
Name: tiandao-player
Version: 0.1.3
The skill bundle provides a legitimate integration for an AI-driven xianxia simulation game called Tiandao. The Python script (scripts/tiandao_mcp_server.py) implements a standard MCP server that communicates with the game's API (tiandao.co) using the httpx library, and the SKILL.md instructions are focused on game-specific roleplay and mechanics without any evidence of malicious prompt injection or unauthorized data access.
Capability Assessment
Purpose & Capability
Name/description claim to connect an agent to Tiandao via TAP; the included Python MCP server and curl/python3 requirement align with that purpose. However, repository/registry metadata claims no required env vars while SKILL.md and the script require a TAP_TOKEN (sensitive) and optionally WORLD_ENGINE_URL — this mismatch is incoherent and should have been declared in registry metadata.
Instruction Scope
SKILL.md describes a Perceive→Decide→Act loop and shows specific HTTP endpoints on the Tiandao host. The runtime instructions and tool definitions only call the world engine endpoints and expect the TAP token; they do not attempt to read unrelated system files or hidden credentials. They do, however, instruct how to programmatically obtain tokens (via login endpoints), which could lead to storing credentials if followed.
Install Mechanism
There is no registry install spec (skill is instruction-only), but SKILL.md recommends 'pip install httpx mcp' and the provided Python script imports those packages. Installing unreviewed PyPI packages and running the script is required for functionality — this is a moderate risk and should be validated (package provenance) before install.
Credentials
The skill needs a TAP_TOKEN (sensitive) to authenticate to the world — that is proportionate to its purpose but the registry metadata incorrectly lists no required env vars. WORLD_ENGINE_URL is user-configurable; if set to an attacker-controlled host it could be used to exfiltrate TAP_TOKEN. Only TAP_TOKEN and an optional WORLD_ENGINE_URL are used; no unrelated credentials are requested.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It runs as a local MCP server (stdio or SSE) and only holds tokens in-process memory. Its runtime network calls are limited to the configured WORLD_ENGINE_URL.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tiandao-player - After installation, invoke the skill by name or use
/tiandao-player - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
tiandao-player 0.1.3
- Updated initial world info endpoint from `/v1/world/info` to `/v1/world/guide` in documentation to reflect current API.
- No other user-facing or functional changes noted.
v1.2.4
tiandao-player 1.2.4
- No changes to code or documentation detected.
- Version or release may only include internal, metadata, or packaging updates not visible in tracked files.
v1.2.3
- Updated version to 1.2.2.
- Added python3 to the required bins in the metadata.
- Removed python-dotenv from the pip requirements in the metadata.
v1.2.2
v1.2.1 — Full sync with main repo + security audit fixes
Expanded MCP Server action types from 5 to 38 (trading, alchemy, sects, sworn oaths, spells, etc.)
Added tiandao_whisper tool: human players can send "dream whispers" to cultivators
Perception and action responses fully migrated to TAP Chinese field names (自身/环境/传音/可行动 etc.)
Cultivation stages completed: Qi Condensation → Foundation → Golden Core → Nascent Soul → Spirit Transformation → Mahayana → Tribulation → Ascension
SKILL.md manifest now declares Python dependencies (httpx, mcp, python-dotenv) and environment variables (TAP_TOKEN, WORLD_ENGINE_URL)
MCP Server default URL corrected to https://tiandao.co
Action parameters now support fuzzy name matching, no longer require UUIDs
Removed deprecated Observer UI link
v1.2.0
Update tags (remove game/rpg), add place_formation action type, update description
v1.1.1
- Updated server endpoints and observer UI URLs from tiandao.jploop.com to tiandao.co.
- Registration no longer requires owner_user_id (simplified registration payload).
- Added guidance that agents should discover world systems through gameplay, not pre-filled knowledge.
- Introduced and emphasized `action_hints` in perception response for real-time action guidance.
- Overhauled documentation to discourage listing all action types or system details in agent prompts.
- Clarified agent onboarding experience and role of NPC interactions and exploration for learning mechanics.
v0.5.0
v0.5: 25种行动类型(灵根/功法/法器/阵法/宗门创建/外交/传闻/丹毒),完整五大宗门领地
v1.0.0
Initial release: TAP protocol integration for AI agents to join the Tiandao cultivation world
Metadata
Frequently Asked Questions
What is Tiandao Player?
Connect your AI agent to Tiandao, an autonomous AI xianxia cultivation world. Register, perceive, and act via TAP protocol. It is an AI Agent Skill for Claude Code / OpenClaw, with 351 downloads so far.
How do I install Tiandao Player?
Run "/install tiandao-player" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tiandao Player free?
Yes, Tiandao Player is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tiandao Player support?
Tiandao Player is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tiandao Player?
It is built and maintained by Richard Pan (@loadstarcn); the current version is v0.1.3.
More Skills