Game Installation Guide: Difference between revisions

From JFTSE Wiki
Jump to navigation Jump to search
Undo revision 96 by RiggedFish (talk)
Tag: Undo
Olex (talk | contribs)
No edit summary
 
Line 1: Line 1:
== <big>'''FantaTennis – Steam Deck Compatibility & Setup Guide'''</big> ==
== Overview ==


This entry documents the current working method for running FantaTennis on the Steam Deck.  
This guide explains how to install and start JFTSE / Fanta Tennis.


Due to the game’s launcher, patcher, and anti‑cheat system, it cannot be launched directly through Steam, regardless of Proton version.  
The recommended setup is the '''Windows version'''.


The procedure below outlines the reliable way to install, patch, and run the game.
The game is designed for Windows and should first be installed and tested on Windows before trying alternative setups such as Steam Deck, Linux or Mac.


== <big>'''Overview'''</big> ==
If the game does not start, shows missing DLL errors, disconnects with an old version message, or has anti-cheat related problems, see the '''[[Troubleshooting|Troubleshooting]]''' page.


FantaTennis does not natively support SteamOS or Proton.
== Recommended Platform ==


The game’s patcher and anti‑cheat fail to initialize when launched through Steam, making Desktop Mode and a Wine frontend (''Q4Wine'') mandatory.  
JFTSE / Fanta Tennis is a Windows game.


Once the initial setup is complete, your settings and input configuration persist, but the game must still be launched through Desktop Mode.
The recommended way to play is:


== <big>'''Prerequisites'''</big> ==
* Windows 10 or Windows 11
* FT_Launcher.exe
* Required redistributables installed
* Game folder excluded from antivirus / Windows Defender if needed


* Steam Deck running SteamOS (''current version'')
Alternative setups such as Steam Deck, Linux or Mac may work, but they are not the primary supported setup and can require extra steps.
*  
 
== Windows Installation ==
 
=== Step 1: Extract or Place the Game Folder ===
 
Download or extract the JFTSE / Fanta Tennis game folder.
 
Keep the game folder in a location where the launcher has permission to download, update and write files.
 
Avoid placing the game folder in protected Windows locations if possible.
 
Recommended examples:
 
* Desktop
* Documents
* A custom Games folder, such as <code>C:\Games\JFTSE</code>
 
=== Step 2: Install Microsoft Visual C++ Redistributables ===
 
The game folder includes a '''redis''' folder with required runtime installers.
 
Inside the '''redis''' folder, locate:
 
* <code>VC_redist.x64.exe</code>
* <code>VC_redist.x86.exe</code>
 
Install both versions:
 
# Double-click <code>VC_redist.x64.exe</code>.
# Follow the installer instructions.
# Accept the license agreement if prompted.
# Finish the installation.
# Double-click <code>VC_redist.x86.exe</code>.
# Follow the installer instructions again.
# Finish the installation.
 
'''Important:''' Install both the 64-bit and 32-bit versions. Some older game components may require the 32-bit runtime even on a 64-bit Windows system.
 
If you receive errors related to missing C++ components, see '''[[Troubleshooting#Fix 1: C++ 2015 (x86) is not installed|Troubleshooting: C++ Redistributable]]'''.
 
=== Step 3: Install Microsoft DirectX End-User Runtime ===
 
Inside the '''redis''' folder, locate:
 
* <code>dxwebsetup.exe</code>
 
Install DirectX:
 
# Double-click <code>dxwebsetup.exe</code>.
# The DirectX setup wizard will open.
# Click '''Next'''.
# Read and accept the license agreement.
# Continue through the setup.
# Let the installer check and install required DirectX components.
# Click '''Finish''' when the setup is complete.
 
If you receive an error such as <code>d3dx9_43.dll is missing</code>, see '''[[Troubleshooting#Fix 2: d3dx9_43.dll is missing|Troubleshooting: DirectX Runtime]]'''.
 
=== Step 4: Start the Launcher ===
 
In the game folder, locate:
 
* <code>FT_Launcher.exe</code>
 
Start the game through the launcher:
 
# Double-click <code>FT_Launcher.exe</code>.
# Let the launcher check for updates.
# Click the double rackets button to download or start the game.
# Wait until all required files are downloaded and updated.
 
'''Important:''' Always use <code>FT_Launcher.exe</code> to keep the game files up to date.
 
If the game says that you are using an old version, see '''[[Troubleshooting#Old Version Error (4002, -62)|Troubleshooting: Old Version Error]]'''.
 
=== Step 5: Add Antivirus / Windows Defender Exclusion ===
 
After the launcher has downloaded all required game files, security software may block or remove important game files.
 
