scripts: waifulib: sdl2: avoid abspath usage that causes problems when the path is concatenated with something else

This function is kinda nasty, some mods (like old RCBot builds) expect a slash,
some newer mods (like Sandbot) doesn't. To preserve compatibility with both old
and new mods, just add it as bug compatibility flag.

.builds/alpine.yml

@@ -0,0 +1,28 @@
+image: alpine/latest
+packages:
+- build-base
+- sdl2-dev
+- freetype-dev
+- fontconfig-dev
+- opus-dev
+- bzip2-dev
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    ./waf configure -8 --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    ./waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-alpine-amd64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-alpine-amd64.tar.bz2

.builds/debian-arm64.yml

@@ -0,0 +1,31 @@
+image: debian/sid
+arch: amd64
+packages:
+- build-essential
+- python-is-python3
+- libsdl2-dev
+- libfreetype-dev
+- libfontconfig-dev
+- libopus-dev
+- libbz2-dev
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    ./waf configure -8 --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    ./waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-debian-arm64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-debian-arm64.tar.bz2
+

.builds/debian.yml

@@ -0,0 +1,30 @@
+image: debian/sid
+packages:
+- build-essential
+- python-is-python3
+- libsdl2-dev
+- libfreetype-dev
+- libfontconfig-dev
+- libopus-dev
+- libbz2-dev
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    ./waf configure -8 --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    ./waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-debian-amd64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-debian-amd64.tar.bz2
+

.builds/freebsd.yml

@@ -0,0 +1,30 @@
+image: freebsd/latest
+packages:
+- lang/python
+- devel/pkgconf
+- devel/sdl20
+- print/freetype2
+- x11-fonts/fontconfig
+- audio/opus
+- archivers/bzip2
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    ./waf configure --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    ./waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-freebsd-amd64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-freebsd-amd64.tar.bz2
+

.builds/netbsd.yml

@@ -0,0 +1,30 @@
+image: netbsd/latest
+packages:
+- python311
+- SDL2
+- freetype2
+- fontconfig
+- libopus
+- pkgconf
+- bzip2
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    python3.11 waf configure --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    python3.11 waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-netbsd-amd64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-netbsd-amd64.tar.bz2
+

.builds/openbsd.yml

@@ -0,0 +1,27 @@
+image: openbsd/latest
+packages:
+- python3
+- sdl2
+- opus
+- bzip2
+sources:
+- https://git.sr.ht/~a1batross/xash3d-fwgs
+tasks:
+- client: |
+    cd xash3d-fwgs
+    python3 waf configure --enable-tests --enable-engine-tests build install --destdir=bin
+- server: |
+    cd xash3d-fwgs
+    python3 waf configure --reconfigure --dedicated build install --destdir=bin
+- run-tests: |
+    cd xash3d-fwgs/bin
+    export SDL_VIDEODRIVER=wayland
+    ./xash3d -runtests
+    ./xash -runtests
+    rm -rf valve/gameinfo.txt test_*
+- package: |
+    cd xash3d-fwgs/bin
+    tar -cjvf xash3d-fwgs-openbsd-amd64.tar.bz2 *
+artifacts:
+- xash3d-fwgs/bin/xash3d-fwgs-openbsd-amd64.tar.bz2
+

.cirrus.yml

@@ -1,34 +1,22 @@
 task:
-  name: freebsd-11-amd64
+  name: freebsd-14-amd64
   freebsd_instance:
-    image_family: freebsd-11-4
+    image_family: freebsd-14-0
   setup_script:
     - pkg update
-    - pkg install -y git sdl2 python
+    - pkg install -y pkgconf git sdl2 python fontconfig opus
     - git submodule update --init --recursive
   test_script:
     - ./scripts/cirrus/build_freebsd.sh dedicated
     - ./scripts/cirrus/build_freebsd.sh full
 
 task:
-  name: freebsd-12-amd64
+  name: freebsd-15-amd64
   freebsd_instance:
-    image_family: freebsd-12-2
+    image_family: freebsd-15-0-snap
   setup_script:
     - pkg update
-    - pkg install -y git sdl2 python
-    - git submodule update --init --recursive
-  test_script:
-    - ./scripts/cirrus/build_freebsd.sh dedicated
-    - ./scripts/cirrus/build_freebsd.sh full
-
-task:
-  name: freebsd-13-amd64
-  freebsd_instance:
-    image_family: freebsd-13-0-snap
-  setup_script:
-    - pkg update
-    - pkg install -y git sdl2 python
+    - pkg install -y pkgconf git sdl2 python fontconfig opus
     - git submodule update --init --recursive
   test_script:
     - ./scripts/cirrus/build_freebsd.sh dedicated

.editorconfig

@@ -1,9 +1,365 @@
-# EditorConfig is awesome: https://EditorConfig.org
+# this file is just a suggestion, you might follow it, you might not
 root = true
 
 [*]
-charset = latin1
+charset = utf-8
 end_of_line = lf
 indent_style = tab
 insert_final_newline = true
 trim_trailing_whitespace = true
+ij_formatter_off_tag = @formatter:off
+ij_formatter_on_tag = @formatter:on
+
+[*.{c++,cc,cpp,cppm,cxx,h,h++,hh,hpp,hxx,inl,ipp,ixx,tlh,tli}]
+
+# Visual C++ Formatting settings
+cpp_indent_braces = false
+cpp_indent_multi_line_relative_to = innermost_parenthesis
+cpp_indent_within_parentheses = indent
+cpp_indent_preserve_within_parentheses = true
+cpp_indent_case_contents = true
+cpp_indent_case_labels = false
+cpp_indent_case_contents_when_block = false
+cpp_indent_lambda_braces_when_parameter = true
+cpp_indent_goto_labels = one_left
+cpp_indent_preprocessor = leftmost_column
+cpp_indent_access_specifiers = false
+cpp_indent_namespace_contents = true
+cpp_indent_preserve_comments = false
+cpp_new_line_before_open_brace_namespace = new_line
+cpp_new_line_before_open_brace_type = new_line
+cpp_new_line_before_open_brace_function = new_line
+cpp_new_line_before_open_brace_block = new_line
+cpp_new_line_before_open_brace_lambda = new_line
+cpp_new_line_scope_braces_on_separate_lines = true
+cpp_new_line_close_brace_same_line_empty_type = false
+cpp_new_line_close_brace_same_line_empty_function = false
+cpp_new_line_before_catch = true
+cpp_new_line_before_else = true
+cpp_new_line_before_while_in_do_while = false
+cpp_space_before_function_open_parenthesis = remove
+cpp_space_within_parameter_list_parentheses = true
+cpp_space_between_empty_parameter_list_parentheses = true
+cpp_space_after_keywords_in_control_flow_statements = false
+cpp_space_within_control_flow_statement_parentheses = true
+cpp_space_before_lambda_open_parenthesis = false
+cpp_space_within_cast_parentheses = false
+cpp_space_after_cast_close_parenthesis = false
+cpp_space_within_expression_parentheses = true
+cpp_space_before_block_open_brace = true
+cpp_space_between_empty_braces = true
+cpp_space_before_initializer_list_open_brace = false
+cpp_space_within_initializer_list_braces = true
+cpp_space_preserve_in_initializer_list = true
+cpp_space_before_open_square_bracket = false
+cpp_space_within_square_brackets = false
+cpp_space_before_empty_square_brackets = false
+cpp_space_between_empty_square_brackets = false
+cpp_space_group_square_brackets = true
+cpp_space_within_lambda_brackets = false
+cpp_space_between_empty_lambda_brackets = false
+cpp_space_before_comma = false
+cpp_space_after_comma = true
+cpp_space_remove_around_member_operators = true
+cpp_space_before_inheritance_colon = true
+cpp_space_before_constructor_colon = true
+cpp_space_remove_before_semicolon = true
+cpp_space_after_semicolon = true
+cpp_space_remove_around_unary_operator = true
+cpp_space_around_binary_operator = insert
+cpp_space_around_assignment_operator = insert
+cpp_space_pointer_reference_alignment = right
+cpp_space_around_ternary_operator = insert
+cpp_use_unreal_engine_macro_formatting = true
+cpp_wrap_preserve_blocks = one_liners
+
+# IDEA settings
+ij_c_add_brief_tag = false
+ij_c_add_getter_prefix = true
+ij_c_add_setter_prefix = true
+ij_c_align_dictionary_pair_values = false
+ij_c_align_group_field_declarations = false
+ij_c_align_init_list_in_columns = true
+ij_c_align_multiline_array_initializer_expression = false
+ij_c_align_multiline_assignment = false
+ij_c_align_multiline_binary_operation = false
+ij_c_align_multiline_chained_methods = false
+ij_c_align_multiline_for = true
+ij_c_align_multiline_ternary_operation = false
+ij_c_array_initializer_comma_on_next_line = false
+ij_c_array_initializer_new_line_after_left_brace = false
+ij_c_array_initializer_right_brace_on_new_line = false
+ij_c_array_initializer_wrap = off
+ij_c_assignment_wrap = off
+ij_c_binary_operation_sign_on_next_line = false
+ij_c_binary_operation_wrap = off
+ij_c_blank_lines_after_class_header = 0
+ij_c_blank_lines_after_imports = 1
+ij_c_blank_lines_around_class = 1
+ij_c_blank_lines_around_field = 0
+ij_c_blank_lines_around_field_in_interface = 0
+ij_c_blank_lines_around_method = 1
+ij_c_blank_lines_around_method_in_interface = 1
+ij_c_blank_lines_around_namespace = 0
+ij_c_blank_lines_around_properties_in_declaration = 0
+ij_c_blank_lines_around_properties_in_interface = 0
+ij_c_blank_lines_before_imports = 1
+ij_c_blank_lines_before_method_body = 0
+ij_c_block_brace_placement = next_line
+ij_c_block_brace_style = next_line
+ij_c_block_comment_at_first_column = true
+ij_c_catch_on_new_line = false
+ij_c_class_brace_style = next_line
+ij_c_class_constructor_init_list_align_multiline = true
+ij_c_class_constructor_init_list_comma_on_next_line = false
+ij_c_class_constructor_init_list_new_line_after_colon = never
+ij_c_class_constructor_init_list_new_line_before_colon = if_long
+ij_c_class_constructor_init_list_wrap = normal
+ij_c_copy_is_deep = false
+ij_c_create_interface_for_categories = true
+ij_c_declare_generated_methods = true
+ij_c_description_include_member_names = true
+ij_c_discharged_short_ternary_operator = false
+ij_c_do_not_add_breaks = false
+ij_c_do_while_brace_force = never
+ij_c_else_on_new_line = false
+ij_c_enum_constants_comma_on_next_line = false
+ij_c_enum_constants_wrap = off
+ij_c_for_brace_force = never
+ij_c_for_statement_new_line_after_left_paren = false
+ij_c_for_statement_right_paren_on_new_line = false
+ij_c_for_statement_wrap = off
+ij_c_function_brace_placement = next_line
+ij_c_function_call_arguments_align_multiline = true
+ij_c_function_call_arguments_align_multiline_pars = false
+ij_c_function_call_arguments_comma_on_next_line = false
+ij_c_function_call_arguments_new_line_after_lpar = false
+ij_c_function_call_arguments_new_line_before_rpar = false
+ij_c_function_call_arguments_wrap = normal
+ij_c_function_non_top_after_return_type_wrap = normal
+ij_c_function_parameters_align_multiline = true
+ij_c_function_parameters_align_multiline_pars = false
+ij_c_function_parameters_comma_on_next_line = false
+ij_c_function_parameters_new_line_after_lpar = false
+ij_c_function_parameters_new_line_before_rpar = false
+ij_c_function_parameters_wrap = normal
+ij_c_function_top_after_return_type_wrap = normal
+ij_c_generate_additional_eq_operators = true
+ij_c_generate_additional_rel_operators = true
+ij_c_generate_class_constructor = true
+ij_c_generate_comparison_operators_use_std_tie = false
+ij_c_generate_instance_variables_for_properties = ask
+ij_c_generate_operators_as_members = true
+ij_c_header_guard_style_pattern = ${PROJECT_NAME}_${FILE_NAME}_${EXT}
+ij_c_if_brace_force = never
+ij_c_in_line_short_ternary_operator = true
+ij_c_indent_block_comment = true
+ij_c_indent_c_struct_members = 4
+ij_c_indent_case_from_switch = true
+ij_c_indent_class_members = 4
+ij_c_indent_directive_as_code = false
+ij_c_indent_implementation_members = 0
+ij_c_indent_inside_code_block = 4
+ij_c_indent_interface_members = 0
+ij_c_indent_interface_members_except_ivars_block = false
+ij_c_indent_namespace_members = 4
+ij_c_indent_preprocessor_directive = 0
+ij_c_indent_visibility_keywords = 0
+ij_c_insert_override = true
+ij_c_insert_virtual_with_override = false
+ij_c_introduce_auto_consts = false
+ij_c_introduce_auto_vars = false
+ij_c_introduce_const_params = false
+ij_c_introduce_const_vars = false
+ij_c_introduce_constexpr_consts = false
+ij_c_introduce_generate_property = false
+ij_c_introduce_generate_synthesize = true
+ij_c_introduce_globals_to_header = true
+ij_c_introduce_prop_to_private_category = false
+ij_c_introduce_static_consts = true
+ij_c_introduce_use_ns_types = false
+ij_c_ivars_prefix = _
+ij_c_ivars_suffix =
+ij_c_keep_blank_lines_before_end = 2
+ij_c_keep_blank_lines_before_right_brace = 2
+ij_c_keep_blank_lines_in_code = 2
+ij_c_keep_blank_lines_in_declarations = 2
+ij_c_keep_case_expressions_in_one_line = false
+ij_c_keep_control_statement_in_one_line = false
+ij_c_keep_directive_at_first_column = true
+ij_c_keep_first_column_comment = false
+ij_c_keep_line_breaks = true
+ij_c_keep_nested_namespaces_in_one_line = false
+ij_c_keep_simple_blocks_in_one_line = false
+ij_c_keep_simple_methods_in_one_line = false
+ij_c_keep_structures_in_one_line = false
+ij_c_lambda_capture_list_align_multiline = false
+ij_c_lambda_capture_list_align_multiline_bracket = false
+ij_c_lambda_capture_list_comma_on_next_line = false
+ij_c_lambda_capture_list_new_line_after_lbracket = false
+ij_c_lambda_capture_list_new_line_before_rbracket = false
+ij_c_lambda_capture_list_wrap = off
+ij_c_line_comment_add_space = false
+ij_c_line_comment_at_first_column = true
+ij_c_method_brace_placement = end_of_line
+ij_c_method_call_arguments_align_by_colons = true
+ij_c_method_call_arguments_align_multiline = false
+ij_c_method_call_arguments_special_dictionary_pairs_treatment = true
+ij_c_method_call_arguments_wrap = off
+ij_c_method_call_chain_wrap = off
+ij_c_method_parameters_align_by_colons = true
+ij_c_method_parameters_align_multiline = false
+ij_c_method_parameters_wrap = off
+ij_c_namespace_brace_placement = next_line
+ij_c_parentheses_expression_new_line_after_left_paren = false
+ij_c_parentheses_expression_right_paren_on_new_line = false
+ij_c_place_assignment_sign_on_next_line = false
+ij_c_property_nonatomic = true
+ij_c_put_ivars_to_implementation = true
+ij_c_refactor_compatibility_aliases_and_classes = true
+ij_c_refactor_properties_and_ivars = true
+ij_c_release_style = ivar
+ij_c_retain_object_parameters_in_constructor = true
+ij_c_semicolon_after_method_signature = false
+ij_c_shift_operation_align_multiline = true
+ij_c_shift_operation_wrap = normal
+ij_c_show_non_virtual_functions = false
+ij_c_space_after_colon = true
+ij_c_space_after_colon_in_foreach = true
+ij_c_space_after_colon_in_selector = false
+ij_c_space_after_comma = true
+ij_c_space_after_cup_in_blocks = false
+ij_c_space_after_dictionary_literal_colon = true
+ij_c_space_after_for_semicolon = true
+ij_c_space_after_init_list_colon = true
+ij_c_space_after_method_parameter_type_parentheses = false
+ij_c_space_after_method_return_type_parentheses = false
+ij_c_space_after_pointer_in_declaration = false
+ij_c_space_after_quest = true
+ij_c_space_after_reference_in_declaration = false
+ij_c_space_after_reference_in_rvalue = false
+ij_c_space_after_structures_rbrace = true
+ij_c_space_after_superclass_colon = true
+ij_c_space_after_type_cast = false
+ij_c_space_after_visibility_sign_in_method_declaration = true
+ij_c_space_before_autorelease_pool_lbrace = true
+ij_c_space_before_catch_keyword = true
+ij_c_space_before_catch_left_brace = true
+ij_c_space_before_catch_parentheses = false
+ij_c_space_before_category_parentheses = true
+ij_c_space_before_chained_send_message = true
+ij_c_space_before_class_left_brace = true
+ij_c_space_before_colon = true
+ij_c_space_before_colon_in_foreach = true
+ij_c_space_before_comma = false
+ij_c_space_before_dictionary_literal_colon = true
+ij_c_space_before_do_left_brace = true
+ij_c_space_before_else_keyword = true
+ij_c_space_before_else_left_brace = true
+ij_c_space_before_export_lbrace = true
+ij_c_space_before_for_left_brace = true
+ij_c_space_before_for_parentheses = false
+ij_c_space_before_for_semicolon = false
+ij_c_space_before_if_left_brace = true
+ij_c_space_before_if_parentheses = false
+ij_c_space_before_init_list = false
+ij_c_space_before_init_list_colon = true
+ij_c_space_before_method_call_parentheses = false
+ij_c_space_before_method_left_brace = true
+ij_c_space_before_method_parentheses = false
+ij_c_space_before_namespace_lbrace = true
+ij_c_space_before_pointer_in_declaration = true
+ij_c_space_before_property_attributes_parentheses = false
+ij_c_space_before_protocols_brackets = true
+ij_c_space_before_quest = true
+ij_c_space_before_reference_in_declaration = true
+ij_c_space_before_superclass_colon = true
+ij_c_space_before_switch_left_brace = true
+ij_c_space_before_switch_parentheses = false
+ij_c_space_before_template_call_lt = false
+ij_c_space_before_template_declaration_lt = true
+ij_c_space_before_try_left_brace = true
+ij_c_space_before_while_keyword = true
+ij_c_space_before_while_left_brace = true
+ij_c_space_before_while_parentheses = false
+ij_c_space_between_adjacent_brackets = false
+ij_c_space_between_operator_and_punctuator = false
+ij_c_space_within_empty_array_initializer_braces = true
+ij_c_spaces_around_additive_operators = true
+ij_c_spaces_around_assignment_operators = true
+ij_c_spaces_around_bitwise_operators = true
+ij_c_spaces_around_equality_operators = true
+ij_c_spaces_around_lambda_arrow = true
+ij_c_spaces_around_logical_operators = true
+ij_c_spaces_around_multiplicative_operators = true
+ij_c_spaces_around_pm_operators = false
+ij_c_spaces_around_relational_operators = true
+ij_c_spaces_around_shift_operators = true
+ij_c_spaces_around_unary_operator = false
+ij_c_spaces_within_array_initializer_braces = true
+ij_c_spaces_within_braces = false
+ij_c_spaces_within_brackets = false
+ij_c_spaces_within_cast_parentheses = false
+ij_c_spaces_within_catch_parentheses = true
+ij_c_spaces_within_category_parentheses = false
+ij_c_spaces_within_empty_braces = false
+ij_c_spaces_within_empty_function_call_parentheses = true
+ij_c_spaces_within_empty_function_declaration_parentheses = true
+ij_c_spaces_within_empty_lambda_capture_list_bracket = false
+ij_c_spaces_within_empty_template_call_ltgt = false
+ij_c_spaces_within_empty_template_declaration_ltgt = false
+ij_c_spaces_within_for_parentheses = true
+ij_c_spaces_within_function_call_parentheses = true
+ij_c_spaces_within_function_declaration_parentheses = true
+ij_c_spaces_within_if_parentheses = true
+ij_c_spaces_within_lambda_capture_list_bracket = false
+ij_c_spaces_within_method_parameter_type_parentheses = false
+ij_c_spaces_within_method_return_type_parentheses = false
+ij_c_spaces_within_parentheses = true
+ij_c_spaces_within_property_attributes_parentheses = false
+ij_c_spaces_within_protocols_brackets = false
+ij_c_spaces_within_send_message_brackets = false
+ij_c_spaces_within_structured_binding_list_bracket = false
+ij_c_spaces_within_switch_parentheses = true
+ij_c_spaces_within_template_call_ltgt = false
+ij_c_spaces_within_template_declaration_ltgt = false
+ij_c_spaces_within_template_double_gt = false
+ij_c_spaces_within_while_parentheses = true
+ij_c_special_else_if_treatment = true
+ij_c_structured_binding_list_align_multiline = false
+ij_c_structured_binding_list_align_multiline_bracket = false
+ij_c_structured_binding_list_comma_on_next_line = false
+ij_c_structured_binding_list_new_line_after_lbracket = false
+ij_c_structured_binding_list_new_line_before_rbracket = false
+ij_c_structured_binding_list_wrap = off
+ij_c_superclass_list_after_colon = never
+ij_c_superclass_list_align_multiline = true
+ij_c_superclass_list_before_colon = if_long
+ij_c_superclass_list_comma_on_next_line = false
+ij_c_superclass_list_wrap = on_every_item
+ij_c_tag_prefix_of_block_comment = at
+ij_c_tag_prefix_of_line_comment = back_slash
+ij_c_template_call_arguments_align_multiline = false
+ij_c_template_call_arguments_align_multiline_pars = false
+ij_c_template_call_arguments_comma_on_next_line = false
+ij_c_template_call_arguments_new_line_after_lt = false
+ij_c_template_call_arguments_new_line_before_gt = false
+ij_c_template_call_arguments_wrap = off
+ij_c_template_declaration_function_body_indent = false
+ij_c_template_declaration_function_wrap = split_into_lines
+ij_c_template_declaration_struct_body_indent = false
+ij_c_template_declaration_struct_wrap = split_into_lines
+ij_c_template_parameters_align_multiline = false
+ij_c_template_parameters_align_multiline_pars = false
+ij_c_template_parameters_comma_on_next_line = false
+ij_c_template_parameters_new_line_after_lt = false
+ij_c_template_parameters_new_line_before_gt = false
+ij_c_template_parameters_wrap = off
+ij_c_ternary_operation_signs_on_next_line = false
+ij_c_ternary_operation_wrap = off
+ij_c_type_qualifiers_placement = before
+ij_c_use_modern_casts = true
+ij_c_use_setters_in_constructor = true
+ij_c_while_brace_force = never
+ij_c_while_on_new_line = false
+ij_c_wrap_property_declaration = off

.github/FUNDING.yml

@@ -0,0 +1 @@
+custom: https://github.com/FWGS/xash3d-fwgs/blob/master/Documentation/donate.md

.github/workflows/c-cpp.yml

@@ -1,6 +1,11 @@
 name: Build & Deploy Engine
 on: [push, pull_request]
 jobs:
+#  cleanup:
+#    runs-on: self-hosted
+#    steps:
+#    - name: Cleanup
+#      run: rm -rf .* || true
   build:
     runs-on: ${{ matrix.os }}
     continue-on-error: true
@@ -8,63 +13,129 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: ubuntu-18.04
+          # Linux build specifically want oldest Ubuntu as possible
+          # to be crossdistribution compatible, otherwise use ubuntu-latest
+          - os: ubuntu-20.04
             targetos: linux
             targetarch: amd64
-          - os: ubuntu-18.04
+          - os: ubuntu-20.04
             targetos: linux
             targetarch: i386
-
-          - os: ubuntu-18.04
+          - os: ubuntu-20.04
+            targetos: linux
+            targetarch: arm64
+            cross: true
+          - os: ubuntu-20.04
+            targetos: linux
+            targetarch: armhf
+            cross: true
+          - os: ubuntu-20.04
+            targetos: linux
+            targetarch: riscv64
+            cross: true
+          - os: ubuntu-20.04
+            targetos: linux
+            targetarch: ppc64el
+            cross: true
+#          - os: ubuntu-aarch64-20.04
+#            targetos: linux
+#            targetarch: aarch64
+          - os: ubuntu-20.04
             targetos: android
-            targetarch: 32
-          - os: ubuntu-18.04
-            targetos: android
-            targetarch: 64
-
-          - os: ubuntu-18.04
-            targetos: motomagx
-            targetarch: armv6
+            targetarch: multiarch
+#          - os: ubuntu-20.04
+#            targetos: motomagx
+#            targetarch: armv6
 
+          - os: ubuntu-latest
+            targetos: nswitch
+            targetarch: arm64
+          - os: ubuntu-latest
+            targetos: psvita
+            targetarch: armv7hf
           - os: windows-latest
             targetos: win32
             targetarch: amd64
-          - os: windows-latest
+          - os: windows-2019 # always use the oldest possible for 32-bit because of older compilers, and better support of certain legacy OSes
             targetos: win32
             targetarch: i386
+          - os: macos-14 # arm64 as per github documentation
+            targetos: apple
+            targetarch: arm64
+          - os: macos-13 # x86 as per github documentation (will they fix it before they deprecate this version?..)
+            targetos: apple
+            targetarch: amd64
     env:
-      SDL_VERSION: 2.0.14
+      SDL_VERSION: 2.30.9
       GH_CPU_ARCH: ${{ matrix.targetarch }}
-      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      ANDROID_SDK_TOOLS_VER: 4333796
-      ANDROID_NDK_VER: r10e
-      UPLOADTOOL_ISPRERELEASE: true
+      GH_CROSSCOMPILING: ${{ matrix.cross }}
     steps:
     - name: Checkout
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
       with:
         submodules: recursive
-    - name: Checkout xash-extras
-      uses: actions/checkout@v2
-      with:
-        repository: FWGS/xash-extras
-        path: xash-extras
-
     - name: Install dependencies
       run: bash scripts/gha/deps_${{ matrix.targetos }}.sh
-
     - name: Build engine
+      env:
+        FWGS_PFX_PASSWORD: ${{ secrets.FWGS_PFX_PASSWORD }}
       run: bash scripts/gha/build_${{ matrix.targetos }}.sh
