A modern server controller for TrackMania Forever. Latest release information, installation guidance and features are synced from GitHub.

LATEST RELEASE / Checking GitHub…
Checking GitHub…
Finding the latest published build

Download and release notes update automatically.

Release notes ↗
Get latest release GitHub Discord

Checking version… TMNF & TMUF MySQL / MariaDB GPL-3.0

pyxaseco — controller preview
Starting… 

        


        

          Illustrative startup · not connected to a live server
          0 lines
        

      

        

      

    


    

      

        
Controller overview

        for TMNF and TMUF
      


      

        PyXASECO brings records, map control, rankings, widgets and moderation tools to your TrackMania Forever server.
      


      

        

          Records & rankings
          Local records, checkpoints, player stats and rankings.
        


        

          Maps & RASP
          Jukebox, map rotation, votes, karma and TMX data.
        


        

          In-game UI
          Records Eyepiece, CP Live, menus and panels.
        


        

          Administration
          Players, bans, maps, restarts and settings through chat commands.
        

      

    


    

      

        
Installation

        latest GitHub release
      


      

        

          

            PyXASECO Checking version…
            Latest published source ZIP, directly from GitHub.
          


          
            Download latest ZIP
          
        


        
    
          
  1. Download the latest published release ZIP.
    2. 
          
  2. Extract the controller into your TrackMania server directory.
    3. 
          
  3. Install Python dependencies from requirements.txt.
    4. 
          
  4. Copy .env.example to .env and configure server and database access.
    5. 
          
  5. Connect your existing XAseco database or import the provided schema.
    6. 
          
  6. Start the controller using main.py or the provided launcher.
    7. 
        

      


      

        

          

            
            
          


          
        


        
# Create a Python environment
py -3.12 -m venv .venv
.venv\Scripts\activate

# Install dependencies
py -3.12 -m pip install -r requirements.txt

# Configure private credentials
copy .env.example .env

# Start PyXASECO
py -3.12 main.py

      


      
Dependencies are loaded from GitHub's requirements.txt.

      
Checking current README… · Documentation · Requirements

    


    

      

        
Setup details

        config and extras
      


      

        

          Configuration files in this release
          

            
Follow the configuration listed in the current release README. Keep private credentials out of your public webroot.


            

              
config.tomlController and TrackMania server connection.

              
apps.tomlEnabled apps and features.

              
settings.tomlController settings.

              
.envPrivate database and server credentials.

            

          

        


        

          Database and XAseco migration
          

            
Use your existing XAseco database or import the base schema supplied with the release. Set database credentials privately in .env and follow the current README.

          

        


        

          Included apps and recent additions
          

            
The active loadout is controlled by apps.toml. See the current release README for included apps.

            
Additional app modules are maintained in the GitHub repository.

          

        


        

          Integrations and optional services
          

            
Some apps use Dedimania, TMX, Discord or optional statistics endpoints. Configure only the services you enable, as described in the latest release documentation.

          

        

      

    


    

      

        
Support

        help and bug reports
      


      

        Report bugs, app issues, startup errors or XAseco differences on Discord or GitHub.
      


      

        Discord
        GitHub issues
        Documentation
      

    


    

      

        
Changelog

        Checking GitHub…
      


      

        
Loading published release notes…