Python 3.12 controller for TMNF and TMUF.
Records, RASP, Dedimania, widgets and admin tools.

Download stable GitHub Discord

v1.1 Stable TMNF & TMUF MySQL / MariaDB GPL-3.0

root@slikzhunt — pyxaseco
Starting… 

        


        

          Startup preview · sensitive data masked
          0 lines
        

      

        

      

    


    

      

        
Controller overview

        for TMNF and TMUF
      


      

        PyXASECO adds records, map control, votes, rankings, widgets and admin commands
        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

        current stable branch
      


      

        

          

            PyXASECO v1.1 Stable
            Current stable build from GitHub.
          


          
            Download ZIP
          
        


        
    
          
  1. Unpack the ZIP into the controller folder.
    2. 
          
  2. Install the Python requirements.
    3. 
          
  3. Configure server, database and admins.
    4. 
          
  4. Start PyXASECO with config.xml.
    5. 
        

      


      

        

          

            
            
          


          
        


        
# Create the environment and install dependencies
> py -3.12 -m venv .venv
> .venv\Scripts\activate
> pip install -r requirements.txt

# Start the controller
> py -3.12 main.py config.xml

      


      

        aiohttp 3.13.5 · aiomysql 0.3.2 · cryptography 46.0.7 · tzdata 2026.1 · pycountry 26.2.16
      

    


    

      

        
Setup details

        config and extras
      


      

        

          Required configuration files
          

            
Check these files before the first start.


            

              

                config.xml
                Server login, GBX port, admins and controller settings.
              

              

                localdatabase.xml
                MySQL or MariaDB connection details.
              

              

                plugins.xml
                Enabled plugins.
              

            

          

        


        

          Database and XAseco migration
          

            

              New installs use the included schema. Existing XAseco databases can be reused.
            


            
CREATE DATABASE pyxaseco CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

mysql -u root -p pyxaseco < database/pyxaseco_default_schema.sql

          

        


        

          Included controller plugins
          

            

              Included by default: records, admin commands, stats, Dedimania, TMX, RASP,
              jukebox, votes, Records Eyepiece, CP Live, ManiaKarma, FuFi menu and Discord webhooks.
            


            

              Optional: BestSecs · BestCPs · Freezone · FlexiTime · STALKER tools · Discord chat bridge
            

          

        


        

          Optional service configuration
          

            

              

                dedimania.xml
                Dedimania credentials.
              

              

                mania_karma.xml
                Map voting, karma and TMX opinions.
              

              

                discord_webhook.xml
                Chat, joins, warnings, admin logs and map changes.
              

            

          

        

      

    


    

      

        
Support

        help and bug reports
      


      

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


      

        Discord
        GitHub issues
        Documentation
      

    


    

      

        
Changelog

        loading…
      


      

        
Loading changelog…