-
-    - name: Upload engine (android)
-      if: matrix.targetos == 'android'
-      run: bash scripts/continious_upload.sh xashdroid-${{ matrix.targetarch }}.apk
-    - name: Upload engine (motomagx)
-      if: matrix.targetos == 'motomagx'
-      run: bash scripts/continious_upload.sh xash3d-fwgs-magx.7z
-    - name: Upload engine (linux)
-      if: matrix.targetos == 'linux'
-      run: bash scripts/continious_upload.sh xash3d-fwgs-${{ matrix.targetarch }}.AppImage xashds-linux-${{ matrix.targetarch }}
-    - name: Upload engine (windows)
-      if: matrix.targetos == 'win32'
-      run: bash scripts/continious_upload.sh xash3d-fwgs-win32-${{ matrix.targetarch }}.7z
+    - name: Upload engine (artifacts)
+      uses: actions/upload-artifact@v4
+      with:
+        name: artifact-${{ matrix.targetos }}-${{ matrix.targetarch }}
+        path: artifacts/*
+  flatpak:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - app: su.xash.Engine.Compat.i386
+    container:
+      image: bilelmoussaoui/flatpak-github-actions:freedesktop-24.08
+      options: --privileged
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+      with:
+        submodules: recursive
+    - name: Build flatpak (Compat.i386)
+      uses: FWGS/flatpak-github-actions/flatpak-builder@v6.3
+      with:
+        bundle: ${{ matrix.app }}.flatpak
+        manifest-path: scripts/flatpak/${{ matrix.app }}.yml
+  release:
+    name: "Upload releases"
+    runs-on: ubuntu-latest
+    needs: [build, flatpak]
+    if: ${{ github.event_name == 'push' }}
+    steps:
+    - name: Remove old release, fetch artifacts, repackage binaries and upload new release
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        RELEASE_TAG: ${{ github.ref_name == 'master' && 'continuous' || format('continuous-{0}', github.ref_name) }}
+      run: |
+        gh release delete "$RELEASE_TAG" \
+          --yes \
+          --cleanup-tag \
+          --repo "$GITHUB_REPOSITORY" || true
+        sleep 20s
+        gh run download "$GITHUB_RUN_ID" \
+          --dir artifacts/ \
+          --repo "$GITHUB_REPOSITORY"
+        pushd artifacts/
+        echo "Found artifacts:"
+        ls
+        for i in $(find -mindepth 1 -maxdepth 1 -type d); do
+          mv "$i"/* .
+          rm -rf "$i"
+        done
+        echo "Repackaged artifacts:"
+        ls -R
+        popd
+        sleep 20s
+        gh release create "$RELEASE_TAG" artifacts/* \
+          --title "Xash3D FWGS Continuous ${{ github.ref_name }} Build" \
+          --target $GITHUB_SHA \
+          --repo "$GITHUB_REPOSITORY" \
+          --prerelease

.gitignore

@@ -54,12 +54,18 @@ CMakeFiles
 Makefile
 cmake_install.cmake
 install_manifest.txt
+CMakeLists.txt*
+CMakeScripts
+Testing
+compile_commands.json
+_deps
 # makedepend
 Makefile.dep
 *.bak
 ALL_BUILD.*
 INSTALL.*
 ZERO_CHECK.*
+CMakeLists.txt
 
 # Visual Studio
 *.obj
@@ -331,4 +337,11 @@ __pycache__
 .vscode/*
 *.code-workspace
 .history/*
-.cache/*
+.cache/*
+enc_temp_folder/
+
+# KDevelop4
+*.kdev4
+
+# ccls langauge server
+.ccls-*

.gitmodules

@@ -1,15 +1,36 @@
 [submodule "mainui"]
-	path = mainui
+	path = 3rdparty/mainui
 	url = https://github.com/FWGS/mainui_cpp
 [submodule "ref_gl/nanogl"]
-	path = ref_gl/nanogl
+	path = 3rdparty/nanogl
 	url = https://github.com/FWGS/nanogl
 [submodule "ref_gl/gl-wes-v2"]
-	path = ref_gl/gl-wes-v2
+	path = 3rdparty/gl-wes-v2
 	url = https://github.com/FWGS/gl-wes-v2
-[submodule "vgui-dev"]
-	path = vgui-dev
-	url = https://github.com/FWGS/vgui-dev
 [submodule "ref_gl/gl4es"]
-	path = ref_gl/gl4es
+	path = 3rdparty/gl4es/gl4es
 	url = https://github.com/ptitSeb/gl4es
+[submodule "vgui_support"]
+	path = 3rdparty/vgui_support
+	url = https://github.com/FWGS/vgui_support
+[submodule "opus"]
+	path = 3rdparty/opus/opus
+	url = https://github.com/xiph/opus
+[submodule "3rdparty/xash-extras"]
+	path = 3rdparty/extras/xash-extras
+	url = https://github.com/FWGS/xash-extras
+[submodule "3rdparty/bzip2/bzip2"]
+	path = 3rdparty/bzip2/bzip2
+	url = https://gitlab.com/bzip2/bzip2
+[submodule "3rdparty/MultiEmulator"]
+	path = 3rdparty/MultiEmulator
+	url = https://github.com/FWGS/MultiEmulator
+[submodule "3rdparty/libogg/libogg"]
+	path = 3rdparty/libogg/libogg
+	url = https://gitlab.xiph.org/xiph/ogg.git
+[submodule "3rdparty/vorbis/vorbis-src"]
+	path = 3rdparty/vorbis/vorbis-src
+	url = https://gitlab.xiph.org/xiph/vorbis.git
+[submodule "3rdparty/opusfile/opusfile"]
+	path = 3rdparty/opusfile/opusfile
+	url = https://gitlab.xiph.org/xiph/opusfile.git

.travis.yml

@@ -1,35 +0,0 @@
-language: c
-compiler: gcc
-sudo: false
-env:
-  global:
-    - SDL_VERSION=2.0.14
-git:
-  depth: 50
-  submodules: true
-
-os: linux
-arch:
-  - aarch64
-  - ppc64le
-  - s390x
-addons:
-  apt:
-    update: true
-    packages:
-      - libx11-dev
-      - libxext-dev
-      - x11-utils
-      - libgl1-mesa-dev
-      - libasound-dev
-      - libstdc++6
-      - libfuse2
-      - unzip
-before_script:
-  - sh scripts/travis/deps_common.sh
-  - sh scripts/travis/deps_${TRAVIS_OS_NAME}.sh
-script:
-  - sh scripts/travis/build_${TRAVIS_OS_NAME}.sh
-after_script:
-  - ccache --show-stats
-  - sh scripts/continious_upload.sh xash3d-fwgs-${ARCH}.tar.xz xashds-linux-${ARCH}

3rdparty/bzip2/wscript

@@ -0,0 +1,27 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+def options(opt):
+	pass
+
+def configure(conf):
+	conf.define('_GNU_SOURCE', 1)
+	conf.define('BZ_NO_STDIO', 1)
+
+	if conf.env.DEST_OS == 'win32':
+		conf.define('BZ_LCCWIN32', 1)
+	else:
+		conf.define('BZ_UNIX', 1)
+
+def build(bld):
+	bld(features = 'subst', source = 'bzip2/bz_version.h.in', target = 'bzip2/bz_version.h', BZ_VERSION='1.1.0-fwgs', name = 'bz_version')
+
+	bz_sources = ['bzip2/blocksort.c', 'bzip2/huffman.c', 'bzip2/crctable.c', 'bzip2/randtable.c', 'bzip2/compress.c', 'bzip2/decompress.c', 'bzip2/bzlib.c']
+
+	bld.stlib(
+		source = bz_sources,
+		target = 'bzip2',
+		use = 'bz_version',
+		includes = 'bzip2/',
+		export_includes = 'bzip2/'
+	)

3rdparty/extras/wscript

@@ -0,0 +1,29 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+import os
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('xash-extras'):
+		conf.fatal('Can\'t find xash-extras submodule.')
+		return
+
+	conf.load('zip')
+
+def build(bld):
+	srcdir = bld.path.find_dir('xash-extras')
+
+	if bld.env.DEST_OS in ['android']:
+		install_path = bld.env.PREFIX
+	else:
+		install_path = os.path.join(bld.env.SHAREDIR, bld.env.GAMEDIR)
+
+	bld(features='zip',
+		name = 'extras.pk3',
+		files = srcdir.ant_glob('**/*'),
+		relative_to = srcdir,
+		compresslevel = 0,
+		install_path = install_path)

3rdparty/gl4es/wscript

@@ -0,0 +1,22 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+import os
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('gl4es') or not conf.path.find_dir('gl4es/src'):
+		conf.fatal('Can\'t find gl4es submodule. Run `git submodule update --init --recursive`.')
+		return
+
+def build(bld):
+	gl4es_srcdir = bld.path.find_node('gl4es/src')
+
+	bld.stlib(source   = gl4es_srcdir.ant_glob(['gl/*.c', 'gl/*/*.c', 'glx/hardext.c']),
+		target   = 'gl4es',
+		includes = ['gl4es/src', 'gl4es/src/gl', 'gl4es/src/glx', 'gl4es/include'],
+		defines  = ['NOX11', 'NO_GBM', 'NO_INIT_CONSTRUCTOR', 'DEFAULT_ES=2', 'NOEGL', 'NO_LOADER', 'STATICLIB'],
+		cflags   = ['-w', '-fvisibility=hidden', '-std=gnu99'],
+		export_includes = '.')

3rdparty/libogg/wscript

@@ -0,0 +1,50 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('libogg') or not conf.path.find_dir('libogg/src'):
+		conf.fatal('Can\'t find libogg submodule. Run `git submodule update --init --recursive`.')
+		return
+
+	conf.env.INCLUDE_INTTYPES_H = 0
+	conf.env.INCLUDE_SYS_TYPES_H = 0
+	conf.env.INCLUDE_STDINT_H = 0
+
+	if conf.check_cc(header_name='inttypes.h', mandatory = False):
+		conf.env.INCLUDE_INTTYPES_H = 1
+	elif conf.check_cc(header_name='sys/types.h', mandatory = False):
+		conf.env.INCLUDE_SYS_TYPES_H = 1
+	elif conf.check_cc(header_name='stdint.h', mandatory = False):
+		conf.env.INCLUDE_STDINT_H = 1
+
+def build(bld):
+	sources = bld.path.ant_glob([
+		'libogg/src/*.c'
+	])
+
+	bld(
+		features = 'subst',
+		name = 'libogg_config_types',
+		source = 'libogg/include/ogg/config_types.h.in',
+		target = 'libogg/include/ogg/config_types.h',
+		INCLUDE_INTTYPES_H = bld.env.INCLUDE_INTTYPES_H,
+		INCLUDE_SYS_TYPES_H = bld.env.INCLUDE_SYS_TYPES_H,
+		INCLUDE_STDINT_H = bld.env.INCLUDE_STDINT_H,
+		SIZE16 = 'int16_t',
+		USIZE16 = 'uint16_t',
+		SIZE32 = 'int32_t',
+		USIZE32 = 'uint32_t',
+		SIZE64 = 'int64_t',
+		USIZE64 = 'uint64_t'
+	)
+
+	bld.stlib(
+		source = sources,
+		target = 'ogg',
+		use = 'libogg_config_types',
+		includes = 'libogg/include/',
+		export_includes = 'libogg/include/'
+	)

3rdparty/opus/wscript

@@ -0,0 +1,68 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+import os
+
+FRAGMENT_VLA='''int main (int argc, char **argv) {
+	char a[argc];
+	a[sizeof( a ) - 1] = 0;
+	int N;
+	return a[0];
+}'''
+
+FRAGMENT_ALLOCA_H='''#include <alloca.h>
+int main (void) {
+	int foo=10;
+	int * array = alloca(foo);
+}'''
+
+FRAGMENT_STDLIB_H='''#include <malloc.h>
+#include <stdlib.h>
+int main (void) {
+	int foo=10;
+	int * array = alloca(foo);
+}'''
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('opus') or not conf.path.find_dir('opus/src'):
+		conf.fatal('Can\'t find opus submodule. Run `git submodule update --init --recursive`.')
+		return
+
+	# Check for C99 variable-size arrays, or alloca() as fallback
+	if conf.check_cc(fragment=FRAGMENT_VLA, msg = 'Checking for C99 VLA support', mandatory = False):
+		conf.define('VAR_ARRAYS', 1)
+	elif conf.check_cc(fragment=FRAGMENT_ALLOCA_H, msg = 'Checking for alloca in alloca.h header', mandatory = False):
+		conf.define('USE_ALLOCA', 1)
+		conf.define('HAVE_ALLOCA_H', 1)
+	elif conf.check_cc(fragmenmt=FRAGMENT_STDLIB_H, msg = 'Checking for alloca.h in stdlib.h', mandatory = False):
+		conf.define('USE_ALLOCA', 1)
+
+	# TODO: ARM/x86 intrinsics detection
+	# TODO: maybe call autotools/cmake/meson instead?
+
+def build(bld):
+	sources = bld.path.ant_glob([
+		'opus/src/*.c',
+		'opus/celt/*.c',
+		'opus/silk/*.c',
+		'opus/silk/float/*.c'
+	], excl = [
+		'opus/src/repacketizer_demo.c',
+		'opus/src/opus_demo.c',
+		'opus/src/opus_compare.c',
+		'opus/celt/opus_custom_demo.c'
+	])
+	includes = ['opus/include/', 'opus/celt/', 'opus/silk/', 'opus/silk/float/']
+	defines = ['OPUS_BUILD', 'FLOAT_APPROX', 'PACKAGE_VERSION="1.4.0"', 'CUSTOM_MODES']
+
+	bld.stlib(
+		source = sources,
+		target = 'opus',
+		features = 'c',
+		includes = includes,
+		defines = defines,
+		export_includes = ['opus/include/']
+	)

3rdparty/opusfile/wscript

@@ -0,0 +1,37 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('opusfile') or not conf.path.find_dir('opusfile/src'):
+		conf.fatal('Can\'t find opusfile submodule. Run `git submodule update --init --recursive`.')
+		return
+
+	if conf.env.COMPILER_CC == 'msvc':
+		conf.define('_CRT_SECURE_NO_WARNINGS', 1)
+		conf.define('_CRT_SECURE_NO_DEPRECATE', 1)
+		conf.define('_CRT_NONSTDC_NO_DEPRECATE', 1)
+
+	if conf.env.DEST_OS == 'android':
+		# HACKHACK: set it to 32 here because opusfile can't be built on Android SDK < 24
+		# with _FILE_OFFSET_BITS 64 (which it sets automatically in src/internal.h)
+		# we are not (????) relying on this part of the API, so it should be harmless
+		conf.define('_FILE_OFFSET_BITS', 32)
+
+def build(bld):
+	sources = [
+		'opusfile/src/info.c',
+		'opusfile/src/internal.c',
+		'opusfile/src/opusfile.c',
+		'opusfile/src/stream.c'
+	]
+
+	bld.stlib(
+		source = sources,
+		target = 'opusfile',
+		includes = 'opusfile/include/',
+		use = 'ogg opus',
+		export_includes = 'opusfile/include/'
+	)

3rdparty/vorbis/wscript

@@ -0,0 +1,71 @@
+#! /usr/bin/env python
+# encoding: utf-8
+
+FRAGMENT_MEMORY_H='''#include <memory.h>
+int main (void) {
+	return 0;
+}'''
+
+FRAGMENT_ALLOCA_H='''#include <alloca.h>
+int main (void) {
+	int foo=10;
+	int * array = alloca(foo);
+}'''
+
+def options(opt):
+	pass
+
+def configure(conf):
+	if not conf.path.find_dir('vorbis-src') or not conf.path.find_dir('vorbis-src/lib'):
+		conf.fatal('Can\'t find Vorbis submodule. Run `git submodule update --init --recursive`.')
+		return
+
+	if conf.check_cc(fragment=FRAGMENT_MEMORY_H, msg = 'Checking for memory.h header', mandatory = False):
+		conf.define('USE_MEMORY_H', 1)
+
+	conf.check_cc(fragment=FRAGMENT_ALLOCA_H, msg = 'Checking for alloca in alloca.h header', mandatory = False)
+
+	if conf.env.COMPILER_CC == 'msvc':
+		conf.define('_CRT_SECURE_NO_WARNINGS', 1)
+		conf.define('_CRT_SECURE_NO_DEPRECATE', 1)
+		conf.define('_CRT_NONSTDC_NO_DEPRECATE', 1)
+
+def build(bld):
+	libvorbis_sources = [
+		'vorbis-src/lib/mdct.c',
+		'vorbis-src/lib/smallft.c',
+		'vorbis-src/lib/block.c',
+		'vorbis-src/lib/envelope.c',
+		'vorbis-src/lib/window.c',
+		'vorbis-src/lib/lsp.c',
+		'vorbis-src/lib/lpc.c',
+		'vorbis-src/lib/analysis.c',
+		'vorbis-src/lib/synthesis.c',
+		'vorbis-src/lib/psy.c',
+		'vorbis-src/lib/info.c',
+		'vorbis-src/lib/floor1.c',
+		'vorbis-src/lib/floor0.c',
+		'vorbis-src/lib/res0.c',
+		'vorbis-src/lib/mapping0.c',
+		'vorbis-src/lib/registry.c',
+		'vorbis-src/lib/codebook.c',
+		'vorbis-src/lib/sharedbook.c',
+		'vorbis-src/lib/lookup.c',
+		'vorbis-src/lib/bitrate.c'
+	]
+
+	bld.stlib(
+		source = libvorbis_sources,
+		target = 'vorbis',
+		includes = 'vorbis-src/include/',
+		use = 'ogg',
+		export_includes = 'vorbis-src/include/'
+	)
+
+	bld.stlib(
+		source = 'vorbis-src/lib/vorbisfile.c',
+		target = 'vorbisfile',
+		includes = 'vorbis-src/include/',
+		use = 'vorbis',
+		export_includes = 'vorbis-src/include/'
+	)

Documentation/bug-compatibility.md

@@ -0,0 +1,18 @@
+# Bug-compatibility in Xash3D FWGS
+
+Xash3D FWGS has special mode for games that rely on original engine bugs. In this mode, we emulate the behaviour of selected functions that may help running mods relying on engine bugs, but enabling them by default may break majority of other games.
+
+At this time, we only have implemented GoldSrc bug-compatibility. It can be enabled with `-bugcomp` command line switch.
+
+When `-bugcomp` is specified without argument, it enables everything. This behavior might be changed or removed in future versions.
+
+When `-bugcomp` is specified with argument, it interpreted as flags separated with `+`. This way it's possible to combine multiple levels of bug-compatibility.
+
+## GoldSrc bug-compatibility
+
+| Flag    | Description | Games that require this flag |
+| ------- | ----------- | ---------------------------- |
+| `peoei` | Reverts `pfnPEntityOfEntIndex` behavior to GoldSrc, where it returns NULL for last player due to incorrect player index comparison | * Counter-Strike: Condition Zero - Deleted Scenes |
+| `gsmrf` | Rewrites message at the moment when Game DLL attempts to write an internal engine message, usually specific to GoldSrc protocol.<br>Right now only supports `svc_spawnstaticsound`, more messages added by request. | * MetaMod/AMXModX based mods |
+| `sp_attn_none` | Makes sounds with attenuation zero spatialized, i.e. have a stereo effect. | Possibly, every game that was made for GoldSrc. |
+| `get_game_dir_full` | Makes server return full path in server's `pfnGetGameDir` API function | Mods targetting engine before HL 1.1.1.1, according to MetaMod [documentation](http://metamod.org/engine_notes.html#GetGameDir) |

Documentation/cross-compiling-for-windows-with-wine.md

@@ -0,0 +1,9 @@
+# Cross-compiling for Windows with Wine
+
+This can be useful to test engine in Wine without using virtual machines or dual-booting to Windows.
+
+0. Clone and install https://github.com/mstorsjo/msvc-wine (you can skip CMake part)
+1. Set environment variable MSVC_WINE_PATH to the path to installed MSVC toolchain
+2. Pre-load wine: `wineserver -k; wineserver -p; wine64 wineboot`
+3. Run `./waf configure -T <build-type> --enable-wine-msvc --sdl2=../SDL2_VC`. Configuration step will take more time than usual.
+4. .. other typical steps to build from console ...

Documentation/debugging-using-minidumps.md

