vitaXash3D

vitaXash3D
vitaXash3D
	File:Vitaxash3dvita.jpg
General
Author	fgsfds
Type	Shooter
Version	4 fix
License	GPL-3.0
Last Updated	2018/08/02
Links
	Download
	Website
	Source

Xash3D is an open source re-creation of the GoldSrc engine, a modified Quake Engine running Half-Life, Counter Strike and Team Fortress.

At the moment vitaXash3D is capable of running Half Life, Counter Strike and their mods.

Requirements

Game Data Files: PC.

How to play

Copy the desired game directory (e.g. valve for Half-Life) to ux0:/data/xash3d/.
Obtain appropriate game libraries (cl_dlls/client.suprx and dlls/server.suprx) and copy them to the game directory. See below for list of game libraries ported to the Vita.
Copy the build/data directory to ux0:/ on your Vita. Replace everything if asked.
Install the VPK obtained after building the port.
Run it.

Warning

This port is still a work in progress. Expect graphics and sound glitches, crashes and gameplay oddities.

Notes

The console log is saved to ux0:/data/xash3d/engine.log when debug mode is enabled.

If you don't have any GoldSrc games, you can use the data files from Half-Life Uplink, HL's free demo version. To do so, just extract this archive to ux0:/ instead of doing step 1 from the guide above.

