Difference between revisions of "PuTTY"

From NetHackWiki
Jump to navigation Jump to search
m (link to telnet)
(Recommended settings: linux ttype is bad, it breaks curses graphics and doesn't seem to make anything better)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''PuTTY''' is a free implementation of [[telnet]], ssh and terminal emulation by Simon Tatham.  It seems to be the preferred way to play NetHack on a [[public server]] on Windows, as it is much more versatile and standards-compliant than Microsoft's telnet.exe that comes with Windows.
+
'''PuTTY''' is a free implementation of [[telnet]], ssh and terminal emulation by Simon Tatham.  It is the preferred way to play NetHack on a [[public server]] on Windows, as it is much more versatile and standards-compliant than Microsoft's telnet.exe that comes with Windows.
  
PuTTY can be downloaded from [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY homepage]
+
PuTTY can be downloaded from [http://www.chiark.greenend.org.uk/~sgtatham/putty/ the PuTTY homepage].
  
To make [[IBMgraphics]] work with PuTTY, you need to set <tt>Window/Translation/Character Set</tt> to <tt>CP437</tt>
+
==Recommended settings==
  
To make PuTTY looks exactly like the Windows terminal window, set <tt>Windows/Appearance/Font</tt> to <tt>Terminal</tt>
+
If at all possible, connect using the SSH protocol, as Telnet provides no encryption or authentication and leaves your credentials vulnerable to network snoopers.
  
Make sure "auto-wrap mode"&nbsp;is switched off or you terminal might get spammed with text artifacts<tt>.</tt>
+
To make [[IBMgraphics]] work with PuTTY, you need to set Remote Character Set (under Window/Translation) to <tt>CP437</tt>
  
When connecting to server using [[Dgamelaunch]], you may become disconnected if you accidentaly resize Putty window to have different width or height in onscreen characters. To prevent this from happening choose between ''Change the size of the font'' (having larger letters is eyes friendly and putting this to fullscreen looks cool) and ''Forbid resizing completely'' in Window settings. You can also set the starting window size here.
+
To make PuTTY looks exactly like the Windows terminal window, set the Font (under Window/Appearance) to <tt>Terminal</tt>
 +
 
 +
Make sure auto-wrap mode (under Terminal) is switched off or you terminal might get spammed with text artifacts.
 +
 
 +
When using [[number_pad]], it may be necessary to disable application keypad mode (under Terminal/Features).
 +
 
 +
When connecting to a server using [[dgamelaunch]], you may become disconnected if you accidentally resize the window to have a different width or height in onscreen characters. To prevent this from happening, choose between ''Change the size of the font'' and ''Forbid resizing completely'' under Window. You can also set the starting window size here.
 +
 
 +
<!--By default, PuTTY sets its terminal-type string as <tt>xterm</tt>, which breaks a lot of things. It's best to change its advertised terminal-type to <tt>linux</tt> (under Connection/Data).
 +
-->
 +
By default, right-click pastes in PuTTY. This can easily lose your game if you accidentally right-click a window when you have a long piece of text on the clipboard. It's recommended that you change the mouse button actions from Compromise to Windows (under Window/Selection) to disable this. Remember that, unless you save your session settings, you have to set this option again every time you play.
 +
 
 +
On some public servers running dgamelaunch, you can [[Dgamelaunch#PuTTY|configure PuTTY to log in automatically]]. Servers running other software may have their own auto-login methods.
 +
 
 +
==Color themes==
 +
Colors can be configured to your preference by going to Window/Color and editing the RGB codes of each color. To avoid the work, many color schemes can be found [https://github.com/AlexAkulov/putty-color-themes here]; just follow the instructions in the <tt>README</tt> file.
  
 
==NetHack mode==
 
==NetHack mode==
  
(from [http://the.earth.li/~sgtatham/putty/0.60/htmldoc/Chapter4.html#config-nethack Putty documentation])
+
PuTTY has a special mode for playing NetHack<ref>http://the.earth.li/~sgtatham/putty/0.76/htmldoc/Chapter4.html#config-nethack</ref>. You can enable it by selecting ‘NetHack’ in the ‘Initial state of numeric keypad’ control (under Terminal/Keyboard).
  
PuTTY has a special mode for playing NetHack. You can enable it by selecting ‘NetHack’ in the ‘Initial state of numeric keypad’ control.
+
In this mode, the numeric keypad keys 1-9 generate the NetHack movement commands (<tt>hjklyubn</tt>). The 5 key generates the . command (do nothing).
  
In this mode, the numeric keypad keys 1-9 generate the NetHack movement commands (hjklyubn). The 5 key generates the . command (do nothing).
+
In addition, pressing Shift or Ctrl with the keypad keys generate the Shift- or Ctrl-keys you would expect (e.g. keypad-7 generates ‘y’, so Shift-keypad-7 generates ‘Y’ and Ctrl-keypad-7 generates Ctrl-Y); these commands tell NetHack to keep moving you in the same direction until you encounter something interesting.
  
In addition, pressing Shift or Ctrl with the keypad keys generate the Shift- or Ctrl-keys you would expect (e.g. keypad-7 generates ‘y’, so Shift-keypad-7 generates ‘Y’ and Ctrl-keypad-7 generates Ctrl-Y); these commands tell NetHack to keep moving you in the same direction until you encounter something interesting.
+
For some reason, this feature only works properly when Num Lock is on.
  
For some reason, this feature only works properly when Num Lock is on. We don't know why.
+
(Note that [[Options#number_pad|OPTIONS=number_pad:<1,2,3,4>]] is superior to this client-level setting, since it lets you use the letters for other commands rather than redundant movement commands, but the option could be useful if you're playing on a server that doesn't let you edit your config file.)
 
[[Category:Utilities]]
 
[[Category:Utilities]]

Latest revision as of 19:42, 25 December 2022

PuTTY is a free implementation of telnet, ssh and terminal emulation by Simon Tatham. It is the preferred way to play NetHack on a public server on Windows, as it is much more versatile and standards-compliant than Microsoft's telnet.exe that comes with Windows.

PuTTY can be downloaded from the PuTTY homepage.

Recommended settings

If at all possible, connect using the SSH protocol, as Telnet provides no encryption or authentication and leaves your credentials vulnerable to network snoopers.

To make IBMgraphics work with PuTTY, you need to set Remote Character Set (under Window/Translation) to CP437

To make PuTTY looks exactly like the Windows terminal window, set the Font (under Window/Appearance) to Terminal

Make sure auto-wrap mode (under Terminal) is switched off or you terminal might get spammed with text artifacts.

When using number_pad, it may be necessary to disable application keypad mode (under Terminal/Features).

When connecting to a server using dgamelaunch, you may become disconnected if you accidentally resize the window to have a different width or height in onscreen characters. To prevent this from happening, choose between Change the size of the font and Forbid resizing completely under Window. You can also set the starting window size here.

By default, right-click pastes in PuTTY. This can easily lose your game if you accidentally right-click a window when you have a long piece of text on the clipboard. It's recommended that you change the mouse button actions from Compromise to Windows (under Window/Selection) to disable this. Remember that, unless you save your session settings, you have to set this option again every time you play.

On some public servers running dgamelaunch, you can configure PuTTY to log in automatically. Servers running other software may have their own auto-login methods.

Color themes

Colors can be configured to your preference by going to Window/Color and editing the RGB codes of each color. To avoid the work, many color schemes can be found here; just follow the instructions in the README file.

NetHack mode

PuTTY has a special mode for playing NetHack[1]. You can enable it by selecting ‘NetHack’ in the ‘Initial state of numeric keypad’ control (under Terminal/Keyboard).

In this mode, the numeric keypad keys 1-9 generate the NetHack movement commands (hjklyubn). The 5 key generates the . command (do nothing).

In addition, pressing Shift or Ctrl with the keypad keys generate the Shift- or Ctrl-keys you would expect (e.g. keypad-7 generates ‘y’, so Shift-keypad-7 generates ‘Y’ and Ctrl-keypad-7 generates Ctrl-Y); these commands tell NetHack to keep moving you in the same direction until you encounter something interesting.

For some reason, this feature only works properly when Num Lock is on.

(Note that OPTIONS=number_pad:<1,2,3,4> is superior to this client-level setting, since it lets you use the letters for other commands rather than redundant movement commands, but the option could be useful if you're playing on a server that doesn't let you edit your config file.)