The file <code>JFTSE.dll</code> is required for the game to connect to the server. It is part of the anti-cheat and game modification system.
 
If <code>JFTSE.dll</code> is deleted, quarantined or blocked, you may see an error such as:
 
<pre>
You have been disconnected because you tried to connect with an old version.
Application will now shut down.
</pre>
 
Recommended action:
 
# Open Windows Security or your antivirus software.
# Check whether <code>JFTSE.dll</code> was quarantined.
# Restore the file if needed.
# Add the full game folder to exclusions.
# Run <code>FT_Launcher.exe</code> again.
 
For more details, see '''[[Troubleshooting#Fix 3: JFTSE.dll was deleted|Troubleshooting: JFTSE.dll was deleted]]'''.
 
=== Step 6: Launch and Play ===
 
After installing the required components and updating the game:
 
# Run <code>FT_Launcher.exe</code>.
# Let the launcher check for updates.
# Start the game.
# Log in and adjust your settings if needed.
 
== Troubleshooting During Installation ==
 
If the game does not start correctly, check the following first:
 
{| class="wikitable"
! Problem
! Possible cause
! Fix
|-
| Old version error
| Missing runtime, blocked JFTSE.dll or outdated files
| See '''[[Troubleshooting#Old Version Error (4002, -62)|Old Version Error]]'''
|-
| Missing <code>d3dx9_43.dll</code>
| DirectX runtime missing
| Install DirectX from the '''redis''' folder or see '''[[Troubleshooting#Fix 2: d3dx9_43.dll is missing|DirectX Fix]]'''
|-
| Game closes or disconnects
| Anti-cheat file blocked or deleted
| Restore <code>JFTSE.dll</code> and add the game folder to exclusions
|-
| Launcher does not update correctly
| Files are outdated or launcher cannot write files
| Run <code>FT_Launcher.exe</code> and make sure the folder is not blocked
|-
| Account already logged in
| Previous session did not close properly
| Wait a few minutes or see '''[[Troubleshooting#User Already Logged In (4002, -2)|User Already Logged In]]'''
|}
 
For the full list of known issues and fixes, see the '''[[Troubleshooting|Troubleshooting]]''' page.
 
== Mac Users ==
 
JFTSE / Fanta Tennis is a Windows game.
 
Mac users may be able to run the game by installing Windows through '''Parallels Desktop'''.
 
Possible setup:
 
# Install Parallels Desktop.
# Install Windows inside Parallels.
# Install JFTSE / Fanta Tennis inside the Windows environment.
# Install the required Visual C++ Redistributables.
# Install the DirectX End-User Runtime.
# Run <code>FT_Launcher.exe</code>.
# Start the game from Windows.
 
'''Note:''' Compatibility may vary depending on the Mac model, Windows version and anti-cheat behavior.
 
For additional notes, see '''[[Troubleshooting#Mac Users|Troubleshooting: Mac Users]]'''.
 
== Steam Deck / Linux Setup ==
 
JFTSE / Fanta Tennis does not natively support SteamOS or Proton.
 
Due to the launcher, patcher and anti-cheat system, the game may not work correctly when launched directly through Steam.
 
The currently documented working method uses:
 
* Steam Deck Desktop Mode
* Q4Wine
* The Windows game files
* Manual launcher and game startup steps
 
'''Important:''' Before trying Steam Deck or Linux, it is recommended to install and test the Windows version first.
 
=== Steam Deck Prerequisites ===
 
You need:
 
* Steam Deck running SteamOS
* Desktop Mode access
* Desktop Mode access
*
* Q4Wine installed
* Q4Wine installed
*  
* JFTSE / Fanta Tennis Windows game files
* FantaTennis JTFSE game files downloaded from the official JTFSE website
*
 
== '''<big>Installation & First‑Time Setup</big>''' ==
 
<big>'''1. Switch to Desktop Mode'''</big>


* Hold the Power Button → select Switch to Desktop.
=== Step 1: Switch to Desktop Mode ===
*
* FantaTennis will not launch through Steam, regardless of Proton version.
*
* The patcher and anti‑cheat also fail under Steam’s runtime.
*
* You must launch the game from Desktop Mode every time.


'''<big>2. Download the Game</big>'''
# Hold the Power button.
# Select '''Switch to Desktop'''.


* Download the FantaTennis JTFSE installer from the official JTFSE website.
The game should be configured from Desktop Mode.
*
* Extract or place the game folder wherever you prefer on your Steam Deck’s storage.
*


