This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
jxclient [2018/03/30 15:07] karl [JXClient] fix external link to java.com |
jxclient [2025/02/21 17:46] (current) leaf [Tile Size (aka zoom)] Added more notes about supported tile sizes |
||
---|---|---|---|
Line 1: | Line 1: | ||
===== JXClient ===== | ===== JXClient ===== | ||
- | The jxclient is a Java based client for crossfire. This is the only client for Windows that supports connections to [[server:|crossfire servers]] of version 1.71 and newer. | + | The jxclient is a Java based client for Crossfire. |
- | + | See [[jxclient:compiling|Compiling]] for information on how to compile the client on Linux | |
- | An occasional bug with this client is that the screen may load completely black, a current work around is to create a shortcut to jxclient.jar and add the following to the "target:" | + | |
- | "C:\**Change to where Crossfire Is Located**\jxclient new.jar" --no-full-screen | + | |
- | * The latest stable binary (.jar) is {{http://crossfire.real-time.com/clients/jxclient.html|here}}. | + | Also, [[jxclient-windows|Download and Launching JXClient on Windows 10]] for Windows users. |
- | * The latest development binary (.jnlp) is {{http://invidious.meflin.net/crossfire/jxclient.jnlp|here}} or (.jar) is {{http://invidious.meflin.net/crossfire/jxclient.jar|here}}. | + | |
+ | For Mac OS users, see [[jxclient-macosx|Download and Launching JXClient]]. | ||
+ | |||
+ | Under Linux, visit [[jxclient-linux|Download and Launching JXClient]]. | ||
If you are having trouble running the .Jar, install the Java Runtime Environment (JRE) from the [[https://www.java.com|java website]] . | If you are having trouble running the .Jar, install the Java Runtime Environment (JRE) from the [[https://www.java.com|java website]] . | ||
+ | |||
+ | ==== Client Commands ==== | ||
+ | |||
+ | === Key Bindings === | ||
+ | |||
+ | List custom or recently added key bindings: | ||
+ | |||
+ | /bindings | ||
+ | |||
+ | ==== Client Options ==== | ||
+ | |||
+ | The client options are used with launching the client (i.e., java -jar jxclient.jar -<options>) | ||
+ | |||
+ | To access the client options, launch the client and use the //--help// option | ||
+ | |||
+ | java -jar jxclient.jar --help | ||
+ | | ||
+ | ==== Help File Output ==== | ||
+ | |||
+ | Available options: | ||
+ | |||
+ | ==== No Full Screen ==== | ||
+ | |||
+ | Disable full-screen mode. | ||
+ | |||
+ | ''--no-full-screen''\\ | ||
+ | ''-n '' \\ | ||
+ | |||
+ | java -jar jxclient.jar -n | ||
+ | or | ||
+ | java -jar jxclient.jar --no-full-screen | ||
+ | |||
+ | ==== Client Resolution ==== | ||
+ | |||
+ | Resolution to use. [default is maximum not exceeding screen] | ||
+ | |||
+ | ''--resolution <width>x<height>''\\ | ||
+ | ''-r <width>x<height>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --resolution 1280x720 | ||
+ | |||
+ | or | ||
+ | |||
+ | java -jar jxclient.jar -r 1600x900 | ||
+ | |||
+ | ==== Skin ==== | ||
+ | |||
+ | Skin name to use. Available skins: default, ragnorok. | ||
+ | |||
+ | ''--skin <skin>''\\ | ||
+ | ''-s <skin>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --skin ragnorok | ||
+ | |||
+ | or | ||
+ | |||
+ | java -jar jxclient.jar -s default | ||
+ | |||
+ | ==== Tile Size (aka zoom) ==== | ||
+ | |||
+ | The size of map view tiles in pixels. It supports only 4, 32 or 64. 32 is the default Crossfire tile size, 4 is what the client needs for the minimap window, 64 is what the client uses by default for the map window. | ||
+ | |||
+ | ''--tile-size <n>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --tile-size 32 | ||
+ | |||
+ | JXClient has some hard-coded 32 x 32 pixel settings. Therefore other tile sizes will probably not work (.e., 24 x 24px.) | ||
+ | |||
+ | The same applies for tile sets: JXClient simply only supports the default tile set. | ||
+ | |||
+ | ==== Avoid Copy Area ==== | ||
+ | |||
+ | Do not copy pixel areas when scrolling the map view. Instead always repaint all map squares. | ||
+ | |||
+ | ''--avoid-copy-area''\\ | ||
+ | |||
+ | java -jar jxclient.jar --avoid-copy-area | ||
+ | |||
+ | ==== Enable OpenGL ==== | ||
+ | |||
+ | Enable the OpenGL rendering pipeline. | ||
+ | | ||
+ | ''--opengl''\\ | ||
+ | |||
+ | java -jar jxclient.jar --opengl | ||
+ | |||
+ | ==== Specify Server ==== | ||
+ | |||
+ | Select a server to connect to; skips main and metaserver windows. | ||
+ | |||
+ | ''--server <host>'' | ||
+ | |||
+ | java -jar jxclient.jar --server 127.0.0.1 | ||
+ | |||
+ | or | ||
+ | |||
+ | java -jar jxclient.jar --server invidious2.meflin.net | ||
+ | |||
+ | ==== Enable Debugging of GUI Elements ==== | ||
+ | |||
+ | Enable debugging of GUI elements. Also shows width and height of the active GUI element. | ||
+ | |||
+ | ''--debug-gui''\\ | ||
+ | |||
+ | java -jar jxclient.jar --debug-gui | ||
+ | |||
+ | ==== Enable Debugging of Keybord Input ==== | ||
+ | |||
+ | Log keyboard input. | ||
+ | |||
+ | ''--debug-keyboard <log-file>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --debug-keyboard | ||
+ | |||
+ | ==== Debug Protocal with Server ==== | ||
+ | |||
+ | Log messages exchanged with the server. | ||
+ | | ||
+ | ''--debug-protocol <log-file>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --debug-protocol log.txt | ||
+ | |||
+ | ==== Debug Screen Resolution ==== | ||
+ | |||
+ | Log messages related to screen resolution. | ||
+ | |||
+ | ''--debug-screen <log-file>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --debug-screen log.txt | ||
+ | |||
+ | ==== Debug Sounds ==== | ||
+ | |||
+ | Log messages related to sound. | ||
+ | |||
+ | ''--debug-sound <log-file>''\\ | ||
+ | |||
+ | java -jar jxclient.jar --debug-sound sound-log.txt | ||
+ | |||
+ | ==== Addition Note ==== | ||
+ | |||
+ | It is possible to combine multiple options in a single launch, like so: | ||
+ | |||
+ | java -jar jxclient.jar --server invidious2.meflin.net -r 1600x900 --tile-size 32 | ||
+ | |||
+ | The above command would automatically connect to invidious2.meflin.net with a client window resolution of 1600px by 900px and a tile size of 32. | ||
+ | |||
==== User Interface ==== | ==== User Interface ==== | ||
Line 88: | Line 235: | ||
==== Features Requiring Server Changes ==== | ==== Features Requiring Server Changes ==== | ||
* <del>knowledge dialog</del> added | * <del>knowledge dialog</del> added | ||
- | * indicators for poisoned, diseased, overloaded, confused, and various effects | + | * <del>indicators for poisoned, diseased, overloaded, confused, and various effects</del> |
* store keybindings on the server | * store keybindings on the server |