WebUI Tester FAQs

Question 1

What does the WebUI Tester skill do?

Accepted Answer

The WebUI Tester skill enables Claude to interact directly with the Majsoul game interface (WebUI) inside the Naki application. it allows for real-time JavaScript execution, visual debugging of 3D objects, and precise game state monitoring through the unified NakiCoordinator API.

Question 2

What is the NakiCoordinator and why is it recommended?

Accepted Answer

NakiCoordinator is a unified API (window.naki) that provides safe, high-level methods for game interaction. Using it is preferred over direct object manipulation because it includes built-in validation, simplifies state access, and ensures that actions like 'chi' or 'pon' are executed safely within the game's lifecycle.

Question 3

When should I use this skill versus standard code editing?

Accepted Answer

Use this skill specifically when you need to test or modify the in-game interface (Laya engine) rather than the native Naki app (SwiftUI). It is essential for tasks like verifying tile positions, testing game logic, or triggering visual effects that require live interaction with the game's JavaScript environment.

Question 4

How does this skill prevent visual-to-logic synchronization errors?

Accepted Answer

The skill implements a specialized tile index mapping system. Since Majsoul's visual hand order often differs from its logical array index, this skill ensures that commands like 'discard' or 'highlight' target the correct visual tile by matching tile types and red dora flags.

Question 5

Why do my JavaScript execution results sometimes return undefined?

Accepted Answer

A common pitfall with the execute_js tool is forgetting the 'return' statement. Because the code is wrapped in a function, you must explicitly use 'return' to pass data (like game states or object properties) back to Claude for analysis.

WebUI Tester

WebUI Tester

About

Key Features

Use Cases

About

Key Features

Use Cases