<big>'''3. Install Q4Wine'''</big>
=== Step 2: Install Q4Wine ===
*
* Open Discover in Desktop Mode.
*
* Search for Q4Wine and install it.
*
* Q4Wine will serve as the launcher for both the patcher and the game executable.
*


== <big>'''Running the Patcher (<small>''Mandatory First Step''</small>)'''</big> ==
# Open Discover in Desktop Mode.
# Search for '''Q4Wine'''.
# Install Q4Wine.


<big>'''4. Launch FT_Launcher.exe via Q4Wine'''</big>
Q4Wine is used to run the launcher and game executable.


* Open Q4Wine.
=== Step 3: Run the Launcher First ===
* Add or navigate to the FantaTennis folder.
*
* Right‑click FT_Launcher.exe → Run.
*
* Open Advanced Options and set:
Priority =
(This is required for the launcher to behave correctly.)


<big>'''5. Allow the Patcher to Run'''</big>
# Open Q4Wine.
# Navigate to the JFTSE / Fanta Tennis folder.
# Run <code>FT_Launcher.exe</code>.
# Open Advanced Options.
# Set:


* The launcher will begin downloading and applying patches.
<pre>
*
Priority = 0
* Let it complete without interruption.
</pre>


<big>'''6. Do NOT Start the Game After Patching'''</big>
# Let the launcher download and apply patches.


* When the patcher finishes, do not click any BAT files or the Start button.
'''Important:''' Do not interrupt the patching process.
*
* Starting the game at this stage will cause anti‑cheat issues.


<big>'''7. Close the Patcher'''</big>
=== Step 4: Do Not Start the Game Immediately After Patching ===


* Once the folder size increases and all patches are applied, close the launcher.
After patching is complete:


<big>'''8. Close Q4Wine Completely'''</big>
# Do not click BAT files.
# Do not start the game immediately from the patcher.
# Close the launcher.
# Close Q4Wine completely.


* Ensure all Q4Wine sockets/tickets are cleared.
Optionally restart the Steam Deck to make sure Wine and anti-cheat related processes are fully closed.
*
* Optionally reboot your Steam Deck to guarantee a clean state.


== <big>'''First Actual Game Launch (<small>''Required Once''</small>)'''</big> ==
=== Step 5: First Actual Game Launch ===


<big>'''9. Launch FantaTennis.exe via Q4Wine'''</big>
After the first patching process:


* Open Q4Wine again and run FantaTennis.exe directly.
# Open Q4Wine again.
# Run <code>FantaTennis.exe</code> directly.
# Set the virtual desktop size:


<big>'''10. Set Virtual Desktop Size'''</big>
<pre>
Virtual Desktop Size = 1920x1080
</pre>


* In the Q4Wine run window, set:
# Open Advanced Options.
*
# Set:
  Virtual Desktop Size = 1920×1080


<big>'''11. Set Priority'''</big>
<pre>
Priority = 0
</pre>


* Under Advanced Options, set:
# Confirm and launch the game.


  Priority = 0
The anti-cheat may initialize required components. This can take a moment.


<big>'''12. Confirm Settings'''</big>
Do not interrupt this process.


* Click OK to launch.
=== Step 6: Regular Steam Deck Use ===


<big>'''13. Wait for Anti‑Cheat Initialization'''</big>
After the first successful launch:


* The anti‑cheat will patch and install required components.
# Run <code>FT_Launcher.exe</code> first.
*
# Let it check and apply patches.
* This may take a moment; do not interrupt it.
# Close the launcher completely.
# Run <code>FantaTennis.exe</code> directly through Q4Wine.


<big>'''14. Game Launches'''</big>
This method can help avoid anti-cheat lockups and startup issues.


* You can now log in.
=== Steam Deck Notes ===
*
* Adjust your Settings immediately:
*
* Configure controls for Steam Deck input instead of keyboard.
*
* These settings will persist for future sessions.


== <big>'''Regular Use After Initial Setup'''</big> ==
* The game must usually be launched from Desktop Mode.
* Steam / Proton direct launch may not work correctly.
* If the game hangs on the anti-cheat screen, restart the Steam Deck.
* If Q4Wine remains stuck, close it completely or reboot before trying again.


<big>'''15. Using the Launcher Normally'''</big>
== Recommended Launch Order ==


* After the first successful launch, you may return to using FT_Launcher.exe.
For Windows:
*
* This ensures the game is patched before each session.
*
* Once patched, you can launch the game normally through the launcher.


<big>'''16. Anti‑Cheat Stuck?'''</big>
# Run <code>FT_Launcher.exe</code>.
# Let the game update.
# Start the game.


* If the game hangs on the anti‑cheat screen after launching from the launcher:
For Steam Deck:
*
* Restart your Steam Deck.
* The anti‑cheat can become stuck and cannot unload itself.