@@ -0,0 +1,10 @@
+# Debugging your mod using minidump files (Windows only)
+Minidump files is awesome instrument for debugging your mod after it's being released, or for catch specific crashes which are presented only in one specific configuration, but doesn't happens in other configurations or even on developer machine. It contains a lot of information useful for debugging, and therefore it size is not so small: around hundreds or even thousands of megabytes. But this is not a problem, since minidump files compresses very effectively using common algorithms.
+There are short algorithm, explaining how to use this debugging instrument:
+
+1. User starts your mod with `-minidumps` startup parameter
+2. Finally, crash happened on user's machine, and minidump file being written. This file has `.mdmp` extension and located in same folder, where mod folder located
+3. User packs this minidump file to .zip/.7z archive, and somehow sends it to developer
+4. Developer just opens minidump file in Visual Studio, then a virtual debugging session is opened and now reasons of crash is pretty easy to detect: you can see call stack, local function variables and global variables, information about exception and a lot of other information
+
+You can find more information about minidumps in this [awesome article](https://learn.microsoft.com/en-us/windows/win32/dxtecharts/crash-dump-analysis?source=recommendations#writing-a-minidump).

Documentation/donate.md

@@ -0,0 +1,24 @@
+# Developers donation page
+
+On this page you can find links where you can support each developer individually, who has provided public sponsorship information.
+
+### [a1batross](https://github.com/a1batross)
+
+* Initial Xash3D SDL2/Linux port author, Xash3D FWGS engine maintainer, creator of non-commercial Flying With Gauss organization.
+* Boosty page: https://boosty.to/a1ba
+
+### [nekonomicon](https://github.com/nekonomicon)
+
+* [hlsdk-portable](https://github.com/FWGS/hlsdk-portable), [mdldec](../utils/mdldec), [opensource-mods.md](opensource-mods.md) maintainer and Xash3D FWGS [contributor](https://github.com/FWGS/xash3d-fwgs/commits?author=nekonomicon) (*BSD/clang port, PNG support, etc).
+* Boosty page: https://boosty.to/nekonomicon
+
+### [Velaron](https://github.com/Velaron)
+* [cs16-client](https://github.com/Velaron/cs16-client) & [tf15-client](https://github.com/Velaron/tf15-client) maintainer and Xash3D FWGS [contributor](https://github.com/FWGS/xash3d-fwgs/commits?author=Velaron) (Android port, voice chat, etc).
+* BuyMeACoffee page: https://www.buymeacoffee.com/velaron
+
+### [SNMetamorph](https://github.com/SNMetamorph)
+* [PrimeXT](https://github.com/SNMetamorph/PrimeXT) & [GoldSrc Monitor](https://github.com/SNMetamorph/goldsrc-monitor) maintainer and Xash3D FWGS [contributor](https://github.com/FWGS/xash3d-fwgs/commits?author=SNMetamorph) (Windows port, voice chat, etc).
+* BTC: `16GAzK3qei5AwBW7sggXp3yNcFHBtdpxXj`
+* ETH (ERC20): `0xb580eeca9756e3881f9d6d026e28db28eb72a383`
+* USDT (ERC20): `0xb580eeca9756e3881f9d6d026e28db28eb72a383`
+* USDC (ERC20): `0xb580eeca9756e3881f9d6d026e28db28eb72a383`

Documentation/environment-variables.md

@@ -0,0 +1,21 @@
+## Environment variables
+
+#### Xash3D FWGS
+
+The engine respects these environment variables:
+
+| Variable              | Type       | Description |
+| --------------------- | ---------- | ----------- |
+| `XASH3D_GAME`         | _string_   | Overrides default game directory. Ignored if `-game` command line argument is set |
+| `XASH3D_BASEDIR`      | _string_   | Sets path to base (root) directory, instead of current working directory |
+| `XASH3D_RODIR`        | _string_   | Sets path to read-only base (root) directory. Ignored if `-rodir` command line argument is set |
+| `XASH3D_EXTRAS_PAK1`  | _string_   | Archive file from specified path will be added to virtual filesystem search path in the lowest possible priority |
+| `XASH3D_EXTRAS_PAK2`  | _string_   | Similar to `XASH3D_EXTRAS_PAK1` but next to it in priority list |
+
+Environment variables NOT listed in the table above are used internally, and aren't considered as stable interface.
+
+#### mdldec
+
+| Variable              | Type       | Description |
+| --------------------- | ---------- | ----------- |
+| `MDLDEC_ACT_PATH`     | _string_   | If set, will read activities list from this path |

Documentation/extensions/entity-tools.md

@@ -0,0 +1,152 @@
+# Entity tools
+
+For some features described below, you need to enable [console scripting](https://github.com/FWGS/xash3d-fwgs/blob/master/Documentation/extensions/console-scripting.md) with command `cmd_scripting 1` in console.
+To get more information about it, check another according page related to console scripting.
+
+## Commands description
+
+### ent_create
+Create entity with specified classname and key/values.
+
+`ent_create <classname> <key> <value> <key> <value> ...`
+
+For example:
+
+`ent_create monster_zombie targetname zomb1`
+
+After creating entity, ent_last_xxx cvars are set to new entity and ent_last_cb called, look at ent_getvars description.
+
+### ent_fire
+
+Makes some actions on entity.
+
+`ent_fire <pattern> <command> <args>`
+
+#### Available commands:
+
+Set fields (only set entity field, does not call any functions)
+* health
+* gravity
+* movetype
+* solid
+* rendermode
+* rendercolor (vector)
+* renderfx
+* renderamt
+* hullmin (vector)
+* hullmax (vector)
+
+Actions
+* rename: set entity targetname
+* settarget: set entity target (only targetnames)
+* setmodel: set entity model (does not update)
+* set: set key/value by server library
+    * See game FGD to get list.
+    * command takes two arguments
+* touch: touch entity by current player.
+* use: use entity by current player.
+* movehere: place entity in player fov.
+* drop2floor: place entity to nearest floor surface
+* moveup: move entity to 25 units up
+* moveup (value): move by y axis relatively to specified value
+
+Flags (set/clear specified flag bit, arg is bit number):
+* setflag
+* clearflag
+* setspawnflag
+* clearspawnflag
+
+### ent_info
+Print information about entity by identificator.
+
+`ent_info <identificator>`
+
+### ent_getvars
+Set client cvars containing entity information (useful for [scripting](extensions/console-scripting.md)) and then calls ent_last_cb.
+
+`ent_getvars <identificator>`
+
+These cvars are set:
+```
+ent_last_name
+ent_last_num
+ent_last_inst
+ent_last_origin
+ent_last_class
+```
+
+### ent_list
+Print short information about antities, filtered by pattern.
+
+`ent_list <pattern>`
+
+## Syntax description
+
+#### \<identificator\>
+* !cross: entity under aim
+* !\<number\>_\<serial\>: instance code
+* Set by ent_getvars command
+* Entity index
+* Targetname pattern
+
+#### \<pattern\>
+
+Pattern is like identificator, but may filter many entities by classname.
+
+#### (vector)
+
+Used by ent_fire command. vector means three float values, entered without quotes.
+
+#### key/value
+
+All entities parameters may be set by specifiing key and value strings.
+
+Originally, this mechanizm is used in map/bsp format, but it can be used in enttools too.
+
+Keys and values are passed to server library and processed by entity keyvalue function, setting edict and entity owns parameters.
+
+If value contains spaces, it must be put in quotes:
+
+`ent_fire !cross set origin "0 0 0"`
+
+## Using with scripting
+
+ent_create and ent_getvars commands are setting cvars on client
+
+It can be used with ent_last_cb alias that is executed after setting cvars.
+
+Simple example:
+
+```
+ent_create weapon_c4
+alias ent_last_cb "ent_fire \$ent_last_inst use"
+```
+
+Use weapon_c4 after creating it.
+
+Note that you cannot use many different callbacks at the same time.
+
+You can set entity name by by pattern and create special script, contatning all callbacks.
+
+Example:
+
+> example.cfg
+```
+alias ent_last_cb exec entity_cb.cfg
+ent create \<class\> targetname my_ent1_$name
+ent_create \<class\> targetname my_ent2_$name
+```
+> entity_cb.cfg
+```
+if $ent_last_name == my_ent1_$name
+:(ent1 actions)
+if $ent_last_name == my_ent2_$name
+:(ent2 actions)
+```
+Note that scripting cannot be blocking. You cannot wait for server answer and continue. But you can use small scripts, connected with ent_last_cb command. The best usage is user interaction. You can add touch buttons to screen or call user command menu actions by callbacks.
+
+## Server side configuration
+
+To enable entity tools on server, set sv_enttools_enable to 1
+
+To change maximum number of entities, touched by ent_fire, change sv_enttools_maxfire to required number.

Documentation/extensions/expanded-common-structures.md

@@ -0,0 +1,8 @@
+# Expanded structures that used by engine and mods
+To make porting and developing mods on 64-bit platforms less painful, we decided to expand size of several structures.
+This information important in case you are using codebase like XashXT, Paranoia 2: Savior and want to compile your mod for platform with 64-bit pointer size: you should replace old definitions with new ones, otherwise your mod will not work with Xash3D FWGS (typically, it's just crashing when starting map).
+| Structure name | Locates in file | Original size on 64-bit | Current size on 64-bit |
+|----------------|-----------------|-------------------------|------------------------|
+|`mfaceinfo_t` | `common/com_model.h` | 176 bytes |  304 bytes |
+|`decal_s` | `common/com_model.h` | 72 bytes |  88 bytes |
+|`mextrasurf_t` | `common/com_model.h` | 376 bytes |  504 bytes |

Documentation/extensions/library-naming.md

@@ -31,11 +31,14 @@ Issue #0. Inconsistency between ABI and Q_buildarch.\
 Resolution: Change Q_buildarch return value to use Debian-styled architectures list: https://www.debian.org/ports/, which includes a special naming for big/little-endian and hard/soft-float ARM.
 
 Issue #1: Build-system integration.\
-Resolution: implemented as [LibraryNaming.cmake](https://github.com/FWGS/hlsdk-xash3d/blob/master/cmake/LibraryNaming.cmake) and [library_naming.py](https://github.com/FWGS/hlsdk-xash3d/blob/master/scripts/waifulib/library_naming.py) extensions, see 
+Resolution: implemented as [LibraryNaming.cmake](https://github.com/FWGS/hlsdk-portable/blob/master/cmake/LibraryNaming.cmake) and [library_naming.py](https://github.com/FWGS/hlsdk-portable/blob/master/scripts/waifulib/library_naming.py) extensions, see 
 
 Issue #2(related to #0): Which ARM flavours we actually need to handle?\
 Resolution: Little-endian only, as there is no known big-endian ARM platforms in the wild.
 Architecture is coded this way:
 * ```armvxy```, where `x` is ARM instruction set level and `y` is hard-float ABI presence: `hf` where hard float ABI used, otherwise `l`.
 
+Issue #3: Some mods (like The Specialists, Tyrian, ...) already apply suffixes _i386, _i686 to the gamedll path:\
+Resolution: On x86 on **Win/Lin/Mac**, don't change anything. Otherwise, strip the _i?86 part and follow the usual scheme.
+
 See discussion: https://github.com/FWGS/xash3d-fwgs/issues/39

Documentation/extensions/mp3-loops.md

@@ -0,0 +1,22 @@
+## Looping MP3 extension
+
+It is now possible to loop MP3 file in Xash3D FWGS by adding a custom text tag with `LOOP_START` or `LOOPSTART` in description and time point (in raw samples) in value.
+
+### Example with foobar2000
+1. Open Foobar2000
+2. Add your .mp3 file to playlist
+3. Right click to newly added file and select Properties
+4. In Metadata tab, at the bottom of the table, select "+add new"
+5. In newly added line replace `<60>input field name<6D>` with `LOOP_START` (without any symbols).
+6. Press Tab and enter loop time point in raw samples. For example, `0` will replay sound file from beginning to end indefinitely.
+
+### Possible alternatives
+1. Classic WAV files looping. HQ WAV files can take too much disk space, and recommended software supporting cue points is paid, outdated and can't run on modern systems. (Although there is alternative that's proven to work with idTech-based engines called LoopAuditioneer.)
+2. Vorbis looping through comment. Engine doesn't support Vorbis but this extension was highly inspired by this hack.
+
+### Known bugs and limitations
+1. At this time using MP3 as SFX requires complete decoding. This can cause noticeable stutters, so keep MP3 file length in mind.
+2. We deliberately only support modern ID3v2.3 and ID3v2.4 tags. Using ID3v1 is not possible.
+
+
+

Documentation/extensions/native-object.md

@@ -0,0 +1,25 @@
+# GetNativeObject API
+
+To be able to use platform-specific features or get optional engine interfaces, we've added a simple call to MobilityAPI on client DLL and PhysicsAPI for server DLL and extended MenuAPI for menu DLL.
+
+It's defined like this:
+
+```
+void *pfnGetNativeObject( const char *name );
+```
+
+#### Cross-platform objects
+
+Only these objects are guaranteed to be available on all targets.
+
+| Object name | Interface |
+|-------------|-----------|
+| `VFileSystem009` | Provides C++ interface to filesystem, binary-compatible with Valve's VFileSystem009. |
+| `XashFileSystemXXX` | Provides C interface to filesystem. This interface is unstable and not recommended for generic use, outside of engine internals. For more info about current version look into `filesystem.h`. |
+
+#### Android-specific objects
+
+| Object name | Interface |
+|-------------|-----------|
+| `JNIEnv`    | Allows interfacing with Java Native Interface. |
+| `ActivityClass` | Returns JNI object for engine Android activity class. |

Documentation/extensions/sounds.lst.md

@@ -0,0 +1,65 @@
+# sounds.lst.md
+
+Using sounds.lst located in scripts folder, modder can override some of the hardcoded sounds in temp entities and server physics.
+
+File format:
+```
+<group name>
+{
+	<path1>
+	<path2>
+	<path3>
+}
+
+<group2 name> <path with %d> <min number> <max number>
+```
+
+* Sounds can use any supported sound format (WAV or MP3).
+* The path must be relative to the sounds/ folder in the game or base directory root, addon folder, or archive root.
+* Groups can be empty or omitted from the file to load no sound.
+* Groups can either list a set of files or specify a format string and a range.
+* Anything after // will be considered a comment and ignored.
+* Behavior is undefined if the group was listed multiple times.
+
+Currently supported groups are:
+|Group name|Usage|
+|----------|-----|
+|`BouncePlayerShell`|Used for BOUNCE_SHELL tempentity hitsound|
+|`BounceWeaponShell`|Used for BOUCNE_SHOTSHELL tempentity hitsound|
+|`BounceConcrete`|Used for BOUNCE_CONCRETE tempentity hitsound|
+|`BounceGlass`|Used for BOUCNE_GLASS|
+|`BounceMetal`|Used for BOUNCE_METAL|
+|`BounceFlesh`|Used for BOUNCE_FLESH|
+|`BounceWood`|Used for BOUNCE_WOOD|
+|`Ricochet`|Used for BOUNCE_SHRAP and ricochet tempentities|
+|`Explode`|Used for tempentity explosions|
+|`EntityWaterEnter`|Used for entity entering water|
+|`EntityWaterExit`|Used for entity exiting water|
+|`PlayerWaterEnter`|Used for player entering water|
+|`PlayerWaterExit`|Used for player exiting water|
+
+## Example
+
+This example is based on defaults sounds used in Half-Life:
+
+```
+BouncePlayerShell "player/pl_shell%d.wav" 1 3
+BounceWeaponShell "weapons/sshell%d.wav" 1 3
+BounceConcrete "debris/concrete%d.wav" 1 3
+BounceGlass "debris/glass%d.wav" 1 4
+BounceMetal "debris/metal%d.wav" 1 6
+BounceFlesh "debris/flesh%d.wav" 1 7
+BounceWood "debris/wood%d.wav" 1 4
+Ricochet "weapons/ric%d.wav" 1 5
+Explode "weapons/explode%d.wav" 3 5
+EntityWaterEnter "player/pl_wade%d.wav" 1 4
+EntityWaterExit "player/pl_wade%d.wav" 1 4
+PlayerWaterEnter
+{
+	"player/pl_wade1.wav"
+}
+PlayerWaterExit
+{
+	"player/pl_wade2.wav"
+}
+```

Documentation/gameinfo.md

@@ -0,0 +1,117 @@
+# Game definition and information file
+
+gameinfo.txt is an essential part of any Xash3D based game. It allows basic customization for games creators, like setting game title, DLL paths, etc.
+
+This document defines gameinfo.txt syntax, supported keys and liblist.gam conversion rules for the latest version of the engine. Note for engine developers, keep this document in sync with an implementation.
+
+## gameinfo.txt syntax
+
+* gameinfo.txt is a simple list of keys and values, separated by newline.
+* You can add single line comments using double slashes (//).
+* Keys can accept integer, float, string or boolean values.
+* Boolean keys use 0 as false and 1 as true value.
+* To have spaces in string values, you must enclose them in double quotes. Then, to have double quotes, you must escape it with backslash, and to have a backslash you need to use double backslashes.
+
+The example:
+```
+// this is a comment :)
+// this is another comment
+some_integer_key 123
+
+this_is_float_key 13.37 // optional comment
+
+enable_feature 1 // boolean, 1 to enable, 0 to disable
+
+example_string_key string_value
+example_spaces "string with spaces"
+example_title "Fate\\Stay Night" // engine will parse it as Fate\Stay Night
+```
+
+## gameinfo.txt keys
+
+This is a list of all gameinfo.txt keys supported by the engine. Be aware that the engine will silently skip all unrecognized keys.
+
+| Key              | Type       | Default value   | Description |
+| ---------------- | ---------- | --------------- | ----------- |
+| `ambient0`       | string     | Empty string    | Automatic ambient sound |
+| `ambient1`       | string     | Empty string    | Automatic ambient sound |
+| `ambient2`       | string     | Empty string    | Automatic ambient sound |
+| `ambient3`       | string     | Empty string    | Automatic ambient sound |
+| `basedir`        | string     | `valve`         | Game base directory, used to share assets between games |
+| `date`           | string     | Empty string    | Game release date. Unused. |
+| `dllpath`        | string     | `cl_dlls`       | Game DLL path. Engine will search custom DLLs (client or menu, for example) in this directory, except `gamedll`, see below. |
+| `fallback_dir`   | string     | Empty string    | Additional game base directory |
+| `gamedir`        | string     | Current gamedir | Game directory, ignored in FWGS, as game directory is defined by the game directory name |
+| `gamedll`        | string     | `dlls/hl.dll`   | Game server DLL for 32-bit x86 Windows (see LibraryNaming.md for details) |
+| `gamemode`       | string     | Empty string    | Game type. When set to `singleplayer_only` or `multiplayer_only` marks the game as SP or MP only respectively, hiding the option in game UI. Omitting this key or using custom values mark the game as both MP and SP compatible. |
+| `icon`           | string     | `game.ico`      | Game icon. Engine will automatically append .ico and may automatically switch to .tga icon as well |
+| `max_beams`      | integer    | 128             | Beams limit, 64 min, 512 max |
+| `max_edicts`     | integer    | 900             | Entities limit, 600 min, 8192 max (protocol limit). In FWGS, minimum is 64. |
+| `max_particles`  | integer    | 4096            | Particles limit, 1024 min, 131072 max |
+| `max_tempents`   | integer    | 500             | Temporary entities limit. 300 min, 2048 max |
+| `mp_entity`      | string     | `info_player_deathmatch` | Entity used to mark maps as multiplayer |
+| `mp_filter`      | string     | Empty string    | When set, used to filter multiplayer maps instead of `mp_entity`.<br>If the map name starts with the same characters as this filter, it's considered a multiplayer map |
+| `nomodels`       | boolean    | 0               | When set to 1, disallows changing player model in UI |
+| `noskills`       | boolean    | 0               | When set to 1, disallows selection of game difficulty |
+| `secure`         | boolean    | 0               | When set to 1, original Unkle Mike's engine will completely disable developer mode. FWGS ignores but preserves this value for compatibility. |
+| `size`           | integer    | 0               | Game directory size in bytes, used in Change Game dialog only |
+| `startmap`       | string     | `c0a0`          | The name of the map used in new game |
+| `sp_entity`      | string     | `info_player_start` | Entity used to mark map as single player. Used in map validation |
+| `title`          | string     | `New Game`      | Game title, used in window title, default server name, etc. |
+| `trainmap`       | string     | `t0a0`          | The name of the training map (Hazard Course) |
+| `type`           | string     | Empty string    | Game type, used in Change Game UI. |
+| `url_info`       | string     | Empty string    | Game homepage URL, used in Change Game UI |
+| `url_update`     | string     | Empty string    | Game updates URL, used in Settings UI |
+| `version`        | float      | 1.0             | Game version, used in Change Game dialog and in server info |
+
+## FWGS-specific gameinfo.txt keys
+
+These strings are specific to Xash3D FWGS.
+
+| Key                     | Type       | Default value            | Description |
+| ----------------------- | ---------- | ------------------------ | ----------- |
+| `animated_title`        | boolean    | 0                        | Use animated title in main menu (WON Half-Life logo.avi imitation from Half-Life 25-th anniversary update)
+| `autosave_aged_count`   | integer    | 2                        | Auto saves limit used in saves rotation |
+| `gamedll_linux`         | string     | Generated from `gamedll` | Game server DLL for 32-bit x86 Linux (see LibraryNaming.md for details) |
+| `gamedll_osx`           | string     | Generated from `gamedll` | Game server DLL for 32-bit x86 macOS (see LibraryNaming.md for details) |
+| `hd_background`         | boolean    | 0                        | Use HD background for main menu (Half-Life 25-th anniversary update) |
+| `internal_vgui_support` | boolean    | 0                        | Only for programmers! Required to be set as 1 for PrimeXT!<br>When set to 1, the engine will not load vgui_support DLL, as VGUI support is done (or intentionally ignored) on the game side. |
+| `render_picbutton_text` | boolean    | 0                        | When set to 1, the UI will not use prerendered `btns_main.bmp` and dynamically render them instead |
+| `quicksave_aged_count`  | integer    | 2                        | Quick saves limit used in saves rotation |
+| `demomap`               | string     | Empty string             | The name of the demo chapter map (Half-Life Uplink) |
+
+## Note on GoldSrc liblist.gam support
+
+As Xash3D accidentally supports GoldSrc games, it also supports parsing liblist.gam.\
+Xash3D will use this file if gameinfo.txt is absent, or if its modification timestamp is older than liblist.gam.
+
+For game creators who plan supporting only Xash3D, using this file is not recommended.
+
+The table below defines conversion rules from liblist.gam to gameinfo.txt. Some keys' interpretation does differ from `gameinfo.txt`, in this case a note will be left. If `liblist.gam` key isn't present in this table, it's ignored.
+
+| `liblist.gam` key | `gameinfo.txt` key | Note |
+| ----------------- | ------------------ | ---- |
+| `animated_title`  | `animated_title`   |      |
+| `edicts`          | `max_edicts`       |      |
+| `fallback_dir`    | `fallback_dir`     |      |
+| `game`            | `title`            |      |
+| `gamedir`         | `gamedir`          |      |
+| `gamedll`         | `gamedll`          |      |
+| `gamedll_linux`   | `gamedll_linux`    |      |
+| `gamedll_osx`     | `gamedll_osx`      |      |
+| `hd_background`   | `hd_background`    |      |
+| `icon`            | `icon`             |      |
+| `mpentity`        | `mp_entity`        |      |
+| `mpfilter`        | `mp_filter`        |      |
+| `nomodels`        | `nomodels`         |      |
+| `secure`          | `secure`           | In GoldSrc it's used to mark the multiplayer game as anti-cheat enabled.<br>Original Xash3D misinterprets its value for disallowing console and developer mode.<br>FWGS ignores this key but preserves for compatibility. |
+| `startmap`        | `startmap`         |      |
+| `size`            | `size`             |      |
+| `trainingmap`     | `trainmap`         |      |
+| `trainmap`        | `trainmap`         |      |
+| `type`            | `type` & `gamemode`| In `liblist.gam` this key works as both `type` and `gamemode`.<br>If value is `singleplayer_only` or `multiplayer_only` the game is marked as SP or MP only, and `gameinfo.txt` type set to `Single` or `Multiplayer`.<br>Any custom value will mark the game as both SP and MP compatible, and type is set to whatever custom value. |
+| `url_dl`          | `url_update`       |      |
+| `url_info`        | `url_info`         |      |
+| `version`         | `version`          |      |
+
+

Documentation/goldsrc-protocol-support.md

@@ -0,0 +1,15 @@
+# Support for GoldSrc network protocol
+This feature is still work-in-progress, but for now it's available for all users, and we appreciate any bug-reports and contributions around it.
+
+For connecting to GoldSrc-based servers, use this command:
+```
+connect ip:port gs
+```
+
+But keep in mind, there are requirement for server to be able to accept connections from Xash3D-based clients: it should use Reunion or Dproto.
+Without this requirement, you will just get "Steam validation rejected" error on connecting.
+
+That is because proper authorization with Steam API is not implemented in engine yet (but we have plans on it).
+
+Also, we encountered that some GoldSrc-based servers are recognizing Xash3D clients as "fake clients" and banning/kicking them. Maybe this problem will be
+solved along with better compatibility with GoldSrc behavior, but may be not - we don't know logic behind this fake client checks.

Documentation/hd-textures.md

@@ -0,0 +1,40 @@
+### HD (external) textures support
+
+Xash3D supports loading texture replacements in TGA format for almost all types of models in the game, except alias models at this time.
+
+Textures are expected to be located at:
+* `modfolder/materials/<mapname>` - for a specific map
+* `modfolder/materials/common` - common for all maps
+* `modfolder/materials/decals` - for decals
+* `modfolder/materials/models/<model>` - for models (texture name must match the internal texture name in the model)
+
+Support for high-resolution textures is enabled setting `host_allow_materials` cvar to `1` or in the menu, in "Video options" section.
+
+#### Xash3D FWGS additions
+
+In addition to paths above, Xash3D FWGS checks following paths:
+
+* `modfolder/materials/sprites/<sprite>` - for sprites, except HUD sprites
+
+Also, to check which texture replacements are loaded successfully, failed or weren't found, a mod developer can set `host_allow_materials` cvar value to `2`. The engine will spew log at any developer level in the following format:
+
+```
+Looking for <replacement> replacement... <status code> (<path relative to mod directory>)
+```
+
+Status codes:
+* `OK` - texture replacement file was found and loaded into GPU memory successfully
+* `FAIL` - texture file was found but hasn't been parsed or loaded successfully. Refer to engine log for more details.
+* `MISS` - texture file wasn't found
+
+Example:
+```
+Looking for maps/bounce.bsp:!waterblue tex replacement...OK (materials/common/!waterblue.tga)
+Looking for maps/bounce.bsp:!waterblue_luma tex replacement...MISS (not found)
+Looking for {shot2 decal replacement...MISS (materials/decals/{shot2.tga)
+Looking for {shot4 decal replacement...MISS (materials/decals/{shot4.tga)
+Looking for {shot3 decal replacement...MISS (materials/decals/{shot3.tga)
+Looking for models/gman tex replacement...FAIL (materials/models/gman/GMan_Case1.tga)
+Looking for models/gman tex replacement...FAIL (materials/models/gman/inside_1.tga)
+```
+

Documentation/mod-porting-guide.md

@@ -1,7 +1,40 @@
-# Server porting
+# Self-made port
+## Compatibility with RISC architectures
+### Unaligned access
+Unaligned access on **i386** causes only performance penalty, but on **RISC** it can cause unstable work.
+
+For HLSDK at least you need such patches in util.cpp:
+ - https://github.com/FWGS/halflife/commit/7bfefe86e35d67867ae7af830ac1fc38f2908360
+ - https://github.com/FWGS/hlsdk-portable/commit/617d75545f2ecb9b2d46cc30728dc37c9eb6d35e
+
+### Signed chars
+`char` type defined as **signed** for **x86** and as **unsigned** for **arm**.
+
+And sometimes such difference can break logic.
+
+As a solution you can use `signed char` type in code directly or use `-fsigned-char` option for gcc/clang compilers.
+
+For HLSDK at least you need such [fix](https://github.com/FWGS/hlsdk-portable/commit/1ca34fcb4381682bd517612b530db22a1354a795) in nodes.cpp/.h.
+
+## Compatibility with 64bit architectures
+You need list of patches for Studio Model Render, MAKE_STRING macro and nodes:
+ - https://github.com/FWGS/hlsdk-portable/commit/d287ed446332e615ab5fb25ca81b99fa14d18a73
+ - https://github.com/FWGS/hlsdk-portable/commit/3bce17e3a04f8af10a927a07ceb8ab0f09152ec4
+ - https://github.com/FWGS/hlsdk-portable/commit/9ebfc981773ec4c7a89ffe52d9c249e1fbef9634
+ - https://github.com/FWGS/hlsdk-portable/commit/00833188dab87ef5746286479ba5aeb9d83b4a0c
+ - https://github.com/FWGS/hlsdk-portable/commit/4661b5c1a5245b27a5532745c11e44b5540e4172
+ - https://github.com/FWGS/hlsdk-portable/commit/2b61380146b1d58a8c465f0e312c061b12bda115
+ - https://github.com/FWGS/hlsdk-portable/commit/8ef6cb2427ee16a763103bd3f315f38e2f01cfe2
+
+## Mobility API
+Xash3D FWGS has special extended interface in `mobility_int.h` which adds some new features like vibration on mobile platforms.
+
+## Porting server-side code
 Original valve's server code was compatible with linux and gcc 2.x.
+
 Newer gcc versions have restriction which breaks build.
-Now, to make it building with gcc 4.x, you need do following:
+
+Now, to make it building with gcc 4.x+ or clang, you need to do following:
 * Go to cbase.h and redefine macros as following
 ```
 #define SetThink( a ) m_pfnThink = static_cast <void (CBaseEntity::*)(void)> (&a)
@@ -18,58 +51,60 @@ Now, to make it building with gcc 4.x, you need do following:
 * Replace all SetThink(NULL), SetTouch(NULL), setUse(NULL) and SetBlocked(NULL) by ResetThink(), ResetTouch(), ResetUse() and ResetBlocked()
 * Sometimes you may need to add #include <ctype.h> if functions tolower or isspace are missing
 
-# Client porting
+## Porting client-side code
 
-## VGUI library
-
-Valve's client uses vgui library which is available only on x86 systems and has big amount of mistakes in headers. The best and simplest way of porting is removing VGUI dependency at all.
-Most singleplayer mods don't really use VGUI at all. It is used in multiplayer only to show score table and MOTD window
-
-## Porting 
-
-### First strategy: full port
-
-#### Basic port (Stage 1)
-* First, remove all files and headers which use vgui (contains "vgui" in file name).
-* After that, try to build it and remove vgui includes.
-* Remove all gViewPort usings.
-* Remove all CVoiceManager usings (xash3d does not support voice)
 * Redefine all DLLEXPORT defines as empty field (Place it under _WIN32 macro if you want to keep windows compatibility).
-* Remove hud_servers.cpp and Servers_Init/Servers_Shutdown from hud.cpp
+* Remove hud_servers.cpp and Servers_Init/Servers_Shutdown from hud.cpp.
 * Fix CAPS filenames in includes (like STDIO.H, replace by stdio.h).
-* Replace broken macros as DECLARE_MESSAGE, DECLARE_COMMAND by fixed examples from our hlsdk-xash3d port (cl_util.h)
-* Add ctype.h where it is need (tolower, isspace functions)
-* Add string.h where it is need (memcpy, strcpy, etc)
-* Use in_defs.h from hlsdk_client
-* Add scoreboard_stub.cpp and input_stub.cpp from hlsdk-xash3d to fix linking.
-Now your client should be able to build and work correctly. Add input_xash3d.cpp from hlsdk-xash3d project to fix input.
+* Replace broken macros as DECLARE_MESSAGE, DECLARE_COMMAND by fixed examples from our hlsdk-portable port (cl_util.h).
+* Add ctype.h where is needed (tolower, isspace functions).
+* Add string.h where is needed (memcpy, strcpy, etc).
+* Use in_defs.h from hlsdk-portable.
+* Add input_xash3d.cpp from hlsdk-portable project to fix input.
 
-#### Multiplayer fix (Stage 2)
-Look at hlsdk-xash3d project.
+Now your client should be able to build and work correctly.
 
-Main changes are:
-* Add MOTD.cpp, scoreboard.cpp and input_xash3d.cpp
-* Add missing functions to hud_redraw.cpp, hud.cpp and tri.cpp, fix class defination in hud.h
-* Remove duplicate functions from hud.cpp and HOOK_MESSAGE's for it
-* Remove +showscores/-showscores hooks from input.h
-* Fix cl_util.h
+# Porting mod to hlsdk-portable
+Look at changes which was made.
 
-### Second way: move mod to hlsdk-xash3d
-Look at changes you made in client.
+If there are not too much changes (for example, only some weapons was added), add these changes in hlsdk-portable.
 
-If there are not much changes (for example, only some weapons was add), add these changes in hlsdk-xash3d.
-
-You may use diff with original HLSDK you used and apply it as patch to hlsdk-xash3d.
+You can use diff with original HLSDK and apply it as patch to hlsdk-portable.
 
+```
+NOTE: Many an old mods was made on HLSDK 2.0-2.1 and some rare mods on HLSDK 1.0.
+So you need to have different versions of HLSDK to make diffs.
+Plus different Spirit of Half-Life versions if mod was made on it.
+Also, weapons in old HLSDK versions does not use client weapon prediction system and you may be need to port standart half-life weapons to server side.
+```
 Files must have same line endings (use dos2unix on all files).
 
-I recommend to enable ignoring space changes in diff.
-### Writing Makefiles
+We recommend to enable ignoring space changes in diff.
 
-Use Makefile from hlsdk-xash3d as Makefile example.
+Move all new files to separate directories.
 
-Get .c and .cpp file lists from Visual Studio project and fill SRCS and SRCS_C variables to Makefile.
+# Possible replacements for non-portable external dependencies
+1. If mod uses **fmod.dll** or **base.dll** to play mp3/ogg on client-side or to precache sounds on server-side, you can replace it with:
+	- [pfnPrimeMusicStream](https://github.com/FWGS/hlsdk-portable/blob/master/engine/cdll_int.h#L293=) engine callback;
+	- [miniaudio](https://github.com/mackron/miniaudio);
+	- [phonon](https://community.kde.org/Phonon).
 
-Remove all files containing vgui in name from list, add missing include dirs.
+2. If mod uses **OpenGL**, porting code to Xash3D render interface is recommended.
+
+3. If mod uses **cg.dll**, you can try to port code to [NVFX](https://github.com/tlorach/nvFX).
+
+4. If mod uses detours, comment code or try to find replacement somehow by yourself.
+
+# Additional recommendations
+1. If mod uses STL, you can replace it with [MiniUTL](https://github.com/FWGS/MiniUTL).
+2. Avoid to use dynamic casts to make small size binaries.
+3. Avoid to use exceptions to make small size binaries.
+ 
+# Writing build scripts
+
+Use wscript/CMakeLists.txt files from hlsdk-portable as build scripts example.
+
+Get .c and .cpp file lists from Visual Studio project.
+
+Add missing include dirs.
 
-Do same for Android.mk if you are building for android.

Documentation/musl.md

@@ -0,0 +1,15 @@
+# Xash3D FWGS on `musl`
+
+Xash3D FWGS works on `musl` out of the box. However, the engine doesn't try to differentiate glibc and musl anymore. If you see error similar to:
+
+```
+Host_InitError: can't initialize cl_dlls/client.so: Error relocating valve/cl_dlls/client.so: __sprintf_chk: symbol not found
+```
+
+... or you know that the game you're running is linked against glibc, you can try using `libgcompat`, like this:
+
+```
+$ LD_PRELOAD=/lib/libgcompat.so.0 ./xash3d ...
+```
+
+It will automatically add the missing symbols that glibc binaries usually need. In the future we might automatically link engine against `libgcompat` for better compatibility with prebuilt or closed-source games, if there will be any use for this.

Documentation/nat-bypass-usage.md

@@ -0,0 +1,32 @@
+# NAT bypass feature in Xash3D FWGS
+Since IPv6 not as widespread as we would like, NAT (Network Address Translation) still being actively used by many internet service providers in an attempts to
+mitigate IPv4 addresses exhaustion. In short, they uses one IPv4 address and doing some tricks with ports to represent many other users behind this address.
+
+But this leads to a problem for users: they cannot accept direct
+incoming connections anymore. This means that if you are behind provider's NAT and will try to setup Xash3D FWGS server - nobody will be able to connect to it,
+and the server will not show up in servers public list.
+
+## Is it possible to avoid this problem?
+In most cases, it is possible to bypass NAT with UDP hole punching, and Xash3D FWGS uses this method too. But this method is not 100% guaranteed to work - it depends
+on NAT configurations on both server and client side, and there is no way to control it.
+
+First of all, server should not be behind symmetric NAT. You can check your NAT type on [this page](https://www.checkmynat.com/).
+If you get "Symmetric NAT" result in this test, that means you cannot setup publicly available server with internet connection that you are using.
+
+Here is more detailed scheme of different NAT types compatibility, it explains are users with different NAT types can connect to each other or not.
+Client NAT type on rows, server NAT type on columns:
+
+| *NAT Type*           | Full Cone | Restricted Cone | Port Restricted Cone | Symmetric |
+| -------------------- | --------- | --------------- | -------------------- | --------- |
+| Full Cone            | ✔️        | ✔️              | ✔️                    | ✔️        | 
+| Restricted Cone      | ✔️        | ✔️              | ✔️                    | ✔️        |
+| Port Restricted Cone | ✔️        | ✔️              | ✔️                    | ❌        |
+| Symmetric            | ✔️        | ✔️              | ❌                   | ❌        |
+
+## How to use NAT bypass feature?
+If you are starting server within the game, you need to enable option "*Use NAT Bypass instead of direct mode*" in bottom left corner of screen.
+
+If you are starting dedicated server, you should add console variable `sv_nat 1` to server.cfg file, or add `+sv_nat 1` to server startup parameters.
+
+If you need to connect to server behind NAT, there is separate tab named *NAT* for such servers in server browser. Note that it is useless to add NAT server to favorites,
+or somehow trying manually to store it, because it has changing address and port.

Documentation/not-supported-mod-list-and-reasons-why.md

@@ -7,6 +7,5 @@
 |Counter Strike: Condition Zero				|The latest steam release	|Uses vgui2 library which xash3d does not support		|Some work on vgui2 support was made here: https://github.com/FWGS/xash3d/tree/vinterface
 |Counter Strike: Condition Zero - Deleted scenes	|The latest steam release	|Uses vgui2 library which xash3d does not support		|Some work on vgui2 support was made here: https://github.com/FWGS/xash3d/tree/vinterface
 |Day of Defeat						|The latest steam release	|Uses vgui2 library which xash3d does not support		|Some work on vgui2 support was made here: https://github.com/FWGS/xash3d/tree/vinterface
-|Sven-Coop						|5.0+				|Uses filesystem_stdio library which xash3d does not support	|filesystem_stdio replacement already was made: https://github.com/FWGS/filesystem_stdio_xash
-|XDM							|3.0.4.0			|								|
+|Sven-Coop						|5.0+				|Uses custom GoldSrc engine					|
 

Documentation/opensource-mods.md

@@ -17,7 +17,9 @@ Mirrored on github - https://github.com/JoelTroch/am_src_rebirth
 Mirrored on github - https://github.com/nekonomicon/BattleGrounds
 
 ## Bubblemod
-Download page on official site - http://www.bubblemod.org/dl_default.php
+Download page on official site(WM snapshot) - [http://www.bubblemod.org/dl_default.php](https://web.archive.org/web/20130717133158/http://www.bubblemod.org/dl_default.php)
+
+Mirrored on github - https://github.com/HLSources/BubbleMod
 
 ## Chicken Fortress
 Official github repository - https://github.com/CKFDevPowered/CKF3Alpha
@@ -25,6 +27,11 @@ Official github repository - https://github.com/CKFDevPowered/CKF3Alpha
 ## Cold Ice
 Version 1.9 is available on ModDB - https://www.moddb.com/mods/cold-ice/downloads/cold-ice-sdk
 
+Version 1.9 mirrored on github - https://github.com/solidi/hl-mods/tree/master/ci
+
+## Cold Ice Ressurection
+Mirrored on github - https://github.com/solidi/hl-mods/tree/master/cir
+
 ## Cthulhu
 Uploaded to github by Oleg Cherkasky - https://github.com/gunrunners-paradise/Cthulhu-HLmod-SDK
 
@@ -38,25 +45,36 @@ Official github repository - https://github.com/adslbarxatov/xash3d-for-ESHQ
 Available on GamerLab - http://gamer-lab.com/eng/code_mods_goldsrc/Half-Life_2D_(Flat-Life)
 
 ## Gang Wars
-Mirrored on github - https://github.com/hammermaps/gw1.45src
+Mirrored on github - https://github.com/nekonomicon/gw1.45src
 
 ## Go-mod
 Versions 2.0 and 3.0, available in mod archives on ModDB - https://www.moddb.com/mods/go-mod/downloads
 
+Version 3.0, mirrored on github - https://github.com/nekonomicon/Go-mod30
+
 ## GT mod
 Available on GamerLab - http://gamer-lab.com/eng/code_mods_goldsrc/GT_mod_(Polnie_ishodniki)
 
+## Half-Life: Advanced Deathmatch
+Mirrored on github - https://github.com/solidi/hl-mods/tree/master/hla
+
+## Half-Life: Decay
+Mirrored on github(PC Port) - https://github.com/hoaxer/Half-Life-Decay
+
 ## Half-Life: Echoes
-Download link on dropbox - https://www.dropbox.com/s/s6j8gtegn10wgvj/dlls.zip?dl=1
+Available on ModDB - https://www.moddb.com/mods/half-life-echoes
 
 ## Half-Life: Expanded Arsenal
 Available on ModDB - https://www.moddb.com/mods/half-life-expanded-arsenal
 
 ## Half-Life: Gravgun mod
-Branch **gravgun** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/gravgun
+Branch **gravgun** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/gravgun
 
 ## Half-Life: Invasion
-official github repository - https://github.com/jlecorre/hlinvasion
+Official github repository - https://github.com/jlecorre/hlinvasion
+
+## Half-Life: Pong
+Mirrored on github - https://github.com/solidi/hl-mods/tree/master/pong
 
 ## Half-Life: Quest Mode
 Available on cs-mapping.com.ua - https://old.cs-mapping.com.ua/forum/showthread.php?t=38030
@@ -67,6 +85,9 @@ Official gitlab repository - https://gitlab.com/Sockman/hltopdown
 ## Half-Life: Update
 Official github repository - https://github.com/Fograin/hl-subsmod-ex
 
+## Half-Life: Rally
+Official gitlab repository - https://gitlab.com/hlrally/src
+
 ## Half-Life: Weapon Edition
 Available on ModDB - https://www.moddb.com/mods/half-life-weapon-edition/downloads/half-life-weapon-edition-1508-alpha-open-src
 
@@ -92,7 +113,7 @@ Official github repository - https://github.com/desukuran/half-screwed
 Version 1.3 on ModDB - https://www.moddb.com/mods/headcrab-frenzy/downloads/headcrab-frenzy-13-beta-source-code
 
 ## Heart of Evil
-Available on ModDB - https://www.moddb.com/mods/heart-of-evil/downloads/heart-of-evil-dlls-source-code
+Mirrored on github - https://github.com/nekonomicon/HeartOfEvil
 
 ## Ingram Chillin' Mod
 Official SourceForge repository - https://sourceforge.net/projects/icm-hl/
@@ -109,22 +130,11 @@ Official github repository - https://github.com/unknownworlds/NS
 ## Overturn
 Available in mod archive on ModDB - https://www.moddb.com/mods/overturn
 
-## Spirit of Half-Life
-[Logic&Trick's](https://github.com/LogicAndTrick) mirror - https://files.logic-and-trick.com/#/Half-Life/Mods/Spirit%20of%20Half-Life
-
-## Threewave CTF
-*Unfinished mod by Valve Software*
-
-Available in Valve's Half-Life repository with Deathmatch Classic sources - https://github.com/ValveSoftware/halflife/tree/master/dmc
-
-## Trinity Render
-Available on ModDB: https://www.moddb.com/mods/half-life-episode-two/downloads/trinity-rendering-engine-v308f
-
-## Tyrian: Ground Assault
-Available on ModDB: https://www.moddb.com/mods/tyriangroundassault/downloads/tyrianga-v1-0-src
+## Oz Deathmatch
+Mirrored on github - https://github.com/nekonomicon/OZDM
 
 ## Paranoia
-Available on ModDB: https://www.moddb.com/mods/paranoia/downloads/paranoia-toolkit
+Available on ModDB - https://www.moddb.com/mods/paranoia/downloads/paranoia-toolkit
 
 ## Paranoia 2: The Savior
 Prealpha, mirrored on github - https://github.com/a1batross/Paranoia2_ancient
@@ -139,12 +149,37 @@ Was found on HLFX - http://hlfx.ru/forum/showthread.php?s=2c892dfc52f72be52a89c3
 ## Ricochet
 Available in Valve's Half-Life repository - https://github.com/ValveSoftware/halflife/tree/master/ricochet
 
+## Spirit of Half-Life
+[Logic&Trick's](https://github.com/LogicAndTrick) mirror - https://files.logic-and-trick.com/#/Half-Life/Mods/Spirit%20of%20Half-Life
+
+## The Wastes
+Version 1.5: mirrored on code.idtech.space - https://code.idtech.space/vera/halflife-thewastes-sdk
+
+## Threewave CTF
+*Unfinished mod by Valve Software*
+
+Available in Valve's Half-Life repository with Deathmatch Classic sources - https://github.com/ValveSoftware/halflife/tree/master/dmc
+
+## Trinity Render
+Available on ModDB - https://www.moddb.com/mods/half-life-episode-two/downloads/trinity-rendering-engine-v308f
+
+## Tyrian: Ground Assault
+Available on ModDB - https://www.moddb.com/mods/tyriangroundassault/downloads/tyrianga-v1-0-src
+
+## Wasteland
+Mirrored on code.idtech.space - https://code.idtech.space/vera/halflife-wasteland-sdk
+
 ## Wizard Wars
 Download page on official site - http://www.thothie.com/ww/
 
 ## XashXT
 Mirrored on github - https://github.com/a1batross/XashXT_original
 
+## Xen-Warrior
+*Source code is a part of Spirit of Half-Life 1.0-1.2 under XENWARRIOR macro*
+
+[Logic&Trick's](https://github.com/LogicAndTrick) mirror - https://files.logic-and-trick.com/#/Half-Life/Mods/Spirit%20of%20Half-Life
+
 ## Zombie-X
 Available in mod archive on ModDB - https://www.moddb.com/mods/zombie-x-10-final/downloads/zombie-x-10-dle-beta6-last-version
 
@@ -155,45 +190,45 @@ Mirrored on github - https://github.com/ZXCmod/ZXCmod
 
 # Reimplementation
 ## Absolute Redemption
-Branch **redempt** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/redempt
+Branch **redempt** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/redempt
 
 ## Adrenaline Gamer
 OpenAG by YaLTeR - https://github.com/YaLTeR/OpenAG
 
 ## Afraid of Monsters
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-aom
+malortie's recreation - https://github.com/malortie/hl-aom
 
-Branch **aom** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/aom
+Branch **aom** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/aom
 
 ## Afraid of Monsters: Director's cut
-Reverse-engineered code, branch **aomdc** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/aomdc
+Reverse-engineered code: branch **aomdc** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/aomdc
 
 ## Azure Sheep
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-asheep
+malortie's recreation - https://github.com/malortie/hl-asheep
 
-Reverse-engineered code, branch **asheep** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/asheep
+Reverse-engineered code: branch **asheep** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/asheep
 
 ## Big Lolly
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-biglolly
+malortie's recreation - https://github.com/malortie/hl-biglolly
 
-Branch **biglolly** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/biglolly
+Branch **biglolly** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/biglolly
 
 ## Black Ops
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-blackops
+malortie's recreation - https://github.com/malortie/hl-blackops
 
-Branch **blackops** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/blackops
+Branch **blackops** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/blackops
 
 ## Bloody Pizza: Vendetta
-Branch **caseclosed** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/caseclosed
+Branch **caseclosed** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/caseclosed
 
 ## Case Closed
-Branch **caseclosed** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/caseclosed
+Branch **caseclosed** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/caseclosed
 
 ## Cleaner's Adventures
-Branch **CAd** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/CAd
+Branch **CAd** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/CAd
 
 ## Counter Strike
-Reverse-engineered code of client part by a1batross - https://github.com/FWGS/cs16-client/tree/v1.32
+Reverse-engineered code of client part by a1batross - https://github.com/Velaron/cs16-client
 
 Reverse-engineered code of server part by nagist - https://github.com/nagist/cs16nd
 
@@ -205,117 +240,141 @@ CSO-like Xash3D-based mod, CSMoE - https://github.com/MoeMod/CSMoE
 ## Crack-Life: Campaign Mode
 Recreation by lostgamer aka nillerusr - https://github.com/LostGamerHL/crack_life
 
-## Escape from the Darkness
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-eftd
+Reverse-engineered code: branch **clcampaign** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/clcampaign
 
-Reverse-engineered code, branch **eftd** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/eftd
+## Escape from the Darkness
+malortie's recreation - https://github.com/malortie/hl-eftd
+
+Reverse-engineered code: branch **eftd** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/eftd
+
+## Half-Life: Black Guard
+*This mod uses dlls from Cleaner's Adventures*
+
+Branch **CAd** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/CAd
 
 ## Half-Life: Blue Shift
 Unkle Mike's recreation - https://hlfx.ru/forum/showthread.php?s=&threadid=5253
 
-Reverse-engineered code, branch **bshift** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/bshift
+Reverse-engineered code: branch **bshift** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/bshift
 
 ## Half-Life: Induction
-Branch **induction** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/induction
+Branch **induction** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/induction
 
 ## Half-Life: Opposing Force
 Recreation by lostgamer aka nillerusr - https://github.com/LostGamerHL/hlsdk-xash3d
 
-Reverse-engineered code, clean branch **opfor** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/opfor
+Reverse-engineered code: clean branch **opfor** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/opfor
 
 Spirit of Half Life: Opposing-Force Edition - https://github.com/Hammermaps-DEV/SOHL-V1.9-Opposing-Force-Edition
 
 ## Half-Life: Rebellion
-Reverse-engineered code, branch **rebellion** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/rebellion
+Reverse-engineered code: branch **rebellion** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/rebellion
+
+## Half-Life: Urbicide
+Branch **hl_urbicide** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/hl_urbicide
 
 ## Half-Life: Visitors
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-visitors
+malortie's recreation - https://github.com/malortie/hl-visitors
 
-Reverse-engineered code, branch **visitors** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/visitors
+Reverse-engineered code: branch **visitors** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/visitors
 
 ## Half-Secret
-Branch **half-secret** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/half-secret
+Branch **half-secret** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/half-secret
 
 ## Night at the Office
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-noffice
+malortie's recreation - https://github.com/malortie/hl-nato
 
-Branch **noffice** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/noffice
+Branch **noffice** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/noffice
 
 ## Poke 646
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-poke646
+malortie's recreation - https://github.com/malortie/hl-poke646
 
-Reverse-engineered code, branch **poke646** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/poke646
+Reverse-engineered code: branch **poke646** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/poke646
 
 ## Poke 646: Vendetta
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-poke646
+malortie's recreation - https://github.com/malortie/hl-poke646-vendetta
 
-Reverse-engineered code, branch **poke646_vendetta** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/poke646_vendetta
+Reverse-engineered code: branch **poke646_vendetta** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/poke646_vendetta
 
 ## Residual Life
-Reverse-engineered code, branch **residual_point** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/residual_point
+Reverse-engineered code: branch **residual_point** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/residual_point
 
 ## Residual Point
-Reverse-engineered code, branch **residual_point** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/residual_point
+Reverse-engineered code: branch **residual_point** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/residual_point
+
+## Sewer Beta
+Branch **sewer_beta** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/sewer_beta
 
 ## Team Fortress Classic
 Reverse-engineered code by Velaron - https://github.com/Velaron/tf15-client
 
 ## The Gate
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-TheGate
+malortie's recreation - https://github.com/malortie/hl-thegate
 
-Reverse-engineered code, branch **thegate** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/thegate
+Reverse-engineered code: branch **thegate** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/thegate
 
 ## They Hunger
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-Hunger
+malortie's recreation - https://github.com/malortie/hl-theyhunger
 
-Reverse-engineered code, branch **theyhunger** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/theyhunger
+Reverse-engineered code: branch **theyhunger** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/theyhunger
 
 They Hunger: Tactical - https://www.moddb.com/mods/they-hunger-tactical/downloads/tht-source-code-documentation
 
 ## Times of Troubles
-malortie's recreation - https://github.com/malortie/halflife/tree/mod-hl-tot
+malortie's recreation - https://github.com/malortie/hl-tot
 
-Branch **tot** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/tot
+Branch **tot** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/tot
 
 # Derived work
 ## Adrenaline Gamer
-Branch **aghl** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/aghl
+Branch **aghl** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/aghl
 
 ## Bubblemod
-Branch **bubblemod** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/bubblemod
+Branch **bubblemod** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/bubblemod
 
 ## Deathmatch Classic
 Deathmatch Classic: Adrenaline Gamer Edition - https://github.com/martinwebrant/agmod/tree/master/src/dmc
 
 Deathmatch Quaked - https://www.moddb.com/games/deathmatch-classic/downloads/dmq2
 
-Branch **dmc** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/dmc
+Branch **dmc** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/dmc
 
 ## Half-Life: Echoes
-Branch **echoes** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/echoes
+Branch **echoes** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/echoes
 
 ## Half-Life: Invasion
-Port to HLSDK 2.4 by malortie - https://github.com/malortie/halflife/tree/mod-hl-invasion
+Port to HLSDK 2.4 by malortie - https://github.com/malortie/hl-invasion
 
 Port to Linux by fmoraw - https://github.com/fmoraw/hlinvasion
 
+Branch **invasion** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/invasion
+
 ## Half-Life: Top-Down
-Branch **hltopdown** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/hltopdown
+Branch **hltopdown** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/hltopdown
 
 ## Half-Screwed
-Branch **half-screwed** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/half-screwed
+Branch **half-screwed** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/half-screwed
 
 ## Natural Selection
 Port to Linux - https://github.com/fmoraw/NS
 
-## Swiss Cheese Halloween 2002
-Just more playable version by malortie - https://github.com/malortie/halflife/tree/mod-hl-halloween
+## Spirit of Half-Life
+Version 1.2: branch **sohl1.2** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/sohl1.2
 
-Branch **halloween** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/halloween
+## Swiss Cheese Halloween 2002
+Just more playable version by malortie - https://github.com/malortie/hl-shall
+
+Branch **halloween** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/halloween
+
+## The Wastes
+Version 1.5: Port to Linux - https://git.mentality.rip/a1batross/halflife-thewastes-sdk
 
 ## Threewave CTF
-Branch **dmc** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/dmc
+Branch **dmc** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/dmc
+
+## Xen-Warrior
+Branch **sohl1.2** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/sohl1.2
 
 ## Zombie-X
-Branch **zombie-x** in hlsdk-xash3d - https://github.com/FWGS/hlsdk-xash3d/tree/zombie-x
+Branch **zombie-x** in hlsdk-portable - https://github.com/FWGS/hlsdk-portable/tree/zombie-x
 

Documentation/ports.md

@@ -1,38 +1,38 @@
-Xash3D FWGS is intended to be easily ported to specific platform, however main issue is maintaining such ports. 
+Xash3D FWGS is intended to be easily portable for various platforms, however main issue is maintaining such ports. 
 
 This page is about merged ports to main source tree and responsible for it developers.
 
-For porting guidelines, look here(TODO!)
+For porting guidelines, read engine-porting-guide.md.
 
 Status: 
-* **Supported**: active, confirmed to be fully functional.
+* **Supported**: active, confirmed to be fully functional, gets built on CI.
+* **Orphaned**: some work was done but not finished or actively tested due to lack of human resources.
 * **In progress**: active, under development.
-* **Incomplete**:  not active, but some work was accepted to main repository before
-* **Old Engine**: port was for old engine fork
-* **Not maintained**: lack of human resources
-* **Not merged**: was done in third-party fork, real status unknown
-* **Deprecated**: not supported anymore
+* **Old Engine**: port was for old engine fork.
+* **Deprecated**: not supported anymore.
 
-Table is sorted by status.
+Table is sorted by status and platform.
 
-| Platform        | Status                     | Maintainer           | Note
-| --------        | ------                     | ----------           | ----
-| Windows         | Supported                  | @a1batross           |
-| *BSD            | Supported                  | @nekonomicon         |
-| GNU/Linux(x86, amd64, arm) | Supported       | @a1batross, @mittorn |
-| Android         | Supported                  | @a1batross, @mittorn |
-| MotoMAGX        | Supported                  | @a1batross           |
-| GNU/Linux(elbrus) | Supported                | @a1batross, @mittorn | Rare and eventual access to e2k machine
-| Haiku           | Supported                  | not maintained       | Was added by #478 and #483
-| DOS4GW          | Supported                  | @mittorn             |
-| GNU/Linux(mipsel) | Supported                | @mittorn             |
-| Switch          | In progress                | @fgsfdsfgs           | [Github Repository](https://github.com/fgsfdsfgs/xash3d-fwgs/tree/switch_new) 
-| Wii             | In progress                | Collaborative effort | [Github Repository](https://github.com/saucesaft/xash3d-wii) 
-| PSP             | In progress                | Collaborative effort | No sources available at this moment
-| Emscripten      | Old Engine                 | not maintained       | 
-| Oculus Quest    | Old Engine fork            | @DrBeef              | [GitHub Repository](https://github.com/DrBeef/Lambda1VR)
-| PSVita          | Old Engine fork            | not maintained       | [GitHub Repository](https://github.com/fgsfdsfgs/vitaXash3D)
-| Switch          | Old Engine fork            | not maintained       | [GitHub Repository](https://github.com/switchports/xash3d-switch)
-| 3DS             | Old Engine fork            | not maintained       | [GitHub Repository](https://github.com/masterfeizz/Xash3DS)
-| macOS           | Deprecated                 | not maintained       | See GitHub issue #61
-| iOS             | Deprecated                 | not maintained       | See GitHub issue #61
+| Platform        | Status                     | Maintainer               | Note
+| --------        | ------                     | ----------               | ----
+| Android         | Supported                  | @Velaron                 |
+| *BSD            | Supported                  | @nekonomicon             |
+| GNU/Linux       | Supported                  | @a1batross, @mittorn     |
+| macOS           | Supported                  | @sofakng                 | 
+| PSVita          | Supported                  | @fgsfdsfgs               |
+| Switch          | Supported                  | @fgsfdsfgs               |
+| Windows         | Supported                  | @a1batross, @SNMetamorph |
+| DOS4GW          | Orphaned                   | N/A                      | Haven't been confirmed to work for a very long time
+| Haiku           | Orphaned                   | N/A                      | Was added by #478 and #483
+| IRIX            | Orphaned                   | N/A                      | Undone, compiles but requires big endian port
+| MotoMAGX        | Orphaned                   | N/A                      | Should work but the compiler used for this platform is very unstable and easy to crash (it's GCC 3.4)
+| SerenityOS      | Orphaned                   | N/A                      | Works but not throughly tested
+| Solaris         | Orphaned                   | N/A                      | Works but not throughly tested
+| WebAssembly System Interface | Orphaned      | N/A                      | Undone, WASI is missing a lot of APIs we want to use
+| Dreamcast       | In progress                | @maximqaxd               | [GitHub Repository](https://github.com/maximqaxd/xash3d-fwgs_dc/)
+| PSP             | In progress                | @Crow_bar, @Velaron      | [GitHub Repository](https://github.com/Crow-bar/xash3d-fwgs)
+| Wii             | In progress                | Collaborative effort     | [GitHub Repository](https://github.com/saucesaft/xash3d-wii)
+| Emscripten      | Old Engine                 | N/A                      | 
+| 3DS             | Old Engine fork            | N/A                      | [GitHub Repository](https://github.com/masterfeizz/Xash3DS)
+| Oculus Quest    | Old Engine fork            | N/A                      | [GitHub Repository](https://github.com/DrBeef/Lambda1VR)
+| iOS             | Deprecated                 | N/A                      | See GitHub issue #61

Documentation/psvita.md

@@ -0,0 +1,49 @@
+## PlayStation Vita port
+
+### Prerequisites
+1. Make sure your PSVita is [set up to run homebrew applications](https://vita.hacks.guide/).
+2. Install [kubridge](https://github.com/TheOfficialFloW/kubridge/releases/) by copying `kubridge.suprx` to your taiHEN plugins folder (usually `ux0:/tai`) and add it to your `config.txt`, for example:
+   ```
+   *KERNEL
+   ux0:tai/kubridge.skprx
+   ```
+3. Install `libshacccg.suprx` by following [this guide](https://cimmerian.gitbook.io/vita-troubleshooting-guide/shader-compiler/extract-libshacccg.suprx).
+
+### Installation
+1. If you have an old vitaXash3D install, remove it.
+2. Get `xash3d-fwgs-psvita.7z` from the latest [automatic build](https://github.com/FWGS/xash3d-fwgs/releases/tag/continuous).
+3. Install `xash.vpk` from the 7z archive onto your PSVita.
+4. Copy the `data` directory from the 7z archive to the root of your PSVita's SD card.
+5. Copy the valve folder and any other mod folders from your Half-Life install to `ux0:/data/xash3d/` (you can use other mountpoints instead of `ux0`). **Do not overwrite anything.**
+
+### Build instructions
+1. Install [VitaSDK](https://vitasdk.org/).
+2. Build and install [vitaGL](https://github.com/Rinnegatamante/vitaGL):
+    ```
+    git clone https://github.com/Rinnegatamante/vitaGL.git
+    make -C vitaGL NO_TEX_COMBINER=1 HAVE_UNFLIPPED_FBOS=1 HAVE_PTHREAD=1 SINGLE_THREADED_GC=1 MATH_SPEEDHACK=1 DRAW_SPEEDHACK=1 HAVE_CUSTOM_HEAP=1 -j2 install
+    ```
+3. Build and install [vita-rtld](https://github.com/fgsfdsfgs/vita-rtld):
+    ```
+    git clone https://github.com/fgsfdsfgs/vita-rtld.git && cd vita-rtld
+    mkdir build && cd build
+    cmake -DCMAKE_BUILD_TYPE=Release ..
+    make -j2 install
+    ```
+4. Build and install [this SDL2 fork](https://github.com/Northfear/SDL) with vitaGL integration:
+    ```
+    git clone https://github.com/Northfear/SDL.git && cd SDL
+    mkdir build && cd build
+    cmake -DCMAKE_TOOLCHAIN_FILE=${VITASDK}/share/vita.toolchain.cmake -DCMAKE_BUILD_TYPE=Release -DVIDEO_VITA_VGL=ON ..
+    make -j2 install
+    ```
+5. Use `waf`:
+    ```
+    ./waf configure -T release --psvita
+    ./waf build
+    ```
+6. Copy all the resulting `.so` files into a single folder:
+    ```
+    ./waf install --destdir=xash3d
+    ```
+7. `xash.vpk` is located in `build/engine/`.

Documentation/supported-mod-list.md

@@ -19,7 +19,22 @@
    - [List of XashXT-based mods](#list-of-xashxt-based-mods)
    - [List of maps for They Hunger](#list-of-maps-for-they-hunger)
    - [List of games and mods with custom gamedll](#list-of-games-and-mods-with-custom-gamedll)
-   - [List of mods for Counter Strike(Android only)](#list-of-mods-for-counter-strike)
+   - [List of mods for Counter Strike](#list-of-mods-for-counter-strike)
+   - [List of supported mods from mobile_hacks branch of HLSDK Portable by FWGS](#list-of-supported-mods-from-mobile_hacks-branch-of-hlsdk-portable-by-fwgs)
+
+# List of supported mods from mobile_hacks branch of HLSDK Portable by FWGS
+1. [Afraid of Monsters](https://www.moddb.com/mods/afraid-of-monsters/downloads/afraid-of-monsters-v1)
+2. [Big Lolly](https://www.moddb.com/mods/big-lolly)
+3. [Half-Life: Blue Shift](https://store.steampowered.com/app/130/HalfLife_Blue_Shift/)
+4. [Half-Secret](https://www.moddb.com/mods/half-secret)
+5. [Case Closed](https://www.moddb.com/mods/caseclosed)
+6. [Bloody Pizza - Vendetta](https://www.moddb.com/games/half-life/addons/bloody-pizza-vendetta)
+7. [Borderlands](https://www.moddb.com/games/half-life/addons/borderlands-v04)
+8. [Half-Life: Induction](https://www.moddb.com/mods/half-life-induction/downloads/half-life-induction-12)
+9. [Redemption/Absolute Redemption](https://www.moddb.com/mods/absolute-redemption)
+10. [Sewer beta](https://www.moddb.com/games/half-life/addons/sewer-beta)
+11. [Times of Troubles](https://www.moddb.com/mods/times-of-troubles)
+12. [Half-Life: Urbicide](https://www.moddb.com/mods/half-life-urbicide)
 
 # List of Half-Life-based mods
 Originally this list was written by *Qwertyus*(*Qortez*)
@@ -46,7 +61,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 16. [Betrayal](http://www.moddb.com/mods/betrayal) (this mod has inner bugs; set **gl_allow_mirrors** to **0** to prevent drops of game's perfomance in some areas)
 17. [Between Two Worlds](https://www.runthinkshootlive.com/posts/between-two-worlds/)
 18. [Black Mesa Energy Testing Chamber](http://twhl.info/competitions.php?results=17)
-19. [Black Mesa Sideline](http://www.isolated-design.de/half-life-mods/black-mesa-sideline/) (set **gl_allow_mirrors** to **0** to prevent drops of game's perfomance in some areas)
+19. [Black Mesa Sideline](https://www.moddb.com/mods/black-mesa-sideline) (set **gl_allow_mirrors** to **0** to prevent drops of game's perfomance in some areas)
 20. [BlackMesa 2007( Black Mesa Missions 2007 )](http://www.moddb.com/addons/blackmesa-2007)
 21. [Blood and Bones](https://www.runthinkshootlive.com/posts/blood-and-bones/)
 22. Boom (Huknenn) v1.0 & [HL Boom: Gold Edition v1.1](http://www.moddb.com/mods/boom)
@@ -103,8 +118,8 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 72. [Freeman](https://www.runthinkshootlive.com/posts/freeman/)
 73. [Freeman's Escape](http://www.moddb.com/mods/freeman-escape-french) (2 maps by *JiggZ*)
 74. [Freeman's Fight](https://www.runthinkshootlive.com/posts/freemans-fight/)
-75. [Freeman's Return](http://jpmaps.wz.cz/epizody.htm)
-76. [Freeman's Return 2](http://jpmaps.wz.cz/epizody.htm)
+75. [Freeman's Return](https://www.moddb.com/games/half-life/addons/freemans-return-v12)
+76. [Freeman's Return 2](https://www.moddb.com/games/half-life/addons/freemans-return-2-v11)
 77. [Freeman's Revenge](https://www.runthinkshootlive.com/posts/freemans-revenge/)
 78. [Freeman's Tomb( The Crypt )](http://twhl.info/vault.php?map=3787)
 79. [G-Invasion v2.5](http://www.moddb.com/mods/g-man-invasion) aka G-Man Invasion (there is an inner crash bug on final titles: some text lines are too long and cannot be properly displayed)
@@ -129,7 +144,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 96. [Haunted](https://www.runthinkshootlive.com/posts/haunted/) (set **sv_validate_changelevel** to **0** to avoid a problem with level change between maps **pagan7** and **pagan8**)
 97. [Hazardous Materials: Episode 1 & 2](http://www.moddb.com/mods/half-life-hazardous-materials)
 98. [Hazardous-Course 2](http://www.moddb.com/mods/hazardous-course-2)
-99. [Help Wanted](http://maps.mrsucko.org/work/)
+99. [Help Wanted](https://www.moddb.com/games/half-life/addons/help-wanted)
 100. [Hidden Evil v1.01](https://www.runthinkshootlive.com/posts/hidden-evil/)
 101. [High Speed](http://www.moddb.com/games/half-life/addons/high-speed-english-version)
 102. [hlife_hotdog_compo26](http://twhl.info/vault.php?map=5181)
@@ -155,7 +170,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 122. [Mario Keys](http://www.moddb.com/mods/mario-keys)
 123. [McBeth](https://www.runthinkshootlive.com/posts/mcbeth/)
 124. [Medieval World](http://www.moddb.com/mods/medieval-world)
-125. [Mel Soaring 2: Star Rancor](http://www.etherealhell.com/etherealhell/index.php/my-levels/half-life)
+125. [Mel Soaring 2: Star Rancor](https://www.moddb.com/addons/mel-soaring-2-star-rancor)
 126. [MINIMICUS](http://twhl.info/vault.php?map=163)
 127. [Mission Failed](http://www.moddb.com/mods/mission-failed)
 128. [Mission MC Poker](http://www.moddb.com/mods/half-life-mission-mc-poker)
@@ -176,7 +191,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 143. [Operation: Nova](http://www.moddb.com/mods/half-life-operation-nova) (there is an inner bug with an M60 machinegun on a map with Osprey: it can be activated and used if you are staying in front of it, not behind it)
 144. [Optimum Fear](https://www.fileplanet.com/7472/0/fileinfo/Optimum-Fear)
 145. [Outrun](http://www.moddb.com/mods/outrun)
-146. [Outwards (Day One)](http://www.visgi.info/maps/)
+146. [Outwards (Day One)](https://web.archive.org/web/20161026104825/http://visgi.info/maps/)
 147. [Overhaul Pack](http://www.moddb.com/mods/half-life-overhaul-pack) (Just HD pack for Half-Life)
 148. [P.I.Z.D.E.C.](https://www.runthinkshootlive.com/posts/pizdec/)
 149. [pagoda](http://www.moddb.com/mods/pagoda1)
@@ -184,7 +199,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 151. [Phobos IV](http://www.moddb.com/mods/phobos-iv)
 152. [Pimp My Car](https://www.runthinkshootlive.com/posts/pimp-my-car/) (there is an inner issue with incorrect responses of buttons on combination locks)
 153. [Point Blank – Stackdeath Complex](https://www.runthinkshootlive.com/posts/half-life-point-blank-stackdeath-complex/)
-154. [Prisoner Escaped](http://four0four.org/downloads/maps/)
+154. [Prisoner Escaped](https://www.moddb.com/mods/prisoner-escaped-1-2)
 155. [Prisoner of Event](http://wp.vondur.net/?page_id=40)
 156. [Prisoner of War](https://www.runthinkshootlive.com/posts/prisoner-of-war/)
 157. [Project Quantum Leap](http://www.moddb.com/mods/project-quantum-leap)
@@ -282,7 +297,7 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 6. [Catacombs: Part 1](https://www.runthinkshootlive.com/posts/catacombs/)
 7. [Cro-man's Office Mappack](http://twhl.info/vault.php?map=5547)
 8. [Half-Life Episode Two Demo Alpha v1.0](http://hl.loess.ru/?mod=451)
-9. [Hazardous-Course (first version of Hazardous-Course 2)](http://www.richmans-maps.ch.vu/) (link dead!)
+9. [Hazardous-Course (first version of Hazardous-Course 2)](https://web.archive.org/web/20110512012317/http://www.richmans-maps.ch.vu/)
 10. [High Tech v0.2](http://hl.loess.ru/?mod=499)
 11. [HL Shadows, Part 1](https://www.fileplanet.com/7466/0/fileinfo/'HL-Shadows',-Part-1)
 12. [HLNewEnd](http://twhl.info/vault.php?map=2275)
@@ -305,11 +320,11 @@ For mappacks - place *.bsp files to **valve/maps** folder, *.wad files to **valv
 29. [Shortcut v1.0 Beta](https://www.runthinkshootlive.com/posts/shortcut/)
 30. [Stoka](https://www.ceskemody.cz/mapy.php?lng=1&clanek=222&razeni_hra=1&pn=stoka)
 31. [Striker's Compo 26](http://twhl.info/vault.php?map=5190) (buggy)
-32. [Technology Test 2](http://www.richmans-maps.ch.vu/) (link dead!)
+32. [Technology Test 2](https://web.archive.org/web/20110512012317/http://www.richmans-maps.ch.vu/)
 33. [The Gate Playable Demo](https://www.fileplanet.com/116347/110000/fileinfo/The-Gate-Playable-Demo)
 34. [They are Back](https://www.runthinkshootlive.com/posts/they-are-back/)
 35. [Tiefseelabor( Deep Sea Laboratory )](https://www.runthinkshootlive.com/posts/deep-sea-laboratory/)
-36. [Time-Shift](http://www.richmans-maps.ch.vu/) (link dead!)
+36. [Time-Shift](https://web.archive.org/web/20110512012317/http://www.richmans-maps.ch.vu/)
 37. [Train Single Beta](https://cs-mapping.com.ua/forum/showthread.php?t=36394) (Remove **gfx.wad** from **TrainSingle** folder)
 38. [WAR: The Killer Beta 0.1](http://www.moddb.com/mods/war)
 39. [White Force Beta( Residual Point prototype )](http://www.moddb.com/mods/hl-residual-point/downloads/white-force-beta-2002)
@@ -379,7 +394,7 @@ Mods:
 5. [Half-Life Baby v1.4](http://www.moddb.com/games/half-life/addons/half-life-baby) (it's an unfinished but playable mod; after installing of the mod open **liblist.gam** or **gameinfo.txt** file in the mod's folder and correct the line **gamedll "..\hlbaby\dlls\hl.dll"** for **gamedll "dlls\hl.dll"**, otherwise you'll not be able to start a game)
 6. [Half-Secret](http://www.moddb.com/mods/half-secret) (this mod has custom **weapon_snark** code)
 7. [Induction](http://www.moddb.com/mods/half-life-induction) (this mod has new item - **item_flashlight**)
-8. [Lost in Black Mesa(first version without HLFX)](http://half-life.ru/forum/showthread.php?threadid=13959)
+8. [Lost in Black Mesa(first version without HLFX)](https://web.archive.org/web/20160407041812/http://half-life.ru/forum/showthread.php?threadid=13959) (download links dead!)
 9. [Soldier](http://www.moddb.com/mods/half-life-soldier)
 10. [Solo Operations](http://www.moddb.com/mods/solo-operations)
 11. [The Blood v1.1](http://hl.loess.ru/?mods=&search=The+Blood) (there are some inner bugs in the mod, but they don't interfere with a game progress)
@@ -440,7 +455,7 @@ Mods:
 51. [Data-base](https://www.runthinkshootlive.com/posts/database/)
 52. [de_dust2_azabetfeN](https://cs-mapping.com.ua/forum/showthread.php?t=36394) (remove **cl_dlls** & **dlls** folders from inside of mod's directory before you start the game)
 53. [De-railed](http://twhl.info/competitions.php?results=7)
-54. [Dead Shift Beta](http://www.moddb.com/mods/dead-shift) - [Demo 1](https://www.gamewatcher.com/mods/half-life-mod/dead-shift-1-0-beta) & [Demo 2](https://www.gamefront.com/files/13532512) (3rd link dead!)
+54. [Dead Shift Beta](http://www.moddb.com/mods/dead-shift) - [Demo 1](https://www.gamewatcher.com/mods/half-life-mod/dead-shift-1-0-beta) & [Demo 2](https://web.archive.org/web/20151030005310/http://www.gamefront.com/files/13532512)
 55. [Deep](http://twhl.info/vault.php?map=1669)
 56. [Desert Attack](http://fyzzer.narod.ru/index.html)
 57. [Desert Combat Demo](https://www.fileplanet.com/190487/190000/fileinfo/Half-Life---Desert-Combat-Mod) (despite a big file size there's only one small unfinished map)
@@ -469,7 +484,7 @@ Mods:
 80. [Extinct Lifeform Hunt](https://www.fileplanet.com/13501/10000/fileinfo/Extinct-Lifeform-Hunt)
 81. [Facility](http://twhl.info/vault.php?map=5482)
 82. [Facility Escape](http://twhl.info/vault.php?map=3673)
-83. [Fallout](http://www.thewall.de/forum/thread/hl1-sp-48h-mapping-contest/64975.4.html) (map by *simb*)
+83. [Fallout](http://www.thewall.de/forum/thread/hl1-sp-48h-mapping-contest/64975.4.html) (map by *simb*) (link dead!)
 84. [Final Assault](http://twhl.info/vault.php?map=4500)
 85. [Flat](http://hl.loess.ru/?mods=&search=Flat)
 86. [Freeman's Allegiance](https://www.runthinkshootlive.com/posts/freemans-allegiance/)
@@ -499,7 +514,7 @@ Mods:
 110. [Hostage](https://www.runthinkshootlive.com/posts/hostage-2/)
 111. [House](http://www.artpeter.net/Data/HalfLife/Hl.php)
 112. [Impulse 101 Fun - The Train](http://web.archive.org/web/20070305075816/http://www.twhl.co.za/mapvault/2817.zip) (map from *TWHL* by *Archie* aka *The Hunter*)
-113. [In America](http://www.lambda-force.org/load/half_life/karty/half_life_in_america/18-1-0-476)
+113. [In America](https://web.archive.org/web/20170221213409/http://www.lambda-force.org/load/half_life/karty/half_life_in_america/18-1-0-476)
 114. [In the Kitchen](http://twhl.info/vault.php?map=4314)
 115. [Infiltration](https://www.fileplanet.com/7467/0/fileinfo/Infiltration)
 116. [Interactivity & Lots of Entities](http://twhl.info/vault.php?map=5744) (link dead!)
@@ -668,7 +683,7 @@ Mods:
 279. [X-treme Violence](http://www.moddb.com/mods/x-treme-violence)
 280. [XargoL's Entry for Vassy's Compo](http://twhl.info/vault.php?map=769)
 281. [Xen Again](https://www.fileplanet.com/9132/0/fileinfo/XEN-AGAIN)
-282. [Xen World](http://www.lambda-force.org/load/half_life/karty/half_life_xen_world/18-1-0-481)
+282. [Xen World](http://www.lambda-force.org/load/half_life/karty/half_life_xen_world/18-1-0-481) (link dead!)
 283. [XUnil](https://www.fileplanet.com/7883/0/fileinfo/XUNIL)
 284. [Zeeba-G's TWHL Compo 26 Entry](http://twhl.info/competitions.php?results=26)
 285. [Zombies!](https://gamebanana.com/maps/160812)
@@ -694,7 +709,7 @@ For Linux and OS X you must download crossbuild from [here](http://www.moddb.com
 2. [Big Scientists](http://www.moddb.com/mods/big-scientists)
 3. [Black Silla Assault DEMO v1.2](http://www.moddb.com/mods/black-silla-assault)
 4. [Blbej Den](http://www.moddb.com/mods/blbej-den)
-5. [Cold Experiment v1](http://jpmaps.wz.cz/epizody.htm) (you will need some files from SoHL to play it properly; download SoHL 1.2, extract files and copy following folders into **coldexv1** folder: cl_dlls, dlls, models, sprites)
+5. [Cold Experiment v1](https://www.moddb.com/games/half-life/addons/cold-experiment) (you will need some files from SoHL to play it properly; download SoHL 1.2, extract files and copy following folders into **coldexv1** folder: cl_dlls, dlls, models, sprites)
 6. [Dead Sector v1.0a](http://www.moddb.com/mods/dead-sector)
 7. [Death Is Dead](http://www.moddb.com/games/half-life/addons/death-is-dead) (there is a fog-related inner bug at the first map)
 8. [Escape from Black Mesa Alpha](http://www.moddb.com/mods/escape-from-black-mesa)
@@ -710,9 +725,9 @@ For Linux and OS X you must download crossbuild from [here](http://www.moddb.com
 18. [Santa's Revenge](http://twhl.info/vault.php?map=4332) (set **fps_max** to **60** to avoid an inner problem of the last map with final scripted sequence, otherwise the mod can not be finished properly)
 19. [Sector 6](https://www.moddb.com/mods/sector-6/) 
 20. [Space Prisoner v1.1](http://www.moddb.com/games/half-life/addons/space-prisoner-v11) (after installing of the mod open **liblist.gam** or **gameinfo.txt** file in the mod's folder and correct the line **gamedll "..\prison\dlls\spirit.dll"** for **gamedll "dlls\spirit.dll"**, otherwise you'll not be able to start a game; there is also a scripting error on a third map of the mod, so you'll be forced to use **noclip** to pass around bugged place)
-21. [Terrorist Attack 2](http://terroristattack.wz.cz/mody.html) (link dead!)
+21. [Terrorist Attack 2](https://www.moddb.com/games/half-life/addons/terrorist-attack-2)
 22. [Timeline III: The Heart of Darkness](http://www.moddb.com/mods/timeline-series)
-23. [Underground 2 Demo](http://www.isolated-design.de/half-life-mods/underground-2/)
+23. [Underground 2 Demo](https://www.moddb.com/games/half-life/addons/underground-2-demo)
 
 ## Mods which based on modified Spirit of Half-Life 1.2 or older(Partially playable with SoHL 1.2 libraries or not playable at all)
 1. [Black Death](http://www.moddb.com/mods/half-life-black-death)
@@ -825,10 +840,10 @@ Mods:
 3. [Bomb Squad](http://www.snarkpit.net/index.php?s=maps&map=3471)
 4. [Corruption](http://www.snarkpit.net/index.php?s=maps&map=3154)
 5. [Critical Mass](http://www.moddb.com/mods/half-life-critical-mass) [C3M1 Build 1 Demo](https://www.fileplanet.com/125746/120000/fileinfo/C3M1-Build-1)
-6. [EPRST!](http://www.planetphillip.com/posts/ep-rst-opposing-force/) (link dead!)
+6. [EPRST!](https://www.runthinkshootlive.com/posts/ep-rst/)
 7. [Firing Range](https://www.runthinkshootlive.com/posts/firing-range/)
 8. [Friendly Fire](https://www.runthinkshootlive.com/posts/friendly-fire/)
-9. [Guitar Star Pre-Alpha](http://hl-lab.ru/eng/mods_goldsrc/Guitar_Star_(Prealpha)) (link dead!)
+9. [Guitar Star Pre-Alpha](http://gamer-lab.com/rus/mods_goldsrc/Guitar_Star_(Prealpha))
 10. [J2000](https://www.runthinkshootlive.com/posts/j2000/)
 11. [Killing House for OF](https://www.runthinkshootlive.com/posts/scientist-rescue-aka-cqb/)
 12. [Klabautermann](https://www.runthinkshootlive.com/posts/klabautermann/) (though the map has some inner issues, it can be properly finished, just don't let the welder soldier die and don't press the fifth button until you mount a special gun in its' place)

README.md

@@ -1,56 +1,57 @@
-# Xash3D FWGS Engine
-[![GitHub Actions Status](https://github.com/FWGS/xash3d-fwgs/actions/workflows/c-cpp.yml/badge.svg)](https://github.com/FWGS/xash3d-fwgs/actions/workflows/c-cpp.yml) [![Travis CI Status](https://api.travis-ci.org/FWGS/xash3d-fwgs.svg?branch=master)](https://travis-ci.org/FWGS/xash3d-fwgs) [![FreeBSD Build Status](https://img.shields.io/cirrus/github/FWGS/xash3d-fwgs?label=freebsd%20build)](https://cirrus-ci.com/github/FWGS/xash3d-fwgs) [![Discord Server](https://img.shields.io/discord/355697768582610945.svg)](http://discord.fwgs.ru/) \
-[![Download Stable](https://img.shields.io/badge/download-stable-yellow)](https://github.com/FWGS/xash3d-fwgs/releases/latest) [![Download Testing](https://img.shields.io/badge/downloads-testing-orange)](https://github.com/FWGS/xash3d-fwgs/releases/tag/continuous) 
+# Xash3D FWGS Engine <img align="right" width="128" height="128" src="https://github.com/FWGS/xash3d-fwgs/raw/master/game_launch/icon-xash-material.png" alt="Xash3D FWGS icon" />
+[![builds.sr.ht status](https://builds.sr.ht/~a1batross/xash3d-fwgs.svg)](https://builds.sr.ht/~a1batross/xash3d-fwgs?) [![GitHub Actions Status](https://github.com/FWGS/xash3d-fwgs/actions/workflows/c-cpp.yml/badge.svg)](https://github.com/FWGS/xash3d-fwgs/actions/workflows/c-cpp.yml) [![FreeBSD Build Status](https://img.shields.io/cirrus/github/FWGS/xash3d-fwgs?label=freebsd%20build)](https://cirrus-ci.com/github/FWGS/xash3d-fwgs) [![Discord Server](https://img.shields.io/discord/355697768582610945.svg)](http://fwgsdiscord.mentality.rip/) \
+[![Download Stable](https://img.shields.io/badge/download-stable-yellow)](https://github.com/FWGS/xash3d-fwgs/releases/latest) [![Download Testing](https://img.shields.io/badge/downloads-testing-orange)](https://github.com/FWGS/xash3d-fwgs/releases/tag/continuous)
 
-Xash3D FWGS is a fork of Xash3D Engine by Unkle Mike with extended features and crossplatform.
+Xash3D (pronounced `[ksɑʂ]`) FWGS is a game engine, aimed to provide compatibility with Half-Life Engine and extend it, as well as to give game developers well known workflow.
 
-```
-Xash3D is a game engine, aimed to provide compatibility with Half-Life Engine, 
-as well as to give game developers well known workflow and extend it.
-Read more about Xash3D on ModDB: https://www.moddb.com/engines/xash3d-engine
-```
+Xash3D FWGS is a heavily modified fork of an original [Xash3D Engine](https://www.moddb.com/engines/xash3d-engine) by Unkle Mike.
+
+## Donate
+[![Donate to FWGS button](https://img.shields.io/badge/Donate_to_FWGS-%3C3-magenta)](Documentation/donate.md) \
+If you like Xash3D FWGS, consider supporting individual engine maintainers. By supporting us, you help to continue developing this game engine further. The sponsorship links are available in [documentation](Documentation/donate.md).
 
 ## Fork features
-* HLSDK 2.4 support.
-* Crossplatform: supported x86 and ARM on Windows/Linux/BSD/Android. ([see docs for more info](Documentation/ports.md))
-* Modern compilers support: say no more to MSVC6.
-* Better multiplayer support: multiple master servers, headless dedicated server.
-* Mobility API: allows better game integration on mobile devices(vibration, touch controls)
-* Different input methods: touch, gamepad and classic mouse & keyboard.
+* Steam Half-Life (HLSDK 2.5) support.
+* Crossplatform and modern compilers support: supports Windows, Linux, BSD & Android on x86 & ARM and [many more](Documentation/ports.md).
+* Better multiplayer: multiple master servers, headless dedicated server, voice chat, [GoldSrc protocol support](Documentation/goldsrc-protocol-support.md) and IPv6 support.
+* Multiple renderers support: OpenGL, GLESv1, GLESv2 and Software.
+* Advanced virtual filesystem: `.pk3` and `.pk3dir` support, compatibility with GoldSrc FS module, fast case-insensitivity emulation for crossplatform.
+* Mobility API: better game integration on mobile devices (vibration, touch controls).
+* Different input methods: touch and gamepad in addition to mouse & keyboard.
 * TrueType font rendering, as a part of mainui_cpp.
-* Multiple renderers support: OpenGL, GLESv1, GLESv2, Software
-* A set of small improvements, without broken compatibility.
-
-## Planned fork features
-* Virtual Reality support and game API
-* Voice support
-* Vulkan renderer
+* External VGUI support module.
+* PNG & KTX2 image format support.
+* Ogg Vorbis (`.ogg`) & Ogg Opus (`.opus`) audio formats support.
+* [A set of small improvements](Documentation/), without broken compatibility.
 
 ## Installation & Running
-0) Get Xash3D binaries: you can use [testing](https://github.com/FWGS/xash3d-fwgs/releases/tag/continuous) build or you can compile engine from source code.
-Choose proper build package depending on which platform you're using.
+0) Get Xash3D FWGS binaries: you can use [testing](https://github.com/FWGS/xash3d-fwgs/releases/tag/continuous) build or you can compile engine from source code.
 1) Copy engine binaries to some directory.
 2) Copy `valve` directory from [Half-Life](https://store.steampowered.com/app/70/HalfLife/) to directory with engine binaries.
-Also if you're using Windows: you should copy `vgui.dll` library from Half-Life directory to Xash3D directory.
-As alternative, you can compile [hlsdk-xash3d](https://github.com/FWGS/hlsdk-xash3d) instead of using official Valve game binaries, but you still needed to copy `valve` directory as all game resources located in there.
-3) Download [extras.pak](https://github.com/FWGS/xash-extras/releases/tag/v0.19.2) and place it to `valve` directory.
-4) Run `xash3d.exe`/`xash3d.sh`/`xash3d` depending on which platform you're using.
-
-Note: on Linux, you may need to create an sh file with the command `LD_LIBRARY_PATH=. ./xash3d`.
+If your CPU is NOT x86 compatible or you're running 64-bit version of the engine, you may want to compile [Half-Life SDK](https://github.com/FWGS/hlsdk-portable).
+This repository contains our fork of HLSDK and restored source code for Half-Life expansions and some mods.
+You still needed to copy `valve` directory as all game resources located there.
+3) Run the main executable (`xash3d.exe` or AppImage).
 
 For additional info, run Xash3D with `-help` command line key.
 
 ## Contributing
-* Before sending an issue, check if someone already reported your issue. Make sure you're following "How To Ask Questions The Smart Way" guide by Eric Steven Raymond. Read more: http://www.catb.org/~esr/faqs/smart-questions.html
-* Issues are accepted in both English and Russian
+* Before sending an issue, check if someone already reported your issue. Make sure you're following "How To Ask Questions The Smart Way" guide by Eric Steven Raymond. Read more: http://www.catb.org/~esr/faqs/smart-questions.html.
+* Issues are accepted in both English and Russian.
 * Before sending a PR, check if you followed our contribution guide in CONTRIBUTING.md file.
 
 ## Build instructions
-We are using Waf build system. If you have some Waf-related questions, I recommend you to read https://waf.io/book/
+We are using Waf build system. If you have some Waf-related questions, I recommend you to read [Waf Book](https://waf.io/book/).
 
 NOTE: NEVER USE GitHub's ZIP ARCHIVES. GitHub doesn't include external dependencies we're using!
 
 ### Prerequisites
+If your CPU is x86 compatible and you're on Windows or Linux, we are building 32-bit code by default. This was done to maintain compatibility with Steam releases of Half-Life and based on it's engine games.
+Even if Xash3D FWGS does support targetting 64-bit, you can't load games without recompiling them from source code!
+
+If your CPU is NOT x86 compatible or you decided build 64-bit version of engine, you may want to compile [Half-Life SDK](https://github.com/FWGS/hlsdk-portable).
+This repository contains our fork of HLSDK and restored source code for Half-Life expansions and some mods.
+
 #### Windows (Visual Studio)
 * Install Visual Studio.
 * Install latest [Python](https://python.org) **OR** run `cinst python.install` if you have Chocolatey.
@@ -60,37 +61,41 @@ NOTE: NEVER USE GitHub's ZIP ARCHIVES. GitHub doesn't include external dependenc
 * Make sure you have at least 12GB of free space to store all build-time dependencies: ~10GB for Visual Studio, 300 MB for Git, 100 MB for Python and other.
 
 #### GNU/Linux
-NOTE FOR USERS WITH X86 COMPATIBLE CPUs:
-We have forced Waf to throw an error, if you're trying to build 64-bit engine. This was done for keeping compatibility with Steam releases of Half-Life and based on it's engine games.
-Even if Xash3D FWGS does support targetting 64-bit, you can't load games without recompiling them from source code!
-
 ##### Debian/Ubuntu
-* Enable i386 on your system, if you're compiling 32-bit engine on amd64. If not, skip this
+* Only for 32-bit engine on 64-bit x86 operating system:
+  * Enable i386 on your system: `$ sudo dpkg --add-architecture i386`.
+  * Install `aptitude` ([why?](https://github.com/FWGS/xash3d-fwgs/issues/1828#issuecomment-2415131759)):  `$ sudo apt update && sudo apt upgrade && sudo apt install aptitude`
+  * Install development tools: `$ sudo aptitude --without-recommends install git build-essential gcc-multilib g++-multilib libsdl2-dev:i386 libfontconfig-dev:i386 libfreetype-dev:i386 libopus-dev:i386 libbz2-dev:i386`.
+  * Set PKG_CONFIG_PATH environment variable to point at 32-bit libraries: `$ export PKG_CONFIG_PATH=/usr/lib/i386-linux-gnu/pkgconfig`.
 
-`$ sudo dpkg --add-architecture i386`
-* Install development tools
-  * For 32-bit engine on amd64: \
-    `$ sudo apt install build-essential gcc-multilib g++-multilib python libsdl2-dev:i386 libfontconfig-dev:i386 libfreetype6-dev:i386`
-  * For everything else: \
-    `$ sudo apt install build-essential python libsdl2-dev libfontconfig-dev libfreetype6-dev`
-* Clone this repostory:
-`$ git clone --recursive https://github.com/FWGS/xash3d-fwgs`
+* For 64-bit engine on 64-bit x86 and other non-x86 systems:
+  * Install development tools: `$ sudo apt install git build-essential python libsdl2-dev libfontconfig-dev libfreetype6-dev libopus-dev libbz2-dev`.
+
+* Clone this repostory: `$ git clone --recursive https://github.com/FWGS/xash3d-fwgs`.
+
+##### RedHat/Fedora
+* Only for 32-bit engine on 64-bit x86 operating system:
+  * Install development tools: `$ sudo dnf install git gcc gcc-c++ glibc-devel.i686 SDL2-devel.i686 opus-devel.i686 fontconfig-devel.i686 freetype-devel.i686 bzip2-devel.i686`.
+  * Set PKG_CONFIG_PATH environment variable to point at 32-bit libraries: `$ export PKG_CONFIG_PATH=/usr/lib/pkgconfig`.
+
+* For 64-bit engine on 64-bit x86 and other non-x86 systems:
+  * Install development tools: `$ sudo dnf install git gcc gcc-c++ SDL2-devel opus-devel fontconfig-devel freetype-devel bzip2-devel`.
+
+* Clone this repostory: `$ git clone --recursive https://github.com/FWGS/xash3d-fwgs`.
 
 ### Building
 #### Windows (Visual Studio)
-0) Open command line
+0) Open command line.
 1) Navigate to `xash3d-fwgs` directory.
-2) Carefully examine which build options are available: `waf --help`
-3) Configure build: `waf configure -T release --sdl2=c:/path/to/SDL2 --prefix=c:/path/to/any/output/directory`
-4) Compile: `waf build`
-5) Install: `waf install`
+2) (optional) Examine which build options are available: `waf --help`.
+3) Configure build: `waf configure --sdl2=c:/path/to/SDL2`.
+4) Compile: `waf build`.
+5) Install: `waf install --destdir=c:/path/to/any/output/directory`.
 
 #### Linux
