@2sheep/mcp 0.1.2 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -3
- package/dist/cli.js +23 -13
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -44,7 +44,16 @@ Other clients take the usual JSON:
|
|
|
44
44
|
Create a lobby on TwoSheep and give your agent the code: "Join TwoSheep lobby K7QM2P and play the game."
|
|
45
45
|
Or ask it to make one: "Create a 4-player TwoSheep lobby with two hard bots, tell me the code, then play."
|
|
46
46
|
|
|
47
|
-
- **Supported games:**
|
|
47
|
+
- **Supported games:** 2 to 8 players, on built-in boards or custom maps:
|
|
48
|
+
- the base game;
|
|
49
|
+
- Seafarers: every scenario map, and the Fog Bank and Misty Realms maps;
|
|
50
|
+
- Fisherman: Fish Ponds and Fish Shoals;
|
|
51
|
+
- Rivers, Troll Bridge (and trolls on any map), Merchant Trains (Caravans) and desertification (Dust Bowl);
|
|
52
|
+
- event cards, turbo (two rolls a turn) and the second settler;
|
|
53
|
+
- the lazy and speed robber, and the starting-placement rules (coastal or inland, a starting city).
|
|
54
|
+
|
|
55
|
+
The agent refuses Cities & Knights and rush. It can still set those games up for other people (see hosting below).
|
|
56
|
+
- **Expansion moves:** ships (build, move, place as a starting piece), the pirate, gold and free-resource picks, fish spending and the old boot, bridges and gold coins (including gold in trades), feeding trolls, and what event cards ask of each seat. Some of these are owed off the agent's turn, such as an event card's gift or a gold pick. Then `wait_for_turn` wakes it with a note saying what is asked. OpenHex has no names for the expansions, so their state, actions and events are TwoSheep additions in the same style.
|
|
48
57
|
- **Rules:** the lobby sets the points to win, the discard limit and whether the robber is friendly, and the agent reads them from the game. 2-player lobbies the agent creates use 15 points, a discard on a 7 for a player holding more than 9 cards, and the friendly robber, which can't block a player who has only their starting points. Bigger ones use the classic 10 points and a discard above 7.
|
|
49
58
|
- **Trading:** in games of 3 or more (and 2-player lobbies that allow it), the agent trades with the other players as well as the bank. On its move it offers trades, waits a few seconds for answers, and carries one out with a player who accepted. It answers other players' offers too: accepting, rejecting, or countering with its own terms. Site bots wait up to 20 seconds for an agent's answer to their offers, rather than the 5 they give people.
|
|
50
59
|
- **Site bots:** a game's bots move when someone at the table asks the server to move them. People's browsers do this, and so does the agent, so a game of agents and bots keeps going with no browser open.
|
|
@@ -62,7 +71,7 @@ It replies with a link that opens the map in the site's map editor.
|
|
|
62
71
|
- **Checks:** the agent refuses to save a map that couldn't be played, such as one with numbers on a desert, a port inland, or a robber at sea. It also warns about legal but unusual choices, such as 6s next to 8s, islands without Seafarers, or a resource nothing produces.
|
|
63
72
|
- **Who can find it:** maps are unlisted, so only people with the link find them. Only signed-in people can publish maps, so the agent can't.
|
|
64
73
|
- **Changing a map:** the agent can update the maps it made, which saves a new version. It can read any map by its id, so you can give it a link to a map to copy.
|
|
65
|
-
- **Playing on it:** the agent
|
|
74
|
+
- **Playing on it:** the agent plays maps with every feature but Cities & Knights, more than one robber and a skipped starting settlement. The map's overview says whether it can.
|
|
66
75
|
|
|
67
76
|
## The agent's account
|
|
68
77
|
|
|
@@ -78,7 +87,7 @@ Put options after the package name, for example `npx -y @2sheep/mcp@latest --pro
|
|
|
78
87
|
| Option | What it does |
|
|
79
88
|
|---|---|
|
|
80
89
|
| `--profile <name>` | Use a separate account. Two agents on one machine need different profiles to play each other. |
|
|
81
|
-
| `--format coordinates\|indices` | Show board positions as OpenHex cube coordinates (the default), or as numbered positions on the standard board. |
|
|
90
|
+
| `--format coordinates\|indices` | Show board positions as OpenHex cube coordinates (the default), or as numbered positions on the standard board (base games on that board only). |
|
|
82
91
|
| `--emulator` | For development: use local Firebase emulators instead of the live site. The other `--emulator-*` options set their host, ports and project. |
|
|
83
92
|
| `--version`, `--help` | Print the version, or the options, and exit. |
|
|
84
93
|
|