<big>'''17. Recommended Reliable Startup Method'''</big>
# Run <code>FT_Launcher.exe</code> through Q4Wine.
# Let the game update.
# Close the launcher.
# Run <code>FantaTennis.exe</code> directly through Q4Wine.


'''For a guaranteed clean launch every time:'''
== Related Pages ==


* Run FT_Launcher.exe first.
* '''[[Troubleshooting]]''' – common errors and fixes.
*  
* '''[[Items]]''' – explains Item-tab objects, Quick Slot items and Buff Items.
* Let it check and apply patches.
* '''[[Stats]]''' – explains stats, attributes and secondary stats.
*  
* '''[[Enchantment]]''' – explains the Enchant system.
* Close the launcher completely.
*
* Launch FantaTennis.exe directly via Q4Wine (''same method as the first launch'').
*  
'''This avoids anti‑cheat lockups and ensures consistent startup success.'''

Latest revision as of 14:23, 5 May 2026

Overview

This guide explains how to install and start JFTSE / Fanta Tennis.

The recommended setup is the Windows version.

The game is designed for Windows and should first be installed and tested on Windows before trying alternative setups such as Steam Deck, Linux or Mac.

If the game does not start, shows missing DLL errors, disconnects with an old version message, or has anti-cheat related problems, see the Troubleshooting page.

Recommended Platform

JFTSE / Fanta Tennis is a Windows game.

The recommended way to play is:

  • Windows 10 or Windows 11
  • FT_Launcher.exe
  • Required redistributables installed
  • Game folder excluded from antivirus / Windows Defender if needed

Alternative setups such as Steam Deck, Linux or Mac may work, but they are not the primary supported setup and can require extra steps.

Windows Installation

Step 1: Extract or Place the Game Folder

Download or extract the JFTSE / Fanta Tennis game folder.

Keep the game folder in a location where the launcher has permission to download, update and write files.

Avoid placing the game folder in protected Windows locations if possible.

Recommended examples:

  • Desktop
  • Documents
  • A custom Games folder, such as C:\Games\JFTSE

Step 2: Install Microsoft Visual C++ Redistributables

The game folder includes a redis folder with required runtime installers.

Inside the redis folder, locate:

  • VC_redist.x64.exe
  • VC_redist.x86.exe

Install both versions:

  1. Double-click VC_redist.x64.exe.
  2. Follow the installer instructions.
  3. Accept the license agreement if prompted.
  4. Finish the installation.
  5. Double-click VC_redist.x86.exe.
  6. Follow the installer instructions again.
  7. Finish the installation.

Important: Install both the 64-bit and 32-bit versions. Some older game components may require the 32-bit runtime even on a 64-bit Windows system.

If you receive errors related to missing C++ components, see Troubleshooting: C++ Redistributable.

Step 3: Install Microsoft DirectX End-User Runtime

Inside the redis folder, locate:

  • dxwebsetup.exe

Install DirectX:

  1. Double-click dxwebsetup.exe.
  2. The DirectX setup wizard will open.
  3. Click Next.
  4. Read and accept the license agreement.
  5. Continue through the setup.
  6. Let the installer check and install required DirectX components.
  7. Click Finish when the setup is complete.

If you receive an error such as d3dx9_43.dll is missing, see Troubleshooting: DirectX Runtime.

Step 4: Start the Launcher

In the game folder, locate:

  • FT_Launcher.exe

Start the game through the launcher:

  1. Double-click FT_Launcher.exe.
  2. Let the launcher check for updates.
  3. Click the double rackets button to download or start the game.
  4. Wait until all required files are downloaded and updated.

Important: Always use FT_Launcher.exe to keep the game files up to date.

If the game says that you are using an old version, see Troubleshooting: Old Version Error.

Step 5: Add Antivirus / Windows Defender Exclusion

After the launcher has downloaded all required game files, security software may block or remove important game files.

The file JFTSE.dll is required for the game to connect to the server. It is part of the anti-cheat and game modification system.

If JFTSE.dll is deleted, quarantined or blocked, you may see an error such as:

You have been disconnected because you tried to connect with an old version.
Application will now shut down.

Recommended action:

  1. Open Windows Security or your antivirus software.
  2. Check whether JFTSE.dll was quarantined.
  3. Restore the file if needed.
  4. Add the full game folder to exclusions.
  5. Run FT_Launcher.exe again.

For more details, see Troubleshooting: JFTSE.dll was deleted.

Step 6: Launch and Play