-0) Examine which build options are available: `./waf --help`
-1) Configure build: `./waf configure -T release --prefix=/path/to/any/output/directory`
-(You need to pass `-8` to compile 64-bit engine on 64-bit x86 processor)
-2) Compile: `./waf build`
-3) Install(optional): `./waf install`
-
-Note: if compiling 32-bit on amd64, you may need to supply `export PKG_CONFIG_PATH=/usr/lib/i386-linux-gnu/pkgconfig` prior to running configure.   
+If compiling 32-bit on amd64, make sure `PKG_CONFIG_PATH` from the previous step is set correctly, prior to running configure.
 
+0) (optional) Examine which build options are available: `./waf --help`.
+1) Configure build: `./waf configure` (you need to pass `-8` to compile 64-bit engine on 64-bit x86 processor).
+2) Compile: `./waf build`.
+3) Install: `./waf install --destdir=/path/to/any/output/directory`.

android/.gitignore

@@ -0,0 +1,14 @@
+.gradle/
+build/
+.externalNativeBuild
+.cxx/
+.idea/
+local.properties
+.project
+.classpath
+.gradle
+.settings
+release/
+*.hprof
+.vscode/
+*.bak

android/app/CMakeLists.txt

@@ -0,0 +1,60 @@
+cmake_minimum_required(VERSION 3.6)
+
+# Only used to build Android project
+
+project(XASH_ANDROID)
+
+# armeabi-v7a requires cpufeatures library
+include(AndroidNdkModules)
+android_ndk_import_module_cpufeatures()
+
+find_package(PythonInterp 2.7 REQUIRED)
+
+get_filename_component(C_COMPILER_ID ${CMAKE_C_COMPILER} NAME_WE)
+get_filename_component(CXX_COMPILER_ID ${CMAKE_CXX_COMPILER} NAME_WE)
+
+if("${CMAKE_BUILD_TYPE}" STREQUAL "Debug")
+	set(BUILD_TYPE "debug")
+else()
+	set(BUILD_TYPE "release")
+	list(APPEND WAF_EXTRA_ARGS --enable-poly-opt --enable-lto)
+endif()
+
+if(CMAKE_SIZEOF_VOID_P MATCHES "8")
+	set(64BIT ON CACHE BOOL "" FORCE)
+	list(APPEND WAF_EXTRA_ARGS -8) # only required for x86 when testing this cmakelist under linux
+endif()
+
+set(CMAKE_VERBOSE_MAKEFILE ON)
+
+set(WAF_CC "${CMAKE_C_COMPILER} --target=${CMAKE_C_COMPILER_TARGET}")
+set(WAF_CXX "${CMAKE_CXX_COMPILER} --target=${CMAKE_CXX_COMPILER_TARGET}")
+
+# not cleanest way to get upper directory
+set(ENGINE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../")
+
+execute_process(
+	COMMAND ${CMAKE_COMMAND} -E env
+	CC=${WAF_CC} CXX=${WAF_CXX}
+	AR=${CMAKE_AR} STRIP=${CMAKE_STRIP}
+	${PYTHON_EXECUTABLE} waf configure -T ${BUILD_TYPE} ${WAF_EXTRA_ARGS} cmake
+	--check-c-compiler=${C_COMPILER_ID} --check-cxx-compiler=${CXX_COMPILER_ID}
+	-s "${ENGINE_SOURCE_DIR}/3rdparty/SDL" --skip-sdl2-sanity-check --enable-bundled-deps
+	WORKING_DIRECTORY "${ENGINE_SOURCE_DIR}"
+)
+
+add_subdirectory("${ENGINE_SOURCE_DIR}/3rdparty/hlsdk-portable" hlsdk-portable)
+
+# try to build minimal SDL. Enable features as we're gonna use them
+set(SDL_RENDER OFF)
+set(SDL_POWER OFF)
+set(SDL_VULKAN OFF)
+set(SDL_DISKAUDIO OFF)
+set(SDL_DUMMYAUDIO OFF)
+set(SDL_DUMMYVIDEO OFF)
+set(SDL_VULKAN OFF)
+set(SDL_OFFSCREEN OFF)
+set(SDL_STATIC OFF)
+add_subdirectory("${ENGINE_SOURCE_DIR}/3rdparty/SDL" SDL)
+add_subdirectory("${ENGINE_SOURCE_DIR}/" xash3d-fwgs)
+add_subdirectory("${ENGINE_SOURCE_DIR}/3rdparty/mainui" mainui)

android/app/build.gradle.kts

@@ -0,0 +1,129 @@
+import java.time.LocalDateTime
+import java.time.Month
+import java.time.temporal.ChronoUnit
+
+plugins {
+    id("com.android.application")
+    id("org.jetbrains.kotlin.android")
+}
+
+android {
+    namespace = "su.xash.engine"
+    ndkVersion = "27.2.12479018"
+
+    defaultConfig {
+        applicationId = "su.xash"
+        applicationIdSuffix = "engine"
+        versionName = "0.21"
+        versionCode = getBuildNum()
+        minSdk = 21
+        targetSdk = 34
+        compileSdk = 34
+
+        externalNativeBuild {
+            cmake {
+                abiFilters("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
+                arguments("-DANDROID_USE_LEGACY_TOOLCHAIN_FILE=OFF")
+            }
+        }
+    }
+
+    externalNativeBuild {
+        cmake {
+            version = "3.22.1"
+            path = file("CMakeLists.txt")
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = "1.8"
+    }
+
+    buildTypes {
+        debug {
+            isMinifyEnabled = false
+            isShrinkResources = false
+            isDebuggable = true
+            applicationIdSuffix = ".test"
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro"
+            )
+        }
+
+        release {
+            isMinifyEnabled = true
+            isShrinkResources = true
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro"
+            )
+        }
+
+        register("asan") {
+            initWith(getByName("debug"))
+        }
+
+        register("continuous") {
+            initWith(getByName("release"))
+            applicationIdSuffix = ".test"
+        }
+    }
+
+    sourceSets {
+        getByName("main") {
+            assets.srcDirs("../../3rdparty/extras/xash-extras", "../moddb")
+            java.srcDir("../../3rdparty/SDL/android-project/app/src/main/java")
+        }
+    }
+
+    lint {
+        abortOnError = false
+    }
+
+    buildFeatures {
+        viewBinding = true
+        buildConfig = true
+    }
+
+    androidResources {
+        noCompress += ""
+    }
+
+    packaging {
+        jniLibs {
+            useLegacyPackaging = true
+        }
+    }
+}
+
+dependencies {
+    implementation("com.google.android.material:material:1.11.0")
+    implementation("androidx.appcompat:appcompat:1.6.1")
+    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
+    implementation("androidx.navigation:navigation-fragment-ktx:2.7.7")
+    implementation("androidx.navigation:navigation-ui-ktx:2.7.7")
+    implementation("androidx.cardview:cardview:1.0.0")
+    implementation("androidx.annotation:annotation:1.7.1")
+    implementation("androidx.fragment:fragment-ktx:1.6.2")
+    implementation("androidx.preference:preference-ktx:1.2.1")
+    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
+    implementation("androidx.work:work-runtime-ktx:2.9.0")
+//    implementation "androidx.legacy:legacy-support-v4:1.0.0"
+
+    implementation("com.madgag.spongycastle:prov:1.58.0.0")
+    implementation("in.dragonbra:javasteam:1.2.0")
+
+    implementation("ch.acra:acra-http:5.11.2")
+}
+
+fun getBuildNum(): Int {
+    val now = LocalDateTime.now()
+    val releaseDate = LocalDateTime.of(2015, Month.APRIL, 1, 0, 0, 0)
+    val qBuildNum = releaseDate.until(now, ChronoUnit.DAYS)
+    val minuteOfDay = now.hour * 60 + now.minute
+    return (qBuildNum * 10000 + minuteOfDay).toInt()
+}

android/app/proguard-rules.pro

@@ -0,0 +1,89 @@
+-keep class su.xash.engine.XashActivity {
+    java.lang.String loadAndroidID();
+    java.lang.String getAndroidID();
+    void saveAndroidID(java.lang.String);
+    java.lang.String getCallingPackage();
+    java.lang.String[] getAssetsList(boolean, java.lang.String);
+    android.content.res.AssetManager getAssets(boolean);
+}
+
+-keep,includedescriptorclasses,allowoptimization class org.libsdl.app.SDLInputConnection {
+    void nativeCommitText(java.lang.String, int);
+    void nativeGenerateScancodeForUnichar(char);
+}
+
+-keep,includedescriptorclasses class org.libsdl.app.SDLActivity {
+    # for some reason these aren't compatible with allowoptimization modifier
+    boolean supportsRelativeMouse();
+    void setWindowStyle(boolean);
+}
+
+-keep,includedescriptorclasses,allowoptimization class org.libsdl.app.SDLActivity {
+    java.lang.String nativeGetHint(java.lang.String); # Java-side doesn't use this, so it gets minified, but C-side still tries to register it
+    boolean onNativeSoftReturnKey();
+    void onNativeKeyboardFocusLost();
+    boolean isScreenKeyboardShown();
+    android.util.DisplayMetrics getDisplayDPI();
+    java.lang.String clipboardGetText();
+    boolean clipboardHasText();
+    void clipboardSetText(java.lang.String);
+    int createCustomCursor(int[], int, int, int, int);
+    void destroyCustomCursor(int);
+    android.content.Context getContext();
+    boolean getManifestEnvironmentVariables();
+    android.view.Surface getNativeSurface();
+    void initTouch();
+    boolean isAndroidTV();
+    boolean isChromebook();
+    boolean isDeXMode();
+    boolean isTablet();
+    void manualBackButton();
+    int messageboxShowMessageBox(int, java.lang.String, java.lang.String, int[], int[], java.lang.String[], int[]);
+    void minimizeWindow();
+    int openURL(java.lang.String);
+    void requestPermission(java.lang.String, int);
+    int showToast(java.lang.String, int, int, int, int);
+    boolean sendMessage(int, int);
+    boolean setActivityTitle(java.lang.String);
+    boolean setCustomCursor(int);
+    void setOrientation(int, int, boolean, java.lang.String);
+    boolean setRelativeMouseEnabled(boolean);
+    boolean setSystemCursor(int);
+    boolean shouldMinimizeOnFocusLoss();
+    boolean showTextInput(int, int, int, int);
+}
+
+-keep,includedescriptorclasses,allowoptimization class org.libsdl.app.HIDDeviceManager {
+    boolean initialize(boolean, boolean);
+    boolean openDevice(int);
+    int sendOutputReport(int, byte[]);
+    int sendFeatureReport(int, byte[]);
+    boolean getFeatureReport(int, byte[]);
+    void closeDevice(int);
+}
+
+-keep,includedescriptorclasses,allowoptimization class org.libsdl.app.SDLAudioManager {
+    int[] getAudioOutputDevices();
+    int[] getAudioInputDevices();
+    int[] audioOpen(int, int, int, int, int);
+    void audioWriteFloatBuffer(float[]);
+    void audioWriteShortBuffer(short[]);
+    void audioWriteByteBuffer(byte[]);
+    void audioClose();
+    int[] captureOpen(int, int, int, int, int);
+    int captureReadFloatBuffer(float[], boolean);
+    int captureReadShortBuffer(short[], boolean);
+    int captureReadByteBuffer(byte[], boolean);
+    void captureClose();
+    void audioSetThreadPriority(boolean, int);
+    native int nativeSetupJNI();
+    native void removeAudioDevice(boolean, int);
+    native void addAudioDevice(boolean, int);
+}
+
+-keep,includedescriptorclasses,allowoptimization class org.libsdl.app.SDLControllerManager {
+    void pollInputDevices();
+    void pollHapticDevices();
+    void hapticRun(int, float, int);
+    void hapticStop(int);
+}

android/app/src/asan/res/values/strings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name" translatable="false">Xash3D FWGS (Test)</string>
+    <string name="authority" translatable="false">su.xash.engine.test.documents</string>
+</resources>

android/app/src/asan/resources/lib/arm64-v8a/wrap.sh

@@ -0,0 +1,26 @@
+
+#!/system/bin/sh
+HERE=$(cd "$(dirname "$0")" && pwd)
+cmd=$1
+shift
+# This must be called *before* `LD_PRELOAD` is set. Otherwise, if this is a 32-
+# bit app running on a 64-bit device, the 64-bit getprop will fail to load
+# because it will preload a 32-bit ASan runtime.
+# https://github.com/android/ndk/issues/1744
+os_version=$(getprop ro.build.version.sdk)
+if [ "$os_version" -eq "27" ]; then
+  cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
+elif [ "$os_version" -eq "28" ]; then
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
+else
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y $@"
+fi
+export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
+ASAN_LIB=$(ls "$HERE"/libclang_rt.asan-*-android.so)
+if [ -f "$HERE/libc++_shared.so" ]; then
+    # Workaround for https://github.com/android-ndk/ndk/issues/988.
+    export LD_PRELOAD="$ASAN_LIB $HERE/libc++_shared.so"
+else
+    export LD_PRELOAD="$ASAN_LIB"
+fi
+exec $cmd

android/app/src/asan/resources/lib/armeabi-v7a/wrap.sh

@@ -0,0 +1,26 @@
+
+#!/system/bin/sh
+HERE=$(cd "$(dirname "$0")" && pwd)
+cmd=$1
+shift
+# This must be called *before* `LD_PRELOAD` is set. Otherwise, if this is a 32-
+# bit app running on a 64-bit device, the 64-bit getprop will fail to load
+# because it will preload a 32-bit ASan runtime.
+# https://github.com/android/ndk/issues/1744
+os_version=$(getprop ro.build.version.sdk)
+if [ "$os_version" -eq "27" ]; then
+  cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
+elif [ "$os_version" -eq "28" ]; then
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
+else
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y $@"
+fi
+export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
+ASAN_LIB=$(ls "$HERE"/libclang_rt.asan-*-android.so)
+if [ -f "$HERE/libc++_shared.so" ]; then
+    # Workaround for https://github.com/android-ndk/ndk/issues/988.
+    export LD_PRELOAD="$ASAN_LIB $HERE/libc++_shared.so"
+else
+    export LD_PRELOAD="$ASAN_LIB"
+fi
+exec $cmd

android/app/src/asan/resources/lib/x86/wrap.sh

@@ -0,0 +1,26 @@
+
+#!/system/bin/sh
+HERE=$(cd "$(dirname "$0")" && pwd)
+cmd=$1
+shift
+# This must be called *before* `LD_PRELOAD` is set. Otherwise, if this is a 32-
+# bit app running on a 64-bit device, the 64-bit getprop will fail to load
+# because it will preload a 32-bit ASan runtime.
+# https://github.com/android/ndk/issues/1744
+os_version=$(getprop ro.build.version.sdk)
+if [ "$os_version" -eq "27" ]; then
+  cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
+elif [ "$os_version" -eq "28" ]; then
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
+else
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y $@"
+fi
+export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
+ASAN_LIB=$(ls "$HERE"/libclang_rt.asan-*-android.so)
+if [ -f "$HERE/libc++_shared.so" ]; then
+    # Workaround for https://github.com/android-ndk/ndk/issues/988.
+    export LD_PRELOAD="$ASAN_LIB $HERE/libc++_shared.so"
+else
+    export LD_PRELOAD="$ASAN_LIB"
+fi
+exec $cmd

android/app/src/asan/resources/lib/x86_64/wrap.sh

@@ -0,0 +1,26 @@
+
+#!/system/bin/sh
+HERE=$(cd "$(dirname "$0")" && pwd)
+cmd=$1
+shift
+# This must be called *before* `LD_PRELOAD` is set. Otherwise, if this is a 32-
+# bit app running on a 64-bit device, the 64-bit getprop will fail to load
+# because it will preload a 32-bit ASan runtime.
+# https://github.com/android/ndk/issues/1744
+os_version=$(getprop ro.build.version.sdk)
+if [ "$os_version" -eq "27" ]; then
+  cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
+elif [ "$os_version" -eq "28" ]; then
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
+else
+  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y $@"
+fi
+export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
+ASAN_LIB=$(ls "$HERE"/libclang_rt.asan-*-android.so)
+if [ -f "$HERE/libc++_shared.so" ]; then
+    # Workaround for https://github.com/android-ndk/ndk/issues/988.
+    export LD_PRELOAD="$ASAN_LIB $HERE/libc++_shared.so"
+else
+    export LD_PRELOAD="$ASAN_LIB"
+fi
+exec $cmd

android/app/src/continuous/res/values/strings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name" translatable="false">Xash3D FWGS (Test)</string>
+    <string name="authority" translatable="false">su.xash.engine.test.documents</string>
+</resources>

android/app/src/debug/res/values/strings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name" translatable="false">Xash3D FWGS (Test)</string>
+    <string name="authority" translatable="false">su.xash.engine.test.documents</string>
+</resources>

android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:allowAudioPlaybackCapture="true"
+    android:installLocation="preferExternal"
+    tools:targetApi="q">
+    <!-- OpenGL ES 1.1 -->
+    <uses-feature android:glEsVersion="0x00010000" />
+    <!-- Touchscreen support -->
+    <uses-feature
+        android:name="android.hardware.touchscreen"
+        android:required="false" />
+    <!-- Game controller support -->
+    <uses-feature
+        android:name="android.hardware.bluetooth"
+        android:required="false" />
+    <uses-feature
+        android:name="android.hardware.gamepad"
+        android:required="false" />
+    <uses-feature
+        android:name="android.hardware.usb.host"
+        android:required="false" />
+    <!-- External mouse input events -->
+    <uses-feature
+        android:name="android.hardware.type.pc"
+        android:required="false" />
+    <!-- Audio recording support -->
+    <uses-feature
+        android:name="android.hardware.microphone"
+        android:required="false" />
+    <!-- Allow downloading to the external storage on Android 5.1 and older -->
+    <uses-permission
+        android:name="android.permission.WRITE_EXTERNAL_STORAGE"
+        android:maxSdkVersion="22" />
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
+        android:maxSdkVersion="32" />
+    <!-- Allow access to Bluetooth devices -->
+    <!-- Currently this is just for Steam Controller support and requires setting SDL_HINT_JOYSTICK_HIDAPI_STEAM -->
+    <uses-permission
+        android:name="android.permission.BLUETOOTH"
+        android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+    <!-- Allow access to the vibrator -->
+    <uses-permission android:name="android.permission.VIBRATE" />
+    <!-- Allow recording audio -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <!-- Allow internet access -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <!-- Dedicated server -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <application
+        android:name=".MainApplication"
+        android:allowBackup="true"
+        android:hardwareAccelerated="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher"
+        android:theme="@style/Theme.App"
+        android:usesCleartextTraffic="true">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+        <activity
+            android:name=".XashActivity"
+            android:alwaysRetainTaskState="true"
+            android:configChanges="orientation|uiMode|screenLayout|screenSize|smallestScreenSize|keyboard|keyboardHidden|navigation|touchscreen"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:preferMinimalPostProcessing="true"
+            android:windowSoftInputMode="adjustResize"
+            tools:targetApi="r">
+            <intent-filter>
+                <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+            </intent-filter>
+        </activity>
+
+        <provider
+            android:name=".XashDocumentsProvider"
+            android:authorities="@string/authority"
+            android:exported="true"
+            android:grantUriPermissions="true"
+            android:permission="android.permission.MANAGE_DOCUMENTS">
+            <intent-filter>
+                <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
+            </intent-filter>
+        </provider>
+    </application>
+
+    <queries>
+        <intent>
+            <action android:name="su.xash.engine.MOD" />
+        </intent>
+    </queries>
+</manifest>

android/app/src/main/java/su/xash/engine/AndroidBug5497Workaround.java

@@ -0,0 +1,49 @@
+package su.xash.engine;
+
+import android.app.Activity;
+import android.graphics.Rect;
+import android.view.View;
+import android.widget.FrameLayout;
+
+public class AndroidBug5497Workaround {
+    // For more information, see https://code.google.com/p/android/issues/detail?id=5497
+    // To use this class, simply invoke assistActivity() on an Activity that already has its content view set.
+
+    public static void assistActivity(Activity activity) {
+        new AndroidBug5497Workaround(activity);
+    }
+
+    private View mChildOfContent;
+    private int usableHeightPrevious;
+    private FrameLayout.LayoutParams frameLayoutParams;
+
+    private AndroidBug5497Workaround(Activity activity) {
+        FrameLayout content = activity.findViewById(android.R.id.content);
+        mChildOfContent = content.getChildAt(0);
+        mChildOfContent.getViewTreeObserver().addOnGlobalLayoutListener(this::possiblyResizeChildOfContent);
+        frameLayoutParams = (FrameLayout.LayoutParams) mChildOfContent.getLayoutParams();
+    }
+
+    private void possiblyResizeChildOfContent() {
+        int usableHeightNow = computeUsableHeight();
+        if (usableHeightNow != usableHeightPrevious) {
+            int usableHeightSansKeyboard = mChildOfContent.getRootView().getHeight();
+            int heightDifference = usableHeightSansKeyboard - usableHeightNow;
+            if (heightDifference > (usableHeightSansKeyboard / 4)) {
+                // keyboard probably just became visible
+                frameLayoutParams.height = usableHeightSansKeyboard - heightDifference;
+            } else {
+                // keyboard probably just became hidden
+                frameLayoutParams.height = usableHeightSansKeyboard;
+            }
+            mChildOfContent.requestLayout();
+            usableHeightPrevious = usableHeightNow;
+        }
+    }
+
+    private int computeUsableHeight() {
+        Rect r = new Rect();
+        mChildOfContent.getWindowVisibleDisplayFrame(r);
+        return (r.bottom - r.top);
+    }
+}

android/app/src/main/java/su/xash/engine/DedicatedActivity.kt

@@ -0,0 +1,4 @@
+package su.xash.engine
+
+class DedicatedActivity {
+}

android/app/src/main/java/su/xash/engine/DedicatedService.kt

@@ -0,0 +1,11 @@
+package su.xash.engine
+
+import android.app.Service
+import android.content.Intent
+import android.os.IBinder
+
+class DedicatedService: Service() {
+    override fun onBind(intent: Intent?): IBinder? {
+        TODO("Not yet implemented")
+    }
+}

android/app/src/main/java/su/xash/engine/MainActivity.kt

@@ -0,0 +1,35 @@
+package su.xash.engine
+
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import androidx.navigation.NavController
+import androidx.navigation.fragment.NavHostFragment
+import androidx.navigation.ui.AppBarConfiguration
+import androidx.navigation.ui.navigateUp
+import androidx.navigation.ui.setupActionBarWithNavController
+import su.xash.engine.databinding.ActivityMainBinding
+
+class MainActivity : AppCompatActivity() {
+    private lateinit var binding: ActivityMainBinding
+    private lateinit var appBarConfiguration: AppBarConfiguration
+    private lateinit var navController: NavController
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        binding = ActivityMainBinding.inflate(layoutInflater)
+        setContentView(binding.root)
+
+        setSupportActionBar(binding.toolbar)
+
+        val navHostFragment =
+            supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment
+        navController = navHostFragment.navController
+        appBarConfiguration = AppBarConfiguration(navController.graph)
+        setupActionBarWithNavController(navController, appBarConfiguration)
+    }
+
+    override fun onSupportNavigateUp(): Boolean {
+        return navController.navigateUp(appBarConfiguration) || super.onSupportNavigateUp()
+    }
+}

