freelancer-hd-edition/README.md

[![GitHub release](https://img.shields.io/github/release/BC46/freelancer-hd-edition.svg)](https://GitHub.com/BC46/freelancer-hd-edition/releases/)
[![Github all releases](https://img.shields.io/github/downloads/BC46/freelancer-hd-edition/total.svg)](https://GitHub.com/BC46/freelancer-hd-edition/releases/)
[![GitHub stars](https://img.shields.io/github/stars/BC46/freelancer-hd-edition?style=social)](https://GitHub.com/BC46/freelancer-hd-edition/stargazers/)
[![Discord](https://img.shields.io/discord/873144025350295612.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/ScqgYuFqmU)

[![Mod DB](https://button.moddb.com/rating/medium/mods/51151.png)](https://www.moddb.com/mods/freelancer-hd-edition)

# Freelancer: HD Edition
Freelancer: HD Edition is a mod that aims to improve every visual, aural, and gameplay aspect of the game Freelancer (2003) while keeping the look and feel as close to vanilla as possible. It also serves as an all-in-one package for players so they don't have to worry about installing countless patches and mods to create the perfect HD and bug-free install.

This mod was made possible thanks to the assistance of project Freelancer: Nomad Legacy. Huge thanks to the developers for allowing us to use their textures!  
[Freelancer: Nomad Legacy website](https://freelancer2.space/en/)  
[Freelancer: Nomad Legacy Mod DB page](https://www.moddb.com/mods/freelancer-nomad-legacy)

**N.B. Freelancer: HD Edition does not add additional content op top of Freelancer but rather enhances what the game already has to offer. Although minor gameplay changes were made, Freelancer: HD Edition will always be compatible with vanilla Freelancer. Therefore, players can use this mod to play on all vanilla servers as long as the server owners allow these changes.**

Join our Discord server to stay up to date with the latest news and information! 

[![Support Server](https://img.shields.io/discord/873144025350295612.svg?label=Freelancer:%20HD%20Edition%20Discord&logo=Discord&colorB=7289da&style=for-the-badge)](https://discord.gg/ScqgYuFqmU)

## Content
### Visual
* HD Asteroids
* HD Character Models
* HD Cockpits
* HD Effects
* HD Mission & News images
* HD Nebulae
* HD Planets
* HD Ships
* HD Space objects
* HD Starspheres
* HD Startup Screen & Main Menu logo
* HD System & Universe Map
* Improved reflections
* Increased effect pool sizes
* Maximized draw distances
* New interface with new icons

### Audio
* HQ Music

### Gameplay
* Advanced Widescreen HUD
* 16:9 planetscape fixes
* Support for scrolling through menus
* Support for zooming in turret view
* Allow players to be called differently in Single Player
* Fixes in many bar scripts
* Enabled NPC paths in Multiplayer
* Include player ships in ship filter
* Make all planets spin slowly
* Set maximum level in Single Player to 40
* Show the names of zones as you enter and leave them
* Show the remaining shield and hull points of the selected target as numbers

### Misc
* 1.1 Patch
* Added more sound and general options
* Added support for running multiple instances of Freelancer on the same machine
* Added updated HUD Shift plugin
* All content from Jason's Freelancer Patch v1.25
* Direct3D 9 wrapper
* Disabled IPv6 adresses in Multiplayer Server list
* Fixed friendly jumphole in mission 6
* Fixed many typos, grammar mistakes, inconsistencies, and more, in the game's text strings
* Fixed missing/small text on 1440p and 4K displays
* Fixed MP3 codec error spam
* Fixed several incorrect/missing names and infocards in EW05, EW06, ST01, ST03 and ST03b
* Freelancer manual
* Improved infocards for unknown factions
* Improved Nomad group member names
* Make energy, shield, and hull bars solid
* No longer hide The Order and the Nomads from the factions list
* No-CD Patch
* Prevent intentional frame drops from occurring
* Realigned HUD elements
* Removed cruise speed display limit
* Removed general speed display limit
* Removed ESRB notice
* Removed unknown graphics card warning
* Show "Far" in contact list only at distances of 999.999K or higher
* Single Player console
* Smoothened jump effect
* Updated zlib.dll for better performance in Multiplayer
* Windows 10 compatibility patch (dgVoodoo2)

## Recommendations 
For the best possible experience, it is recommended to force enable anti-aliasing and anisotropic filtering for Freelancer through your GPU settings. To learn how to do this, please visit the link from your GPU manufacturer:
* NVIDIA: https://www.nvidia.com/content/Control-Panel-Help/vLatest/en-us/mergedProjects/nv3d/Manage_3D_Settings_(reference).htm
* AMD: https://www.amd.com/en/support/kb/faq/dh-012
* Intel: https://www.intel.com/content/www/us/en/support/articles/000057285/graphics.html

If you have selected the Windows 10 compatibility patch when installing this mod, you can learn how to enable native anti-aliasing and anisotropic filtering here: [How to enable native MSAA and Anisotropic Filtering with the Windows 10 compatibility patch](https://github.com/BC46/freelancer-hd-edition/wiki/How-to-enable-native-MSAA-and-Anisotropic-Filtering-with-the-Windows-10-compatibility-patch)

Due to the large file size of many textures used in this mod, some users may experience significantly longer load times during gameplay. Therefore, it is strongly recommended to install Freelancer: HD Edition on an (M.2) SSD.

## Installation instructions
**N.B. Do NOT extract the files to your Freelancer folder manually, it won't work! This mod comes with a lot of custom options that can only be configured in FLMM**
1. Make sure you have a clean installation of Freelancer
2. Download the mod from [Releases](https://github.com/BC46/freelancer-hd-edition/releases)
3. Open the .flmod file using [Freelancer Mod Manager 1.31](https://www.moddb.com/games/freelancer/downloads/freelancer-mod-manager-131)
4. Open Freelancer Mod Manager as an Administrator
5. Activate Freelancer: HD Edition

## Contributing
Have something to contribute to make the mod even better? Feel free to create a pull request or feature request! We are always open to new suggestions and improvements. Making the repository public has allowed us as a community to create the best possible HD mod for Freelancer out there since many modders from around the world have contributed to this project.

## Credits
* BC46
  - [HD Character Models](https://www.moddb.com/addons/freelancer-hd-character-models) *([Mirror](https://github.com/BC46/freelancer-hd-character-models))*
  - HD Cockpits
  - HD Explosion effects
  - HD Mission & News images
  - HD Nebulae
  - HD Nomad, Corsair, Bretonia, Blood Dragon and Utility ships
  - HD Starsphere improvements and HD Starsphere for ST03b
  - HD Startup Screen & Main Menu logo
  - HD System Map with HD Map objects
  - HUD alignment fixes
  - Improved reflections
  - Many general HD and effect additions
  - Many misc fixes
  - Many misc improvements
  - [Maximized Draw Distances](https://www.moddb.com/games/freelancer/downloads/freelancer-maximized-draw-distances) *([Mirror](https://github.com/BC46/freelancer-maximized-draw-distances))*
  - Mod script
  - Spinning planets
  - [Text Strings Revision](https://www.moddb.com/games/freelancer/downloads/freelancer-text-strings-revision) *([Mirror](https://github.com/BC46/freelancer-hd-character-models))*
* Buck Danny
  - [Unofficial FL SP 1.4 patch](https://www.moddb.com/games/freelancer/downloads/freelancer-unofficial-patch-14) *(included in Jason's Freelancer Patch)*
* crosire et al.
  - [d3d8to9](https://github.com/crosire/d3d8to9)
* Dege
  - [dgVoodoo2](http://dege.freeweb.hu/dgVoodoo2/dgVoodoo2/)
* Freestalker.fl
  - [FLHQmusics Remaster](https://www.moddb.com/games/freelancer/addons/flhqmusics-remaster-read-description)
* Hrimthur
  - [Freelancer Full-HD](https://the-starport.net/freelancer/forum/viewtopic.php?topic_id=5070)
* HUN0R
  - [Flat Interface](https://www.moddb.com/games/freelancer/addons/freelancer-flat-interface)
  - [HD Starsphere pack](https://www.moddb.com/games/freelancer/news/freelancer-hd-starsphere-pack)
  - [HD Universe Map](https://www.moddb.com/games/freelancer/news/freelancer-hd-starsphere-pack)
* Jason Hood
  - [Call Sign plugin](http://adoxa.altervista.org/freelancer/plugins.html#callsign)
  - [Console plugin](http://adoxa.altervista.org/freelancer/plugins.html#console)
  - [HUD Shift plugin](http://adoxa.altervista.org/freelancer/index.html#hudshift)
  - [Jason's Freelancer Patch v1.25](http://adoxa.altervista.org/freelancer/index.html)
  - [MP Rep plugin](http://adoxa.altervista.org/freelancer/plugins.html#mprep)
  - [MP3 Codec Fix](http://adoxa.altervista.org/freelancer/plugins.html#mp3codec)
  - [Numeric Damage plugin](http://adoxa.altervista.org/freelancer/plugins.html#numeric)
  - [Turret Zoom plugin](http://adoxa.altervista.org/freelancer/plugins.html#turretzoom)
  - [Wheel Scroll plugin](http://adoxa.altervista.org/freelancer/plugins.html#wheelscroll)
  - [Zone plugin](http://adoxa.altervista.org/freelancer/plugins.html#zone)
* Jean-loup Gailly and Mark Adler
  - [zlib](https://zlib.net/)
* Jeider, RenderG & Whiskas T-Mech
  - [Freelancer Advanced Widescreen HUD](https://www.moddb.com/mods/freelacer-advanced-widescreen-hud)
  - [Nomad Legacy HD textures pack](https://www.moddb.com/mods/nomad-legacy-hd-textures-pack)
  - [Additional textures from Freelancer: The Nomad Legacy](https://www.moddb.com/mods/freelancer-nomad-legacy)
* Louva-Deus
  - [Freelancer SDK/QuickFix](https://swat-portal.com/forum/filebase/file/619-freelancer-quickfix-1-0c/) *(included in Jason's Freelancer Patch)*
* Microsoft
  - [Freelancer Patch 1.1](https://www.moddb.com/games/freelancer/downloads/freelancer-patch-11)
* Radiant
  - [HD Textures 1.2](https://www.moddb.com/games/freelancer/addons/hd-textures-12)
* Ruppetus
  - [Planetscapes Fixed for 16:9 Resolutions](https://www.moddb.com/games/freelancer/addons/planetscapes-fixed-for-169-resolutions)
  - Many bar script fixes
* Why485
  - [The Big Huge Effects Pack](https://the-starport.net/freelancer/forum/viewtopic.php?topic_id=1317)