Keep in mind that the game can hang for a long time when saving or autosaving (see issue #7), so don't kill it if it suddenly hangs when you enter a map or cross a checkpoint. You can disable autosaves in the "Game options" menu or with sv_autosave 0.

Multiplayer seems to work, but it hasn't been tested much. You can connect to any Xash3D server as long as it is compatible with this port, meaning it has to be running the same mod as you on Xash3D-FWGS v0.19 or Xash3D build 3366.

The mod launcher detects all directories you have inside ux0:/data/xash3d/, including valve, except launcher and directories that have names starting with a dot.

Installing mods works the same as with PC Half-Life: you just have to copy the mod directory (e. g. darkstar) into ux0:/data/xash3d/. Keep in mind that you'll also need Vita ports of the mod's game libraries, if it has any. For available ports, see list below.

If you're trying to run a mod that has no game libraries, Xash will try to fall back to the HL ones, so it's best that you have them installed at all times.

If you don't have the full version of HL and are using the Uplink archive linked above, multiplayer and other mods won't work. If you have the full version of HL, you can also install Uplink as a mod by copying only the uplink folder from the same archive.

If you're trying to connect to an online server from the server list and you get dropped back to main menu, then either you're banned on that server or it took too long to connect, in which case you just have to retry.

Some Xash servers automatically ban people connecting from a device other than an Android or iOS smartphone, nothing can be done about that.

Changing the video mode (screen resolution) immediately restarts the game. You can also change it by editing your mod's video.cfg. Keep in mind that some mods, like Counter-Strike, were not meant to be played in a resolution smaller than 640x400.

To change your name either enter name my_name in the console or change name in your mod's config.cfg.

You can change the layout of on-screen touch buttons by using the "Editor" function in the "Touch buttons" menu.

Expect every new release to invalidate at least some of your old save files. Pretty much nothing can be done about this right now, as saves are function offset based, and those offsets change with almost every code change.

Media

Screenshots

Default controls

LEFT ANALOG: move player
RIGHT ANALOG: move camera
LTRIGGER: secondary fire when in game, turn on onscreen keyboard when in console
RTRIGGER: primary fire
CROSS: use, select menu option
SQUARE: reload
CIRCLE: jump
TRIANGLE: duck
LEFT, RIGHT: change weapon
UP: last used weapon
DOWN: flashlight
START: open/close menu
SELECT: open/close console (only works in-game)

Controls can be customized in the options menu.

Installing mods

The integrated mod selector detects all folders you have inside ux0:/data/xash3d as mods and lists them for selection.

To install a mod, just copy its folder (e. g. darkstar for USS Darkstar, bshift for Blue Shift, gearbox for Opposing Force) to ux0:/data/xash3d, but make sure to not replace any files.

Available game libraries

Half-Life (included in vitaXash3D releases after v2)
Blue Shift (included in vitaXash3D releases after v2)
Opposing Force (included in vitaXash3D releases after v2)
Counter-Strike client (included in vitaXash3D releases after v3)
Counter-Strike server (ReGameLite, includes ZBot, unstable)

Read this before asking questions

The port is still very much a work in progress. Performance is subpar and there are numerous issues I've yet to fix. FPS is usually between 20 and 60, depending on the amount of stuff onscreen.
Right now only Half-Life, Blue Shift, Opposing Force and Counter-Strike game libraries have been ported to the Vita. They are included in data.zip since Release 3 (CS since Release 4).
To enable debugging features and ability to open console in the menu, run the game in debug mode by pressing TRIANGLE instead of CROSS in the mod launcher. This will also write the console log to ux0:/data/xash3d/engine.log.
If you're having trouble aiming, try turning on Autoaim in Configuration -> Controls -> Adv controls and/or lowering analog sensitivity for Pitch and Yaw in Configuration -> Gamepad. You can also invert any axis on either analog in the same menu by ticking the appropriate Invert checkbox. Pitch and yaw seem to be swapped for some reason, though.
Saving takes a really long time, sometimes up to two minutes, loading is also slow, but not as much. This is a known issue and I'm working on fixing it. When the game hangs at a random point or when you enter a new map, it's probably autosaving, so wait until it finishes. If you want, you can disable autosaves in Configuration -> Game options.
Multiplayer works with any Xash3D server as long as it's compatible with this port, meaning it has to be running the same mod/game as you on either Xash3D-FWGS v0.19 or Xash3D build 3366, otherwise it will probably crash during connection. Hosting a server on your Vita and joining it also should work, at least over LAN.
The game will download any maps and resources you don't have when you join a server automatically, as long as you enable Allow download in Configuration -> Game options.
Playing multiplayer and running other mods requires the full version of Half-Life.
You can install Uplink as a mod alongside the full version by copying just the uplink folder from the Uplink archive linked above.
If you need to navigate number menus like this one in Counter-Strike, install the CS server library linked above. It includes a new touch button that pops up a numeric keypad when used.
Expect every new release to be incompatible with some or all saves from previous releases.
If your question is not answered in this section, check the README and the issues list on Github first.

Changelog

(v.4.0-fix)

This re-enables the server list. Just install this VPK to update.

(v.4.0)

much more stable due to expanded memory mode and recent vitaGL changes;
new launcher;
support for more screen resolutions;
slightly better performance;
improved touch and analog controls;
Counter-Strike support;
bugfixes.

WARNING: This release is probably incompatible with savegames from Release 1, Release 2 and likely Release 3. If the game crashes after you die or when you load a save, delete your old saves.

(v.3.0)

somewhat better performance;
now uses dynamic game libraries instead of hardlinked HLSDK;
basic touch support.

(v.2.0)

multiplayer sort of works (untested);
integrated mod launcher (only works with mods that don't require custom DLLs, this means CS and TFC won't work);
sound pitch fixed;
most blending bugs fixed;
option to disable autosaves.

(v.1.0)

First Release.

Credits

Uncle Mike & co for Xash3D and FWGS team for Xash3D-FWGS and game DLL source code;
Vita SDK Team for the Vita SDK;
Rinnegatamante for vitaGL, vitaQuake/vitaQuakeII and general advice;
ArkSource for the Live Area stuff;
KINGGOLDrus for some launcher graphics;
everyone on the #henkaku and #vitasdk IRC channels for help and/or testing.

External links

Official Website - https://github.com/FWGS/xash3d-fwgs
Github - https://github.com/fgsfdsfgs/vitaXash3D
VitaDB - https://vitadb.rinnegatamante.it/#/info/365
Wololo - https://wololo.net/talk/viewtopic.php?t=48892