android/app/src/main/java/su/xash/engine/MainApplication.kt

@@ -0,0 +1,28 @@
+package su.xash.engine
+
+import android.app.Application
+import android.content.Context
+import android.os.StrictMode
+import org.acra.config.httpSender
+import org.acra.data.StringFormat
+import org.acra.ktx.initAcra
+
+class MainApplication : Application() {
+    override fun attachBaseContext(base: Context?) {
+        super.attachBaseContext(base)
+
+        if (!BuildConfig.DEBUG) {
+            initAcra {
+                buildConfigClass = BuildConfig::class.java
+                reportFormat = StringFormat.JSON
+
+                httpSender {
+                    uri = "http://bodis.pp.ua:5000/report"
+                }
+            }
+        } else {
+            // enable strict mode to detect memory leaks etc.
+            StrictMode.enableDefaults();
+        }
+    }
+}

android/app/src/main/java/su/xash/engine/XashActivity.java

@@ -0,0 +1,136 @@
+package su.xash.engine;
+
+import android.annotation.SuppressLint;
+import android.content.pm.ActivityInfo;
+import android.content.res.AssetManager;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings.Secure;
+import android.util.Log;
+import android.view.KeyEvent;
+import android.view.WindowManager;
+
+import org.libsdl.app.SDLActivity;
+
+public class XashActivity extends SDLActivity {
+    private boolean mUseVolumeKeys;
+    private String mPackageName;
+    private static final String TAG = "XashActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+            //getWindow().addFlags(WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES);
+            getWindow().getAttributes().layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
+        }
+
+        AndroidBug5497Workaround.assistActivity(this);
+    }
+
+    @Override
+    protected String[] getLibraries() {
+        return new String[]{"SDL2", "xash"};
+    }
+
+    @SuppressLint("HardwareIds")
+    private String getAndroidID() {
+        return Secure.getString(getContentResolver(), Secure.ANDROID_ID);
+    }
+
+    @SuppressLint("ApplySharedPref")
+    private void saveAndroidID(String id) {
+        getSharedPreferences("xash_preferences", MODE_PRIVATE).edit().putString("xash_id", id).commit();
+    }
+
+    private String loadAndroidID() {
+        return getSharedPreferences("xash_preferences", MODE_PRIVATE).getString("xash_id", "");
+    }
+
+    @Override
+    public String getCallingPackage() {
+        if (mPackageName != null) {
+            return mPackageName;
+        }
+
+        return super.getCallingPackage();
+    }
+
+    private AssetManager getAssets(boolean isEngine) {
+        AssetManager am = null;
+
+        if (isEngine) {
+            am = getAssets();
+        } else {
+            try {
+                am = getPackageManager().getResourcesForApplication(getCallingPackage()).getAssets();
+            } catch (Exception e) {
+                Log.e(TAG, "Unable to load mod assets!");
+                e.printStackTrace();
+            }
+        }
+
+        return am;
+    }
+
+    private String[] getAssetsList(boolean isEngine, String path) {
+        AssetManager am = getAssets(isEngine);
+
+        try {
+            return am.list(path);
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+
+        return new String[]{};
+    }
+
+    @Override
+    public boolean dispatchKeyEvent(KeyEvent event) {
+        if (SDLActivity.mBrokenLibraries) {
+            return false;
+        }
+
+        int keyCode = event.getKeyCode();
+        if (!mUseVolumeKeys) {
+            if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN ||
+                    keyCode == KeyEvent.KEYCODE_VOLUME_UP ||
+                    keyCode == KeyEvent.KEYCODE_CAMERA ||
+                    keyCode == KeyEvent.KEYCODE_ZOOM_IN ||
+                    keyCode == KeyEvent.KEYCODE_ZOOM_OUT) {
+                return false;
+            }
+        }
+
+        return getWindow().superDispatchKeyEvent(event);
+    }
+
+    // TODO: REMOVE LATER, temporary launchers support?
+    @Override
+    protected String[] getArguments() {
+        String gamedir = getIntent().getStringExtra("gamedir");
+        if (gamedir == null) gamedir = "valve";
+        nativeSetenv("XASH3D_GAME", gamedir);
+
+        String gamelibdir = getIntent().getStringExtra("gamelibdir");
+        if (gamelibdir != null) nativeSetenv("XASH3D_GAMELIBDIR", gamelibdir);
+
+        String pakfile = getIntent().getStringExtra("pakfile");
+        if (pakfile != null) nativeSetenv("XASH3D_EXTRAS_PAK2", pakfile);
+
+        mUseVolumeKeys = getIntent().getBooleanExtra("usevolume", false);
+        mPackageName = getIntent().getStringExtra("package");
+
+        String[] env = getIntent().getStringArrayExtra("env");
+        if (env != null) {
+            for (int i = 0; i < env.length; i += 2)
+                nativeSetenv(env[i], env[i + 1]);
+        }
+
+        String argv = getIntent().getStringExtra("argv");
+        if (argv == null) argv = "-console -log";
+        return argv.split(" ");
+    }
+}

