System Console How-To

A system console is now available for use via the in-game chat window. It is understood that if you have never used DOS, *nix, or other command-line based systems that this feature may seem a little daunting. I assure you that it is quite straightforward and with a little practice it will make perfect sense. Never hesitate to come visit the forums if you have any questions at all.

How do I access it?

As it stands, all console commands affect a particular game; therefore, you enter console commands in the chat window of the game in question. So that the system knows you are entering a console command, the very first character in the chat window must be a tilde(~). (That's the wavy character usually found at the top-left of a QWERTY keyboard.) If you put any spaces before the tilde the system will not recognize it as a console command and will instead pass the text to the regular chat system.

Once a command has been entered, if it requires the approval of others, it will appear on your personal console page. This too is the only way non-participants will know their approval is needed (ie. tournament moderators).

What commands are available?

General Commands

  • ~vote accept cmdid
  • ~vote reject cmdid

Instead of visiting your personal console page, you can accept/reject requests directly from the chat window. The cmdid is the ID number assigned the request and should have appeared in the game's chat log.

Clock Commands

  • ~clock freeze
  • ~clock unfreeze or ~clock thaw

These first two should be self-explanatory. They will freeze/thaw the game clock if all players agree. It should be noted that if you page an administrator, and the page gets cleared, the clock's status will be reset to active. In rare cases where administrator intervention is needed in a frozen game, just let the admin know and he will reset the clock's frozen status.

  • ~clock change #/#/#

This command allows the players to adjust the primary clock settings (start, increment, max). The format is the same as for the "New Challenge" screen. You may suffix the number with an h to use hours, otherwise the system will assume you mean days. It should be noted that the new max setting will not be immediately enforced. If you set the max to a value lower than someone's current bank then the bank will remain until that player next moves; at which time the values will be reset.

  • ~clock reset

This command resets the clocks to their initial states, meaning all players will have their banks reset to the the start setting of the main clock.

  • ~clock bank username timechange

This command allows you to adjust an individual's clock. The timechange variable is automatically assumed to be in hours should either be:

  • a positive integer to increase one's clock by the given number of hours (eg. 25, 12, etc…)
  • a negative integer to decrease one's clock by the given number of hours (eg. -25, -12, etc…)
  • or a number prefixed by an equal sign if you wish to set the player's clock to that exact amount (eg. =25, =-12, etc…)

Variant Commands

  • ~variant add name
  • ~variant remove name or ~variant del name

The variant commands allow the players to add/remove various variant settings. It should be noted, however, that there are some variants that only have meaning at certain phases of the game (ie. the Islands variant of Depth Charge for example). Adding/removing such variants will have an undefined behaviour.

What about Ladders and Tournaments?

The use of the console is restricted in Ladder and Tournament games. In Ladders one can only freeze/thaw the clocks. In tournaments, all commands must be approved by the tournament organizers as well.

Any other restrictions?

Yes. No console commands work for Zendo games.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License