After installing the required components and updating the game:

  1. Run FT_Launcher.exe.
  2. Let the launcher check for updates.
  3. Start the game.
  4. Log in and adjust your settings if needed.

Troubleshooting During Installation

If the game does not start correctly, check the following first:

Problem Possible cause Fix
Old version error Missing runtime, blocked JFTSE.dll or outdated files See Old Version Error
Missing d3dx9_43.dll DirectX runtime missing Install DirectX from the redis folder or see DirectX Fix
Game closes or disconnects Anti-cheat file blocked or deleted Restore JFTSE.dll and add the game folder to exclusions
Launcher does not update correctly Files are outdated or launcher cannot write files Run FT_Launcher.exe and make sure the folder is not blocked
Account already logged in Previous session did not close properly Wait a few minutes or see User Already Logged In

For the full list of known issues and fixes, see the Troubleshooting page.

Mac Users

JFTSE / Fanta Tennis is a Windows game.

Mac users may be able to run the game by installing Windows through Parallels Desktop.

Possible setup:

  1. Install Parallels Desktop.
  2. Install Windows inside Parallels.
  3. Install JFTSE / Fanta Tennis inside the Windows environment.
  4. Install the required Visual C++ Redistributables.
  5. Install the DirectX End-User Runtime.
  6. Run FT_Launcher.exe.
  7. Start the game from Windows.

Note: Compatibility may vary depending on the Mac model, Windows version and anti-cheat behavior.

For additional notes, see Troubleshooting: Mac Users.

Steam Deck / Linux Setup

JFTSE / Fanta Tennis does not natively support SteamOS or Proton.

Due to the launcher, patcher and anti-cheat system, the game may not work correctly when launched directly through Steam.

The currently documented working method uses:

  • Steam Deck Desktop Mode
  • Q4Wine
  • The Windows game files
  • Manual launcher and game startup steps

Important: Before trying Steam Deck or Linux, it is recommended to install and test the Windows version first.

Steam Deck Prerequisites

You need:

  • Steam Deck running SteamOS
  • Desktop Mode access
  • Q4Wine installed
  • JFTSE / Fanta Tennis Windows game files

Step 1: Switch to Desktop Mode

  1. Hold the Power button.
  2. Select Switch to Desktop.

The game should be configured from Desktop Mode.

Step 2: Install Q4Wine

  1. Open Discover in Desktop Mode.
  2. Search for Q4Wine.
  3. Install Q4Wine.

Q4Wine is used to run the launcher and game executable.

Step 3: Run the Launcher First

  1. Open Q4Wine.
  2. Navigate to the JFTSE / Fanta Tennis folder.
  3. Run FT_Launcher.exe.
  4. Open Advanced Options.
  5. Set:
Priority = 0
  1. Let the launcher download and apply patches.

Important: Do not interrupt the patching process.

Step 4: Do Not Start the Game Immediately After Patching

After patching is complete:

  1. Do not click BAT files.
  2. Do not start the game immediately from the patcher.
  3. Close the launcher.
  4. Close Q4Wine completely.

Optionally restart the Steam Deck to make sure Wine and anti-cheat related processes are fully closed.

Step 5: First Actual Game Launch

After the first patching process:

  1. Open Q4Wine again.
  2. Run FantaTennis.exe directly.
  3. Set the virtual desktop size:
Virtual Desktop Size = 1920x1080
  1. Open Advanced Options.
  2. Set:
Priority = 0
  1. Confirm and launch the game.

The anti-cheat may initialize required components. This can take a moment.

Do not interrupt this process.

Step 6: Regular Steam Deck Use

After the first successful launch:

  1. Run FT_Launcher.exe first.
  2. Let it check and apply patches.
  3. Close the launcher completely.
  4. Run FantaTennis.exe directly through Q4Wine.

This method can help avoid anti-cheat lockups and startup issues.

Steam Deck Notes

  • The game must usually be launched from Desktop Mode.
  • Steam / Proton direct launch may not work correctly.
  • If the game hangs on the anti-cheat screen, restart the Steam Deck.
  • If Q4Wine remains stuck, close it completely or reboot before trying again.

Recommended Launch Order

For Windows:

  1. Run FT_Launcher.exe.
  2. Let the game update.
  3. Start the game.

For Steam Deck:

  1. Run FT_Launcher.exe through Q4Wine.
  2. Let the game update.
  3. Close the launcher.
  4. Run FantaTennis.exe directly through Q4Wine.

Related Pages

  • Troubleshooting – common errors and fixes.
  • Items – explains Item-tab objects, Quick Slot items and Buff Items.
  • Stats – explains stats, attributes and secondary stats.
  • Enchantment – explains the Enchant system.