android/app/src/main/java/su/xash/engine/XashDocumentsProvider.java

@@ -0,0 +1,253 @@
+package su.xash.engine;
+
+import android.annotation.TargetApi;
+import android.content.res.AssetFileDescriptor;
+import android.database.Cursor;
+import android.database.MatrixCursor;
+import android.graphics.Point;
+import android.os.Build;
+import android.os.CancellationSignal;
+import android.os.ParcelFileDescriptor;
+import android.provider.DocumentsContract.Document;
+import android.provider.DocumentsContract.Root;
+import android.provider.DocumentsProvider;
+import android.webkit.MimeTypeMap;
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.IOException;
+
+@TargetApi(Build.VERSION_CODES.KITKAT)
+public class XashDocumentsProvider extends DocumentsProvider {
+    private static final String ALL_MIME_TYPES = "*/*";
+    private File mRootDir;
+
+    private static final String TAG = "XashDocumentsProvider";
+
+    @Override
+    public boolean onCreate() {
+        mRootDir = getContext().getExternalFilesDir(null);
+
+        return true;
+    }
+
+    private static final String[] DEFAULT_ROOT_PROJECTION = new String[]{Root.COLUMN_ROOT_ID,
+            Root.COLUMN_MIME_TYPES,
+            Root.COLUMN_FLAGS,
+            Root.COLUMN_ICON,
+            Root.COLUMN_TITLE,
+            Root.COLUMN_SUMMARY,
+            Root.COLUMN_DOCUMENT_ID,
+            Root.COLUMN_AVAILABLE_BYTES};
+
+    private static final String[] DEFAULT_DOCUMENT_PROJECTION = new String[]{Document.COLUMN_DOCUMENT_ID,
+            Document.COLUMN_MIME_TYPE,
+            Document.COLUMN_DISPLAY_NAME,
+            Document.COLUMN_LAST_MODIFIED,
+            Document.COLUMN_FLAGS,
+            Document.COLUMN_SIZE};
+
+    @Override
+    public Cursor queryRoots(String[] projection) {
+        final MatrixCursor result = new MatrixCursor(projection != null ? projection : DEFAULT_ROOT_PROJECTION);
+
+        final String appName = getContext().getString(R.string.app_name);
+        final String docId = getDocIdForFile(mRootDir);
+
+        int flags;
+
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
+            flags = Root.FLAG_LOCAL_ONLY | Root.FLAG_SUPPORTS_CREATE | Root.FLAG_SUPPORTS_SEARCH;
+        } else {
+            flags = Root.FLAG_LOCAL_ONLY | Root.FLAG_SUPPORTS_CREATE | Root.FLAG_SUPPORTS_SEARCH | Root.FLAG_SUPPORTS_IS_CHILD;
+        }
+
+        final MatrixCursor.RowBuilder row = result.newRow();
+        row.add(Root.COLUMN_ROOT_ID, docId);
+        row.add(Root.COLUMN_DOCUMENT_ID, docId);
+        row.add(Root.COLUMN_SUMMARY, null);
+        row.add(Root.COLUMN_FLAGS, flags);
+        row.add(Root.COLUMN_TITLE, appName);
+        row.add(Root.COLUMN_MIME_TYPES, ALL_MIME_TYPES);
+        row.add(Root.COLUMN_AVAILABLE_BYTES, mRootDir.getFreeSpace());
+        row.add(Root.COLUMN_ICON, R.mipmap.ic_launcher);
+
+        return result;
+    }
+
+    @Override
+    public Cursor queryDocument(String documentId, String[] projection) throws FileNotFoundException {
+        final MatrixCursor result = new MatrixCursor(projection != null ? projection : DEFAULT_DOCUMENT_PROJECTION);
+
+        includeFile(result, documentId, null);
+
+        return result;
+    }
+
+    @Override
+    public Cursor queryChildDocuments(String parentDocumentId, String[] projection, String sortOrder) throws FileNotFoundException {
+        final MatrixCursor result = new MatrixCursor(projection != null ? projection : DEFAULT_DOCUMENT_PROJECTION);
+
+        final File parent = getFileForDocId(parentDocumentId);
+        final File[] filesList = parent.listFiles();
+
+        if (filesList != null) {
+            for (File file : filesList) {
+                includeFile(result, null, file);
+            }
+        }
+
+        return result;
+    }
+
+    @Override
+    public ParcelFileDescriptor openDocument(final String documentId, String mode, CancellationSignal signal) throws FileNotFoundException {
+        final File file = getFileForDocId(documentId);
+
+        final int accessMode = ParcelFileDescriptor.parseMode(mode);
+
+        return ParcelFileDescriptor.open(file, accessMode);
+    }
+
+    @Override
+    public AssetFileDescriptor openDocumentThumbnail(String documentId, Point sizeHint, CancellationSignal signal) throws FileNotFoundException {
+        final File file = getFileForDocId(documentId);
+
+        final ParcelFileDescriptor pfd = ParcelFileDescriptor.open(file, ParcelFileDescriptor.MODE_READ_ONLY);
+
+        return new AssetFileDescriptor(pfd, 0, file.length());
+    }
+
+    @Override
+    public String createDocument(String parentDocumentId, String mimeType, String displayName) throws FileNotFoundException {
+        File newFile = new File(parentDocumentId, displayName);
+
+        int noConflictId = 1;
+
+        while (newFile.exists()) {
+            newFile = new File(parentDocumentId, displayName + " (" + noConflictId++ + ")");
+        }
+
+        try {
+            boolean succeeded;
+
+            if (Document.MIME_TYPE_DIR.equals(mimeType)) {
+                succeeded = newFile.mkdir();
+            } else {
+                succeeded = newFile.createNewFile();
+            }
+
+            if (!succeeded) {
+                throw new FileNotFoundException("Failed to create document with id " + newFile.getPath());
+            }
+        } catch (IOException e) {
+            throw new FileNotFoundException("Failed to create document with id " + newFile.getPath());
+        }
+
+        return newFile.getPath();
+    }
+
+    @Override
+    public void deleteDocument(String documentId) throws FileNotFoundException {
+        File file = getFileForDocId(documentId);
+
+        if (file.isDirectory()) {
+            if (!deleteDirectory(file)) {
+                throw new FileNotFoundException("Failed to delete document with id " + documentId);
+            }
+        } else if (!file.delete()) {
+            throw new FileNotFoundException("Failed to delete document with id " + documentId);
+        }
+    }
+
+    @Override
+    public String getDocumentType(String documentId) throws FileNotFoundException {
+        File file = getFileForDocId(documentId);
+
+        return getMimeType(file);
+    }
+
+    @Override
+    public boolean isChildDocument(String parentDocumentId, String documentId) {
+        return documentId.startsWith(parentDocumentId);
+    }
+
+    private static File getFileForDocId(String docId) throws FileNotFoundException {
+        final File f = new File(docId);
+
+        if (!f.exists()) throw new FileNotFoundException(f.getAbsolutePath() + " not found");
+
+        return f;
+    }
+
+    private static String getDocIdForFile(File file) {
+        return file.getAbsolutePath();
+    }
+
+    private static String getMimeType(File file) {
+        if (file.isDirectory()) {
+            return Document.MIME_TYPE_DIR;
+        } else {
+            final String name = file.getName();
+            final int lastDot = name.lastIndexOf('.');
+
+            if (lastDot >= 0) {
+                final String extension = name.substring(lastDot + 1).toLowerCase();
+                final String mime = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension);
+
+                if (mime != null) return mime;
+            }
+
+            return "application/octet-stream";
+        }
+    }
+
+    private static boolean deleteDirectory(File dir) {
+        final File[] allContents = dir.listFiles();
+
+        if (allContents != null) {
+            for (File file : allContents) {
+                deleteDirectory(file);
+            }
+        }
+        return dir.delete();
+    }
+
+    private void includeFile(MatrixCursor result, String docId, File file) throws FileNotFoundException {
+        if (docId == null) {
+            docId = getDocIdForFile(file);
+        } else {
+            file = getFileForDocId(docId);
+        }
+
+        int flags = 0;
+
+        if (file.isDirectory()) {
+            if (file.canWrite()) {
+                flags |= Document.FLAG_DIR_SUPPORTS_CREATE;
+            }
+        } else if (file.canWrite()) {
+            flags |= Document.FLAG_SUPPORTS_WRITE;
+        }
+
+        File parentFile = file.getParentFile();
+        if (parentFile != null && parentFile.canWrite()) {
+            flags |= Document.FLAG_SUPPORTS_DELETE;
+        }
+
+        final String displayName = file.getName();
+        final String mimeType = getMimeType(file);
+
+        if (mimeType.startsWith("image/")) {
+            flags |= Document.FLAG_SUPPORTS_THUMBNAIL;
+        }
+
+        final MatrixCursor.RowBuilder row = result.newRow();
+        row.add(Document.COLUMN_DOCUMENT_ID, docId);
+        row.add(Document.COLUMN_DISPLAY_NAME, displayName);
+        row.add(Document.COLUMN_SIZE, file.length());
+        row.add(Document.COLUMN_MIME_TYPE, mimeType);
+        row.add(Document.COLUMN_LAST_MODIFIED, file.lastModified());
+        row.add(Document.COLUMN_FLAGS, flags);
+        row.add(Document.COLUMN_ICON, R.mipmap.ic_launcher);
+    }
+}

