IPSJ Programming Contest Committee
2020/09/29
The SamurAI Dig Here page is a tool to enjoy the game of SamurAI Dig Here on HTML browsers.
You can do the following in the SamurAI Dig Here page.
The figure below shows a sample display image of the page.
The game field is divided into grid-aligned cells.
Four agents, one samurai and one dog for each side, are initially located on some of the distinct cells of the game field.
Agents can move to one of the neighboring cells in a single game step, or can also choose to stay on the same cell. Dogs can move to any of the eight neighboring cells. Samurai can usually move only one of the four neighboring cells, however, when they take a rest, they can move to any of the eight neighbors in the step immediately following. Samurai in such a state are colored more brightly.
Initially, some of the cells in the game field have a hole, preventing game agents from stepping into them.
Samurai can dig a new hole or plug a new hole in a neighboring cell. Usually, one of the four neighboring cells are the target of digging or plugging, however, in the step immediately after a rest step, any of the eight neighboring cells can be the target. Dogs can do neither.
Some of the cells have certain amounts of buried treasure. Positions and amounts of some of them are already known initially, while some are not. The objective of the game is to dig out more treasure than the opponent. Samurai can dig out the buried treasure in neighboring cells by digging new holes there.
Dogs on one of the eight neighboring cells can detect the existence and the amount of the buried treasure. When a dog is on a cell with buried treasure, the position and the amount of the treasure is revealed to all the agents of both teams.
Clicking the import button
on top of the screen,
a window for selecting a file to import pops up.
A game log is imported by choosing a file.
Note that, when the game log is updated after importing, loading the same file expecting the updated one to be loaded may fail, because the browser sticks to the cache kept on the first import, that is, the version before the update. Reloading the whole web page by the reload feature of the browser may solve the problem.
The initial play mode is automatic. In the automatic mode, game steps recorded in the game log loaded are visualized, and steps beyond what are recorded are automatically generated with agent moves chosen by players built in the system. The generated moves are appended to the game record.
The game progresses controlled by some of the buttons on the top.
Buttons on the top left and their functions are as follows.
rolls back the display to the initial state of the game.
displays the game state of one step before the current.
starts automatic playback that repetitively displays
the following steps in a constant pace
until the end of the game is reached.
The button changes its form to
,
clicking which stops the playback.
When the end of the plays in the recorded game is reached,
but the game is not ended yet,
following steps are automatically generated,
as stated above.
The speed of playback can be adjusted using the
speedometer button
explained below.
makes a single step of playback.
displays the game state of the last step of the game record.
can be used to adjust the speed of playback.
The number displayed on its right indicates
the current playback speed in steps per minute (spm, in short).
Clicking the speedometer will decrease the speed by 4 spm,
or increase it by 4 spm if a shift key is pressed down.
The speed can also be adjusted by rotating the mouse wheel
while the mouse cursor is on the speedometer.
The maximum play speed is 240 spm and the minimum is 24.
.
Buttons on the top right and their functions are as follows.
starts the edit mode (described below).
coming next, the positions and the amounts of all the hidden
buried treasure in the game field are displayed with their
amounts in red figures. Releasing the button makes them
hidden again.
displayed on the top right of the screen.
Clicking the icon advances or rolls back the displayed state
by one step, depending whether or not a shift key is pressed.
Rotating the wheel up or down also advances or rolls back
the displayed state.
When a control key is pressed,
10 steps are advanced or rolled back at a time.
Neither going before the initial state nor
beyond the last recorded step is possible.
starts the manual play mode.
pops up the settings dialog
in which detailed settings can be adjusted.
opens the manual page, that is, this page, in a separate
tab. If the language preference of the browser is Japanese
(ja), the Japanese page is shown.
In the manual play mode, one of the two samurai can be controlled manually.
Clicking the manual play button
on the top right starts the manual play mode.
The first click on the button makes the red samurai controlled
manually. The button changes its color to red
.
All the other agents, dogs and the blue samurai, are
controlled by the built-in players.
Another click makes the blue samurai under manual control,
and changes the button color to blue
.
The the red samurai is then controlled by the built-in player,
as well as dogs.
Still another click will revert the play mode to automatic,
changing the button color back to the original white.
In the manual play mode, arrow symbols are displayed on cells around the manually controlled agent, showing possible plays. Clicking the cells marked with arrows tells the following.
Actions of the manually controlled samurai can also be told by
pressing keys.
The keys and their meaning are as follows.
| y | Upper left cell (↖) | u | Upper right cell (↗) |
|---|---|---|---|
| b | Lower left cell (↙) | n | Lower right cell (↘) |
| h ← | Left cell (←) | l → | Right cell (→) |
| k ↑ | Upper cell (↑) | j ↓ | Lower cell (↓) |
| . space | Take a rest |
Stepping manually deletes any play records of steps beyond the played step, and the result of the stepping is recorded as the last step.
Automatic plays can also be instructed in the manual play mode.
Single step by the step forward button
,
and repetitive play by the play button
,
are possible.
When the play stops, the play mode is kept to be manual.
Rolling back to the initial state by the rewind button
is also possible.
Edit mode is enabled by clicking the edit button
on top of the screen.
The edit mode enables editing, saving, and loading the
game log and/or configuration of the game field.
The following changes are made on the displayed screen.
In the edit mode, the border of the cell with the mouse pointer
becomes white, indicating that the cell is being edited.
Any configuration changes discard all of the recorded play.
Pressing a mouse button on a cell with an agent on it, and dragging the mouse moves the agent another cell. Agents cannot be moved to a cell with buried treasure or a hole; instead, the position will be the cell the mouse cursor was previously on.
If a shift key is pressed when the mouse mouse button is pressed, the agent rotates clockwise. Note that, although this changes the appearance of the agent in the initial state, it has no influence on the game play.
The amount of buried treasure in a cell can be increased or decreased by clicking the mouse button on the cell. With a mouse click without pressing a shift key decreases the amount by 2. When the amount becomes 0, the buried treasure in the cell disappears. A mouse click while pressing a shift key increases the amount by 2. When the click is on a cell while pressing a shift key on a cell without any buried treasure, treasure of amount 2 is buried in the cell.
A mouse click on a cell with buried treasure while pressing a control key toggles the treasure initial status between apparent and hidden. Amounts of hidden treasures are displayed in red figures while those of apparent ones are in yellow.
With a mouse click on a cell with a hole, it is plugged up. Otherwise, if the cell does not have any buried treasure, a new hole is dug out.
Clicking the expand button
increments the number of cells in one side of the field.
Clicking it with a shift key pressed down decrements it.
The size cannot be made smaller than 6 nor larger than 20.
Agents on cells lost on resize will be moved to some other cells.
Any holes and buried treasures in the cells lost or on the cell
to which an agent is moved will be lost.
The maximum number of steps of the game can be
incremented or decremented by
a mouse click or mouse wheel rotation on the clock icon
while in the edit mode.
Clicking the icon while pressing a shift key
increments the maximum number of steps and
decrements otherwise.
Rotating the wheel up or down increments or decrements it
respectively.
When a control key is pressed, the change amount is multiplied by 10.
It cannot be set to be less than 10.
Clicking the random configurations button
makes a new random field configuration.
Play logs, if any, will be lost.
If a shift key is pressed on clicking, only the buried treasures (both hidden and known) are reconfigured at random, without changing the positions of agents and holes.
Clicking the clear log button
discards play logs, if any, keeping the field configuration as is.
This is meant for saving or exporting the field configuration
without any play logs.
The current game state, that is, the configuration of the game field as well as the play log, can be saved to the storage of the browser for loading afterwards. This storage is kept in the browser of the system; Neither page reloading reload nor browser is restart will destroy the record. The record, however, cannot be accessed with other browsers or on other systems.
Clicking the save button
on the screen top, a dialog window pops up for entering a name.
When the name is entered, the current game is saved with that name.
Game states saved with the same name, if any, will be overwritten.
Clicking the load button
on the screen top, a list of names of saved game states appears.
Choosing one of them will load the game state with that name.
Clicking the remove button
on the screen top, a list of names of saved game states appears.
Choosing one of them will remove the game state with that name
from the storage.
Clicking the export button
on top of the screen,
a window to input the name for a file pops up.
Game log of the current game is exported into the file with
given name.
If no file name extension is specified,
the extension of ".dighere" is automatically appended to
the name.
Clicking the exit edit mode button
on the screen top ends the edit mode,
and the display the initial state reflecting the editing.
Detailed settings can be altered with the settings dialog
shown by clicking the settings button
.
Several music tunes are provided to be played during the automatic plays. They are different arrangements of Hanasaka Jijii, a popular nursery song about a dog barked on embedded treasure. You can choose a tune, with the selector labeled "BGM", or choose "MUTE" if you don't want music.
Clicking the random configurations button
randomly reconfigure the game field setting.
Which game features to be randomized can be chosen can be chosen.
There are four icons for agents
,
holes 
,
known treasures 
,
and hidden treasures
.
Icons with red borders mean that the corresponding features are
to be configured randomly.
Others are kept without reconfiguration.
Clicking these icons can toggle whether or not
the features are to be configured.
The field to the right of the hole icon is for setting the probability of holes in the game field cells on random configurations.
The two fields to the right of the known treasure icon are for setting parameters used in random reconfiguration of known treasures. The first one is for setting the probability of treasures in game field cells. The next, labeled "max", is for setting the maximum amount of treasure in one cell. This should be a positive even number. If an odd number or a number less than 2 is specified, the value is adjusted to satisfy the constraints.
The two fields to the right of the hidden treasure icon are for setting parameters used in random reconfiguration of hidden treasures in the same manner.
Clicking the "Done" button will make the changes made take effect. Clicking the "Cancel" button will discard all the changes. Either will close the dialog.