android/app/src/main/java/su/xash/engine/adapters/GameAdapter.kt

@@ -0,0 +1,77 @@
+package su.xash.engine.adapters
+
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.navigation.findNavController
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import su.xash.engine.R
+import su.xash.engine.databinding.CardGameBinding
+import su.xash.engine.model.Game
+import su.xash.engine.ui.library.LibraryViewModel
+
+
+class GameAdapter(private val libraryViewModel: LibraryViewModel) :
+    ListAdapter<Game, GameAdapter.GameViewHolder>(DiffCallback()) {
+
+    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): GameAdapter.GameViewHolder {
+        val binding = CardGameBinding.inflate(LayoutInflater.from(parent.context), parent, false)
+        return GameViewHolder(binding)
+    }
+
+    override fun onBindViewHolder(holder: GameAdapter.GameViewHolder, position: Int) {
+        return holder.bind(getItem(position))
+    }
+
+    private class DiffCallback : DiffUtil.ItemCallback<Game>() {
+        override fun areItemsTheSame(oldItem: Game, newItem: Game): Boolean {
+            return oldItem.basedir.name == newItem.basedir.name
+        }
+
+        override fun areContentsTheSame(oldItem: Game, newItem: Game): Boolean {
+            return oldItem.basedir.name == newItem.basedir.name && oldItem.installed == newItem.installed
+        }
+
+    }
+
+    inner class GameViewHolder(val binding: CardGameBinding) :
+        RecyclerView.ViewHolder(binding.root) {
+        fun bind(game: Game) {
+            binding.apply {
+                gameTitle.text = game.title
+
+                if (game.icon != null) {
+                    gameIcon.setImageBitmap(game.icon)
+                } else {
+                    gameIcon.visibility = View.GONE
+                }
+
+                if (game.cover != null) {
+                    gameCover.setImageBitmap(game.cover)
+                } else {
+                    gameCover.visibility = View.GONE
+                }
+
+                if (!game.installed) {
+                    launchButton.visibility = View.GONE
+                    settingsButton.visibility = View.GONE
+                    progressIndicator.visibility = View.VISIBLE
+                    return
+                }
+
+                settingsButton.setOnClickListener {
+                    libraryViewModel.setSelectedGame(game)
+                    it.findNavController()
+                        .navigate(R.id.action_libraryFragment_to_gameSettingsFragment)
+                }
+
+                root.setOnClickListener { libraryViewModel.startEngine(it.context, game) }
+                launchButton.setOnClickListener {
+                    libraryViewModel.startEngine(it.context, game)
+                }
+            }
+        }
+    }
+}

android/app/src/main/java/su/xash/engine/model/BackgroundBitmap.kt

@@ -0,0 +1,89 @@
+package su.xash.engine.model
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.Canvas
+import androidx.documentfile.provider.DocumentFile
+import su.xash.engine.util.TGAReader
+import java.util.Scanner
+
+
+object BackgroundBitmap {
+    private const val BACKGROUND_ROWS = 3
+    private const val BACKGROUND_COLUMNS = 4
+    private const val BACKGROUND_WIDTH = 800
+    private const val BACKGROUND_HEIGHT = 600
+
+    fun createBackground(ctx: Context, file: DocumentFile): Bitmap {
+        var bitmap =
+            Bitmap.createBitmap(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, Bitmap.Config.ARGB_8888)
+        var canvas = Canvas(bitmap)
+        var x: Int
+        var y = 0
+        var width: Int
+        var height = 0
+
+        var bgLayout = file.findFile("resource")?.findFile("HD_BackgroundLayout.txt")
+        if (bgLayout == null) {
+            bgLayout = file.findFile("resource")?.findFile("BackgroundLayout.txt")
+        }
+
+        if (bgLayout == null) {
+            val dir = file.findFile("resource")?.findFile("background")
+            for (i in 0 until BACKGROUND_ROWS) {
+                x = 0
+                for (j in 0 until BACKGROUND_COLUMNS) {
+                    val filename = "${BACKGROUND_WIDTH}_${i + 1}_${'a' + j}_loading.tga"
+                    val bmpFile = dir?.findFile(filename)
+                    val bmpImage = loadTga(ctx, bmpFile!!)
+
+                    canvas.drawBitmap(bmpImage, x.toFloat(), y.toFloat(), null)
+                    x += bmpImage.width
+                    height = bmpImage.height
+
+                }
+                y += height
+            }
+            return bitmap
+        }
+
+        ctx.contentResolver.openInputStream(bgLayout.uri).use { inputStream ->
+            Scanner(inputStream).use { scanner ->
+                while (scanner.hasNext()) {
+                    when (val str = scanner.next()) {
+                        "resolution" -> {
+                            width = scanner.nextInt()
+                            height = scanner.nextInt()
+                            bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)
+                            canvas = Canvas(bitmap)
+                        }
+
+                        else -> {
+                            var bmpFile = file
+                            str.split("/").forEach { bmpFile = bmpFile.findFile(it)!! }
+                            //skip
+                            scanner.next()
+                            x = scanner.nextInt()
+                            y = scanner.nextInt()
+                            val bmp = loadTga(ctx, bmpFile)
+                            canvas.drawBitmap(bmp, x.toFloat(), y.toFloat(), null)
+                        }
+                    }
+                }
+            }
+        }
+        return bitmap
+    }
+
+    private fun loadTga(ctx: Context, file: DocumentFile): Bitmap {
+        ctx.contentResolver.openInputStream(file.uri).use {
+            val buffer = it?.readBytes()
+            val pixels = TGAReader.read(buffer, TGAReader.ARGB)
+
+            val width = TGAReader.getWidth(buffer)
+            val height = TGAReader.getHeight(buffer)
+
+            return Bitmap.createBitmap(pixels, 0, width, width, height, Bitmap.Config.ARGB_8888)
+        }
+    }
+}

android/app/src/main/java/su/xash/engine/model/Game.kt

@@ -0,0 +1,133 @@
+package su.xash.engine.model
+
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageInfo
+import android.content.pm.PackageManager
+import android.graphics.Bitmap
+import android.net.Uri
+import android.provider.MediaStore
+import androidx.documentfile.provider.DocumentFile
+import su.xash.engine.XashActivity
+
+
+class Game(val ctx: Context, val basedir: DocumentFile, var installed: Boolean = true) {
+    private var iconName = "game.ico"
+    var title = "Unknown Game"
+    var icon: Bitmap? = null
+    var cover: Bitmap? = null
+
+    private val pref = ctx.getSharedPreferences(basedir.name, Context.MODE_PRIVATE)
+
+    init {
+        basedir.findFile("gameinfo.txt")?.let {
+            parseGameInfo(it)
+        } ?: basedir.findFile("liblist.gam")?.let { parseGameInfo(it) }
+
+        basedir.findFile(iconName)
+            ?.let { icon = MediaStore.Images.Media.getBitmap(ctx.contentResolver, it.uri) }
+
+        try {
+            cover = BackgroundBitmap.createBackground(ctx, basedir)
+        } catch (e: Exception) {
+            e.printStackTrace()
+        }
+    }
+
+    fun startEngine(ctx: Context) {
+        ctx.startActivity(Intent(ctx, XashActivity::class.java).apply {
+            flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
+            putExtra("gamedir", basedir.name)
+            putExtra("argv", pref.getString("arguments", "-console -log"))
+            putExtra("usevolume", pref.getBoolean("use_volume_buttons", false))
+            //.putExtra("gamelibdir", getGameLibDir(context))
+            //.putExtra("package", getPackageName()) }
+        })
+    }
+
+    private fun parseGameInfo(file: DocumentFile) {
+        ctx.contentResolver.openInputStream(file.uri).use { inputStream ->
+            inputStream?.bufferedReader().use { reader ->
+                reader?.forEachLine {
+                    val tokens = it.split("\\s+".toRegex(), limit = 2)
+                    if (tokens.size >= 2) {
+                        val k = tokens[0]
+                        val v = tokens[1].trim('"')
+
+                        if (k == "title" || k == "game") title = v
+                        if (k == "icon") iconName = v
+                    }
+                }
+            }
+        }
+    }
+
+    private fun getPackageName(): String? {
+//        return if (mDbEntry != null) {
+//            mDbEntry.getPackageName()
+//        } else null
+        return null
+    }
+
+    private fun getGameLibDir(ctx: Context): String? {
+        val pkgName = getPackageName()
+        if (pkgName != null) {
+            val pkgInfo: PackageInfo = try {
+                ctx.packageManager.getPackageInfo(pkgName, 0)
+            } catch (e: PackageManager.NameNotFoundException) {
+                e.printStackTrace()
+                ctx.startActivity(
+                    Intent(
+                        Intent.ACTION_VIEW, Uri.parse("market://details?id=$pkgName")
+                    ).setFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK)
+                )
+                return null
+            }
+            return pkgInfo.applicationInfo.nativeLibraryDir
+        }
+        return ctx.applicationInfo.nativeLibraryDir
+    }
+
+    companion object {
+        fun getGames(ctx: Context, file: DocumentFile): List<Game> {
+            val games = mutableListOf<Game>()
+
+            if (checkIfGamedir(file)) {
+                games.add(Game(ctx, file))
+            } else {
+                file.listFiles().forEach {
+                    if (it.isDirectory) {
+                        if (checkIfGamedir(it)) {
+                            games.add(Game(ctx, it))
+                        }
+                    }
+                }
+            }
+
+            return games
+        }
+
+        fun checkIfGamedir(file: DocumentFile): Boolean {
+            // exclude unfinished downloads
+            if (file.name?.startsWith('.') == true)
+                return false
+
+            file.findFile("liblist.gam")?.let { return true }
+            file.findFile("gameinfo.txt")?.let { return true }
+            return false
+        }
+    }
+}
+
+//    Intent intent = new Intent("su.xash.engine.MOD");
+//                for (ResolveInfo info : context.getPackageManager()
+//                        .queryIntentActivities(intent, PackageManager.GET_META_DATA)) {
+//                        String packageName = info.activityInfo.applicationInfo.packageName;
+//                        String gameDir = info.activityInfo.applicationInfo.metaData.getString(
+//                        "su.xash.engine.gamedir");
+//                        Log.d(TAG, "package = " + packageName + " gamedir = " + gameDir);
+//                        }
+
+//public void startEngine(Context context) {
+//    context.startActivity(new Intent(context, XashActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP).putExtra("gamedir", getGameDir()).putExtra("argv", getArguments()).putExtra("usevolume", getVolumeState()).putExtra("gamelibdir", getGameLibDir(context)).putExtra("package", getPackageName()));
+//}

android/app/src/main/java/su/xash/engine/model/ModDatabase.kt

@@ -0,0 +1,59 @@
+package su.xash.engine.model
+
+import org.json.JSONArray
+import org.json.JSONObject
+import java.io.InputStream
+
+class ModDatabase(inputStream: InputStream) {
+    val entries = mutableListOf<Entry>()
+
+    companion object {
+        const val VERSION = 1
+
+        fun getFilename(): String {
+            return "v${VERSION}.json"
+        }
+    }
+
+    init {
+        inputStream.bufferedReader().use {
+            val jsonArray = JSONArray(it.readText())
+
+            for (i in 0..<jsonArray.length()) {
+                entries.add(Entry(jsonArray.getJSONObject(i)))
+            }
+        }
+    }
+
+    fun getByGameDir(gamedir: String): Entry? {
+        return entries.filter { it.gamedir.equals(gamedir) }.firstOrNull()
+    }
+
+
+    inner class Entry(jsonObject: JSONObject) {
+        var name: String? = null
+        var appid: Int? = null
+        var gamedir: String? = null
+
+        // TODO Depots
+        var pkgname: String? = null
+
+        init {
+            if (jsonObject.has("name")) {
+                name = jsonObject.getString("name");
+            }
+
+            if (jsonObject.has("app_id")) {
+                appid = jsonObject.getInt("app_id");
+            }
+
+            if (jsonObject.has("gamedir")) {
+                gamedir = jsonObject.getString("gamedir");
+            }
+
+            if (jsonObject.has("package_name")) {
+                pkgname = jsonObject.getString("package_name");
+            }
+        }
+    }
+}

android/app/src/main/java/su/xash/engine/ui/library/LibraryFragment.kt

@@ -0,0 +1,94 @@
+package su.xash.engine.ui.library
+
+import android.annotation.SuppressLint
+import android.content.Intent
+import android.os.Bundle
+import android.util.Log
+import android.view.LayoutInflater
+import android.view.Menu
+import android.view.MenuInflater
+import android.view.MenuItem
+import android.view.View
+import android.view.ViewGroup
+import androidx.core.view.MenuProvider
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.lifecycle.Lifecycle
+import androidx.lifecycle.lifecycleScope
+import androidx.lifecycle.repeatOnLifecycle
+import androidx.navigation.fragment.findNavController
+import kotlinx.coroutines.launch
+import su.xash.engine.R
+import su.xash.engine.adapters.GameAdapter
+import su.xash.engine.databinding.FragmentLibraryBinding
+
+class LibraryFragment : Fragment(), MenuProvider {
+    private var _binding: FragmentLibraryBinding? = null
+    private val binding get() = _binding!!
+
+    private val libraryViewModel: LibraryViewModel by activityViewModels()
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = FragmentLibraryBinding.inflate(inflater, container, false)
+
+        val adapter = GameAdapter(libraryViewModel)
+        binding.gamesList.adapter = adapter
+
+        requireActivity().addMenuProvider(this, viewLifecycleOwner, Lifecycle.State.RESUMED)
+
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        binding.swipeRefresh.setOnRefreshListener { libraryViewModel.reloadGames(requireContext()) }
+
+        libraryViewModel.isReloading.observe(viewLifecycleOwner) {
+            binding.swipeRefresh.isRefreshing = it
+        }
+
+        libraryViewModel.installedGames.observe(viewLifecycleOwner) {
+            (binding.gamesList.adapter as GameAdapter).submitList(it)
+        }
+
+        libraryViewModel.workInfos.observe(viewLifecycleOwner) {
+            libraryViewModel.refreshDownloads(requireContext())
+        }
+
+        libraryViewModel.downloads.observe(viewLifecycleOwner) {
+            libraryViewModel.reloadGames(requireContext())
+        }
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+
+    override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
+        menuInflater.inflate(R.menu.menu_library, menu)
+    }
+
+    override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
+        when (menuItem.itemId) {
+            R.id.action_browse -> {
+                startActivity(
+                    Intent(Intent.ACTION_VIEW).setDataAndType(
+                        null, "vnd.android.document/directory"
+                    )
+                )
+            }
+
+            R.id.action_install -> {
+                findNavController().navigate(R.id.action_libraryFragment_to_setupFragment)
+            }
+
+            R.id.action_settings -> {
+                findNavController().navigate(R.id.action_libraryFragment_to_appSettingsFragment)
+            }
+        }
+
+        return false
+    }
+}

android/app/src/main/java/su/xash/engine/ui/library/LibraryViewModel.kt

@@ -0,0 +1,127 @@
+package su.xash.engine.ui.library
+
+import android.app.Application
+import android.content.Context
+import android.content.SharedPreferences
+import android.net.Uri
+import androidx.documentfile.provider.DocumentFile
+import androidx.lifecycle.AndroidViewModel
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.lifecycleScope
+import androidx.lifecycle.viewModelScope
+import androidx.preference.PreferenceManager
+import androidx.work.Data
+import androidx.work.OneTimeWorkRequestBuilder
+import androidx.work.OutOfQuotaPolicy
+import androidx.work.WorkInfo
+import androidx.work.WorkManager
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
+import su.xash.engine.model.Game
+import su.xash.engine.model.ModDatabase
+import su.xash.engine.workers.FileCopyWorker
+import su.xash.engine.workers.KEY_FILE_URI
+import java.util.Locale
+
+const val TAG_INSTALL = "TAG_INSTALL"
+
+class LibraryViewModel(application: Application) : AndroidViewModel(application) {
+    val installedGames: LiveData<List<Game>> get() = _installedGames
+    private val _installedGames = MutableLiveData(emptyList<Game>())
+
+    val downloads: LiveData<List<Game>> get() = _downloads
+    private val _downloads = MutableLiveData(emptyList<Game>())
+
+    val isReloading: LiveData<Boolean> get() = _isReloading
+    private val _isReloading = MutableLiveData(false)
+
+    private val workManager = WorkManager.getInstance(application.applicationContext)
+    val workInfos: LiveData<List<WorkInfo>> = workManager.getWorkInfosByTagLiveData(TAG_INSTALL)
+
+    val selectedItem: LiveData<Game> get() = _selectedItem
+    private val _selectedItem = MutableLiveData<Game>()
+
+    val appPreferences = application.getSharedPreferences("app_preferences", Context.MODE_PRIVATE)
+    val modDb: ModDatabase
+
+    init {
+        modDb = application.assets.open(ModDatabase.getFilename()).use { ModDatabase(it) }
+        reloadGames(application.applicationContext)
+    }
+
+    fun reloadGames(ctx: Context) {
+        if (isReloading.value == true) {
+            return
+        }
+        _isReloading.value = true
+
+        viewModelScope.launch {
+            withContext(Dispatchers.IO) {
+                val games = mutableListOf<Game>()
+                val root = DocumentFile.fromFile(ctx.getExternalFilesDir(null)!!)
+
+                val installedGames = Game.getGames(ctx, root)
+                    .filter { p -> _downloads.value?.any { p.basedir.name == it.basedir.name } == false }
+
+                games.addAll(installedGames)
+                downloads.value?.let { games.addAll(it) }
+
+                _installedGames.postValue(games)
+                _isReloading.postValue(false)
+            }
+        }
+    }
+
+    fun refreshDownloads(ctx: Context) {
+        viewModelScope.launch {
+            withContext(Dispatchers.IO) {
+                val games = mutableListOf<Game>()
+
+                workInfos.value?.filter {
+                    it.state == WorkInfo.State.RUNNING && !it.progress.getString(FileCopyWorker.Input)
+                        .isNullOrEmpty()
+                }?.forEach {
+                    val uri = Uri.parse(it.progress.getString(FileCopyWorker.Input))
+                    val file = DocumentFile.fromTreeUri(ctx, uri)
+                    games.addAll(Game.getGames(ctx, file!!))
+                    games.forEach { g -> g.installed = false }
+                }
+
+                _downloads.postValue(games)
+            }
+        }
+    }
+
+    fun installGame(uri: Uri) {
+        val data = Data.Builder().putString(KEY_FILE_URI, uri.toString()).build()
+        val request = OneTimeWorkRequestBuilder<FileCopyWorker>().run {
+            setInputData(data)
+            addTag(TAG_INSTALL)
+            build()
+        }
+        workManager.enqueue(request)
+    }
+
+    fun setSelectedGame(game: Game) {
+        _selectedItem.value = game
+    }
+
+    fun uninstallGame(game: Game) {
+        viewModelScope.launch {
+            withContext(Dispatchers.IO) {
+                game.installed = false
+                game.basedir.delete()
+                _installedGames.postValue(_installedGames.value)
+            }
+        }
+    }
+
+    fun startEngine(ctx: Context, game: Game) {
+        game.startEngine(ctx)
+    }
+}

android/app/src/main/java/su/xash/engine/ui/settings/AppSettingsFragment.kt

@@ -0,0 +1,31 @@
+package su.xash.engine.ui.settings
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import su.xash.engine.databinding.FragmentAppSettingsBinding
+
+class AppSettingsFragment : Fragment() {
+    private var _binding: FragmentAppSettingsBinding? = null
+    private val binding get() = _binding!!
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = FragmentAppSettingsBinding.inflate(inflater, container, false)
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+        childFragmentManager.beginTransaction()
+            .add(binding.settingsFragment.id, AppSettingsPreferenceFragment()).commit();
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+}

android/app/src/main/java/su/xash/engine/ui/settings/AppSettingsPreferenceFragment.kt

@@ -0,0 +1,12 @@
+package su.xash.engine.ui.settings
+
+import android.os.Bundle
+import androidx.preference.PreferenceFragmentCompat
+import su.xash.engine.R
+
+class AppSettingsPreferenceFragment() : PreferenceFragmentCompat() {
+    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
+        preferenceManager.sharedPreferencesName = "app_preferences";
+        setPreferencesFromResource(R.xml.app_preferences, rootKey);
+    }
+}

android/app/src/main/java/su/xash/engine/ui/settings/GameSettingsFragment.kt

@@ -0,0 +1,64 @@
+package su.xash.engine.ui.settings
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.navigation.fragment.findNavController
+import su.xash.engine.R
+import su.xash.engine.databinding.FragmentGameSettingsBinding
+import su.xash.engine.ui.library.LibraryViewModel
+
+class GameSettingsFragment : Fragment() {
+    private var _binding: FragmentGameSettingsBinding? = null
+    private val binding get() = _binding!!
+
+    private val libraryViewModel: LibraryViewModel by activityViewModels()
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = FragmentGameSettingsBinding.inflate(inflater, container, false)
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+
+        val game = libraryViewModel.selectedItem.value!!
+
+        binding.gameCard.apply {
+            gameTitle.text = game.title
+
+            if (game.icon != null) {
+                gameIcon.setImageBitmap(game.icon)
+            } else {
+                gameIcon.visibility = View.GONE
+            }
+
+            if (game.cover != null) {
+                gameCover.setImageBitmap(game.cover)
+            } else {
+                gameCover.visibility = View.GONE
+            }
+
+            buttonsContainer.visibility = View.GONE
+        }
+
+        childFragmentManager.beginTransaction()
+            .add(binding.settingsFragment.id, GameSettingsPreferenceFragment(game))
+            .commit();
+
+        binding.bottomNavigation.menu.findItem(R.id.action_uninstall).setOnMenuItemClickListener {
+            libraryViewModel.uninstallGame(game)
+            findNavController().popBackStack()
+        }
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+}

android/app/src/main/java/su/xash/engine/ui/settings/GameSettingsPreferenceFragment.kt

@@ -0,0 +1,40 @@
+package su.xash.engine.ui.settings
+
+import android.os.Bundle
+import androidx.preference.ListPreference
+import androidx.preference.PreferenceFragmentCompat
+import androidx.preference.SwitchPreferenceCompat
+import su.xash.engine.R
+import su.xash.engine.model.Game
+
+class GameSettingsPreferenceFragment(val game: Game) : PreferenceFragmentCompat() {
+    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
+        preferenceManager.sharedPreferencesName = game.basedir.name;
+        setPreferencesFromResource(R.xml.game_preferences, rootKey);
+
+        val packageList = findPreference<ListPreference>("package_name")!!
+        packageList.entries = arrayOf(getString(R.string.app_name))
+        packageList.entryValues = arrayOf(requireContext().packageName)
+
+        if (packageList.value == null) {
+            packageList.setValueIndex(0);
+        }
+
+        val separatePackages = findPreference<SwitchPreferenceCompat>("separate_libraries")!!
+        val clientPackage = findPreference<ListPreference>("client_package")!!
+        val serverPackage = findPreference<ListPreference>("server_package")!!
+        separatePackages.setOnPreferenceChangeListener { _, newValue ->
+            if (newValue == true) {
+                packageList.isVisible = false
+                clientPackage.isVisible = true
+                serverPackage.isVisible = true
+            } else {
+                packageList.isVisible = true
+                clientPackage.isVisible = false
+                serverPackage.isVisible = false
+            }
+
+            true
+        }
+    }
+}

android/app/src/main/java/su/xash/engine/ui/setup/SetupFragment.kt

@@ -0,0 +1,48 @@
+package su.xash.engine.ui.setup
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.viewpager2.adapter.FragmentStateAdapter
+import su.xash.engine.databinding.FragmentSetupBinding
+import su.xash.engine.ui.setup.pages.LocationPageFragment
+import su.xash.engine.ui.setup.pages.WelcomePageFragment
+
+class SetupFragment : Fragment() {
+    private var _binding: FragmentSetupBinding? = null
+    private val binding get() = _binding!!
+    private val setupViewModel: SetupViewModel by activityViewModels()
+
+    private lateinit var setupPageAdapter: SetupPageAdapter
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = FragmentSetupBinding.inflate(inflater, container, false)
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        setupPageAdapter = SetupPageAdapter(this)
+        binding.viewPager.isUserInputEnabled = false
+        binding.viewPager.adapter = setupPageAdapter
+
+        setupViewModel.pageNumber.observe(viewLifecycleOwner) {
+            binding.viewPager.setCurrentItem(it, true)
+        }
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+}
+
+class SetupPageAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {
+    val pages = listOf(WelcomePageFragment(), LocationPageFragment())
+    override fun getItemCount(): Int = 2
+    override fun createFragment(position: Int): Fragment = pages[position]
+}

android/app/src/main/java/su/xash/engine/ui/setup/SetupViewModel.kt

@@ -0,0 +1,25 @@
+package su.xash.engine.ui.setup
+
+import android.app.Application
+import android.net.Uri
+import androidx.documentfile.provider.DocumentFile
+import androidx.lifecycle.AndroidViewModel
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import su.xash.engine.MainApplication
+import su.xash.engine.model.Game
+
+class SetupViewModel(application: Application) : AndroidViewModel(application) {
+    val pageNumber: LiveData<Int> get() = _pageNumber
+    private val _pageNumber = MutableLiveData(0)
+
+    fun checkIfGameDir(uri: Uri): Boolean {
+        val ctx = getApplication<MainApplication>().applicationContext
+        val file = DocumentFile.fromTreeUri(ctx, uri)!!
+        return Game.checkIfGamedir(file)
+    }
+
+    fun setPageNumber(pos: Int) {
+        _pageNumber.value = pos
+    }
+}

android/app/src/main/java/su/xash/engine/ui/setup/pages/LocationPageFragment.kt

@@ -0,0 +1,59 @@
+package su.xash.engine.ui.setup.pages
+
+import android.content.Intent
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.navigation.fragment.findNavController
+import com.google.android.material.dialog.MaterialAlertDialogBuilder
+import su.xash.engine.R
+import su.xash.engine.databinding.PageLocationBinding
+import su.xash.engine.ui.library.LibraryViewModel
+import su.xash.engine.ui.setup.SetupViewModel
+
+class LocationPageFragment : Fragment() {
+    private var _binding: PageLocationBinding? = null
+    private val binding get() = _binding!!
+    private val setupViewModel: SetupViewModel by activityViewModels()
+    private val libraryViewModel: LibraryViewModel by activityViewModels()
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = PageLocationBinding.inflate(inflater, container, false)
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        binding.pageButton.setOnClickListener {
+            getGamesDirectory.launch(null)
+        }
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+
+    private val getGamesDirectory =
+        registerForActivityResult(ActivityResultContracts.OpenDocumentTree()) {
+            it?.let {
+                if (!setupViewModel.checkIfGameDir(it)) {
+                    MaterialAlertDialogBuilder(requireContext()).apply {
+                        setTitle(R.string.error)
+                        setMessage(R.string.setup_location_empty)
+                        setPositiveButton(R.string.ok) { dialog, _ -> dialog.dismiss() }
+                        show()
+                    }
+                } else {
+                    requireContext().contentResolver.takePersistableUriPermission(it, Intent.FLAG_GRANT_READ_URI_PERMISSION)
+                    libraryViewModel.installGame(it)
+                    findNavController().navigate(R.id.action_setupFragment_to_libraryFragment)
+                }
+            }
+        }
+}

android/app/src/main/java/su/xash/engine/ui/setup/pages/WelcomePageFragment.kt

@@ -0,0 +1,35 @@
+package su.xash.engine.ui.setup.pages
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import su.xash.engine.databinding.PageWelcomeBinding
+import su.xash.engine.ui.setup.SetupViewModel
+
+class WelcomePageFragment : Fragment() {
+    private var _binding: PageWelcomeBinding? = null
+    private val binding get() = _binding!!
+    private val setupViewModel: SetupViewModel by activityViewModels()
+
+    override fun onCreateView(
+        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
+    ): View? {
+        _binding = PageWelcomeBinding.inflate(inflater, container, false)
+        return binding.root
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        binding.pageButton.setOnClickListener {
+            setupViewModel.setPageNumber(1)
+        }
+        setupViewModel.setPageNumber(0)
+    }
+
+    override fun onDestroyView() {
+        super.onDestroyView()
+        _binding = null
+    }
+}

android/app/src/main/java/su/xash/engine/util/TGAReader.java

@@ -0,0 +1,589 @@
+/**
+ * TGAReader.java
+ * <p>
+ * Copyright (c) 2014 Kenji Sasaki
+ * Released under the MIT license.
+ * https://github.com/npedotnet/TGAReader/blob/master/LICENSE
+ * <p>
+ * English document
+ * https://github.com/npedotnet/TGAReader/blob/master/README.md
+ * <p>
+ * Japanese document
+ * http://3dtech.jp/wiki/index.php?TGAReader
+ */
+
+package su.xash.engine.util;
+
+import java.io.IOException;
+
+public final class TGAReader {
+
+    public static final Order ARGB = new Order(16, 8, 0, 24);
+    public static final Order ABGR = new Order(0, 8, 16, 24);
+
+    public static int getWidth(byte[] buffer) {
+        return (buffer[12] & 0xFF) | (buffer[13] & 0xFF) << 8;
+    }
+
+    public static int getHeight(byte[] buffer) {
+        return (buffer[14] & 0xFF) | (buffer[15] & 0xFF) << 8;
+    }
+
+    public static int[] read(byte[] buffer, Order order) throws IOException {
+
+        // header
+//		int idFieldLength = buffer[0] & 0xFF;
+//		int colormapType = buffer[1] & 0xFF;
+        int type = buffer[2] & 0xFF;
+        int colormapOrigin = (buffer[3] & 0xFF) | (buffer[4] & 0xFF) << 8;
+        int colormapLength = (buffer[5] & 0xFF) | (buffer[6] & 0xFF) << 8;
+        int colormapDepth = buffer[7] & 0xFF;
+//		int originX = (buffer[8] & 0xFF) | (buffer[9] & 0xFF) << 8; // unsupported
+//		int originY = (buffer[10] & 0xFF) | (buffer[11] & 0xFF) << 8; // unsupported
+        int width = getWidth(buffer);
+        int height = getHeight(buffer);
+        int depth = buffer[16] & 0xFF;
+        int descriptor = buffer[17] & 0xFF;
+
+        int[] pixels;
+
+        // data
+        switch (type) {
+            case COLORMAP: {
+                int imageDataOffset = 18 + (colormapDepth / 8) * colormapLength;
+                pixels = createPixelsFromColormap(width, height, colormapDepth, buffer, imageDataOffset, buffer, colormapOrigin, descriptor, order);
+            }
+            break;
+            case RGB:
+                pixels = createPixelsFromRGB(width, height, depth, buffer, 18, descriptor, order);
+                break;
+            case GRAYSCALE:
+                pixels = createPixelsFromGrayscale(width, height, depth, buffer, 18, descriptor, order);
+                break;
+            case COLORMAP_RLE: {
+                int imageDataOffset = 18 + (colormapDepth / 8) * colormapLength;
+                byte[] decodeBuffer = decodeRLE(width, height, depth, buffer, imageDataOffset);
+                pixels = createPixelsFromColormap(width, height, colormapDepth, decodeBuffer, 0, buffer, colormapOrigin, descriptor, order);
+            }
+            break;
+            case RGB_RLE: {
+                byte[] decodeBuffer = decodeRLE(width, height, depth, buffer, 18);
+                pixels = createPixelsFromRGB(width, height, depth, decodeBuffer, 0, descriptor, order);
+            }
+            break;
+            case GRAYSCALE_RLE: {
+                byte[] decodeBuffer = decodeRLE(width, height, depth, buffer, 18);
+                pixels = createPixelsFromGrayscale(width, height, depth, decodeBuffer, 0, descriptor, order);
+            }
+            break;
+            default:
+                throw new IOException("Unsupported image type: " + type);
+        }
+
+        return pixels;
+
+    }
+
+    private static final int COLORMAP = 1;
+    private static final int RGB = 2;
+    private static final int GRAYSCALE = 3;
+    private static final int COLORMAP_RLE = 9;
+    private static final int RGB_RLE = 10;
+    private static final int GRAYSCALE_RLE = 11;
+
+    private static final int RIGHT_ORIGIN = 0x10;
+    private static final int UPPER_ORIGIN = 0x20;
+
+    private static byte[] decodeRLE(int width, int height, int depth, byte[] buffer, int offset) {
+        int elementCount = depth / 8;
+        byte[] elements = new byte[elementCount];
+        int decodeBufferLength = elementCount * width * height;
+        byte[] decodeBuffer = new byte[decodeBufferLength];
+        int decoded = 0;
+        while (decoded < decodeBufferLength) {
+            int packet = buffer[offset++] & 0xFF;
+            if ((packet & 0x80) != 0) { // RLE
+                for (int i = 0; i < elementCount; i++) {
+                    elements[i] = buffer[offset++];
+                }
+                int count = (packet & 0x7F) + 1;
+                for (int i = 0; i < count; i++) {
+                    for (int j = 0; j < elementCount; j++) {
+                        decodeBuffer[decoded++] = elements[j];
+                    }
+                }
+            } else { // RAW
+                int count = (packet + 1) * elementCount;
+                for (int i = 0; i < count; i++) {
+                    decodeBuffer[decoded++] = buffer[offset++];
+                }
+            }
+        }
+        return decodeBuffer;
+    }
+
+    private static int[] createPixelsFromColormap(int width, int height, int depth, byte[] bytes, int offset, byte[] palette, int colormapOrigin, int descriptor, Order order) throws IOException {
+        int[] pixels;
+        int rs = order.redShift;
+        int gs = order.greenShift;
+        int bs = order.blueShift;
+        int as = order.alphaShift;
+        switch (depth) {
+            case 24:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 3 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * i + (width - j - 1)] = color;
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 3 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * (height - i - 1) + (width - j - 1)] = color;
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 3 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * i + j] = color;
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 3 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * (height - i - 1) + j] = color;
+                            }
+                        }
+                    }
+                }
+                break;
+            case 32:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 4 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = palette[index + 3] & 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * i + (width - j - 1)] = color;
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 4 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = palette[index + 3] & 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * (height - i - 1) + (width - j - 1)] = color;
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 4 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = palette[index + 3] & 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * i + j] = color;
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int colormapIndex = bytes[offset + width * i + j] &
+                                        0xFF - colormapOrigin;
+                                int color = 0xFFFFFFFF;
+                                if (colormapIndex >= 0) {
+                                    int index = 4 * colormapIndex + 18;
+                                    int b = palette[index] & 0xFF;
+                                    int g = palette[index + 1] & 0xFF;
+                                    int r = palette[index + 2] & 0xFF;
+                                    int a = palette[index + 3] & 0xFF;
+                                    color = (r << rs) | (g << gs) | (b << bs) | (a << as);
+                                }
+                                pixels[width * (height - i - 1) + j] = color;
+                            }
+                        }
+                    }
+                }
+                break;
+            default:
+                throw new IOException("Unsupported depth:" + depth);
+        }
+        return pixels;
+    }
+
+    private static int[] createPixelsFromRGB(int width, int height, int depth, byte[] bytes, int offset, int descriptor, Order order) throws IOException {
+        int[] pixels;
+        int rs = order.redShift;
+        int gs = order.greenShift;
+        int bs = order.blueShift;
+        int as = order.alphaShift;
+        switch (depth) {
+            case 24:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 3 * width * i + 3 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * i + (width - j - 1)] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 3 * width * i + 3 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * (height - i - 1) + (width - j - 1)] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 3 * width * i + 3 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * i + j] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 3 * width * i + 3 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * (height - i - 1) + j] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                }
+                break;
+            case 32:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 4 * width * i + 4 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = bytes[index + 3] & 0xFF;
+                                pixels[width * i + (width - j - 1)] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 4 * width * i + 4 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = bytes[index + 3] & 0xFF;
+                                pixels[width * (height - i - 1) + (width - j - 1)] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 4 * width * i + 4 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = bytes[index + 3] & 0xFF;
+                                pixels[width * i + j] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int index = offset + 4 * width * i + 4 * j;
+                                int b = bytes[index] & 0xFF;
+                                int g = bytes[index + 1] & 0xFF;
+                                int r = bytes[index + 2] & 0xFF;
+                                int a = bytes[index + 3] & 0xFF;
+                                pixels[width * (height - i - 1) + j] = (r << rs) |
+                                        (g << gs) |
+                                        (b << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                }
+                break;
+            default:
+                throw new IOException("Unsupported depth:" + depth);
+        }
+        return pixels;
+    }
+
+    private static int[] createPixelsFromGrayscale(int width, int height, int depth, byte[] bytes, int offset, int descriptor, Order order) throws IOException {
+        int[] pixels;
+        int rs = order.redShift;
+        int gs = order.greenShift;
+        int bs = order.blueShift;
+        int as = order.alphaShift;
+        switch (depth) {
+            case 8:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + width * i + j] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * i + (width - j - 1)] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + width * i + j] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * (height - i - 1) + (width - j - 1)] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + width * i + j] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * i + j] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + width * i + j] & 0xFF;
+                                int a = 0xFF;
+                                pixels[width * (height - i - 1) + j] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                }
+                break;
+            case 16:
+                pixels = new int[width * height];
+                if ((descriptor & RIGHT_ORIGIN) != 0) {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + 2 * width * i + 2 * j] & 0xFF;
+                                int a = bytes[offset + 2 * width * i + 2 * j + 1] & 0xFF;
+                                pixels[width * i + (width - j - 1)] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerRight
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + 2 * width * i + 2 * j] & 0xFF;
+                                int a = bytes[offset + 2 * width * i + 2 * j + 1] & 0xFF;
+                                pixels[width * (height - i - 1) + (width - j - 1)] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                } else {
+                    if ((descriptor & UPPER_ORIGIN) != 0) {
+                        // UpperLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + 2 * width * i + 2 * j] & 0xFF;
+                                int a = bytes[offset + 2 * width * i + 2 * j + 1] & 0xFF;
+                                pixels[width * i + j] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    } else {
+                        // LowerLeft
+                        for (int i = 0; i < height; i++) {
+                            for (int j = 0; j < width; j++) {
+                                int e = bytes[offset + 2 * width * i + 2 * j] & 0xFF;
+                                int a = bytes[offset + 2 * width * i + 2 * j + 1] & 0xFF;
+                                pixels[width * (height - i - 1) + j] = (e << rs) |
+                                        (e << gs) |
+                                        (e << bs) |
+                                        (a << as);
+                            }
+                        }
+                    }
+                }
+                break;
+            default:
+                throw new IOException("Unsupported depth:" + depth);
+        }
+        return pixels;
+    }
+
+    private TGAReader() {
+    }
+
+    public static final class Order {
+        Order(int redShift, int greenShift, int blueShift, int alphaShift) {
+            this.redShift = redShift;
+            this.greenShift = greenShift;
+            this.blueShift = blueShift;
+            this.alphaShift = alphaShift;
+        }
+
+        public int redShift;
+        public int greenShift;
+        public int blueShift;
+        public int alphaShift;
+    }
+
+}

android/app/src/main/java/su/xash/engine/workers/FileCopyWorker.kt

@@ -0,0 +1,97 @@
+package su.xash.engine.workers
+
+import android.content.Context
+import android.net.Uri
+import androidx.documentfile.provider.DocumentFile
+import androidx.work.CoroutineWorker
+import androidx.work.WorkerParameters
+import androidx.work.workDataOf
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+const val KEY_FILE_URI = "KEY_FILE_URI"
+
+class FileCopyWorker(ctx: Context, params: WorkerParameters) : CoroutineWorker(ctx, params) {
+    companion object {
+        const val Input = "Input"
+        const val Progress = "Progress"
+    }
+
+    private var fileCount = 0
+    private var fileCopied = 0
+
+    override suspend fun doWork(): Result {
+        withContext(Dispatchers.IO) {
+            val fileUri = inputData.getString(KEY_FILE_URI)
+            setProgress(workDataOf(Input to fileUri))
+
+            val uri = Uri.parse(fileUri)
+            val source = DocumentFile.fromTreeUri(applicationContext, uri)
+
+            fileCount = source?.countDirFiles() ?: return@withContext Result.failure()
+
+            setProgress(workDataOf(Progress to 0f))
+
+            val gamedir = source.name!!
+            val externalFilesDir = DocumentFile.fromFile(applicationContext.getExternalFilesDir(null)!!)
+
+            // create a directory to store staged files
+            val target = externalFilesDir.createDirectory(".$gamedir")!!
+
+            source.copyDirTo(applicationContext, this@FileCopyWorker, target)
+
+            target.renameTo(gamedir)
+
+            setProgress(workDataOf(Progress to 1f))
+        }
+        return Result.success()
+    }
+
+    suspend fun fileCopied(count: Int) {
+        if(count == 0)
+            return
+
+        fileCopied += count
+        val percentage: Float = fileCopied.toFloat() / fileCount.toFloat();
+        setProgress(workDataOf(Progress to percentage))
+    }
+}
+
+fun DocumentFile.countDirFiles(): Int {
+    var count: Int = 0
+
+    listFiles().forEach {
+        if (it.isDirectory)
+            count += it.countDirFiles()
+        else
+            count++
+    }
+
+    return count
+}
+
+fun DocumentFile.copyFileTo(ctx: Context, file: DocumentFile) {
+    val outFile = file.createFile("application", name!!)!!
+
+    ctx.contentResolver.openOutputStream(outFile.uri).use { os ->
+        ctx.contentResolver.openInputStream(uri).use {
+            it?.copyTo(os!!)
+        }
+    }
+}
+
+suspend fun DocumentFile.copyDirTo(ctx: Context, worker: FileCopyWorker, dir: DocumentFile) {
+    var count: Int = 0
+
+    listFiles().forEach {
+        if (it.isDirectory) {
+            val outDir = dir.createDirectory(it.name!!)!!
+            it.copyDirTo(ctx, worker, outDir)
+        } else {
+            it.copyFileTo(ctx, dir)
+            count++
+        }
+    }
+
+    worker.fileCopied(count)
+}

android/app/src/main/res/drawable/ic_baseline_add_24.xml

@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:tint="?attr/colorControlNormal"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="@android:color/white"
+        android:pathData="M19,13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z" />
+</vector>

android/app/src/main/res/drawable/ic_baseline_delete_24.xml

@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:tint="?attr/colorControlNormal"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="@android:color/white"
+        android:pathData="M6,19c0,1.1 0.9,2 2,2h8c1.1,0 2,-0.9 2,-2V7H6v12zM19,4h-3.5l-1,-1h-5l-1,1H5v2h14V4z" />
+</vector>

android/app/src/main/res/drawable/ic_baseline_folder_open_24.xml

@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:tint="?attr/colorControlNormal"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="@android:color/white"
+        android:pathData="M20,6h-8l-2,-2L4,4c-1.1,0 -1.99,0.9 -1.99,2L2,18c0,1.1 0.9,2 2,2h16c1.1,0 2,-0.9 2,-2L22,8c0,-1.1 -0.9,-2 -2,-2zM20,18L4,18L4,8h16v10z" />
+</vector>

android/app/src/main/res/drawable/ic_baseline_key_24.xml

@@ -0,0 +1,5 @@
+<vector android:height="24dp" android:tint="#000000"
+    android:viewportHeight="24" android:viewportWidth="24"
+    android:width="24dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@android:color/white" android:pathData="M21,10h-8.35C11.83,7.67 9.61,6 7,6c-3.31,0 -6,2.69 -6,6s2.69,6 6,6c2.61,0 4.83,-1.67 5.65,-4H13l2,2l2,-2l2,2l4,-4.04L21,10zM7,15c-1.65,0 -3,-1.35 -3,-3c0,-1.65 1.35,-3 3,-3s3,1.35 3,3C10,13.65 8.65,15 7,15z"/>
+</vector>

android/app/src/main/res/drawable/ic_baseline_person_24.xml

@@ -0,0 +1,5 @@
+<vector android:height="24dp" android:tint="#000000"
+    android:viewportHeight="24" android:viewportWidth="24"
+    android:width="24dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@android:color/white" android:pathData="M12,12c2.21,0 4,-1.79 4,-4s-1.79,-4 -4,-4 -4,1.79 -4,4 1.79,4 4,4zM12,14c-2.67,0 -8,1.34 -8,4v2h16v-2c0,-2.66 -5.33,-4 -8,-4z"/>
+</vector>

android/app/src/main/res/drawable/ic_baseline_play_arrow_24.xml

@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:tint="#000000"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="@android:color/white"
+        android:pathData="M8,5v14l11,-7z" />
+</vector>